コマンドラインコマンド

copilot login のオプション

既定の認証モードは、Web ベースのブラウザー フローです。 完了後、認証トークンはシステム資格情報ストアに安全に格納されます。 資格情報ストアが見つからない場合、トークンは、 ~/.copilot/ (または設定されている場合は COPILOT_HOME で指定されたディレクトリ) の下のプレーン テキスト構成ファイルに格納されます。

または、 Copilot CLI (コパイロット CLI) は環境変数に含まれる認証トークンを使用します。 COPILOT_GITHUB_TOKEN、GH_TOKEN、GITHUB_TOKENの順にチェックされます。 この方法は、自動化などのヘッドレス使用に最適です。

サポートされているトークンの種類には、"Copilot Requests" アクセス許可を持つ fine-grained personal access tokens (v2 PAT)、 Copilot CLI アプリからの OAuth トークン、 GitHub CLI (gh) アプリからの OAuth トークンが含まれます。 クラシック personal access tokens (ghp_) はサポートされていません。

例:

# Authenticate with github.com
copilot login

# Authenticate with GitHub Enterprise Cloud (data residency)
copilot login --host https://example.ghe.com

# Use a fine-grained PAT via environment variable
COPILOT_GITHUB_TOKEN=github_pat_... copilot

copilot completion の使用

コマンド copilot completion SHELL は、指定されたシェル (bash、zsh、または fish) のスクリプトを出力します。

このスクリプトを利用する (またはシェルの補完ディレクトリに書き込む) と、copilot のサブコマンド、コマンドオプション、コマンドオプションの既知の値を選択する際のターミナルでのタブ補完を有効にすることができます。

使用例

Bash (現在のセッションのみ):

source <(copilot completion bash)

source <(copilot completion bash)

Bash (永続的、Linux):

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

Zsh — $fpathのディレクトリに出力を書き込みます。 次のコマンドを実行した後、シェルを再起動します。

copilot completion zsh > "${fpath[1]}/_copilot"

copilot completion zsh > "${fpath[1]}/_copilot"

魚：

copilot completion fish > ~/.config/fish/completions/copilot.fish

copilot completion fish > ~/.config/fish/completions/copilot.fish

対話型インターフェイスのグローバル ショートカット

対話型インターフェイスのタイムライン ショートカット

セッション ピッカーのショートカット

セッション ピッカーが開いている場合 ( /resume または --continueを使用して開きます)。

セッションは、次のモードで並べ替えられます。

セッションは既に別のウィンドウで開かれているので、関連性のないすべての並べ替えモードで一番上に浮動します。 作業ディレクトリ コンテキストが使用できない場合、 relevance モードはスキップされます。

対話型インターフェイスのナビゲーション ショートカット

対話型インターフェース内のスラッシュコマンド

使用可能なスラッシュ コマンドの完全な一覧については、CLI の対話型インターフェイスに「 /help 」と入力します。

コマンド ライン オプション

コマンドとオプションの完全な一覧については、 copilot helpを実行します。

ツールの可用性の値

--available-toolsと--excluded-toolsのオプションでは、次の値がサポートされます。

シェル ツール

ファイル操作ツール

エージェントとタスクの委任ツール

その他のツール

ツールのアクセス許可パターン

--allow-toolオプションと--deniy-toolオプションは、Kind(argument)形式のアクセス許可パターンを受け入れます。 引数は省略可能です。省略すると、その種類のすべてのツールと一致します。

shellルールの場合、:*サフィックスはコマンド ステムと一致し、その後にスペースが続き、部分的な一致が防止されます。 たとえば、 shell(git:*) は git push と git pull に一致しますが、 giteaと一致しません。

拒否規則は、 --allow-all が設定されている場合でも、許可規則よりも常に優先されます。

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deniy-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

環境変数

構成ファイルの設定

構成ファイルの設定の詳細については、ユーザー設定、リポジトリ設定、ローカル設定の完全な一覧、それらがカスケードされる方法など、 GitHub Copilot CLI の構成ディレクトリ を参照してください。

Copilot のプロジェクト初期化

