원문 소식, 쉽게 읽기
GitHub는 2026년 10월 21일 GitHub CLI의 만료·자동 갱신 토큰을 선택형 공개 미리보기로 발표했습니다. 출처
CLI는 터미널 명령으로 GitHub 기능을 사용하는 도구입니다. 기능을 담은 2.103.0 자체는 정식 릴리스로 등록돼 있습니다. 출처
로그인 유지와 토큰의 수명
OAuth 토큰은 허용받은 계정 기능을 앱이 사용할 때 쓰는 인증정보입니다. 새 방식은 수명이 짧은 요청용 접근 토큰과 새 접근 토큰 발급용 회전 갱신 토큰을 함께 보관합니다. CLI 2.103.0 이상에서 선택하며 필요할 때 자동 갱신합니다. 출처
선택하려면 로그인 때 gh auth login --expiring을 사용합니다. 이 옵션은 만료형 자격증명을 요청하는 설정이며 실제 발급은 호스트와 OAuth 앱의 지원에 달려 있습니다. 출처
| 접속 환경 | 발표된 지원 범위 |
|---|---|
| github.com·ghe.com | 만료형 토큰 지원 |
| GitHub Enterprise Server 3.23 이상 | 지원 시작 |
| 이전 Enterprise Server | 기존 비만료형으로 처리 |
GitHub Enterprise Server는 조직이 직접 운영하는 GitHub 서버 제품입니다. 발표는 기존 로그인과 직접 제공한 토큰의 동작을 유지한다고 안내합니다. 새 기본값으로의 전환은 향후 계획입니다. 출처
만료 상태는 gh auth status로 보며 토큰 값은 기본 숨김입니다. gh auth refresh로 권한을 바꿀 때도 --expiring이나 해당 설정으로 만료형을 요청합니다. 자동 갱신은 권한 변경과 구분됩니다. 출처
HTTPS Git과 외부 스크립트의 차이
HTTPS로 Git 저장소를 주고받을 때는 GitHub CLI가 자격증명 도우미 역할을 맡아 토큰을 제공하고 갱신해야 합니다. 도우미는 Git이 인증정보를 요청할 때 응답하는 프로그램입니다. 공식 문서는 gh auth setup-git으로 설정하도록 안내합니다. 출처
Git 2.46 이상은 권장 버전입니다. CLI가 만료 자격증명을 표시해 캐시 도우미가 수명 이후까지 저장하지 않게 합니다. 구버전도 동작하지만 캐시에 남은 만료 값을 다시 사용할 가능성이 있습니다. 출처
gh auth token의 결과를 한 번 저장해 반복 사용하는 스크립트나 다른 도구에는 별도 조건이 생깁니다. 복사한 접근 토큰은 나중에 만료되므로, 공식 발표는 외부에서 필요할 때마다 새로 읽도록 권고합니다. 오랫동안 유효한 토큰에 의존하는 작업은 선택 적용을 미루라고 안내합니다. 출처
자격증명 저장 위치도 함께 봐야 합니다. CLI는 시스템의 보안 자격증명 저장소를 사용하지만, 사용할 수 없거나 문제가 있으면 평문 파일로 보관합니다. 이 저장 방식은 만료 시간과 함께 운영 조건으로 고려할 항목입니다. 출처
OYOPICK의 시선
이번 변화에서 살펴볼 기준은 토큰이 얼마나 짧게 유효한지와 함께 누가 갱신을 맡는지입니다. CLI나 자격증명 도우미를 거치는 작업과 복사한 문자열을 계속 사용하는 작업을 구분하면, 같은 계정에서도 적용 판단이 달라지는 이유를 이해하기 쉽습니다.
일상 명령은 간편하게 유지하면서 유출된 접근 토큰의 사용 가능 시간을 줄이는 방향으로 발전하길 바랍니다. 향후 기본값이 바뀔 때에도 실제 서버가 발급한 방식과 외부 스크립트의 의존성을 분명하게 보여주면 전환이 더 수월해질 수 있습니다. 공개 미리보기 단계에서는 이런 경계를 드러내는 안내가 유용한 평가 기준이라고 봅니다.