GitHub Copilot CLIの認証トラブルシューティング

認証エラー

認証エラーが発生した場合は、次の表を使用して原因と解決策を特定します。

問題点	原因	修正	詳細情報
認証情報が見つかりません	資格情報が格納されていない

          `copilot login` を実行します。                                       | 
          [認証情報が見つかりません](#no-authentication-information-found)       |

認証情報が見つかりません

Copilot CLI のエラーが次のように表示されます。

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

原因

チェックされた場所には資格情報が存在しません。

修正

認証が見つからない場所を見つけて、accessを復元するには、次の手順に従います。

認証の状態を確認する

Bash

gh auth status

gh auth status

ログインしていないことを示すメッセージが表示された場合は、 gh auth login でログインするか、 copilot loginで OAuth フローを使用します。

認証環境変数が設定されているかどうかを確認する

環境変数を使用している場合は、 COPILOT_GITHUB_TOKEN、 GH_TOKEN、または GITHUB_TOKEN 環境変数が設定されているかどうかを確認します。

Bash

echo $COPILOT_GITHUB_TOKEN

echo $COPILOT_GITHUB_TOKEN

コマンドが何も出力しない場合、変数は設定されません。変数を有効なトークンに設定します。トークンを生成するには、GitHub Copilot CLIを認証するを参照してください。

Bash

 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

macOS キーチェーン

Bash

security find-generic-password -s copilot-cli

security find-generic-password -s copilot-cli

項目が見つからない場合は、 /login で再度認証するか、 copilot login して作成します。項目が見つかったが認証に失敗した場合は、保存された資格情報を削除し、 /login または copilot loginで再び認証します。

Bash

  security delete-generic-password -s copilot-cli

  security delete-generic-password -s copilot-cli

トークンの期限切れまたは取り消し

Copilot 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 のトークンの状態とアクセス許可を確認します。トークンには Copilot Requests アクセス許可が必要です。必要に応じて、必要なアクセス許可を持つ新しいトークンを生成します。

Token (classic) が拒否されました

          `ghp_`で始まるトークンは暗黙的に無視され、CLI はトークンが設定されていないかのように動作します。

原因

クラシック personal access tokens は、 Copilot CLI ではサポートされていません。

修正

必要なスコープを持つ詳細に設定された personal access token を生成します。

Access拒否

Copilot 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:

原因

organization のポリシーで GitHub Copilot CLI（コマンドラインインターフェース）がブロックされているか、ユーザーアカウントに GitHub Copilot ライセンスがありません。

修正

アカウントにアクティブな GitHub Copilot ライセンスがあることを確認します。
organization の管理者に、organization のポリシー内で GitHub Copilot CLI（コマンドラインインターフェース）を有効にするよう依頼してください。

キーチェーンアクセス失敗

ログイン中に、CLI によってシステムキーチェーンが使用できないことを確認するメッセージが表示され、資格情報をプレーンテキストで格納するかどうかを確認するメッセージが表示されます。

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

原因

システムキーチェーンにアクセスできません。これは、 libsecret、ヘッドレスサーバー、またはアクセス許可の問題があるシステムがない Linux システムで発生する可能性があります。

修正

オペレーティングシステムの手順に従って、安全に資格情報の保存を復元します。

macOS または Windows

macOS では、キーチェーン Access アプリが使用可能であることを確認し、ログインキーチェーンのロックを解除できます。 Windows では、Credential Manager が使用可能であることを確認し、Windows Vault にアクセスできることを確認してください。システム資格情報マネージャーにアクセスできない場合は、プロンプトが表示された場合はプレーンテキストストレージを使用するか、環境変数トークンを用いて認証し、/login または copilot login を再度実行してください。

Linux

Linux では、システムキーリングを使用するか、プレーンテキストで資格情報を格納します。

       `secret-tool`がインストールされているかどうかを確認します。

Bash

command -v secret-tool

command -v secret-tool

       `secret-tool`が見つからない場合、または検索コマンドが結果を返さない場合は、`libsecret`とその依存関係をインストールします。

Bash

sudo apt sudo apt list libsecret-1-0 libsecret-1-dev libsecret-common gnome-keyring gnome-keyring-pkcs11 seahorse

sudo apt sudo apt list libsecret-1-0 libsecret-1-dev libsecret-common gnome-keyring gnome-keyring-pkcs11 seahorse

```
       `secret-tool`がインストールされたら、キーリングで保存された資格情報を検索します。
```
Bash
```
secret-tool search copilot-cli
```
```
secret-tool search copilot-cli
```
コマンドから 1 つ以上の結果が返された場合、資格情報はキーリングに存在します。ターミナルで copilot login を実行するか、または Copilot CLI で /login を実行してください。

GitHub Copilot CLIの認証トラブルシューティング

この記事で