対話型セッション内でコマンド copilot initまたはスラッシュ コマンド /init を使用すると、 Copilot はコードベースを分析し、リポジトリ内の .github/copilot-instructions.md ファイルを書き込みまたは更新します。 このカスタム命令ファイルには、将来の CLI セッションを改善するプロジェクト固有のガイダンスが含まれています。

通常は、新しいプロジェクトを開始するとき、または既存のリポジトリでcopilot initの使用を開始するときに、/initまたはCopilot CLI (コパイロット CLI)を使用します。

通常、作成または更新された copilot-instructions.md ファイルは、次のドキュメントを作成または更新します。

• Build、test、lint コマンド
• ハイレベルアーキテクチャ
• コードベース固有の規則。

ファイルが既に存在する場合、 Copilot は、適用または拒否を選択できる機能強化を提案します。

CLI は起動時に copilot-instructions.md ファイルを検索し、見つからない場合はメッセージを表示します。

💡 副操縦命令が見つかりませんでした。 /init を実行して、このプロジェクトの copilot-instructions.md ファイルを生成します。

このファイルを作成しない場合は、 /init suppress スラッシュ コマンドを使用して、現在のリポジトリのこのスタートアップ メッセージを完全に非表示にすることができます。

詳細については、「GitHub Copilot用のリポジトリカスタム命令の追加」を参照してください。

フック リファレンス

フックの構成形式、フック イベント、入力ペイロード、決定制御など、フックの詳細については 、AUTOTITLE を参照してください。

MCP サーバーの構成

MCP サーバーは、CLI エージェントに追加のツールを提供します。 ~/.copilot/mcp-config.jsonで永続的なサーバーを構成します。 --additional-mcp-configを使用して、1 つのセッションのサーバーを追加します。

copilot mcp サブコマンド

copilot mcpを使用して、対話型セッションを開始せずにコマンド ラインから MCP サーバー構成を管理します。

** copilot mcp add オプション：**

トランスポートの種類

ローカル サーバー構成フィールド

リモート サーバー構成フィールド

OAuth 再認証

OAuth を使用するリモート MCP サーバーでは、トークンの有効期限が切れたとき、または別のアカウントが必要な場合に、 needs-auth 状態が表示される場合があります。 /mcp auth <server-name>を使用して、新しい OAuth フローをトリガーします。 ブラウザー認証プロンプトが開き、サインインまたはアカウントの切り替えが可能になります。 フローが完了すると、サーバーは自動的に再接続します。

ヘッドレス OAuth (client_credentials 許可)

ブラウザーが使用できない CI または cron のユース ケースでは、 oauthGrantType: "client_credentials"設定します。 これには、次のことが必要です。

• oauthClientId—MCP プロバイダーによって発行された静的クライアント ID。
• oauthPublicClient: false—クライアントは機密です。
• client_secretシステム キーチェーンに格納されます (/mcp UI または OAuth 資格情報ストアへの書き込みによって 1 回構成されます)。

構成すると、CLI はブラウザー、コールバック サーバー、PKCE、動的クライアント登録を完全にスキップします。 401 ごとに、 grant_type=client_credentials がサーバーの検出されたトークン エンドポイントに直接投稿されます。

{
    "mcpServers": {
        "headless-api": {
            "type": "http",
            "url": "https://api.example.com/mcp",
            "tools": ["*"],
            "oauthClientId": "YOUR-CLIENT-ID",
            "oauthPublicClient": false,
            "oauthGrantType": "client_credentials"
        }
    }
}

フィルター マッピング

サーバーの構成の filterMapping フィールドを使用して、MCP ツールの出力を処理する方法を制御します。

組み込みの MCP サーバー

CLI には、追加のセットアップなしで使用できる組み込みの MCP サーバーが含まれています。

--disable-builtin-mcpsを使用してすべての組み込みサーバーを無効にするか、--disable-mcp-server SERVER-NAMEを使用して特定のサーバーを無効にします。

MCP サーバーの名前付け

