GITHUB COPILOT CLI コマンド リファレンス

コマンドラインコマンド

          Copilot CLI (コパイロット CLI)のタブ補完を有効にするために使用できる、選択したシェルのシェル スクリプトを印刷します。 サポートされているシェル: `bash`、 `zsh`、 `fish`。 
          [
          `copilot completion`の使用](#using-copilot-completion)を参照してください。 |

| copilot help [TOPIC] | ヘルプ情報を表示します。 ヘルプ トピックには、 config、 commands、 environment、 logging、 monitoring、 permissions、 providersなどがあります。 | | copilot init | このリポジトリ Copilot カスタム命令を初期化します。 | | copilot login | OAuth デバイス フローを使用して Copilot で認証します。 --host HOST を受け入れてホスト URL を指定します (既定値: GitHub)。 | | copilot login [OPTION] | OAuth デバイス フローを使用して Copilot で認証します。 copilot loginオプションを参照してください。 | | copilot mcp | コマンド ラインから MCP サーバー構成を管理します。 | | copilot plugin | プラグインとプラグイン マーケットプレースを管理します。 | | copilot update | 最新バージョンをダウンロードしてインストールします。 | | copilot version | バージョン情報を表示し、更新プログラムを確認します。 |

          `copilot login` のオプション

          GitHub ホスト URL (既定値: `https://github.com`)。 これを使用して、データ所在地 (たとえば、GitHub Enterprise Cloud) を使用する`https://example.ghe.com` インスタンスで認証します。 |

既定の認証モードは、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

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

          GitHubの問題またはプル要求をコンテキストに含めます。 |

| ! COMMAND | Copilotをバイパスして、ローカル シェルでコマンドを実行します。 | | ? | (空のプロンプトで) クイック ヘルプを開きます。 | | Esc | 現在の操作を取り消します。 | | Ctrl+C | 操作の取り消し/入力のクリア。 2 回押して終了します。 | | Ctrl+ | シャットダウンする | | + | 外部エディター ($EDITOR) でプロンプトを編集します。 | | + | 画面をクリアします。 | | + または Ctrl+ | エージェントが忙しいときに送信するメッセージをキューに入れます。 | | + | コマンド履歴を逆検索します。 | | Ctrl+V | クリップボードから添付ファイルとして貼り付けます。 | | + | プロンプトの入力を開始すると、スラッシュ コマンドを実行できます。たとえば、プロンプトを再入力せずにモデルを変更する場合などです。 | | + | 外部エディター ($EDITOR) でプロンプトを編集します。 | | + | タイムラインから最新のリンクを開きます。 | | Ctrl + + | プロセスをバックグラウンドで中断します (Unix)。 | | + または Option+ (Mac) / Alt+ (Windows/Linux) | 入力に改行を挿入します。 | | Shift+タブ | 標準モード、プラン モード、オートパイロット モードの間を循環します。 |

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

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

          </kbd>
          +
                | 次の文字に移動します。                  |

| + | 前の文字を削除します。 | | Ctrl+K | カーソルから行の末尾まで削除します。 カーソルが行の末尾にある場合は、改行を削除します。 | | Ctrl+ | カーソル位置から行の先頭まで削除します。 | | + | 前の単語を削除します。 | | Home | テキストの先頭に移動します。 | | 終了 | テキストの末尾に移動します。 | | Alt+←/→ (Windows/Linux)
オプション+←/→ (Mac) | カーソルを単語単位で移動します。 | | ↑/↓ | コマンド履歴に移動します。 | | / Y | 現在のインライン入力候補を受け入れます。 |

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

          [「プロジェクト初期化」Copilot](#project-initialization-for-copilot)を参照してください。 |

| /instructions | カスタム命令ファイルを表示および切り替えます。 | | /keep-alive [on\|busy\|NUMBERm\|NUMBERh] | CLI セッションがアクティブな間、エージェントがビジー状態の間、または定義された時間の間、マシンがスリープ状態にならないようにします。 実験モードでのみ使用できます。 | | /list-dirs | ファイル アクセスが許可されているすべてのディレクトリを表示します。 | | /login | Copilotにログインします。 | | /logout | Copilotからログアウトします。 | | /lsp [show\|test\|reload\|help] [SERVER-NAME] | 言語サーバーの構成を管理します。 | | /mcp [show\|add\|edit\|delete\|disable\|enable\|auth\|reload] [SERVER-NAME] | MCP サーバー構成を管理します。 「GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する」を参照してください。 | | /model、/models [MODEL] | 使用する AI モデルを選択します。 | | /plan [PROMPT] | コーディングする前に実装計画を作成します。 | | /plugin [marketplace\|install\|uninstall\|update\|list] [ARGS...] | プラグインとプラグイン マーケットプレースを管理します。 「GitHub Copilot CLI（コマンドラインインターフェース） のプラグインについて」を参照してください。 | | /pr [view\|create\|fix\|auto] | 現在のブランチのプル要求を管理します。 「/pr コマンドを使用したプル要求の管理」を参照してください。 | | /remote [on\|off] | リモート コントロールの状態を表示する (引数が指定されていない場合)、リモート ステアリングを有効にする (on)、またはリモート接続を終了する (off)。 「別のデバイスからの GitHub Copilot CLI（コマンドラインインターフェース） セッションのステアリング」を参照してください。 | | /rename [NAME] | 現在のセッションの名前を変更します (省略すると名前が自動生成されます。 /session renameのエイリアス)。 | | /research TOPIC | GitHub検索と Web ソースを使用して詳細な調査を実行します。 「GitHub Copilot CLI（コマンドラインインターフェース） を用いた調査」を参照してください。 | | /reset-allowed-tools | 許可されているツールの一覧をリセットします。 | | /restart | 現在のセッションを保持して、CLI を再起動します。 | | /resume [SESSION-ID]、/continue [SESSION-ID] | リストから選択して別のセッションに切り替えます (必要に応じてセッション ID を指定します)。 | | /review [PROMPT] | コード レビュー エージェントを実行して変更を分析します。 「を使用してコード レビューを要求する GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。 | | /session [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all]、/sessions [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all] | セッション情報を表示し、セッションを管理します。 サブコマンド: info、 checkpoints、 files、 plan、 rename、 cleanup、 prune、 delete、 delete-all。 | | /share [file\|html\|gist] [session\|research] [PATH]、/export [file\|html\|gist] [session\|research] [PATH] | セッションを Markdown ファイル、対話型 HTML ファイル、または GitHub gist に共有します。 | | /skills [list\|info\|add\|remove\|reload] [ARGS...] | 強化された機能のスキルを管理します。 「エージェント スキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。 | | /statusline、/footer | ステータス行に表示する項目を構成します。 | | /tasks | バックグラウンド タスク (サブエージェントとシェル セッション) を表示および管理します。 | | /terminal-setup | 複数行入力をサポートするようにターミナルを構成します (Shift+Enter と Ctrl+Enter)。 | | /theme [default\|dim\|high-contrast\|colorblind] | カラー モードを表示または設定します。 | | /undo、/rewind | 最後のターンを巻き戻し、ファイルの変更を元に戻します。 | | /update、/upgrade | CLI を最新バージョンに更新します。 | | /usage | セッション使用状況のメトリックと統計情報を表示します。 | | /user [show\|list\|switch] | 現在の GitHub ユーザーを管理します。 | | /version | バージョン情報を表示し、更新プログラムを確認します。 |

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

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

          `~/.copilot/mcp-config.json`から構成を拡張します。 インストール済みの MCP サーバー構成を同じ名前でオーバーライドします。 「[AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。 |

| --agent=AGENT | 使用する カスタム エージェント を指定します。 「カスタム エージェントについて」を参照してください。 | | --allow-all | すべてのアクセス許可 ( --allow-all-tools --allow-all-paths --allow-all-urlsと同等) を有効にします。 | | --allow-all-paths | ファイル パスの検証を無効にし、任意のパスへのアクセスを許可します。 | | --allow-all-tools | すべてのツールを確認なしで自動的に実行できるようにします。 CLI をプログラムで使用する場合は必須 (env: COPILOT_ALLOW_ALL)。 | | --allow-all-urls | 確認なしですべての URL へのアクセスを許可します。 | | --allow-tool=TOOL ... | CLI が使用する権限を持っているツール。 アクセス許可を求めるメッセージは表示されません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 「ツールの使用の許可と拒否」を参照してください。 | | --allow-url=URL ... | 特定の URL またはドメインへのアクセスを許可します。 複数の URLは、引用符で囲まれたコンマ区切りのリストを使用します。 | | --autopilot | プロンプトモードでオートパイロットを続行可能にします。 「GitHub Copilot CLI が自律的に動作できるようにする」を参照してください。 | | --available-tools=TOOL ... | モデルで使用できるのは、これらのツールのみです。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 「ツールの使用の許可と拒否」を参照してください。 | | --banner、--no-banner | スタートアップ バナーを表示または非表示にします。 | | --bash-env | bash シェル BASH_ENV サポートを有効にします。 | | --connect[=SESSION-ID] | リモート セッションに直接接続します (必要に応じて、セッション ID またはタスク ID を指定します)。 --resumeと--continueとの競合。 | | --continue | 現在の作業ディレクトリの最新のセッションを再開し、グローバルに最新のセッションにフォールバックします。 | | --deny-tool=TOOL ... | CLI が使用する権限を持たないツール。 アクセス許可を求めるメッセージは表示されません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 | | --deny-url=URL ... | 特定の URL またはドメインへのアクセスを拒否すると、 --allow-urlよりも優先されます。 複数の URLは、引用符で囲まれたコンマ区切りのリストを使用します。 | | --disable-builtin-mcps | すべての組み込み MCP サーバー (現在: github-mcp-server) を無効にします。 | | --disable-mcp-server=SERVER-NAME | 特定の MCP サーバーを無効にします (複数回使用できます)。 | | --disallow-temp-dir | システム一時ディレクトリへの自動アクセスを禁止します。 | | --effort=LEVEL、--reasoning-effort=LEVEL | 理由の作業レベル (low、 medium、 high) を設定します。 | | --enable-all-github-mcp-tools | 既定の CLI サブセットではなく、すべての GitHub MCP サーバー ツールを有効にします。 --add-github-mcp-toolsetオプションと--add-github-mcp-toolオプションをオーバーライドします。 | | --enable-reasoning-summaries | それをサポートする OpenAI モデルの推論の概要を要求します。 | | --excluded-tools=TOOL ... | これらのツールはモデルでは使用できません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 | | --experimental | 試験的な機能を有効にする ( --no-experimental を使用して無効にする)。 | | -h、--help | ヘルプを表示します。 | | -i PROMPT、--interactive=PROMPT | 対話型セッションを開始し、このプロンプトを自動的に実行します。 | | --log-dir=DIRECTORY | ログ ファイル ディレクトリを設定します (既定値: ~/.copilot/logs/)。 | | --log-level=LEVEL | ログ レベル ( none、 error、 warning、 info、 debug、 all、 default) を設定します。 | | --max-autopilot-continues=COUNT | オートパイロット モードでの継続メッセージの最大数 (既定値: 無制限)。 「GitHub Copilot CLI が自律的に動作できるようにする」を参照してください。 | | --mode=MODE | 初期エージェント モード ( interactive、 plan、 autopilot) を設定します。 --autopilotまたは--planと組み合わせることはできません。 | | --model=MODEL | 使用する AI モデルを設定します。 autoを渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。 | | --mouse[=VALUE] | 代替画面モードでマウスサポートを有効にします。 VALUE は、 on (既定値) または offできます。 有効にすると、CLI は代替画面モード (スクロール ホイール、クリックなど) でマウス イベントをキャプチャします。無効にすると、ターミナルのネイティブ マウス動作が保持されます。 設定が完了すると、構成ファイルに書き込まれ、設定が保持されます。| | -n NAME、--name=NAME | 新しいセッションの名前を設定します。 名前でセッションを検索するために、 --resume と /resume によって使用されます。 | | --no-ask-user | ask_user ツールを無効にします (エージェントは質問をせずに自律的に動作します)。 | | --no-auto-update | CLI 更新プログラムの自動的なダウンロードを無効にします。 | | --no-bash-env | bash シェル BASH_ENV サポートを無効にします。 | | --no-color | すべてのカラー出力を無効にします。 | | --no-custom-instructions | AGENTS.mdおよび関連ファイルからのカスタム命令の読み込みを無効にします。 | | --no-experimental | 試験的な機能を無効にします。 | | --no-mouse | マウスのサポートを無効にします。 | | --no-remote | このセッションのリモート アクセスを無効にします。 | | --output-format=FORMAT | FORMAT は、 text (既定) または json (JSONL 出力: 1 行に 1 つの JSON オブジェクト) にすることができます。 | | -p PROMPT、--prompt=PROMPT | プログラムでプロンプトを実行します (完了後に終了します)。 「プログラムによる GitHub Copilot CLI（コマンドラインインターフェース） の実行」を参照してください。 | | --plan | プラン モードで開始します。 --mode plan の短縮形です。 --modeまたは--autopilotと組み合わせることはできません。 | | --plain-diff | リッチ差分レンダリングを無効にします (git 構成で指定された差分ツールを使用した構文の強調表示)。 | | --plugin-dir=DIRECTORY | ローカル ディレクトリからプラグインを読み込みます (複数回使用できます)。 | | --remote | GitHub.comおよびGitHub Mobileからこのセッションへのリモート アクセスを有効にします。 「別のデバイスからの GitHub Copilot CLI（コマンドラインインターフェース） セッションのステアリング」を参照してください。 | | --resume[=VALUE] | 一覧から選択して、以前の対話型セッションを再開します。 必要に応じて、セッション ID、ID プレフィックス、またはセッション名を指定します。 名前の一致は正確で大文字と小文字が区別されません。明示的な名前が一致しない場合、自動生成された概要にフォールバックします。 | | -s、--silent | -pを使用したスクリプト作成に役立つ、エージェントの応答のみを出力します (使用状況統計なし)。 | | --screen-reader | スクリーン リーダーの最適化を有効にします。 | | --secret-env-vars=VAR ... | シェルおよび MCP サーバー環境から環境変数を編集します (複数回使用できます)。 複数の変数の場合は、引用符で囲まれたコンマ区切りのリストを使用します。 GITHUB_TOKEN環境変数とCOPILOT_GITHUB_TOKEN環境変数の値は、既定で出力から編集されます。 | | --share=PATH | プログラム セッションの完了後にセッションを Markdown ファイルに共有します (既定のパス: ./copilot-session-<ID>.md)。 | | --share-gist | プログラムによるセッションの完了後に、シークレット ギスト GitHub にプログラムセッションを共有します。 | | --stream=MODE | ストリーミング モード (モードの選択肢: on または off) を有効または無効にします。 | | -v、--version | バージョン情報を表示します。 | | --yolo | すべてのアクセス許可 ( --allow-allと同等) を有効にします。 |

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

          `--remote`、`--no-remote`、および`--connect`オプションを使用するには、アカウントでリモート セッション機能を使用できる必要があります。

ツールの可用性の値

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

シェル ツール

ファイル操作ツール

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

その他のツール

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

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

          `read`、`read(.env)` |

| shell | シェル コマンドの実行 | shell(git push)、shell(git:*)、shell | | url | Web フェッチまたはシェル経由の URL アクセス | url(github.com)、url(https://*.api.com) | | write | ファイルの作成または変更 | write、write(src/*.ts) | | SERVER-NAME | MCP サーバー ツールの呼び出し | MyMCP(create_issue)、MyMCP |

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

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

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deny-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 (コパイロット CLI)専用のホスト名。`GH_HOST`をオーバーライドします。 
          `GH_HOST`がGitHub Enterprise Serverをターゲットにしているが、CopilotがGitHub.comやGitHub Enterprise Cloudのホスト名に対して認証する必要がある場合に使用します。 |

| COPILOT_GITHUB_TOKEN | 認証トークン。 GH_TOKENとGITHUB_TOKENよりも優先されます。 | | COPILOT_HOME | 構成ディレクトリと状態ディレクトリをオーバーライドします。 既定値: $HOME/.copilot。 | | COPILOT_MODEL | AI モデルを設定します。 | | COPILOT_PROMPT_FRAME | 入力プロンプトの周囲の装飾 UI フレームを有効にするには、 1 に設定するか、無効に 0 します。 現在のセッションの実験用機能フラグ PROMPT_FRAME オーバーライドします。 | | COPILOT_SKILLS_DIRS | スキルの追加ディレクトリのコンマ区切りの一覧。 | | COPILOT_SUBAGENT_MAX_CONCURRENT | セッション ツリー全体の同時サブエージェントの最大数。 既定値: 32。 範囲: 1 – 256。 | | COPILOT_SUBAGENT_MAX_DEPTH | サブエージェントの入れ子の深さの最大値。 既定値: 6。 範囲: 1 – 256。 | | GH_HOST | GitHub GitHub CLIとCopilot CLI (コパイロット CLI)の両方のホスト名 (既定値: github.com)。 データ所在地のホスト名を使用して GitHub Enterprise Cloud に設定します。 COPILOT_GH_HOSTはCopilot CLI (コパイロット CLI)専用でオーバーライドします。 | | GH_TOKEN | 認証トークン。 GITHUB_TOKENよりも優先されます。 | | GITHUB_TOKEN | 認証トークン。 | | PLAIN_DIFF | リッチ差分レンダリングを無効にするには、 true に設定します。 | | USE_BUILTIN_RIPGREP | バンドルされたバージョンの代わりにシステム ripgrep を使用するには、 false に設定します。 |

構成ファイルの設定

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

          Copilot のプロジェクト初期化

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

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

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

• コマンドのビルド、テスト、およびリント。
• ハイレベルアーキテクチャ
• コードベース固有の規則。

ファイルが既に存在する場合、 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-config.json`に書き込みます。 |

| remove <name> | ユーザー レベルのサーバーを削除します。 ワークスペース サーバーは、構成ファイルで直接編集する必要があります。 |

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

          `--show-secrets` では、機密性の高い環境変数とヘッダー値をターミナルまたはログに出力できます。 信頼できる環境でのみこのオプションを使用し、共有ログまたは履歴に出力をコピー、貼り付け、またはその他の方法でキャプチャしないようにします。

トランスポートの種類

          `command`、`args` |

| http | ストリーミング可能な HTTP トランスポートを使用するリモート サーバー。 | url | | sse | Server-Sent イベント トランスポートを使用するリモート サーバー。 | url |

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

          `$VAR`、`${VAR}`、および`${VAR:-default}`展開をサポートします。 |

| cwd | いいえ | サーバーの作業ディレクトリ。 | | timeout | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 | | type | いいえ | "local" または "stdio"。 既定値: "local"。 |

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

          `"http"` または `"sse"`。 |

| url | はい | サーバー URL。 | | tools | はい | 有効にするツール。 | | headers | いいえ | HTTP ヘッダー。 変数の拡張をサポートします。 | | oauthClientId | いいえ | 静的 OAuth クライアント ID (動的登録をスキップします)。 | | oauthPublicClient | いいえ | OAuth クライアントがパブリックかどうか。 既定値: true。 | | oidc | いいえ | OIDC トークンの挿入を有効にします。 trueすると、GITHUB_COPILOT_OIDC_MCP_TOKEN環境変数 (ローカル サーバー) または Bearer``Authorization ヘッダー (リモート サーバー) が挿入されます。 | | timeout | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 |

OAuth 再認証

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

フィルター マッピング

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

組み込みの MCP サーバー

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

          GitHub API 統合: 問題、プル要求、コミット、コード検索、および GitHub Actions。 |

| playwright | ブラウザーの自動化: 移動、クリック、入力、スクリーンショット、フォーム処理。 | | fetch | fetch ツールを使用した HTTP 要求。 | | time | 時間ユーティリティ: get_current_time と convert_time。 |

          `--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 サーバーは、それぞれ異なる信頼レベルを持つ複数のソースから読み込まれます。

すべての 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`
          ](https://jqlang.github.io/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 を使用します。

組み込みエージェント

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

          `~/.copilot/mcp-config.json`と同じスキーマを使用します。 |

| model | 文字列 | いいえ | このエージェントの AI モデル。 設定を解除すると、外部エージェントのモデルが継承されます。 セッション モデルが Auto (サーバー選択) に設定されている場合、サブエージェントは、このフィールドに関係なく、解決されたセッション モデルを常に継承します。 | | name | 文字列 | いいえ | 表示名。 デフォルトはファイル名です。 | | tools | string[] | いいえ | エージェントで使用できるツール。 既定値: ["*"] (すべてのツール)。 |

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

          `.github/agents/` または `.claude/agents/` |

| User | ~/.copilot/agents/ | | プラグイン | <plugin>/agents/ |

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

サブエージェントの制限

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

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

権限承認応答

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

セッションの承認は、 /clear を実行するか、新しいセッションを開始するとリセットされます。

OpenTelemetry の監視

          Copilot CLI (コパイロット CLI)
          [では、OpenTelemetry (OTel](https://opentelemetry.io/)) を使用してトレースとメトリックをエクスポートできるため、エージェントの対話、LLM 呼び出し、ツールの実行、トークンの使用状況を把握できます。 すべてのシグナル名と属性は、 [OTel GenAI セマンティック規則](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/)に従います。

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

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

OTel 環境変数

          `OTEL_EXPORTER_OTLP_ENDPOINT`が設定されている場合は不要です。 |

| OTEL_EXPORTER_OTLP_ENDPOINT | — | OTLP エンドポイント URL。 これを自動的に設定すると、OTel が有効になります。 | | COPILOT_OTEL_EXPORTER_TYPE | otlp-http | エクスポーターの種類: otlp-http または file。 fileが設定されているときにCOPILOT_OTEL_FILE_EXPORTER_PATHを自動選択します。 | | OTEL_SERVICE_NAME | github-copilot | リソース属性のサービス名。 | | OTEL_RESOURCE_ATTRIBUTES | — | コンマ区切りの key=value ペアとしての追加のリソース属性。 特殊文字にはパーセント エンコードを使用します。 | | OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT | false | 完全なプロンプトと応答のコンテンツをキャプチャします。 コンテンツ キャプチャを参照してください。 | | OTEL_LOG_LEVEL | — | OTel 診断ログ レベル: NONE、 ERROR、 WARN、 INFO、 DEBUG、 VERBOSE、 ALL。 | | COPILOT_OTEL_FILE_EXPORTER_PATH | — | すべてのシグナルを JSON 行としてこのファイルに書き込みます。 これを自動的に設定すると、OTel が有効になります。 | | COPILOT_OTEL_SOURCE_NAME | github.copilot | トレーサーとメーターのインストルメンテーション スコープ名。 | | OTEL_EXPORTER_OTLP_HEADERS | — | OTLP エクスポーターの認証ヘッダー (たとえば、 Authorization=Bearer token)。 |

痕跡

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

          `invoke_agent` スパン属性

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

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

          `["stop"]` または `["error"]` | 両方とも |

| gen_ai.usage.input_tokens | 入力トークンの合計 (すべてのターン) | 両方とも | | gen_ai.usage.output_tokens | 出力トークンの合計 (すべてのターン) | 両方とも | | gen_ai.usage.cache_read.input_tokens | キャッシュされた入力トークンの読み取り | 両方とも | | gen_ai.usage.cache_creation.input_tokens | キャッシュされた入力トークンの作成 | 両方とも | | github.copilot.turn_count | LLMラウンドトリップの数 | 両方とも | | github.copilot.cost | 貨幣コスト | 両方とも | | github.copilot.aiu | 消費された AI ユニット | 両方とも | | server.address | サーバーのホスト名 | CLIENT のみ | | server.port | サーバー ポート | CLIENT のみ | | error.type | エラー クラス名 (エラー時) | 両方とも | | gen_ai.input.messages | JSON としての完全な入力メッセージ (コンテンツ キャプチャのみ) | 両方とも | | gen_ai.output.messages | JSON としての完全な出力メッセージ (コンテンツ キャプチャのみ) | 両方とも | | gen_ai.system_instructions | システム プロンプト コンテンツを JSON (コンテンツ キャプチャのみ) として | 両方とも | | gen_ai.tool.definitions | JSON としてのツール スキーマ (コンテンツ キャプチャのみ) | 両方とも |

          `chat` スパン属性

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

          `execute_tool` スパン属性

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

Metrics

GenAI 慣例メトリック

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

          `gen_ai.tool.name` および `success` によるツールの呼び出し |

| github.copilot.tool.call.duration | ヒストグラム | s | gen_ai.tool.name によるツールの実行待機時間 | | github.copilot.agent.turn.count | ヒストグラム | 回転 | エージェント呼び出しごとの LLM ラウンドトリップ |

Span イベント

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

          `github.copilot.hook.type`、`github.copilot.hook.invocation_id` |

| github.copilot.hook.end | フックが正常に完了しました | github.copilot.hook.type、github.copilot.hook.invocation_id | | github.copilot.hook.error | フックに失敗しました | github.copilot.hook.type、github.copilot.hook.invocation_id、github.copilot.hook.error_message | | github.copilot.session.truncation | 会話履歴が切り捨てられました | github.copilot.token_limit、 github.copilot.pre_tokens、 github.copilot.post_tokens、 github.copilot.pre_messages、 github.copilot.post_messages、 github.copilot.tokens_removed、 github.copilot.messages_removed、 github.copilot.performed_by | | github.copilot.session.compaction_start | 圧縮が開始された歴史 | なし | | github.copilot.session.compaction_complete | 履歴の圧縮が完了しました | github.copilot.success、 github.copilot.pre_tokens、 github.copilot.post_tokens、 github.copilot.tokens_removed、 github.copilot.messages_removed、 github.copilot.message (コンテンツ キャプチャのみ) | | github.copilot.skill.invoked | スキルが呼び出されました | github.copilot.skill.name、 github.copilot.skill.path、 github.copilot.skill.plugin_name、 github.copilot.skill.plugin_version | | github.copilot.session.shutdown | セッションがシャットダウン中 | github.copilot.shutdown_type、github.copilot.total_premium_requests、github.copilot.lines_added、github.copilot.lines_removed、github.copilot.files_modified_count | | github.copilot.session.abort | ユーザーが現在の操作を取り消した | github.copilot.abort_reason | | exception | セッション エラー | github.copilot.error_type、github.copilot.error_status_code、github.copilot.error_provider_call_id |

リソース属性

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

          `github-copilot` ( `OTEL_SERVICE_NAME`を介して構成可能) |

| service.version | ランタイム バージョン |

コンテンツ キャプチャ

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

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

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

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