GitHub에 첫 push 로그인 에러 해결법 (MacOS)

🧨 GitHub에 첫 push 하려는데 로그인 에러?! (비밀번호 인증 실패 해결법)

처음 GitHub에 코드를 push 하려는데…
아래 처럼 로그인이 안된다고 뜹니다.

remote: Support for password authentication was removed on August 13, 2021.
fatal: Authentication failed

😱 내 비밀번호 맞는데 왜 안 되는 거야?!
바로 여기서 멘붕 오죠. 저도 그랬습니다. (진짜로요...)

💢 원인 👉 GitHub, 비밀번호 인증을 아예 막아버렸어요

2021년 8월부터 GitHub는 비밀번호 인증을 전면 중단했습니다.
→ 앞으로는 비밀번호를 써도 절대 로그인되지 않아요.

❗ 그래서 뭘 써야 하냐고요?

바로 Personal Access Token (PAT) 이라는 걸 써야 해요!
이제 이게 비밀번호를 대체하는 인증 수단이 됐습니다.

아래 설명대로 따라하시면 됩니다.

1️⃣ GitHub에서 토큰(PAT) 만들기

📍 링크 클릭 👉토큰 생성하러 가기

✍️ 토큰 종류 고르기

옵션	설명
Fine-grained token	✅ GitHub가 공식 추천하는 방식, 더 안전
Classic token	구버전 호환용, 필요 시 사용 가능

💡 지금은 Fine-grained token으로 추천드립니다.

🔎 Classic Token vs Fine-grained Token... 뭐가 다른가요?

GitHub에서 Personal Access Token(PAT)을 만들다 보면
“Classic”이랑 “Fine-grained” 중 뭐 고를지 고민될 수 있어요.

두 토큰은 기능적으로 비슷하지만, 다음과 같은 차이점이 있습니다.

항목	🔐 Classic Token	🧬 Fine-grained Token
적용 범위	내 계정의 모든 저장소	선택한 특정 저장소만
권한 설정	대략적인 범위 (repo, gist, 등)	📌 읽기, 쓰기, 삭제까지 세부 설정 가능
보안성	보통 수준	✅ 훨씬 안전함
사용 가능성	대부분의 툴에서 사용 가능	일부 오래된 툴에서는 미지원 가능성 있음
GitHub 공식 권장도	⚠️ 점차 줄어드는 중	✅ GitHub가 공식 추천하는 방식

🎯 어떤 걸 선택해야 할까?

• 처음 Git을 배우고 있고, 혼자 공부하거나 프로젝트를 시작한다면
  → ✅ Fine-grained Token 추천!

• 회사 내부 툴, CI/CD, GitHub CLI 등 다양한 도구와 연동해야 하고,
  이 도구들이 아직 Fine-grained를 제대로 지원하지 않는다면
  → ✅ Classic Token도 필요할 수 있어요

⚠️ 단, Classic Token은 계정 전체에 접근 권한을 주기 때문에
실수하면 민감한 저장소까지 노출될 수 있어요!
꼭 필요한 경우에만 쓰는 게 좋아요.

💡 Tip

• 공부용 / 개인 프로젝트에는 → Fine-grained로 충분합니다
• 회사 팀 프로젝트 중 일부 저장소만 관리 → Fine-grained + "Only select repositories"
• 툴 연동 문제로 Classic이 필요할 때 → 최소 권한만 부여하고, 만료기간도 짧게!

⚙️ Repository access 설정

이건 내 토큰이 어떤 저장소에 접근할 수 있는가를 정하는 부분입니다.

옵션	설명	추천 상황
Public repositories	공개 저장소만 읽기 전용	❌ push는 안 됨
All repositories	모든 저장소(read/write) 접근	✅ 혼자 개인 프로젝트
Only select repositories	특정 저장소만 선택해서 설정	✅ 회사/팀 프로젝트

⚠️ push, commit 하려면 반드시 All or Only select 중 하나 선택해야 해요!

🔐 Repository permissions 설정

여기에서 실제 권한을 정합니다. ( 위의 Repository access를 선택하면 아래에 Repository permissions이 뜹니다.)

All repositories를 선택했다면, 아래에 여러 메뉴가 뜰 거예요.
그 중에 아래 항목 설정 값 추천합니다.

항목	기본값	해야 할 설정
Contents	❌ No access	✅ Read and write ← 꼭!
Metadata	Read-only	그대로 OK
나머지 (Issues, PR 등)	No access	필요할 때만 설정

🧩 No access는 말 그대로 “아무 것도 못 함”이에요.
push가 안 되는 이유는 대부분 여기에서 Contents가 No access인 상태 때문입니다!

✨ 나중에 권한 바꾸고 싶으면?

✅ 가능합니다!
GitHub에서는 생성한 토큰을 나중에 언제든 수정할 수 있어요.

• Personal access tokens 관리 페이지로 가서
• 원하는 토큰 우측의 Edit 클릭
• Repository access, Permissions 등 원하는 항목 수정
• 저장하면 바로 적용됩니다.

💡 예: 원래는 read-only로 만들었는데, 나중에 push 작업도 하게 되면 Read and write로 변경 가능!

---

2️⃣ Git에 토큰을 붙여넣기

위의 순서대로 토큰을 만들었다면 토큰이 생성되면서 '다음에는 볼 수 없다' 라고 뜹니다. (그러니 페이지를 이동하면 안돼요...ㅠㅠ)
바로 토큰을 복사합니다!

이제 다시 터미널에서 push 해보세요.
Git에서 로그인 정보를 물을 때 이렇게 뜰 거예요.

Username: your-email@example.com
Password: [👉 여기다 복사한 토큰 붙여넣기!]

✅ GitHub가 이 토큰을 비밀번호처럼 인식해서 로그인에 성공합니다!

---

3️⃣ 다음부터 안 물어보게 저장하기

✅ macOS에서는 Git 2.9.0 (2016년 6월 출시)부터
credential-osxkeychain helper가 자동으로 설치되고 사용할 수 있게 되었습니다.
다만, 자동 설정(--global)로 등록되는 시점은 Git 설치 방법에 따라 다릅니다.

✅ 확인 방법

git config --global credential.helper

→ 결과가 osxkeychain이면 이미 설정된 상태입니다.

설정 안 되어 있으면 수동으로 추가하면 됩니다!

git config --global credential.helper osxkeychain

---

🙌 드디어 성공~~ 🎉

처음엔 헷갈릴 수 있지만, 한 번만 제대로 설정하면
그다음부터는 정말 편하게 GitHub와 소통할 수 있어요.

💬 "처음 push 하다가 인증 오류 나서 하루를 날렸습니다…"
→ 그런 분들이 더 이상 생기지 않길 바라며, 이 글을 씁니다.