Michael Johnson변수나 스크립트에 한 번 복사해 둔 토큰은 만료된 뒤 작동하지 않을 수 있습니다. 2026년 10월 21일, GitHub는 GitHub CLI에서 자동 갱신되는 만료형 OAuth 인증 정보의 공개 프리뷰를 발표했습니다. 이 모드는 선택적으로 활성화할 수 있으며, CLI가 직접 인증을 관리하는 워크플로를 위한 기능입니다.
갱신되는 인증 정보 활성화하기
GitHub CLI 버전 2.103.0 이상이 필요합니다. 이번 로그인에만 적용하려면 --expiring 플래그를 추가하세요:
gh auth login --expiring이후 로그인에서도 갱신되는 인증 정보를 요청하도록 설정하려면 다음 명령을 실행하세요:
gh config set expiring_credentials enabledCLI는 만료형 액세스 토큰과 순환 갱신 토큰을 함께 저장하고, 인증 정보가 필요할 때 갱신합니다. gh auth status 명령으로 인증 상태와 현재 토큰의 만료 시점을 확인할 수 있습니다. 이 플래그는 갱신되는 인증 정보를 요청하지만, 실제 발급 여부는 호스트의 기능과 OAuth 앱 설정에 따라 달라집니다. 서버가 이를 지원하지 않으면 CLI는 만료되지 않는 일반 토큰을 사용합니다.
인증 정보를 사용하는 Git 설정하기
HTTPS를 사용하는 저장소에서는 GitHub CLI를 Git credential helper로 설정하세요:
gh auth setup-git그러면 Git이 gh에 인증 정보를 요청하고, CLI는 사용 전에 이를 갱신할 수 있습니다. GitHub는 Git 2.46 이상을 권장합니다. 이 버전에서는 CLI가 만료형 인증 정보를 표시해 Git이 만료 후에도 이를 캐시하지 않도록 할 수 있습니다. 구버전 Git에서도 GitHub CLI를 사용할 수 있지만, 한 번 업그레이드 안내가 표시됩니다.
설정 후 원격 저장소 상태를 읽는 등 HTTPS를 통한 일반적인 Git 작업을 실행해 확인하세요. Git이 helper를 통해 인증 정보를 가져오는지 점검하면 CLI 로그인뿐 아니라 전체 인증 경로를 확인할 수 있습니다.
스크립트와 외부 앱 점검하기
한 번 gh auth token을 실행해 토큰 문자열을 저장한 뒤 나중에 다시 사용하는 스크립트나 확장 프로그램은 취약한 지점입니다. 해당 액세스 토큰이 만료될 수 있기 때문입니다. 외부 프로세스에 토큰이 필요하다면 실행할 때마다 gh auth token으로 새 토큰을 요청하세요. 토큰을 사용하는 쪽에서도 최신 값을 활용하고 만료를 처리할 수 있어야 합니다.
운영 환경에서 이 모드를 활성화하기 전에 CI 작업, 로컬 스크립트, 편집기 확장 프로그램, 환경 변수나 설정 파일에서 토큰을 가져오는 도구를 점검하세요. 실행할 때마다 최신 값을 요청하는지, 아니면 저장된 사본에 의존하는지 확인해야 합니다. 장기간 유효한 토큰이 필요한 프로세스에는 기존 인증 방식을 유지하세요.
기능 지원 범위
GitHub는 github.com과 ghe.com에서 이 기능을 지원한다고 발표했습니다. GitHub Enterprise Server는 버전 3.23부터 이러한 인증 정보를 발급합니다. 이전 버전에서는 갱신되는 인증 정보를 요청해도 만료되지 않는 일반 토큰으로 전환됩니다. 현재 이 모드는 선택적으로 활성화해야 하며, GitHub는 향후 신규 로그인에서 기본값으로 설정할 계획입니다.
실무에서는 GitHub CLI를 업데이트하고, 갱신되는 인증 정보 요청을 활성화한 다음, gh auth setup-git으로 Git을 설정하고 외부 프로세스가 토큰을 저장하는지 확인하면 됩니다. 이렇게 하면 전환 전에 호환되지 않는 사용 사례를 찾아낼 수 있습니다.
자세한 내용은 GitHub의 프리뷰 발표와 gh auth login 명령 문서에서 확인할 수 있습니다.