깃허브 비밀번호 오류 100% 해결: 개인 액세스 토큰(PAT) 발급 및 등록 가이드

로컬 환경에서 코드를 열심히 수정하고 git push를 보냈을 때, 갑자기 자격 증명 오류(Authentication Failed)를 마주하면 당황스럽기 마련입니다. 아이디와 비밀번호를 분명 정확하게 입력했는데도 로그인이 거부되는 이유는 GitHub의 보안 정책 때문입니다.

깃허브는 계정 탈취나 보안 취약점을 방지하기 위해 터미널 환경에서의 일반 계정 비밀번호 인증을 전면 중단했습니다. 대신 비밀번호보다 훨씬 안전하고 일회성 관리가 가능한 개인 액세스 토큰(Personal Access Token, PAT) 사용을 의무화했는데요. 개발자라면 반드시 한 번은 설정해야 하는 깃허브 토큰 발급 절차와 터미널 연동법을 쉽고 빠르게 정리해 드리겠습니다.

깃허브 개인 액세스 토큰 발급 6단계 상세 절차

토큰을 발급받는 메뉴는 의외로 홈페이지 메뉴 깊숙한 곳에 숨어 있어서 처음 접근할 때 헤매기 쉽습니다. 아래의 경로를 차근차근 따라오시면 1분 만에 발급 화면까지 진입할 수 있습니다.

🔉 1. 깃허브 계정 설정 및 개발자 메뉴 이동 경로

GitHub 공식 웹사이트에 로그인한 다음, 화면 오른쪽 맨 위에 있는 동그란 프로필 아이콘을 클릭합니다. 아래로 열리는 드롭다운 메뉴 창에서 톱니바퀴 모양의 Settings를 눌러 계정 관리 페이지로 이동합니다.

설정 페이지로 넘어온 후, 왼쪽 사이드바 메뉴의 가장 최하단까지 쭉 스크롤을 내리면 나오는 Developer settings 메뉴를 클릭합니다. 이곳이 바로 외부 프로그램 연동을 위한 자격 증명을 총괄하는 세팅 센터입니다.

🔉 2. 개인 액세스 토큰 Classic 메뉴 선택 및 생성 시작

Developer settings 내부 화면으로 진입했다면 왼쪽 메뉴판에서 Personal access tokens를 눌러 하위 메뉴를 열어줍니다. 최근 추가된 fine-grained 방식도 있지만, 전통적인 터미널 환경 및 다양한 소스코드 에디터와 호환성이 가장 좋은 Tokens (classic)를 선택합니다.

그다음 오른쪽 상단에 배치된 Generate new token 단추를 누르고, 이어서 나오는 Generate new token (classic)을 최종 선택하면 상세 설정 페이지가 나타납니다.

토큰 세부 옵션 설정과 권한 부여 및 안전 보관 규칙

설정 창에 들어왔다면 토큰의 쓰임새와 유효 기한, 그리고 로컬 컴퓨터에 허용할 권한 영역을 올바르게 체크해 주어야 합니다. 이 과정을 대충 넘기면 push 명령어가 먹통이 될 수 있습니다.

🔉 3. 토큰 식별 이름 Note 작성과 Expiration 만료일 지정 방법

화면 가장 위에 보이는 Note 기입란에는 이 토큰이 어디에 쓰이는지 식별할 수 있는 메모를 적어줍니다. 저 같은 경우에는 후속 관리가 편하도록 'notebook-vs-code'나 'main-desktop-cli'처럼 기기명과 개발 툴 이름을 조합해서 적어두는 편입니다.

바로 아래에 있는 Expiration은 이 자격 증명을 언제까지 유효하게 만들 것인지 결정하는 만료일 설정입니다. 보안을 철저히 유지하기 위해서는 가급적 '30 days' 또는 '60 days'처럼 주기가 짧은 옵션을 선택하고 만료 시점에 갱신해 주는 것이 안전합니다.

🔉 4. repo 접근 범위 Scopes 체크 및 토큰 최종 생성과 보관

