GitHub Copilot CLI 인증 문제 해결

부조종사 CLI 로그인 중 발생하는 인증 실패 문제를 진단합니다.

이 문서의 내용

인증 오류

인증 오류가 발생하는 경우 아래 표를 사용하여 원인과 해결 방법을 식별합니다.

문제원인수정추가 정보
인증 정보를 찾을 수 없음자격 증명이 저장되지 않음
          `copilot login`을 실행합니다.                                       | 
          [인증 정보를 찾을 수 없음](#no-authentication-information-found)       |

| 401 권한 없음 | 토큰이 해지되었거나 권한이 부족합니다. | 사용 권한이 있는 토큰 생성 | 토큰이 만료되었거나 해지됨 | | Token (classic) 리젝됨 | Token (classic) (ghp_) | 세분화된 personal access token을 활용 | Token (classic)이(가) 거부되었습니다 | | 403 금지 또는 정책 거부 | Copilot 라이선스 또는 enterprise/조직 정책 | 구독 및 조직 설정 확인 | 액세스 거부됨 | | 키 집합을 사용할 수 없음 | 누락된 시스템 키체인 | libsecret을 설치하거나 일반 텍스트를 수락하십시오. | 키 집합 액세스 실패 | | 잘못된 계정 | 여러 계정 또는 환경 변수 재정의 | 환경 변수를 확인하고 /user switch를 사용하세요. | 잘못된 계정 |

인증 정보를 찾을 수 없음

부조종사 CLI는 다음과 같은 오류를 표시합니다.

Error: No authentication information found
Copilot can be authenticated with GitHub using an OAuth Token or a Fine-Grained Personal Access Token

원인

선택한 위치에 자격 증명이 없습니다.

수정

다음 단계를 사용하여 인증이 누락된 위치를 찾고 액세스를 복원합니다.

인증 상태 확인

Bash
gh auth status

로그인하지 않았음을 나타내는 메시지가 표시되면 gh auth login으로 로그인하세요. 또는 copilot login로 OAuth 흐름을 사용하세요.

인증 환경 변수가 설정되었는지 확인

환경 변수를 사용하는 경우, COPILOT_GITHUB_TOKEN, GH_TOKEN, 또는 GITHUB_TOKEN 환경 변수가 설정되어 있는지 확인합니다.

Bash
echo $COPILOT_GITHUB_TOKEN

명령이 아무 것도 인쇄하지 않으면 변수가 설정되지 않습니다. 변수를 유효한 토큰으로 설정합니다. 토큰을 생성하려면 GitHub Copilot CLI 인증을 참조하세요.

Bash
 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

macOS 키체인

Bash
security find-generic-password -s copilot-cli

항목을 찾을 수 없는 경우 /login 또는 copilot login로 다시 인증하거나 새 항목을 만들 수 있습니다. 항목을 찾았지만 인증이 여전히 실패하는 경우 저장된 자격 증명을 제거한 다음, 다음을 사용하여 /login 다시 인증합니다 copilot login.

Bash
  security delete-generic-password -s copilot-cli

토큰이 만료되었거나 해지됨

부조종사 CLI는 다음과 같은 오류를 표시합니다.

Error: Authentication failed

Your GitHub token may be invalid, expired, or lacking the required permissions.

To resolve this, try the following:
  • Start 'copilot' and run the '${LOGIN_COMMAND}' command to re-authenticate
  • If using a Fine-Grained PAT, ensure it has the 'Copilot Requests' permission enabled
  • If using COPILOT_GITHUB_TOKEN, GH_TOKEN or GITHUB_TOKEN environment variable, verify the token is valid and not expired
  • Run 'gh auth status' to check your current authentication status

원인

토큰이 해지되었거나, 만료되었거나, 필요한 권한 없이 만들어졌습니다.

수정

GitHub에 대한 토큰의 상태 및 사용 권한을 검토합니다. 토큰에는 코필로트 요청 권한이 있어야 합니다. 필요한 경우 필요한 권한으로 새 토큰을 생성합니다.

Token (classic) 리젝됨

토큰으로 ghp_ 시작하는 것은 자동으로 무시되고 CLI는 토큰이 설정되지 않은 것처럼 동작합니다.

원인

부조종사 CLI에서는 고전적인 personal access tokens를 지원하지 않습니다.

수정

필요한 권한 범위를 직접 지정하여 상세하게 설정된 personal access token를 생성할 수 있습니다.

액세스 거부됨

부조종사 CLI를 사용할 때 다음 오류 중 하나가 나타날 수 있습니다.

Error: Access denied by policy settings

Your Copilot CLI policy setting may be preventing access. This can happen when:
  • Your organization has restricted Copilot access
  • Your Copilot subscription does not include this feature
  • Required policies have not been enabled by your administrator

To resolve this, visit your Copilot settings:

원인

조직의 정책으로 인해 GitHub Copilot 명령 줄 인터페이스 (CLI) 사용이 차단되었거나, 해당 사용자 계정에 GitHub Copilot 라이선스가 부여되지 않았습니다.

수정

  • 계정에 활성 상태인 GitHub Copilot 라이선스가 있는지 확인합니다.
  • 조직의 정책에서 GitHub Copilot 명령 줄 인터페이스 (CLI)을(를) 활용하도록 조직 관리자에게 요청하세요.

키체인 액세스 실패

로그인하는 동안 CLI는 시스템 키 집합을 사용할 수 없다는 메시지를 표시하고 자격 증명을 일반 텍스트로 저장할지 여부를 묻습니다.

System keychain unavailable. Store token in plaintext config file? (y/N)

원인

시스템 키 집합에 액세스할 수 없습니다. 이 문제는 사용 권한 문제가 있는 시스템 또는 헤드리스 서버가 없는 libsecretLinux 시스템에서 발생할 수 있습니다.

수정

운영 체제의 단계에 따라 보안 자격 증명 스토리지를 복원합니다.

macOS 또는 Windows

macOS에서 키 집합 액세스 앱을 사용할 수 있는지 확인하고 로그인 키 집합의 잠금을 해제할 수 있습니다. Windows에서 자격 증명 관리자가 사용 가능한지 확인하고 Windows 자격 증명 모음에 액세스할 수 있는지 확인하십시오. 시스템 자격 증명 관리자에 액세스할 수 없는 경우 일반 텍스트 스토리지(메시지가 표시되면)를 사용하거나 환경 변수 토큰을 사용하여 인증한 다음 다시 실행 /login 하거나 copilot login.

리눅스

Linux에서 시스템 키 지정을 사용하거나 자격 증명을 일반 텍스트로 저장합니다.

  1.        `secret-tool`이(가) 설치되어 있는지 확인합니다.
    Bash
    command -v secret-tool

  2.        `secret-tool`를 찾을 수 없거나 검색 명령이 결과를 반환하지 않으면 `libsecret` 및 그 종속성을 설치하십시오.
    Bash
    sudo apt sudo apt list libsecret-1-0 libsecret-1-dev libsecret-common gnome-keyring gnome-keyring-pkcs11 seahorse

  3. 설치되면 secret-tool 키링에서 저장된 자격 증명을 검색합니다.

    Bash
    secret-tool search copilot-cli

    명령이 하나 이상의 결과를 반환하는 경우 자격 증명이 키링에 존재합니다. 터미널에서 copilot login을(를) 실행하거나 부조종사 CLI에서 /login을(를) 다시 실행하세요.

잘못된 계정

잘못된 사용자가 인증되었거나 토큰이 잘못된 조직에 속합니다.

원인

여러 계정이 저장되거나 환경 변수가 저장된 토큰을 재정의합니다.

수정

계정을 전환하려면 CLI 프롬프트에서 /user switch을 사용하거나 /logout으로 로그아웃한 후 올바른 계정으로 /login을 실행하십시오.