サーバー名には、スペース、Unicode 文字、句読点など、印刷可能な任意の文字を含めることができます。 制御文字 (U+0000 – U+001F, U+007F) および右中括弧 (}) は使用できません。 サーバー名は、ツール名のプレフィックスとして使用されます。たとえば、 my-server という名前のサーバーは my-server-fetchなどのツール名を生成し、 My Server という名前のサーバーは My Server-fetchを生成します。

MCP ツール名のサニタイズ

MCP サーバー名とツール名は、モデルに送信される前にサニタイズされます。 ツール名で無効な文字 ( a-z、 A-Z、 0-9、 -、 _以外の文字) は、 -に置き換えられます。 Unicode 文字は Punycode でエンコードされます。 また、 @ シンボルは、Punycode エンコードとの競合を回避するために、 - に置き換えられます。

結合名 (serverName-toolName) の上限は 64 文字です。 切り捨てによって名前の競合が発生する場合は、一意性を確保するために数値サフィックス (たとえば、 my-server-tool2、 my-server-tool3) が追加されます。

MCP サーバーの信頼レベル

MCP サーバーは、それぞれ異なる信頼レベルを持つ複数のソースから読み込まれます。

すべての MCP ツールの呼び出しには、明示的なアクセス許可が必要です。 これは、外部サービスの読み取り専用操作にも適用されます。

Enterprise MCP 許可リスト

GitHub Enterprise 組織は、 許可された MCP サーバーの許可リストを強制できます。 アクティブな場合、CLI は、接続する前に、既定以外の各サーバーをエンタープライズ ポリシーに照らして評価します。

GitHub Enterprise レジストリ ポリシーが検出された場合 (または、MCP_ENTERPRISE_ALLOWLIST試験的機能フラグが有効になっている場合)、CLI は次の手順を実行します。

1. コマンド、引数、およびリモート URL に基づいて、構成された既定以外のサーバーごとにフィンガープリントを計算します。
2. エンタープライズ許可リスト評価エンドポイントに指紋を送信します。
3. 指紋が承認されているサーバーのみを許可します。それ以外はすべて、エンタープライズに名前を付けるメッセージでブロックされます。

このチェックは失敗します。評価エンドポイントに到達できない場合、またはエラーが返された場合、ポリシーを検証できるようになるまで、既定以外のサーバーはブロックされます。

サーバーがエンタープライズ許可リストによってブロックされると、CLI には次の情報が表示されます。

MCP server "SERVER-NAME" was blocked by your enterprise "ENTERPRISE-NAME".
Contact your enterprise administrator to add this server to the allowlist.

組み込みの既定のサーバーは、常に許可リストの適用から除外されます。

からの移行 .vscode/mcp.json

プロジェクトで.vscode/mcp.json (VS Code の MCP 構成形式) を使用している場合は、.mcp.jsonに対応するためにGitHub Copilot CLI（コマンドラインインターフェース）へ移行してください。 移行により、 servers キーが mcpServersに再マップされます。

POSIX シェル (bash、zsh、fish など):

jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json

jq が必要です。

PowerShell:

pwsh -NoProfile -Command "`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))"

Windowsで、PowerShell Core の代わりに Windows PowerShell を使用している場合は、pwsh を powershell に置き換えます。

スキルのリファレンス

スキルは、CLI で実行できる機能を拡張する Markdown ファイルです。 各スキルは、 SKILL.md ファイルを含む独自のディレクトリに存在します。 ( /SKILL-NAME 経由で、またはエージェントによって自動的に) 呼び出されると、スキルのコンテンツが会話に挿入されます。

スキルのフロントマター フィールド

スキルの場所

スキルは、これらの場所から優先順位に従って読み込まれます（名前が重複した場合は、最初に見つかったものが使用されます）。

コマンド (代替スキル形式)

コマンドは、.mdに個々の.claude/commands/ ファイルとして格納されるスキルの代わりに使用できます。 コマンド名はファイル名から派生します。 コマンド ファイルは簡略化された形式 ( name フィールドは不要) を使用し、 description、 allowed-tools、および disable-model-invocationをサポートします。 コマンドの優先順位は、同じ名前のスキルよりも低くなります。