가장 중요한 Scopes(권한 범위) 선택 구간입니다. 단순히 내 컴퓨터 터미널에서 원격 저장소에 코드를 push하고 pull하는 기본 작업을 원한다면, 리스트 맨 위에 있는 repo 항목의 체크박스만 가볍게 체크해 주시면 됩니다.

스크롤을 맨 아래로 내려 Generate token을 누르면 초록색 체크 모양과 함께 고유한 토큰 문자열이 생성됩니다. 이 문자열은 창을 새로고침하거나 다른 페이지로 넘어가면 평생 다시 볼 수 없으므로, 그 자리에서 즉시 복사하여 나만의 개인 메모장이나 텍스트 파일에 꼭 저장해 두어야 합니다.

터미널 및 로컬 환경에서 발급된 토큰 사용법

안전하게 복사해 둔 토큰 값을 활용해 내 컴퓨터 터미널에서 직접 원격 저장소와 데이터를 주고받는 실전 활용 단계입니다. 일회성 사용법과 자동 로그인 연동법 두 가지가 있습니다.

🔉 5. git push 실행 시 패스워드 프롬프트 입력 방식

로컬 프로젝트 폴더에서 커밋을 마치고 git push origin main과 같은 명령어를 치면 터미널 창에 사용자 이름과 패스워드를 묻는 텍스트 라인이 뜹니다.

Username에는 기존처럼 본인의 깃허브 아이디를 적고 엔터를 누릅니다. 그다음 Password를 요구하는 자리에 방금 발급받아 메모장에 복사해 두었던 토큰 문자열을 그대로 붙여넣기(Ctrl+V 또는 우클릭) 하고 엔터를 치면 정상적으로 푸시가 완료됩니다. (입력 시 보안상 토큰 글자가 화면에 보이지 않는 것이 정상입니다.)

🔉 6. 원격 URL 변경 및 토큰 영구 포함 매핑 방식

매번 명령어를 입력할 때마다 메모장을 열어 긴 토큰을 복사하는 과정이 귀찮다면, 프로젝트의 원격 주소 자체에 토큰 인증 정보를 영구적으로 심어버리는 팁이 있습니다.

git remote set-url origin https://<내토큰값>@github.com/<계정명>/<저장소명>.git 주소 구조에 맞게 본인의 정보를 대입하여 터미널에 한 번만 실행해 주면, 앞으로는 아이디와 비번을 묻는 팝업이나 프롬프트 없이 즉시 동기화가 진행되어 작업 효율이 극대화됩니다.

자주 묻는 질문

Q1. 발급받은 토큰 창을 복사하지 못하고 닫아버렸는데 확인 방법이 절대 없나요?

A1. 깃허브 서버 자체에서도 보안상 평문 토큰은 재열람을 차단하기 때문에 절대 다시 확인할 수 없습니다. 아쉽지만 기존에 잘못 만든 토큰은 Delete 버튼을 눌러 지워버리시고, 동일한 과정으로 새 토큰을 재발급(Regenerate)받아 메모장에 처음부터 다시 저장하셔야 합니다.

Q2. 깃허브 토큰의 만료 기한이 지나면 기존 소스코드가 다 날아가나요?

A2. 아닙니다. 저장소 내부의 소스코드나 커밋 내역은 안전하게 보존됩니다. 다만 터미널에서 push나 pull을 시도할 때 인증 오류(401 에러)가 발생하며 동기화만 막히는 것이므로, 깃허브 웹사이트에 들어가 만료된 토큰의 기한을 연장하거나 새 토큰을 발급받아 로컬 컴퓨터에 다시 등록해 주시면 정상 작동합니다.

Q3. 원격 주소에 토큰을 심어두는 방식(set-url)은 보안상 안전한가요?

A3. 개인만 사용하는 독립된 컴퓨터나 노트북 환경이라면 매우 편리하고 안전한 방식입니다. 다만 공용 PC나 다른 사람과 함께 쓰는 기기의 경우, 터미널 명령어 히스토리나 .git/config 설정 파일에 내 토큰 값이 평문으로 노출될 우려가 있으므로 공용 환경에서는 권장하지 않습니다.