GitHub CLI 토큰 자동 갱신 지원…gh auth login --expiring 적용 전 확인할 사항

먼저 읽는 핵심

GitHub CLI 2.103.0부터 만료·자동 갱신 OAuth 인증을 선택적으로 활성화할 수 있다.
기존 로그인에는 자동 적용되지 않으며 Git HTTPS 연결에는 gh 자격 증명 도우미 설정이 권장된다.
토큰을 파일이나 환경변수에 장기 보관하는 스크립트는 만료로 실패할 수 있어 사용 방식을 점검해야 한다.

소프트웨어 아키텍처를 설계하는 개발자 — 고도화 소프트웨어 시스템 설계 및 개발 작업

무엇이 바뀌었나

GitHub는 2026년 10월 21일 GitHub CLI(gh)에서 만료형 OAuth 자격 증명과 자동 갱신 기능을 공개 미리보기로 제공한다고 발표했다. gh는 유효기간이 있는 액세스 토큰과 갱신할 때 교체되는 리프레시 토큰을 저장하고, 필요한 시점에 갱신한다.

이전처럼 장기간 유효한 토큰 하나에 의존하지 않으므로 액세스 토큰이 노출되더라도 악용 가능한 시간은 줄어든다. 하지만 토큰 탈취 위험 자체가 사라지는 것은 아니므로 비밀정보 관리와 최소 권한 원칙은 여전히 중요하다.

로그인과 상태 확인 방법

GitHub 공식 안내에 따르면 GitHub CLI 2.103.0 이상에서 `gh auth login --expiring`으로 만료형 인증을 요청할 수 있다. 매 로그인에 적용하고 싶다면 `gh config set expiring_credentials enabled`를 사용한다.

현재 인증과 액세스 토큰 만료 상태는 `gh auth status`로 확인할 수 있다. 기능은 선택 사항이므로 기존 로그인과 직접 입력한 토큰은 별도로 바꾸지 않는 한 종전 방식으로 동작한다.

코드 리뷰 및 구조 회의를 진행하는 개발팀 — 소프트웨어 아키텍처 정기 코드 리뷰 및 배포 전략 논의

Git HTTPS 연결과 자동화의 함정

Git HTTPS를 함께 사용한다면 `gh auth setup-git`으로 GitHub CLI를 자격 증명 도우미로 구성하는 것이 권장된다. Git 2.46 이상으로 업그레이드하면 만료된 인증 정보가 수명보다 오래 캐시되는 문제를 줄이는 데 도움이 된다.

주의할 부분은 한 번 얻은 토큰을 계속 재사용하는 스크립트다. `gh auth token`의 결과를 저장하거나 다른 프로그램으로 복사해 장기간 사용하면 갱신 후 기존 토큰이 만료될 수 있다. 외부 프로그램에서 토큰이 필요하다면 호출 직전에 `gh auth token`을 다시 읽는 방식이 적합하다.