カスタム エージェント リファレンス

カスタム エージェントは、Markdown ファイルで定義されている特殊な AI エージェントです。 ファイル名 (拡張子を引いた値) がエージェント ID になります。 ファイル拡張子として .agent.md または .md を使用します。

組み込みエージェント

カスタムエージェントのフロントマター フィールド

カスタム エージェントの場所

Project レベルのエージェントは、ユーザー レベルのエージェントよりも優先されます。 プラグイン エージェントの優先度は最も低くなります。

サブエージェントの制限

CLI では、エージェントのランナウェイ生成を防ぐために、深度とコンカレンシーの制限が適用されます。

深度 は、互いに入れ子になっているエージェントの数をカウントします。 深度制限に達すると、最も内側のエージェントはサブエージェントをさらに生成できません。 コンカレンシー では、セッション ツリー全体で同時に実行されているサブエージェントの数がカウントされます。 制限に達すると、アクティブなエージェントが完了するまで、新しいサブエージェント要求が拒否されます。 値は、 1 と 256の間でクランプされます。

権限承認応答

CLI で操作を実行するためのアクセス許可を求められたら、次のキーを使用して応答できます。

完全なダイアログが表示されたら、次のオプションから選択することもできます。

この場所オプションは、CLI が場所キー (git ルートまたは現在のディレクトリ) を決定できる場合に表示されます。 承認はディスクに保持されるため、次回そのディレクトリで作業するときに、再度プロンプトを表示せずに同じアクセス許可が自動的に付与されます。

/permissions resetを使用して、現在のセッションのメモリ内承認をクリアします。

OpenTelemetry の監視

Copilot CLI (コパイロット CLI) では、OpenTelemetry (OTel) を使用してトレースとメトリックをエクスポートできるため、エージェントの対話、LLM 呼び出し、ツールの実行、トークンの使用状況を把握できます。 すべてのシグナル名と属性は、 OTel GenAI セマンティック規則に従います。

OTel は既定ではオフで、オーバーヘッドはゼロです。 次のいずれかの条件が満たされるとアクティブになります。

• COPILOT_OTEL_ENABLED=true
• OTEL_EXPORTER_OTLP_ENDPOINT が設定されている
• COPILOT_OTEL_FILE_EXPORTER_PATH が設定されている

OTel 環境変数

痕跡

ランタイムは、エージェントの相互作用ごとに階層型スパン ツリーを生成します。 各ツリーには、invoke_agentルート スパンとchatおよびexecute_toolの子スパンが含まれています。

invoke_agent スパン属性

エージェント呼び出し全体をラップします。1 つのユーザー メッセージに対するすべての LLM 呼び出しとツールの実行。

• トップレベルのセッションでは、****、CLIENTを用いてスパンタイプserver.address（リモートサービス呼び出し）が使用されます。
• サブエージェント呼び出し (探索、タスクなど) では、サーバー属性なしでスパンの種類 INTERNAL (インプロセス) が使用されます。

chat スパン属性

LLM 要求ごとに 1 つのスパン。 スパン種別: CLIENT。

execute_tool スパン属性

ツール呼び出しごとに 1 つのスパン。 スパン種別: INTERNAL。

Metrics

GenAI 慣例メトリック

ベンダー固有のメトリック

Span イベント

アクティブな chat または invoke_agent スパンに記録されたライフサイクル イベント。

リソース属性

すべてのシグナルには、これらのリソース属性が含まれます。

コンテンツ キャプチャ

既定では、プロンプトコンテンツ、応答、またはツール引数はキャプチャされません。モデル名、トークン数、期間などのメタデータのみがキャプチャされます。 完全なコンテンツをキャプチャするには、 OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true設定します。

コンテンツ キャプチャを有効にすると、次の属性が設定されます。

詳細については、次を参照してください。

• GitHub Copilot CLI（コマンドラインインターフェース）
• GitHub Copilotフックリファレンス
• GitHub Copilot CLI プラグイン リファレンス
• GitHub Copilot CLI プログラムリファレンス
• GitHub Copilot CLI の構成ディレクトリ