Git Credential Manager

사용 대상과 역할

터미널이나 개발 도구에서 HTTPS 주소로 원격 저장소를 이용하는 개발자에게 적합하다. Git 자체나 저장소 관리 화면을 대체하는 프로그램이 아니라, Git이 인증을 요청할 때 호출하는 보조 도구다. 여러 호스팅 서비스를 함께 쓰거나 조직의 다중 인증을 거쳐야 할 때 활용할 수 있다.

설치와 설정이 끝나면 평소의 clone·fetch·pull·push 명령을 사용한다. 호스팅 서비스에 따라 로그인 화면은 달라지며, 저장된 자격 증명이나 토큰은 유효한 동안 재사용된다.

지원 OS와 버전 검토

2026-10-09 확인한 공식 배포 페이지에서 최신 표시는 3.0.1이다. 입력 정보에는 macOS만 기재돼 있지만 공식 지원 OS는 Windows, macOS, Linux다. 3.x의 macOS 최소 요구 사항은 macOS 14이며 ARM64와 x64를 지원한다. Intel Mac 지원은 공식 문서에서 최선 노력 수준으로 명시한다.

현재 GCM은 지원 종료 제품이 아니다. 다만 이름이 비슷한 구형 Git Credential Manager for Windows와 Java 기반 Git Credential Manager for Mac and Linux는 사용 중단 대상이므로 설치 파일과 기존 설정을 구분해야 한다.

macOS 설치와 첫 작업

먼저 Git 사용 가능 여부와 macOS 버전을 확인한다. Homebrew를 이용한다면 공식 권장 설치 명령은 brew install --cask git-credential-manager다. 공식 Releases에서 macOS 설치 패키지를 내려받아 실행하는 방법도 제공한다. 일반 플랫폼 패키지는 별도 .NET 설치가 필요 없지만 .NET 도구 방식은 .NET 10 SDK가 필요하다.

GitHub 공식 안내에 따르면 macOS 설치 시 Git 설정은 자동으로 구성된다. 이후 접근 권한이 있는 비공개 저장소의 HTTPS 주소로 git clone을 실행하고, 열린 브라우저에서 계정 로그인·OAuth 앱 승인·필요한 2단계 인증을 완료한다. 업데이트는 brew upgrade --cask git-credential-manager로 진행할 수 있다.

실무 활용 예시

Mac에서 회사 GitHub 비공개 저장소와 Azure Repos 프로젝트를 함께 관리하는 상황을 생각할 수 있다. 각 저장소의 HTTPS 주소로 작업하면 GCM이 해당 서비스의 인증을 연결하고 후속 fetch나 push에 자격 증명을 재사용한다. 저장소마다 토큰을 문서나 스크립트에 적어 두는 방식보다 관리 부담을 줄이는 용도다.

Azure Repos는 3.x에서 OAuth가 기본이며 Microsoft 인증 브로커도 지원 환경에서 기본 활성화된다. macOS 브로커 인증에는 Company Portal과 장치 등록이 필요하므로 회사의 장치 관리 정책을 먼저 확인해야 한다.

비용과 사용 제약

GCM은 MIT 라이선스로 제공돼 도구 자체를 무료로 사용할 수 있다. 확인한 공식 자료에는 별도 유료판이나 무료판의 저장소 수 제한이 제시돼 있지 않다. 연결하는 호스팅 서비스의 요금과 접근 권한은 별도로 판단해야 한다.

macOS 기본 저장소는 보통 login 키체인이다. GCM에는 평문 파일 저장 옵션도 있지만 공식 문서는 안전한 저장 방식이 아니라고 경고한다. SSH 주소를 사용하는 저장소의 인증에는 GCM이 필요하지 않으며, 설치만으로 저장소 접근 권한이 생기지는 않는다.

인증 실패 시 확인 순서

clone·pull·push가 실패하면 먼저 git remote -v로 주소를 확인하고 브라우저에서 같은 저장소에 접근할 수 있는지 살핀다. 브라우저에서도 접근하지 못하면 저장소 권한부터 확인한다. 개발 도구에서만 실패한다면 터미널에서 같은 작업을 시도해 도구별 설정 문제인지 좁힌다.

이어 git-credential-manager diagnose로 상태를 점검한다. HTTP 보안 오류는 원격 주소의 HTTPS 사용 여부를, 회사 프록시 환경의 오류는 Git과 GCM의 프록시 설정을 확인한다. GitHub Enterprise Managed Users에서 로그인이 반복되면 공식 안내의 계정 필터링 설정을 검토한다. 해결되지 않으면 공식 FAQ의 GCM_TRACE 절차로 추가 정보를 수집한다.

다른 도구와 선택 기준

GitHub만 사용하면서 관련 명령도 함께 쓰려면 GitHub CLI의 gh auth login으로 HTTPS 인증을 구성하는 방법을 고려할 수 있다. 여러 호스팅 서비스의 인증을 Git 작업에 연결하려면 GCM이 후보가 된다.

이미 SSH 키로 작업하는 환경이라면 SSH 인증을 계속 사용할 수 있다. macOS의 osxkeychain 같은 단순 저장 도구와 비교할 때는 자격 증명 보관뿐 아니라 브라우저 로그인과 다중 인증 처리까지 필요한지를 기준으로 선택하면 된다.

공식 안내

• Git Credential Manager — README · 확인 2026-10-09
• Install instructions · 확인 2026-10-09
• Releases — GCM 3.0.1 · 확인 2026-10-09
• Credential stores · 확인 2026-10-09
• Frequently asked questions · 확인 2026-10-09
• Git Credential Manager — MIT License · 확인 2026-10-09
• Caching your GitHub credentials in Git · 확인 2026-10-09