# GITHUB COPILOT CLI コマンド リファレンス Copilot CLI (コパイロット CLI)を効果的に使用するのに役立つコマンドとキーボード ショートカットを見つけます。 ## コマンドラインコマンド | 命令 | Purpose | | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `copilot` | 対話型ユーザー インターフェイスを起動します。 | | `copilot completion SHELL` | | | Copilot CLI (コパイロット CLI)のタブ補完を有効にするために使用できる、選択したシェルのシェル スクリプトを印刷します。 サポートされているシェル: `bash`、 `zsh`、 `fish`。 | | | \[ | | | `copilot completion`の使用]\(#using-copilot-completion)を参照してください。 | | | `copilot help [TOPIC]` | ヘルプ情報を表示します。 ヘルプ トピックには、 `billing`、 `config`、 `commands`、 `environment`、 `logging`、 `monitoring`、 `permissions`、 `providers`、 `sandbox`などがあります。 | | `copilot init` | このリポジトリ Copilot カスタム命令を初期化します。 | | `copilot login` | OAuth デバイス フローを使用して Copilot で認証します。 | | `--host HOST` を受け入れてホスト URL を指定します (既定値: GitHub)。 | | | `copilot login [OPTION]` | OAuth デバイス フローを使用して Copilot で認証します。 | | \[ | | | `copilot login`オプション]\(#copilot-login-options)を参照してください。 | | | `copilot mcp` | コマンド ラインから MCP サーバー構成を管理します。 | | `copilot plugin` | プラグインとプラグイン マーケットプレースを管理します。 | | `copilot plugins list` | 現在の作業ディレクトリで検出されたすべてのプラグイン、MCP サーバー、スキル、命令ソース、言語サーバーを非対話形式で検査します。CLI プラグイン ダッシュボードに表示されるのと同じリソースです。 | | \[ | | | `copilot plugins list`の使用]\(#using-copilot-plugins-list)を参照してください。 | | | `copilot skill` | コマンド ラインからエージェント スキルを管理します (スキルの一覧表示、追加、削除)。 「[エージェント スキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。 | | `copilot update` | 最新バージョンをダウンロードしてインストールします。 | | `copilot version` | バージョン情報を表示し、更新プログラムを確認します。 | ### `copilot login` のオプション | オプション | Purpose | | -------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `--host HOST` | | | 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_`) はサポートされていません。 **例:** ```shell # 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 (現在のセッションのみ): ```bash copy source <(copilot completion bash) ``` Bash (永続的、Linux): ```bash copy copilot completion bash | sudo tee /etc/bash_completion.d/copilot ``` Zsh — $fpathのディレクトリに出力を書き込みます。 次のコマンドを実行した後、シェルを再起動します。 ```shell copy copilot completion zsh > "${fpath[1]}/_copilot" ``` 魚： ```shell copy copilot completion fish > ~/.config/fish/completions/copilot.fish ``` ### `copilot plugins list` の使用 `copilot plugins list`を実行して、現在の作業ディレクトリで検出されたすべてのプラグイン、MCP サーバー、スキル、命令ソース、言語サーバーを検査します。 出力は、種類、構成スコープ (ユーザー、リポジトリ、組織、プラグイン提供、組み込み、不明) ごとにグループ化されます。 ```bash # List everything for the current workspace copilot plugins list # Only MCP servers and skills copilot plugins list --kind mcp --kind skill # Only user-scoped resources, as JSON copilot plugins list --scope user --json ``` | オプション | 説明 | | -------------------------- | ------------------------------------------------------------------------- | | `--kind KINDS` | 種類で絞り込む。 繰り返し可能またはコンマ区切り: `mcp`、 `skill`、 `instruction`、 `plugin`、 `lsp`。 | | `--scope SCOPES` | 構成スコープで絞り込む。 繰り返し可能またはカンマ分離。 | | `--json` | グループ化されたテキストの代わりに、マシンが読み取り可能な JSON を出力します。 | | `--config-dir=DIRECTORY` | 構成ディレクトリへのパス。 このオプションは非推奨です。 | | `COPILOT_HOME` を代わりに使用します。 | | カスタム エージェントとセッション スコープのフックは、 `copilot plugins list`の対象になりません。両方ともライブ セッションが必要です。 ### `copilot plugins enable` / `copilot plugins disable` プラグイン、MCP サーバー、またはスキルを名前で有効または無効にします。 変更は構成に保持され、今後のセッションに適用されます。 ```bash # Disable an MCP server copilot plugins disable github --mcp # Enable a skill copilot plugins enable my-skill --skill # Enable a plugin (default kind) copilot plugins enable spark@copilot-plugins ``` | オプション | 説明 | | -------------------------- | ----------------------------------------- | | `--plugin` | プラグインをターゲットにします (既定)。 | | `--mcp` | MCP サーバーをターゲットにします。 | | `--skill` | スキルをターゲットに設定します。 | | `--config-dir=DIRECTORY` | 構成ディレクトリへのパス。 このオプションは非推奨です。 | | `COPILOT_HOME` を代わりに使用します。 | | 指示はセッション内でのみ有効であり、これらのコマンドで切り替えることはできません。 言語サーバー、エージェント、フックは他の場所で管理されます。 ### `copilot plugins remove` プラグインをアンインストールするか、MCP サーバーを削除するか、スキルを名前で削除します。 ```bash # Remove an MCP server copilot plugins remove github --mcp # Delete a personal or project skill copilot plugins remove my-skill --skill # Uninstall a plugin (default kind) copilot plugins remove spark@copilot-plugins ``` | オプション | 説明 | | -------------------------- | ----------------------------------------- | | `--plugin` | プラグインを削除します (既定)。 | | `--mcp` | MCP サーバーを削除します。 | | `--skill` | 個人またはプロジェクトのスキルを削除します。 | | `--config-dir=DIRECTORY` | 構成ディレクトリへのパス。 このオプションは非推奨です。 | | `COPILOT_HOME` を代わりに使用します。 | | `--skill`では、スキル名または追加したカスタム スキル ディレクトリへのパスを渡します。 スキル名は、そのスキルのファイルを削除します。カスタム ディレクトリ パスは、ディレクトリの登録を解除し、そのファイルをディスク上に残すだけです。 追加した個人およびプロジェクトのスキルのみを削除できます。プラグインまたは組み込みセットによって提供されるスキルは、この方法では削除できません (代わりに無効にします)。 命令ソースはディスクから検出され、ここで削除することはできません。 ## 対話型インターフェイスのグローバル ショートカット | Shortcut | Purpose | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | | `@ FILENAME` | コンテキストにファイルの内容を含めます。 | | `# NUMBER` | | | GitHubの問題またはプル要求をコンテキストに含めます。 | | | `! COMMAND` | | | Copilotをバイパスして、ローカル シェルでコマンドを実行します。 空のプロンプト `!` 単独で入力して、複数のシェル コマンドを順番に実行するためのシェル モードに入ります。 シェル モードを終了するには、空のプロンプトで Esc キーまたは Ctrl+キーを押します。 | | | `$` | プロンプトで単独の `$` を入力すると、ターミナルの操作が、セッションの作業ディレクトリを起点とする実際の対話型シェル（Unix では `$SHELL`、Windows では `%COMSPEC%`）に渡されます。 | | `!`シェル モードとは異なり、これにより CLI UI が完全に中断されるため、ジョブ制御、全画面表示アプリ、タブ補完、色はすべてネイティブに動作します。 シェル (Unix では `exit` または Ctrl+D ) を終了して CLI に戻ります。 実TTY上の、ローカルかつ信頼されたアイドル状態のセッションでのみ有効になります。 エンタープライズ管理設定で無効にすることができます。 既定で無効になっています。 | | | `shellShortcut`設定で有効にします。[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings) を参照してください。 | | | `?` | (空のプロンプトで) クイック ヘルプを開きます。 もう一度押すと解除され、文字どおりの `?` が挿入されます。 | | Esc | 現在の操作を取り消します。 実行中のターンを中断するか、メイン エージェントがアイドル状態のときにバックグラウンド エージェントを停止するには、2 回押します。 | | Ctrl+C | 操作の取り消し/入力のクリア。 2 回押して終了します。 | | Ctrl+ | シャットダウンする | | | | + | 外部エディター (`$EDITOR`) でプロンプトを編集します。 | | + | 画面をクリアします。 | | + または Ctrl+ | エージェントが忙しいときに送信するメッセージをキューに入れます。 | | + | コマンド履歴を逆検索します。 | | Ctrl+ | クリップボードから添付ファイルとして貼り付けます。 | | + | プロンプトの入力を開始すると、スラッシュ コマンドを実行できます。たとえば、プロンプトを再入力せずにモデルを変更する場合などです。 | | + | 外部エディター (`$EDITOR`) でプロンプトを編集します。 | | + | 実行中のタスクまたはシェル コマンドをバックグラウンドに昇格させます。 | | + | タイムラインから最新のリンクを開きます。 | | Ctrl + + | プロセスをバックグラウンドで中断します (Unix)。 | | + または Option+ (Mac) / Alt+ (Windows/Linux) | 入力に改行を挿入します。 | | Shift+タブ | 標準モード、プラン モード、オートパイロット モードの間を循環します。 | ## 対話型インターフェイスのタイムライン ショートカット | Shortcut | Purpose | | -------- | ------- | | | | + | タイムライン検索を開きます。 | | Ctrl+ + O | プロンプト入力には何もありませんが、これにより、 Copilotの応答タイムラインの最近の項目が展開され、詳細が表示されます。 | | Ctrl+E | プロンプト入力には何もありませんが、これにより、 Copilotの応答タイムライン内のすべての項目が展開されます。 | | Ctrl+T | 応答内の推論の表示を展開/折りたたむ。 | | ページアップ/ページダウン | タイムラインを 1 ページ上または下にスクロールします。 | ## セッション ピッカーのショートカット セッション ピッカーが開いている場合 ( `/resume` または `--continue`を使用して開きます)。 | Shortcut | Purpose | | ------------------------- | -------------------------------- | | ↑/↓ | 選択範囲を上下に移動します。 | | | | | を入力 | 選択したセッションを開きます。 | | `s` | 並べ替え順序を循環させます。関連性→作成日時→名前→最後に使用。 | | タブ | ローカル タブとリモート タブを切り替えます。 | | `d` | 選択したセッションを削除します。 | | Esc | ピッカーを閉じます。 | セッションは、次のモードで並べ替えられます。 | モード | 説明 | | ----------- | --------------------------------------- | | `relevance` | 現在の作業ディレクトリと一致してセッションをスコア付けします (既定)。 | | `last used` | 最も最近変更されたセッションを優先表示。 | | `created` | 最新のセッションが最初に表示されます。 | | `name` | セッション名のアルファベット順。名前のないセッションは末尾に並べ替えられます。 | セッションは既に別のウィンドウで開かれているので、関連性のないすべての並べ替えモードで一番上に浮動します。 作業ディレクトリ コンテキストが使用できない場合、 `relevance` モードはスキップされます。 ## 差分モードのショートカット 差分モードが開いている場合 ( `/diff`経由で入力): | Shortcut | Purpose | | --------------------------------------------- | ------------------------------- | | ↑ / `k` | 選択範囲を 1 行上に移動します。 | | ↓ / `j` | 選択範囲を 1 行下に移動します。 | | ← / `h` | 前のファイルに移動します。 | | → / `l` | 次のファイルに移動します。 | | ホーム / `g` | 最初の行にジャンプします。 | | 終わり / `G` | 最後の行にジャンプします。 | | ページアップ | 1 ページ上にスクロールします。 | | ページダウン | 1 ページ下にスクロールします。 | | Ctrl+ | ページの半分までスクロールします。 | | Ctrl+ | 1 ページ半下にスクロールします。 | | `Click` | クリックされた差分行を選択します (マウスのサポートが必要)。 | | マウス スクロール | 上または下にスクロールします。 | | Alt/Option + scroll | 細かく制御するために一度に 1 行スクロールします。 | | `c` | 選択した行にコメントを追加または編集します。 | | `s` | コメントの概要を表示します (コメントが存在する場合)。 | | `b` | ステージされていない変更とブランチの差分を切り替えます。 | | `w` | 空白のみの変更の非表示を切り替えます。 | | | | | を入力 | すべてのコメントを送信します (コメントが存在する場合)。 | | `r` | 差分を更新します (リモート セッションのみ)。 | | Esc / Ctrl+C | 差分モードを終了します。 | ## 対話型インターフェイスのナビゲーション ショートカット | Shortcut | Purpose | | ---------------------------- | ----------------- | | Ctrl+A | 行の先頭に移動します (入力時)。 | | Ctrl+B | 前の文字に移動します。 | | Ctrl+E | 行の末尾に移動します (入力時)。 | | | | + | 次の文字に移動します。 | | + | 前の文字を削除します。 | | Ctrl+K | カーソルから行の末尾まで削除します。 カーソルが行の末尾にある場合は、改行を削除します。 | | Ctrl+ | カーソル位置から行の先頭まで削除します。 | | + | 前の単語を削除します。 | | Home | 現在の表示線の先頭に移動します。 | | 終了 | 現在の表示線の末尾に移動します。 | | Ctrl+ホーム | テキストの先頭に移動します。 | | + | テキストの末尾に移動します。 | | + / (Windows/Linux)
オプション+←/→ (Mac) | カーソルを単語単位で移動します。 | | ↑/↓ | コマンド履歴に移動します。 | | / Y | 現在のインライン完了候補を受け入れます。 | ## 対話型インターフェース内のスラッシュコマンド これらは、対話型 CLI セッション内から使用できるスラッシュ コマンドです。 これらのスラッシュ コマンドのサブセットは、ACP サーバー経由で CLI を使用するクライアントで使用できます。 詳細については、「[Copilot CLI ACP サーバー](/ja/copilot/reference/copilot-cli-reference/acp-server)」を参照してください。 | 命令 | Purpose | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/add-dir PATH` | ファイル アクセスの許可リストにディレクトリを追加します。 | | `/after [DELAY PROMPT]`、`/after` | 現在のセッションの非定期的なプロンプト、スキル、またはスケジュール可能なスラッシュ コマンド ( `/after 30m remind me the time` や `/after 1h /chronicle standup`など) をスケジュールします。 引数を指定しないと、スケジュール マネージャーが表示されます。 実験モードでのみ使用できます。 | | `/agent` | 使用可能なエージェント (存在する場合) を参照して選択します。 「[カスタム エージェントについて](/ja/copilot/concepts/agents/copilot-cli/about-custom-agents)」を参照してください。 | | `/app` | | | GitHub Copilot アプリを起動するか、アプリがインストールされていない場合はダウンロード URL を表示します。 | | | `/ask QUESTION` | 会話履歴に追加せずに、簡単な側面の質問をします。 | | `/allow-all [on\|off\|show]`、`/yolo [on\|off\|show]` | すべてのアクセス許可 (ツール、パス、URL) を有効にします。 | | `/changelog [summarize] [VERSION\|last N\|since VERSION]`、`/release-notes [summarize] [VERSION\|last N\|since VERSION]` | CLI 変更ログを表示します。 必要に応じて、バージョン、最近のリリースの数、または開始バージョンを指定します。 AI によって生成された概要のキーワード `summarize` を追加します。 | | `/chronicle ` | セッション履歴ツールと分析情報。 | | `skills` サブコマンドは、観察された使用状況から生成されたリポジトリ スキル提案のドラフト、レビュー、および状態の追跡を行います。 「[セッション データ GitHub Copilot CLI（コマンドラインインターフェース） について](/ja/copilot/concepts/agents/copilot-cli/chronicle)」を参照してください。 | | | `/clear [PROMPT]`、`/new [PROMPT]`、`/reset [PROMPT]` | 新しい会話を開始します。 | | `/clikit [COMPONENT]` | CLI ビジネス コンポーネントのプレビュー (クォータ情報など)。 | | `/compact [FOCUS-INSTRUCTIONS]` | 会話履歴を要約して、コンテキスト ウィンドウの使用量を減らします。 必要に応じて、概要 (たとえば、 `/compact focus on the auth module`) を操作するためのフォーカス指示を指定します。 「[でコンテキストを管理する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/concepts/agents/copilot-cli/context-management#compaction)」を参照してください。 | | `/context` | コンテキスト ウィンドウのトークンの使用状況と視覚化を表示します。 「[でコンテキストを管理する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage)」を参照してください。 | | `/copy` | 最後の応答をクリップボードにコピーします。 | | `/cwd`、`/cd [PATH]` | 作業ディレクトリを変更するか、現在のディレクトリを表示します。 | | `/delegate [PROMPT]` | AI によって生成されたプル要求を使用して、リモート リポジトリに変更を委任します。 「[Copilotにタスクを委任](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca)」を参照してください。 | | `/diff` | 現在のディレクトリの変更を確認します。作業ツリーがクリーン (試験段階)、分岐の差分に自動切り替えます。 | | `/downgrade VERSION` | 特定の CLI バージョンにダウンロードして再起動します。 チーム アカウントで使用できます。 | | `/env` | 読み込まれた環境の詳細 (命令、MCP サーバー、スキル、エージェント、フック、プラグイン、LSP、拡張機能) を表示します。 | | `/every [INTERVAL PROMPT]`、`/every` | 現在のセッション ( `/every 1h run tests` や `/every 1d /chronicle standup`など) の定期的なプロンプト、スキル、またはスケジュール可能なスラッシュ コマンドをスケジュールします。 引数を指定しないと、スケジュール マネージャーが表示されます。 実験モードでのみ使用できます。 | | `/exit`、`/quit` | 現在のセッションを閉じます。 他のセッションが実行中の場合、終了せずに、残っている中で最も新しいセッションを前面に表示します。 最後に開いているセッションの場合にのみ、CLI を終了します。 | | `/exit print` は常に CLI を終了し、トランスクリプトをダンプするかどうかを確認します。 | | | `/extensions [manage\|mode]`、`/extension` | CLI 拡張機能を管理します。 | | `/experimental [on\|off\|show]` | 試験段階の機能の切り替え、設定、または表示を行います。 | | `/feedback`、`/bug` | CLI に関するフィードバックを提供します。 | | `/fleet [PROMPT]` | タスクの一部の並列サブエージェント実行を有効にします。 「[\`/fleet\` コマンドを使用したタスクの並列実行](/ja/copilot/concepts/agents/copilot-cli/fleet)」を参照してください。 | | `/help` | 対話型コマンドのヘルプを表示します。 | | `/ide` | IDE ワークスペースに接続します。 「[GitHub Copilot CLI（コマンドラインインターフェース）をVS Codeに接続する](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/connecting-vs-code#managing-the-connection-with-the-ide-slash-command)」を参照してください。 | | `/init` | このリポジトリ Copilot カスタム命令とエージェント機能を初期化します。 | | [「プロジェクト初期化」Copilot](#project-initialization-for-copilot)を参照してください。 | | | `/instructions` | カスタム命令ファイルを表示および切り替えます。 | | `/keep-alive [on\|off\|busy\|DURATION]`、`/caffeinate [on\|off\|busy\|DURATION]` | CLI セッションがアクティブな間、エージェントがビジー状態の間、または定義された時間の間、マシンがスリープ状態にならないようにします。 | | `30`、`30m`、`2h`、`1d` などの期間を受け入れます (ベア番号の既定値は分)。 | | | `/limits` | 対話型応答の制限ダイアログを開きます。 | | `/limits set max-ai-credits VALUE` | 応答ごとに許可される AI クレジットのソフト最大値を設定します。 応答の制限は、各ユーザー メッセージに対してリセットされるソフト制限です。 「[で AI credit セッション制限を設定する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/set-session-limit)」を参照してください。 | | `/limits unset [max-ai-credits\|all]` | 特定の応答制限またはすべての応答制限を削除します。 | | `/list-dirs` | ファイル アクセスが許可されているすべてのディレクトリを表示します。 | | `/login` | | | Copilotにログインします。 | | | `/logout` | | | Copilotからログアウトします。 | | | `/lsp [show\|test\|reload\|logs\|help] [SERVER-NAME]` | 言語サーバーの構成を管理します。 | | `logs` サブコマンドは、ライブ LSP サービス・ログ・パネルを開きます。 | | | `/mcp [list\|show\|add\|edit\|delete\|disable\|enable\|auth\|reload\|search] [SERVER-NAME]` | MCP サーバー構成を管理します。 | | `list` (エイリアス `ls`)は、接続状態とライブ状態を持つ構成済みサーバーのプレーンテキスト リストを出力し、読み取り専用であるため、エージェントがターンの処理中に実行できます。その他のすべてのサブコマンドは、ターンが終了するまでブロックされます。 セキュリティで保護されたローカル サーバーには、 `connected (sandboxed)` 状態が表示されます。 「[GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers)」を参照してください。 | | | `/model [--repo\|--local\|--session] [MODEL]`、`/models` | 使用する AI モデルを選択するか、\[自動] を選択 **します**。 `--repo`/`--local` は、現在のセッションではなくリポジトリ設定で既定のモデルをピン留めします。 `--session` (別名 `-s`) は、保存された設定に触れることなく、現在のセッションのモデル、推論作業、またはコンテキスト ウィンドウのみを変更します。 長いコンテキストバリアントを持つモデルの Tab キーを押して、コンテキスト列を既定のコンテキスト ウィンドウと長いコンテキスト ウィンドウの間で切り替えます。 「[について Copilot自動モデルの選択](/ja/copilot/concepts/models/auto-model-selection)」を参照してください。 | | `/permissions [show\|reset]` | 現在のセッションのメモリ内ツールとパスの承認を表示またはクリアします。 | | `/plan [PROMPT]` | コーディングする前に実装計画を作成します。 | | `/plugins`（別名 `/plugin`） | プラグイン、MCP サーバー、スキルを管理する。プラグイン ダッシュボードを開くか、 `--plugin`、 `--mcp`、または `--skill` で実行して、そのタブにフォーカスを置いて開きます。 [GitHub Copilot プラグインについて](/ja/copilot/concepts/agents/about-plugins) を参照してください。 | | `/plugins help` | | | `/plugins` コマンドの完全な使用方法を表示する。 | | | `/plugins install SOURCE` | Marketplace 仕様、 GitHub リポジトリ、git URL、またはローカル パスからプラグインをインストールします。 | | `/plugins install --skill [--project] ` | スキルをインストールする。 `--project` は、ユーザー アカウントではなく、このリポジトリへのファイルまたは URL インストールのスコープを設定します。 | | `/plugins update PLUGIN[@MARKETPLACE]` | インストールされているプラグインを更新します。 | | `/plugins uninstall PLUGIN[@MARKETPLACE]` | プラグインをアンインストールします。 | | `/plugins list`（別名 `/plugin ls`） | インストールされているプラグインを一覧表示します。 | | `/plugins enable\|disable\|remove --plugin\|--mcp\|--skill NAME` | プラグイン、MCP サーバー、またはスキルを名前で有効、無効、または削除/アンインストールする。既定では、種類が指定されていない場合は `--plugin` されます。 | | `/plugins marketplace add SOURCE` | マーケットプレースを追加します。 | | `/plugins marketplace remove NAME` | マーケットプレースを削除します。 | | `/plugins marketplace list` | 登録済みのマーケットプレースを一覧表示します。 | | `/plugins marketplace browse NAME` | マーケットプレースでプラグインを参照します。 | | `/plugins mcp [SUBCOMMAND]` | プラグイン ダッシュボードから MCP サーバーを管理する `/mcp`への委任。 | | `/pr [view\|create\|fix\|auto\|automerge]` | 現在のブランチのプル要求を管理します。 | | `auto` プル要求を緑に駆動し、停止します。 `automerge` (エイリアス: `agentmerge`) によってプル要求が緑に駆動され、マージされます。 「[/pr コマンドを使用したプル要求の管理](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/manage-pull-requests)」を参照してください。 | | | `/refine TEXT` | 大まかに構成されたプロンプトを、レビュー用の明確なプロンプトに書き換える。 現在の入力ボックスをクリーンアップするには、引数なしで ( Ctrl+X キーを押してから `/refine`) 実行します。 特に、音声で入力したプロンプトに便利です。 | | `/remote [on\|off]` | リモート コントロールの状態を表示する (引数が指定されていない場合)、リモート ステアリングを有効にする (`on`)、またはリモート接続を終了する (`off`)。 「[別のデバイスからの GitHub Copilot CLI（コマンドラインインターフェース） セッションのステアリング](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely)」を参照してください。 | | `/rename [NAME]` | 現在のセッションの名前を変更します (省略すると名前が自動生成されます。 `/session rename`のエイリアス)。 | | `/research TOPIC` | | | GitHub検索と Web ソースを使用して詳細な調査を実行します。 「[GitHub Copilot CLI（コマンドラインインターフェース） を用いた調査](/ja/copilot/concepts/agents/copilot-cli/research)」を参照してください。 | | | `/reset-allowed-tools` | 許可されているツールの一覧をリセットします。 | | `/restart` | 現在のセッションを保持して、CLI を再起動します。 | | `/resume [SESSION-ID]`、`/continue [SESSION-ID]` | リストから選択して別のセッションに切り替えます (必要に応じてセッション ID を指定します)。 | | `/review [PROMPT]` | コード レビュー エージェントを実行して変更を分析します。 「[を使用してコード レビューを要求する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review)」を参照してください。 | | `/rubber-duck [PROMPT]` | 計画、コード、およびテストに関する 2 番目の意見については、ラバー ダック エージェントを参照してください。 「[ラバーダックエージェントについて](/ja/copilot/concepts/agents/copilot-cli/rubber-duck)」を参照してください。 | | `/sandbox [enable\|disable]` | シェル コマンド、MCP/LSP サーバー、組み込みのファイル/Web ツールのファイルシステムとネットワーク アクセスを制限する OS レベルのサンドボックスを有効、無効、または構成します。 引数なしで `/sandbox` を実行して、ポリシー ダイアログを開きます。 | | `/search [QUERY]`、`/find [QUERY]` | 会話のタイムラインを検索します。 実験モードでのみ使用できます。 | | `/security-review [PROMPT]` | アクティブなローカル コードの変更に重点を置いたセキュリティ レビューを実行し、修復候補を使用して優先順位付けされた脆弱性の結果を返します。 このコマンドは、完全なリポジトリ セキュリティ監査ではありません。 | | `/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` サブコマンドは、セッション リンクを含むセッションの詳細を表示します (使用可能な場合)。 サブコマンド: `info`、 `checkpoints`、 `files`、 `plan`、 `rename`、 `cleanup`、 `prune`、 `delete`、 `delete-all`。 | | | `/settings [--repo\|--local] [show KEY\|KEY\|KEY VALUE]`,
`/config [--repo\|--local] [show KEY\|KEY\|KEY VALUE]` | 設定ダイアログを開き、特定の設定 (`KEY`) にフォーカスして開くか、設定をインライン (`KEY VALUE`) に設定するか、設定の現在の値 (`show KEY`) を表示します。 | | `show` は、シークレット名が付いた値 (たとえば、設定の配下にネストされたトークンや API キー) を平文で表示する代わりにマスクします。 ダイアログには、 **ユーザー**、 **リポジトリ**、 **およびリポジトリ (ローカル)** タブが表示されます。 Tab/Shift+Tab で切り替えます。別のスコープでオーバーライドされた設定には、どのスコープが優先するかを示すバッジの名前が表示されます。 ユーザー設定ファイルではなく、ターゲット `--repo`または`--local`に`.github/copilot/settings.json`または`.github/copilot/settings.local.json`を追加します (例: `/settings --repo model gpt-5.2`)。 この方法で設定できるのは [、リポジトリでオーバーライド可能なキー](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson) のみです。 アクティブな組織または MDM で管理されるポリシーによって制御される行は、`(managed)` タグ付きで読み取り専用として表示されます。 「[\`/settings\` コマンドを使用して設定を変更する](/ja/copilot/how-tos/copilot-cli/customize-copilot/change-settings)」を参照してください。 | | | `/share [link\|off\|file\|html\|gist\|research] [...]`、`/export [...]` | 現在のセッションを共有します。 サブコマンドがないと、ログインして同期するときに共有可能な GitHub リンクが生成されます (それ以外の場合は Markdown ファイルのエクスポートにフォールバックします)。 | | `off` は共有を停止します。 | | | `link` は、既定のリンク フローの明示的なエイリアスです。 `link off` はリンク共有を停止します。 | | | `file [session\|research] [PATH]` マークダウン ファイルにエクスポートします。 | | | `html [session\|research] [PATH]` HTML ファイルにエクスポートします。 | | | `gist [session\|research]` は、 GitHub の要点を作成します。 | | | `research [PATH]` 研究報告書をエクスポートします。 | | | `/skills [list\|info\|add\|remove\|reload] [ARGS...]` | 強化された機能のスキルを管理します。 「[エージェント スキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。 | | `/statusline`、`/footer` | ステータス行に表示する項目を構成します。 | | `/subagents`、`/agents` | 既定のサブエージェント モデルとエージェントごとのサブエージェント モデルを構成します。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)」を参照してください。 | | `/tasks` | タスク (サブエージェントおよびシェル コマンド) を表示および管理します。 | | `/terminal-setup` | 複数行入力をサポートするようにターミナルを構成します (Shift+Enter と Ctrl+Enter)。 | | `/theme [default\|github\|dim\|high-contrast\|colorblind]` | カラー モードを表示または設定します。 | | `/tuikit [colors\|icons\|select\|tabbar]` | プレビュー TUIkit デザイン システム コンポーネントとカラー トークン。 | | `/undo`、`/rewind` | 最後のターンを巻き戻し、ファイルの変更を元に戻します。 ファイル追跡はツール レイヤーを介して行われ、Git は必要ありません。 | | `/update`、`/upgrade` | CLI を最新バージョンに更新します。 | | `/usage` | セッション使用状況メトリックと統計 (モデルごとのトークンの合計を含む) を表示します。 | | `/user [show\|list\|switch]` | 現在の GitHub ユーザーを管理します。 | | `/version` | バージョン情報を表示し、更新プログラムを確認します。 | | `/voice [on\|off\|models\|devices]` | 音声モードの切り替え、使用可能な音声モデルの参照、または入力デバイス (マイク) の選択を行います。 | | `/fork [NAME]`、`/branch [NAME]` | 現在のセッションを新しいセッションにフォークします(必要に応じて名前を付けます)。 実験モードでのみ使用できます。 | | `/worktree [branch\|task]` | | | `HEAD`から新しい Git ワークツリーを作成し、それに切り替えて、コミットされていない変更を現在のワークツリーに残します。 ブランチ名、タスクの説明 (複数行サポート、新しいワークツリーの開始プロンプトとして使用) を渡すか、引数を省略して会話からブランチ名を自動生成します。 Git リポジトリが必要です。 実験モードでのみ使用できます。 | | | `/move [branch\|task]` | コミットされていない変更を新しい Git ワークツリーに移動し、それに切り替えます。 ブランチ名、タスクの説明 (複数行サポート、新しいワークツリーの開始プロンプトとして使用) を渡すか、引数を省略して会話からブランチ名を自動生成します。 Git リポジトリが必要です。 実験モードでのみ使用できます。 | 使用可能なスラッシュ コマンドの完全な一覧については、CLI の対話型インターフェイスに「 `/help` 」と入力します。 ## コマンド ライン オプション | オプション | Purpose | | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | | `--add-dir=PATH` | ファイル アクセスの許可リストにディレクトリを追加します (複数回使用できます)。 | | | `--add-github-mcp-tool=TOOL` | 既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールを追加します (複数回使用できます)。 すべてのツールに `*` を使用します。 | | | `--add-github-mcp-toolset=TOOLSET` | 既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールセットを追加します (複数回使用できます)。 すべてのツールセットに `all` を使用します。 | | | `--additional-mcp-config=JSON` | このセッション専用の MCP サーバーを追加します。 サーバー構成は、JSON 文字列またはファイル パス ( `@` プレフィックス) として指定できます。 | | | `~/.copilot/mcp-config.json`から構成を拡張します。 インストール済みの MCP サーバー構成を同じ名前でオーバーライドします。 「[GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。 | | | | `--agent=AGENT` | 使用する カスタム エージェント を指定します。 「[カスタム エージェントについて](/ja/copilot/concepts/agents/copilot-cli/about-custom-agents)」を参照してください。 | | | `--allow-all` | すべてのアクセス許可 ( `--allow-all-tools --allow-all-paths --allow-all-urls`と同等) を有効にします。 | | | `--allow-all-mcp-server-instructions` | システム プロンプトにすべての MCP サーバーからの初期化命令を含めます。 既定では、許可リストに登録されているサーバー命令のみが前もって含まれます。他のサーバーの命令はオンデマンドで取得されます。 | | | `--allow-all-paths` | ファイル パスの検証を無効にし、任意のパスへのアクセスを許可します。 | | | `--allow-all-tools` | すべてのツールを確認なしで自動的に実行できるようにします。 CLI をプログラムで使用する場合は必須 (env: `COPILOT_ALLOW_ALL`)。 | | | `--allow-all-urls` | 確認なしですべての URL へのアクセスを許可します。 | | | `--allow-tool=TOOL ...` | CLI が使用する権限を持っているツール。 アクセス許可を求めるメッセージは表示されません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 「[ツールの使用の許可と拒否](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools#allowing-or-denying-permission-for-specific-tools)」を参照してください。 | | | `--allow-url=URL ...` | 特定の URL またはドメインへのアクセスを許可します。 複数の URLは、引用符で囲まれたコンマ区切りのリストを使用します。 | | | `--acp` | エージェント クライアント プロトコル サーバーとして起動します。 | | | `--attachment PATH` | ファイルを最初のプロンプトに添付します (複数回使用できます)。 画像ファイルは受け入れられますが、正常に送信するには、選択したモデルと組織のポリシーで視覚入力を許可する必要があります。 | | | `--autopilot` | オートパイロット継続を有効にします。エージェントは、 `task_complete` が呼び出されるまで動作し続け、対話モードに戻ります。 「[GitHub Copilot CLI が自律的に動作できるようにする](/ja/copilot/concepts/agents/copilot-cli/autopilot)」を参照してください。 | | | `--available-tools=TOOL ...` | モデルで使用できるのは、これらのツールのみです。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 「[ツールの使用の許可と拒否](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools)」を参照してください。 | | | `--banner`、`--no-banner` | スタートアップ バナーを表示または非表示にします。 | | | `--bash-env` | bash シェル `BASH_ENV` サポートを有効にします。 | | | `-C DIRECTORY` | 他の操作を行う前に作業ディレクトリを変更します。 | | | `--connect[=SESSION-ID]` | リモート セッションに直接接続します (必要に応じて、セッション ID またはタスク ID を指定します)。 | | | `--resume`と`--continue`との競合。 | | | | `--context TIER`。 | 階層型料金モデルのコンテキストウィンドウのティアを設定します（保存済みの設定より優先され、新しい対話型セッションで適用されます）。 選択肢: "default"、"long\_context"。 | | | `--config-dir=DIRECTORY` | 構成ディレクトリを設定するためのこのオプションは非推奨です。 代わりに、 `COPILOT_HOME` 環境変数を使用してください。 | | | `--continue` | 現在の作業ディレクトリの最新のセッションを再開し、グローバルに最新のセッションにフォールバックします。 | | | `--resume`との競合。 | | | | `--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`、 `xhigh`、 `max`) を設定します。 | | | `max` は、Anthropic モデルの最上位レベルです。 | | | | `--enable-all-github-mcp-tools` | 既定の CLI サブセットではなく、すべての GitHub MCP サーバー ツールを有効にします。 | | | `--add-github-mcp-toolset`オプションと`--add-github-mcp-tool`オプションをオーバーライドします。 | | | | `--enable-memory` | プロンプト モードでメモリを有効にします (既定では無効)。 | | | `--enable-reasoning-summaries` | それをサポートする OpenAI モデルの推論の概要を要求します。 | | | `--excluded-tools=TOOL ...` | これらのツールはモデルでは使用できません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 | | | `--experimental` | 試験的な機能を有効にする ( `--no-experimental` を使用して無効にする)。 | | | `--extension-sdk-path DIRECTORY` | ローカル `@github/copilot-sdk` フォルダーを使用して拡張サブプロセスに挿入されたバンドルされた`copilot-sdk/`をオーバーライドします。 無効なパスは、バンドルされた SDK にフォールバックします。 | | | `-h`、`--help` | ヘルプを表示します。 | | | `-i PROMPT`、`--interactive=PROMPT` | 対話型セッションを開始し、このプロンプトを自動的に実行します。 | | | `--log-dir=DIRECTORY` | ログ ファイル ディレクトリを設定します (既定値: `~/.copilot/logs/`)。 | | | `--log-level=LEVEL` | ログ レベル ( `none`、 `error`、 `warning`、 `info`、 `debug`、 `all`、 `default`) を設定します。 | | | `--max-ai-credits=CREDITS` | 各応答で許可される AI クレジットのソフト最大値を設定します。 制限はユーザー メッセージごとにリセットされ、 `/limits`を使用してセッションの途中で調整できます。 「[で AI credit セッション制限を設定する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/set-session-limit)」を参照してください。 | | | `--max-autopilot-continues=COUNT` | オートパイロット モードでの継続メッセージの最大数 (既定値: 無制限)。 負以外の整数である必要があります。形式が正しくない値 (`NaN`、負、小数) は拒否されます。 「[GitHub Copilot CLI が自律的に動作できるようにする](/ja/copilot/concepts/agents/copilot-cli/autopilot)」を参照してください。 | | | `--mode=MODE` | 初期エージェント モード ( `interactive`、 `plan`、 `autopilot`) を設定します。 | | | `--autopilot`または`--plan`と組み合わせることはできません。 | | | | `--model=MODEL` | 使用する AI モデルを設定します。 | | | `auto`を値として渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。 「[について Copilot自動モデルの選択](/ja/copilot/concepts/models/auto-model-selection)」を参照してください。 | | | | `--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` | このセッションのリモート アクセスを無効にします。 | | | `--no-remote-export` | | | | GitHub.comおよびGitHub Mobileへのセッションのエクスポートを無効にします (リモート コントロールも無効になります)。 | | | | `--output-format=FORMAT` | FORMAT は、 `text` (既定) または `json` (JSONL 出力: 1 行に 1 つの JSON オブジェクト) にすることができます。 | | | `-p PROMPT`、`--prompt=PROMPT` | プログラムでプロンプトを実行します (完了後に終了します)。 終了の概要には、セッションを続行するための `copilot --resume=SESSION-ID` ヒントが含まれています。 「[プログラムによる GitHub Copilot CLI（コマンドラインインターフェース） の実行](/ja/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically)」を参照してください。 | | | `--plan` | プラン モードで開始します。 | | | `--mode plan` の短縮形です。 | | | | `--mode`または`--autopilot`と組み合わせることはできません。 | | | | `--plain-diff` | リッチ差分レンダリングを無効にします (Git 構成で指定された差分ツールを使用した構文の強調表示)。 | | | `--plugin-dir=DIRECTORY` | ローカル ディレクトリからプラグインを読み込みます (複数回使用できます)。 | | | `--remote` | | | | GitHub.comおよびGitHub Mobileからこのセッションへのリモート アクセスを有効にします。 「[別のデバイスからの GitHub Copilot CLI（コマンドラインインターフェース） セッションのステアリング](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely)」を参照してください。 | | | | `--remote-export` | セッションを GitHub.com および GitHub Mobile にエクスポートします (読み取り専用。リモート 制御は有効になりません)。 | | | `-r`、`--resume[=VALUE]` | 一覧から選択して、以前の対話型セッションを再開します。 必要に応じて、セッション ID、ID プレフィックス、またはセッション名を指定します。 名前の一致は正確で大文字と小文字が区別されません。明示的な名前が一致しない場合、自動生成された概要にフォールバックします。 | | | `--continue`との競合。 ベア `--resume` (値なし) は、TTY を必要とする対話型セッション ピッカーを示します。 複数のセッションが存在し、ピッカーを表示できない場合 (たとえば、 `-p`、TTY 以外の `-i`、パイプされた stdin の下)、CLI は、新しいセッションを自動的に開始するのではなく、エラーで終了します。明示的な `--resume=SESSION-ID` を渡すか、 `--continue`を使用します。 | | | | `-s`、`--silent` | | | | `-p`を使用したスクリプト作成に役立つ、エージェントの応答のみを出力します (使用状況統計なし)。 | | | | `--screen-reader` | スクリーン リーダーの最適化を有効にします。 | | | `--secret-env-vars=VAR ...` | シェルおよび MCP サーバー環境から環境変数を編集します (複数回使用できます)。 複数の変数の場合は、引用符で囲まれたコンマ区切りのリストを使用します。 | | | `GITHUB_TOKEN`環境変数と`COPILOT_GITHUB_TOKEN`環境変数の値は、既定で出力から編集されます。 | | | | `--session-id ID` | ID プレフィックスまたはセッション名による `--resume` のより広範な一致を望まない場合は、正確なセッション ID またはタスク ID を使用してください。 ID が既存のセッションまたはタスクと一致する場合、そのセッションまたはタスクは再開されます。 何も一致しない場合、値が有効な UUIDにのみ新しいセッションが作成されます。 名前と ID プレフィックスでは、新しいセッションは作成されません。 このオプションは、 `--resume`、 `--continue`、 `--connect`などの他のセッション選択またはセッション開始オプションと組み合わせないでください。これは、開くか作成するかを決定するために競合するためです。 | | | `--sandbox` | 保存したサンドボックス設定を変更せずに、このセッションに対してのみ OS レベルのシェル サンドボックスを有効にします。 | | | `-p`で便利です。 実験モードでのみ使用できます。 | | | | `--no-sandbox` | 保存したサンドボックス設定を変更せずに、このセッションに対してのみ OS レベルのシェル サンドボックスを無効にします。 実験モードでのみ使用できます。 | | | `--share=PATH` | プログラム セッションの完了後にセッションを Markdown ファイルに共有します (既定のパス: `./copilot-session-.md`)。 | | | `--share-gist` | プログラムによるセッションの完了後、シークレット GitHub gist にプログラムセッションを共有します。 | | | `--stream=MODE` | ストリーミング モードを有効または無効にします。このモードでは、完全な応答が到着するまで待機するのではなく、生成された Copilotの応答が段階的に表示されます (モードの選択肢: `on` または `off`、既定: `on`)。 | | | `-v`、`--version` | バージョン情報を表示します。 | | | `-w`、`--worktree[=NAME]` | | | | `.worktrees/`の下に分離された Git ワークツリーを作成または再利用し、その中でセッションを開始します。 | | | | `NAME` は省略可能です。ブランチ名を自動生成するには省略します。 | | | | `--resume`、`--continue`、および`--connect`との競合。 実験モードでのみ使用できます。 | | | | `--yolo` | すべてのアクセス許可 ( `--allow-all`と同等) を有効にします。 | | コマンドとオプションの完全な一覧については、 `copilot help`を実行します。 > \[!NOTE] > `--remote`、`--no-remote`、`--remote-export`、`--no-remote-export`、`--connect`の各オプションを使用するには、アカウントでリモート セッション機能を使用できる必要があります。 `--remote`と`--resume `を使用して、リモート タスクをローカルで再開できます。 これは、タスクが最初に Git リポジトリの外部で作成された場合でも機能します。 > \[!NOTE] > `permissions.disableBypassPermissionsMode`が `"disable"` に設定されている場合、すべての許可フラグ (`--allow-all-tools`、`--allow-all-paths`、`--allow-all-urls`、`--allow-all`、`--yolo`) は起動時に抑制され、昇格されたアクセス許可を付与するために使用することはできません。 この制限は、次の 3 つのソースで設定できます。この制限は、永続性の順に増加します。 | 情報源 | Scope | アカウント切り替えでクリアされましたか? | | ----------------------------------- | ----- | ------------------------------------------ | | ユーザー設定 (`~/.copilot/settings.json`) | 機械 | いいえ — すべてのアカウントに適用されます | | 管理設定（アカウントごとにサーバーから取得） | アカウント | はい — バイパス モードを無効にしない別のアカウントに切り替えるとクリアされます | | MDM ポリシー (plist/registry/file) | デバイス | Never — アカウントの切り替えでオーバーライドできないデバイスレベルのポリシー | MDM 構成の詳細については、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#mdm-managed-settings) を参照してください。 ## サポートされているモデル `--model=MODEL`または`COPILOT_MODEL`環境変数を使用して、AI モデルを選択します。 `auto`を渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。 | Model | 最適な用途 | | ------------------------ | -------------------- | | `claude-sonnet-4.6` | 汎用コーディング (既定) | | `gpt-5.4` | 複雑な推論タスク | | `claude-haiku-4.5` | 高速で軽量な操作 | | `gpt-5.3-codex` | コードに重点を置いたタスク | | `gemini-3.1-pro-preview` | Google Gemini の推論 | | `gemini-3.5-flash` | 速いGoogleジェミニの応答 | | `gemini-3.6-flash` | 速いGoogleジェミニの応答 | | `mai-code-1-flash` | 高速でアダプティブなコーディング タスク | `/model`スラッシュ コマンドを使用して、対話型セッション中にモデルを切り替えることもできます。 ## ツールの可用性の値 `--available-tools`と`--excluded-tools`のオプションでは、次の値がサポートされます。 ### シェル ツール | ツール名 | 説明 | | --------------------------------- | ---------------------- | | `bash` / `powershell` | コマンドを実行する | | `list_bash` / `list_powershell` | アクティブなシェル セッションを一覧表示する | | `read_bash` / `read_powershell` | シェル セッションからの出力の読み取り | | `stop_bash` / `stop_powershell` | シェル セッションを終了する | | `write_bash` / `write_powershell` | シェル セッションに入力を送信する | ### ファイル操作ツール | ツール名 | 説明 | | ------------- | ----------------------------------------- | | `apply_patch` | パッチを適用する ( `edit`/`create`の代わりに一部のモデルで使用) | | `create` | 新しいファイルを作成する | | `edit` | 文字列置換を使用してファイルを編集する | | `view` | ファイルまたはディレクトリの読み取り | ### エージェントとタスクの委任ツール | ツール名 | 説明 | | ------------- | ----------------------- | | `list_agents` | 使用可能なエージェントを一覧表示する | | `read_agent` | バックグラウンド エージェントの状態を確認する | | `task` | サブエージェントの実行 | | `write_agent` | 実行中のエージェントにメッセージを送信する | ### その他のツール | ツール名 | 説明 | | ----------------- | ------------------ | | `ask_user` | ユーザーに質問する | | `glob` | パターンに一致するファイルを検索する | | `grep` (または `rg`) | ファイル内のテキストを検索する | | `skill` | カスタム スキルを呼び出す | | `web_fetch` | ウェブコンテンツの取得と解析 | ## ツールのアクセス許可パターン `--allow-tool`オプションと`--deny-tool`オプションは、`Kind(argument)`形式のアクセス許可パターンを受け入れます。 引数は省略可能です。省略すると、その種類のすべてのツールと一致します。 | サブタイプ | 説明 | パターンの例 | | ------------------------------------------ | -------------------------- | -------- | | `memory` | ファクトをエージェント のメモリに格納する | `memory` | | `read` | ファイルまたはディレクトリの読み取り | | | `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` が設定されている場合でも、許可規則よりも常に優先されます。 ```shell # 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' # Deny writes to a specific path (exact or trailing-path-segment match; no glob support yet) copilot --deny-tool='write(secret.txt)' ``` `--deny-tool='write(PATH)'` は拒否の適用範囲をそのパスに限定します。他の書き込みには影響しません。 この一致により、シンボリック リンクと`.`/`..` セグメントが解決され、macOS とWindowsでは大文字と小文字が区別されません。 ## 環境変数 | Variable | 説明 | | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `COPILOT_ALLOW_ALL` | すべてのアクセス許可を自動的に許可するように `true` に設定します ( `--allow-all`と同等)。 | | `COPILOT_AUTO_UPDATE` | 自動更新を無効にするには、 `false` に設定します。 | | `COPILOT_CACHE_HOME` | キャッシュ ディレクトリ (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) をオーバーライドします。 プラットフォームの既定値については [、AUTOTITLE](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) を参照してください。 | | `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | カスタム命令用の追加ディレクトリのコンマ区切りの一覧。 | | `COPILOT_EDITOR` | 対話型編集のためのエディターコマンド（`$VISUAL` および `$EDITOR` の後にチェックされたもの）。 何も設定されていない場合、デフォルトで `vi` になります。 | | `COPILOT_ENABLE_HTTP2` | HTTP/2 トランスポートをオプトインするには、 `1` または `true` に設定します。 HTTP/1.1 が既定値です。 | | `COPILOT_GH_HOST` | | | 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_LARGE_OUTPUT_THRESHOLD_BYTES` | モデルに直接返されるツール出力の最大 UTF-8 バイト サイズ。 既定値: `20480` (20 KiB)。 「[でコンテキストを管理する GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/concepts/agents/copilot-cli/context-management#managing-large-tool-output)」を参照してください。 | | `COPILOT_MCP_TOOL_CACHE` | プロセス全体のローカル MCP サーバー ツール スナップショットの読み込みと永続化を無効にするには、 `false` に設定します。 | | [ツールスナップショットキャッシュを](#tool-snapshot-caching)参照してください。 | | | `COPILOT_MODEL` | AI モデルを設定します。 | | `COPILOT_PROMPT_FRAME` | 入力プロンプトの周囲の装飾 UI フレームを有効にするには、 `1` に設定するか、無効に `0` します。 現在のセッションの実験用機能フラグ `PROMPT_FRAME` オーバーライドします。 | | `COPILOT_SKILLS_DIRS` | スキルの追加ディレクトリのコンマ区切りの一覧。 | | `COPILOT_STRIP_REASONING_ON_RESUME` | セッション全体で BYOK 推論トークンを削除するのではなく再開するように、 `0` または `false` に設定します。 既定では、それらは取り除かれます。 | | `COPILOT_SUBAGENT_MAX_CONCURRENT` | セッションあたりの最大同時サブエージェント数 (既定: `32`、範囲: `1`– `256`)。 | | `COPILOT_SUBAGENT_MAX_DEPTH` | サブエージェントの入れ子の深さの最大値 (既定値: `4`、範囲: `1` – `128`)。 | | `COPILOT_TASK_WAIT_TIMEOUT_SECONDS` | | | `-p` (および`-p --autopilot`) の最大秒数は、保留中のバックグラウンド エージェントまたはシェル コマンドが終了するまで待機してから終了します (既定値: `600`;`0`は待機せずに直ちに終了します)。 | | | `GH_HOST` | | | GitHub | | | GitHub CLIとCopilot CLI (コパイロット CLI)の両方のホスト名 (既定値: `github.com`)。 データ所在地のホスト名を使用して GitHub Enterprise Cloud を設定します。 | | | `COPILOT_GH_HOST` を Copilot CLI (コパイロット CLI) のみでオーバーライドします。 | | | `GH_TOKEN` | 認証トークン。 | | `GITHUB_TOKEN`よりも優先されます。 | | | `GITHUB_COPILOT_PROMPT_MODE_EXTENSIONS` | プロジェクト拡張機能を読み込み、プロンプト モード (`true`) で拡張機能管理ツールを許可するには、`-p`に設定します。 対話型の信頼なしでリポジトリによって制御される拡張コードが実行されないようにするには、既定で無効になっています。 | | `GITHUB_COPILOT_PROMPT_MODE_REPO_HOOKS` | プロンプト モード (`true`) でリポジトリ フックを読み込むには、`-p`に設定します。 リポジトリ フックは、フォルダーが既に信頼されているか、 `COPILOT_ALLOW_ALL` が設定されている場合にも自動的に読み込まれます。 | | `GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP` | プロンプト モード (`true`) でワークスペース MCP ソースを読み込むには、`-p`に設定します。 対話型の信頼なしでリポジトリによって制御される MCP サーバーの起動を防ぐには、既定で無効になっています。 | | `GITHUB_TOKEN` | 認証トークン。 | | `PLAIN_DIFF` | リッチ差分レンダリングを無効にするには、 `true` に設定します。 | | `USE_BUILTIN_RIPGREP` | バンドルされたバージョンの代わりにシステム ripgrep を使用するには、 `false` に設定します。 | ## 構成ファイルの設定 構成ファイルの設定の詳細については、ユーザー設定、リポジトリ設定、ローカル設定の完全な一覧、それらがカスケードされる方法など、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings) を参照してください。 > \[!NOTE] > ユーザー設定は、以前は `~/.copilot/config.json` に格納されていました。 その場所の既存のユーザー編集可能な設定は、起動時に自動的に `~/.copilot/settings.json` に移行されます。 ## 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用のリポジトリカスタム命令の追加](/ja/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)」を参照してください。 ### カスタム命令の場所 Copilot CLI (コパイロット CLI) これらの場所からカスタム命令を同時に読み込みます (すべてがマージされます)。 | 場所 | Notes | | -------------------------------------------------- | --------------------------- | | `CLAUDE.md` | Git ルートおよびカレントワーキングディレクトリ内で | | `GEMINI.md` | Git ルートおよびカレントワーキングディレクトリ内で | | `AGENTS.md` | Git ルートおよびカレントワーキングディレクトリ内で | | `.github/instructions/**/*.instructions.md` | Git ルートおよびカレントワーキングディレクトリ内で | | `.github/copilot-instructions.md` | Git ルートおよびカレントワーキングディレクトリ内で | | `$HOME/.copilot/copilot-instructions.md` | — | | `$HOME/.copilot/instructions/**/*.instructions.md` | — | | `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | 環境変数を使用した追加のディレクトリ。 | ### カスタム命令のインポート 命令ファイルでは、 `@path` インポートがサポートされます。 `@`を含む行の前に、別のファイルの内容をインライン化するためのパスを付けます。 パスは、命令ファイルのディレクトリまたは絶対パスに対する相対パスにすることができます。 インポートは、サイクルとサイズのガードを使用して、深さの制限まで再帰的に解決されます。 これは、 `AGENTS.md`、 `CLAUDE.md`、および `.github/copilot-instructions.md`でサポートされています。 ## フック リファレンス フックの構成形式、フック イベント、入力ペイロード、決定制御など、フックの詳細については [、AUTOTITLE を](/ja/copilot/reference/hooks-reference)参照してください。 ## MCP サーバーの構成 MCP サーバーは、CLI エージェントに追加のツールを提供します。 `~/.copilot/mcp-config.json`で永続的なサーバーを構成します。 `--additional-mcp-config`を使用して、1 つのセッションのサーバーを追加します。 サンドボックス内で生成されるローカル (stdio) サーバー (`/sandbox` スラッシュ コマンドを参照) では、リモート (HTTP/SSE) サーバーはサンドボックス化されないので、`connected (sandboxed)`と`copilot mcp list`で`/mcp list`状態が表示されます。 実験モードでのみ使用できます。 `copilot mcp list` と `/mcp list` は、無効なサーバーを、テキスト出力では `(disabled)` サフィックスを付けて、または `"enabled": false` 出力ではサーバーごとに `--json` を付けてマークします。 `copilot mcp get` には、 `Status: Enabled`/`Disabled` 行が表示されます。 `/sandbox` を切り替えると、サンドボックス内で起動されるため、ローカル（stdio）の MCP サーバーだけが再起動されます。 リモート (HTTP/SSE) サーバーは接続された状態を維持します。 ### `copilot mcp` サブコマンド `copilot mcp`を使用して、対話型セッションを開始せずにコマンド ラインから MCP サーバー構成を管理します。 | サブコマンド | 説明 | | ------------------------------------ | ------------------------------------------------------------------- | | `list [--json]` | プラグインが提供するサーバーを含め、ソース別にグループ化されたすべての構成済み MCP サーバーを一覧表示します。 | | `get [--json]` | 特定のサーバーの構成とツールを表示します。 プラグインが提供するサーバーの場合は、ソース プラグインの名前とバージョンも表示されます。 | | `add ` | ユーザー構成にサーバーを追加します。 | | `~/.copilot/mcp-config.json`に書き込みます。 | | | `remove ` | ユーザー レベルのサーバーを削除します。 ワークスペース サーバーは、構成ファイルで直接編集する必要があります。 | \*\* `copilot mcp add` オプション：\*\* | オプション | 説明 | | ------------------------ | ----------------------------------------------- | | `-- [args...]` | ローカル (stdio) サーバーのコマンドと引数。 | | `--url ` | リモート サーバーの URL。 | | `--type ` | トランスポートの種類: `local`、 `stdio`、 `http`、または `sse`。 | | `--env KEY=VALUE` | 環境変数 (反復可能)。 | | `--header KEY=VALUE` | リモート サーバーの HTTP ヘッダー (反復可能)。 | | `--tools ` | ツール フィルター: `"*"` すべて、コンマ区切りのリスト、または `""` なし。 | | `--timeout ` | タイムアウト (ミリ秒単位)。 | | `--json` | JSON として追加された構成を出力します。 | | `--show-secrets` | 完全な環境変数とヘッダー値を表示します。 | > \[!CAUTION] > `--show-secrets` では、機密性の高い環境変数とヘッダー値をターミナルまたはログに出力できます。 信頼できる環境でのみこのオプションを使用し、共有ログまたは履歴に出力をコピー、貼り付け、またはその他の方法でキャプチャしないようにします。 ### トランスポートの種類 | タイプ | 説明 | 必須フィールド | | ------------------------------------------------------- | --------------------------------------- | ------- | | `local` / `stdio` | stdin/stdout を介して通信するローカル プロセス。 | | | `command`、`args` | | | | `http` | ストリーミング可能な HTTP トランスポートを使用するリモート サーバー。 | | | `"streamable-http"` はエイリアスとしても受け入れられ、 `"http"`に正規化されます。 | `url` | | | `sse` | Server-Sent イベント トランスポートを使用するリモート サーバー。 | `url` | ### ローカル サーバー構成フィールド | フィールド | 必須 | 説明 | | ----------------------------------------------------- | --- | ----------------------------------------------------- | | `command` | はい | サーバーを起動するコマンド。 | | `args` | はい | コマンド引数 (配列)。 | | `tools` | はい | 有効にするツール: すべてのツールの `["*"]` 、または特定のツール名の一覧。 | | `env` | いいえ | 環境変数。 | | `$VAR`、`${VAR}`、および`${VAR:-default}`展開をサポートします。 | | | | `cwd` | いいえ | サーバーの作業ディレクトリ。 | | `timeout` | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 | | `type` | いいえ | | | `"local"` または `"stdio"`。 既定値: `"local"`。 | | | | `deferTools` | いいえ | | | `"auto"` (既定) または `"never"`。 | | | | `"never"`に設定すると、ツール検索がアクティブな場合でも、このサーバーのツールが常に表示されます。 | | | | `disableToolCache` | いいえ | このサーバーのツール スナップショットの読み込みと永続化をスキップするには、 `true` に設定します。 | ### ツール スナップショットキャッシュ Copilot CLI (コパイロット CLI) では、各ローカル サーバーのツール リストのスナップショットが保持されるため、ライブ検出がバックグラウンドで完了している間は、起動時にすぐにツールを使用できます。 ライブ検出は常に実行され、完了するとスナップショットが置き換えられます。 サーバーで `disableToolCache: true` を設定して、そのサーバーに対してのみライブ検出を強制するか、 `COPILOT_MCP_TOOL_CACHE=false` 環境変数を設定して、プロセス全体のスナップショットの読み込みと永続化を無効にします。 どちらのオプトアウトも、既存のキャッシュ ファイルはそのまま残ります。 ### プライベート npm レジストリ `--registry`配列の`args`を使用して、Artifactory や GitHub Packages フィードなどのプライベート npm レジストリからパッケージをプルします。 ```json { "mcpServers": { "my-internal-server": { "command": "npx", "args": [ "--registry", "https://npm.pkg.github.com", "@my-org/internal-mcp-server" ], "tools": ["*"] } } } ``` `--registry` フラグとその他の npm 構成フラグ (`--userconfig`、`--globalconfig`、`--prefix`、`--cache`、`--node-options`、`--workspace`、`-w`) は、サーバーの ID フィンガープリントを計算するときに値を消費する引数として扱われます。 これにより、パッケージ名の前にこれらのフラグが表示される場合に、エンタープライズ許可リストのチェックとレジストリ検証が正しく機能します。 ### リモート サーバー構成フィールド | フィールド | 必須 | 説明 | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | -------------------------------------------------------------------------------------------------------------- | | `type` | はい | | | `"http"` または `"sse"` (`"streamable-http"` は `"http"`のエイリアスとしても受け入れられます)。 | | | | `url` | はい | サーバー URL。 | | `tools` | はい | 有効にするツール。 | | `headers` | いいえ | HTTP ヘッダー。 変数の拡張をサポートします。 | | `oauthClientId` | いいえ | 静的 OAuth クライアント ID (動的登録をスキップします)。 | | `oauthPublicClient` | いいえ | OAuth クライアントがパブリックかどうか。 既定値: `true`。 保存されているシークレットを持つ機密クライアントの `false` に設定します。 | | `oauthGrantType` | いいえ | OAuth 許可の種類: `"authorization_code"` (既定のブラウザー ベースのフロー) または `"client_credentials"` (完全にヘッドレス、ブラウザーまたはコールバックなし)。 | | `oidc` | いいえ | OIDC トークンの挿入を有効にします。 | | `true`すると、CLI は、サーバーの `GITHUB_COPILOT_OIDC_MCP_TOKEN` ブロック (ローカル サーバー) で参照される任意の`GITHUB_COPILOT_OIDC_MCP_TOKEN_`または`env`変数の OIDC トークンを挿入するか、トークンを`Bearer``Authorization` ヘッダー (リモート サーバー) として送信します。 ローカル サーバーの場合は、サフィックス付きのバリアント (たとえば、 `${GITHUB_COPILOT_OIDC_MCP_TOKEN_MY_SVC}`) を使用して、サーバーごとに一意の変数名を割り当てます。 | | | | `timeout` | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 | | `deferTools` | いいえ | | | `"auto"` (既定) または `"never"`。 | | | | `"never"`に設定すると、ツール検索がアクティブな場合でも、このサーバーのツールが常に表示されます。 | | | ### OAuth 再認証 OAuth を使用するリモート MCP サーバーでは、トークンの有効期限が切れたとき、または別のアカウントが必要な場合に、 `needs-auth` 状態が表示される場合があります。 `/mcp auth `を使用して、新しい 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` がサーバーの検出されたトークン エンドポイントに直接投稿されます。 ```json { "mcpServers": { "headless-api": { "type": "http", "url": "https://api.example.com/mcp", "tools": ["*"], "oauthClientId": "YOUR-CLIENT-ID", "oauthPublicClient": false, "oauthGrantType": "client_credentials" } } } ``` ### フィルター マッピング サーバーの構成の `filterMapping` フィールドを使用して、MCP ツールの出力を処理する方法を制御します。 | モード | 説明 | | ------------------- | -------------------------- | | `none` | フィルター処理なし。 | | `markdown` | 出力を Markdown として書式設定します。 | | `hidden_characters` | 非表示または制御文字を削除します。 Default. | ### 組み込みの MCP サーバー CLI には、追加のセットアップなしで使用できる組み込みの MCP サーバーが含まれています。 | \[サーバー] | 説明 | | ------------------------------------------------------ | ----------------------------------------------- | | `github-mcp-server` | | | GitHub API 統合: 問題、プル要求、ラベル、コミット、コード検索、 GitHub Actions。 | | | `playwright` | ブラウザーの自動化: 移動、クリック、入力、スクリーンショット、フォーム処理。 | | `fetch` | | | `fetch` ツールを使用した HTTP 要求。 | | | `time` | 時間ユーティリティ: `get_current_time` と `convert_time`。 | `--disable-builtin-mcps`を使用してすべての組み込みサーバーを無効にするか、`--disable-mcp-server SERVER-NAME`を使用して特定のサーバーを無効にします。 #### GitHub MCP サーバー ツール `github-mcp-server`には、次のツールが用意されています。 | Tools | 説明 | | ---------------------------------------------------------------- | ----------------- | | `get_file_contents`、`search_code` | リポジトリ ファイルを参照します。 | | `list_issues`、`issue_read`、`search_issues` | 課題追跡。 | | `get_pull_request`、`list_pull_requests`、`get_pull_request_files` | プル要求。 | | `list_commits`、`get_commit` | コミット履歴。 | | `list_workflow_runs`、`get_workflow_run_logs` | | | GitHub Actions。 | | | `get_label`、`list_label`、`label_write` | ラベル管理。 | ### 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 サーバーは、それぞれ異なる信頼レベルを持つ複数のソースから読み込まれます。 | 情報源 | 信頼レベル | 確認が必要 | | ------------------------------------- | ------------ | ----------- | | 組み込み | High | いいえ | | リポジトリ (`.github/mcp.json`) | 中程度 | 推奨 | | ワークスペース (`.mcp.json`) | 中程度 | 推奨 | | ユーザー構成 (`~/.copilot/mcp-config.json`) | User-defined | ユーザーの責任での対応 | | リモート サーバー | 低 | いつも | すべての MCP ツールの呼び出しには、明示的なアクセス許可が必要です。 これは、外部サービスの読み取り専用操作にも適用されます。 ### MCP サーバーの読み込み優先度 異なるソースの MCP サーバーは、優先順位 (最も高い順) でマージされます。 サーバーが名前を共有する場合、優先順位の高いソースが優先されます。 1. `--additional-mcp-config` フラグ (最高) 2. プラグインによって提供されるサーバー 3. ワークスペース サーバー—`.mcp.json` と `.github/mcp.json` は作業ディレクトリから Git ルートに向かって上位へたどりながら読み込まれます。フォルダーが信頼済みである必要があります 4. `~/.copilot/mcp-config.json` (最低) > \[!NOTE] > ワークスペース MCP サーバー (`.mcp.json` と `.github/mcp.json`) は、作業ディレクトリが信頼されていれば、対話型セッションと SDK サーバー モード セッションの両方に読み込まれます。 フォルダーの信頼の詳細については、「 [ツールの使用の許可と拒否](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools)」を参照してください。 ### Enterprise MCP 許可リスト GitHub Enterprise 組織は、 許可された MCP サーバーの許可リストを強制できます。 アクティブな場合、CLI は、接続する前に、既定以外の各サーバーをエンタープライズ ポリシーに照らして評価します。 GitHub Enterprise レジストリ ポリシーが検出された場合 (または、`MCP_ENTERPRISE_ALLOWLIST`試験的機能フラグが有効になっている場合)、CLI は次の手順を実行します。 1. コマンド、引数、およびリモート URL に基づいて、構成された既定以外のサーバーごとにフィンガープリントを計算します。 2. エンタープライズ許可リスト評価エンドポイントに指紋を送信します。 3. 指紋が承認されているサーバーのみを許可します。それ以外はすべて、エンタープライズに名前を付けるメッセージでブロックされます。 このチェックは失敗します。評価エンドポイントに到達できない場合、またはエラーが返された場合、ポリシーを検証できるようになるまで、既定以外のサーバーはブロックされます。 サーバーがエンタープライズ許可リストによってブロックされると、CLI には次の情報が表示されます。 ```text 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 など):** ```shell jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json ``` [ `jq` ](https://jqlang.github.io/jq/)が必要です。 **PowerShell**: ```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` に置き換えます。 ### Stdio サーバーの出力 MCP stdio トランスポートは、改行区切りの JSON-RPC フレーム専用に stdout を予約します。 CLI は、出力をプロトコル パーサーに渡す前に、JSON 以外の行 (プレーンテキスト ログ、例外スタック トレース、または空白のみの行) を自動的に除外します。 stdout ではなく、すべての診断出力を **stderr** に書き込みます。 stdout にログまたはエラー メッセージを書き込むサーバーは、初期化ハンドシェイクをストールさせる解析エラー フィードバック ループをトリガーできます。このフィルターは、JSON 以外のフレームをサイレント に削除することでこれを防ぎます。 1 MB を超える行は構造チェックをバイパスし、as-is転送されます。これは、サイズが大きいが有効なプロトコル フレーム (大きな `tools/list` 応答など) の分割やドロップを回避するためです。 ## スキルのリファレンス スキルは、CLI で実行できる機能を拡張する Markdown ファイルです。 各スキルは、 `SKILL.md` ファイルを含む独自のディレクトリに存在します。 ( `/SKILL-NAME` 経由で、またはエージェントによって自動的に) 呼び出されると、スキルのコンテンツが会話に挿入されます。 ### スキルのフロントマター フィールド | フィールド | タイプ | 必須 | 説明 | | -------------------------- | -------------------- | --- | ---------------------------------------------------------------------- | | `name` | 文字列 | はい | スキルのユニークID。 文字、数字、ハイフンのみ。 最大 64 文字。 | | `description` | 文字列 | はい | スキルが実行する内容と、それを使用するタイミング。 最大 1024 文字。 | | `argument-hint` | 文字列 | いいえ | スキル ピッカー (たとえば、 `"[target] [mode]"`) に表示される、予期される引数を記述するフリーフォーム ヒント。 | | `allowed-tools` | string または string\[] | いいえ | スキルがアクティブな場合に自動的に許可されるツールのコンマ区切りリストまたは YAML 配列。 すべてのツールに `"*"` を使用します。 | | `user-invocable` | ブーリアン | いいえ | ユーザーが `/SKILL-NAME`を使用してスキルを呼び出すことができるかどうか。 既定値: `true`。 | | `disable-model-invocation` | ブーリアン | いいえ | エージェントがこのスキルを自動的に呼び出さないようにします。 既定値: `false`。 | ### スキルの場所 スキルは、これらの場所から優先順位に従って読み込まれます（名前が重複した場合は、最初に見つかったものが使用されます）。 | 場所 | Scope | 説明 | | --------------------- | ------ | --------------------------------------------------------------------- | | `.github/skills/` | プロジェクト | Project固有のスキル。 | | `.agents/skills/` | プロジェクト | 別のプロジェクトの場所。 | | `.claude/skills/` | プロジェクト | Claude 互換の場所。 | | 親 `.github/skills/` | 継承済み | Monorepo 親ディレクトリのサポート。 | | `~/.copilot/skills/` | 個人用 | すべてのプロジェクトに必要な個人のスキル。 | | `~/.agents/skills/` | 個人用 | すべてのプロジェクトで共有されるエージェント スキル。 | | プラグイン ディレクトリ | プラグイン | インストールされているプラグインのスキル。 | | `COPILOT_SKILLS_DIRS` | カスタム | 追加のディレクトリ (コンマ区切り)。 | | (CLI にバンドル) | 組み込み | CLI に付属するスキル。 優先順位が最も低く、他のソースによってオーバーライドできます。 | | (組織/エンタープライズ) | リモート | AHP リレーを介して中継される、組織または企業でホストされるスキル。 スキルが呼び出されたときに、コンテンツが必要に応じて取得されます。 | リモート スキルは、ローカル スキルと共に投影され、ローカル スキルの名前が同じである場合は、同じ名前ベースの優先順位に従います。 2 つのプラグインが同じ名前のスキルを提供する場合、 `/my-plugin/search` や `/other-plugin/search`などのプラグイン修飾呼び出し名を使用して共存します。 修飾なしの名前は、優先度の高いプラグインに振り分けられます。 これはスキルにのみ適用されます。コマンドは、優先順位の高いソースが優先される Standard レベルベースの重複除去を維持します。 ### 非対話形式でのスキルのインストール `copilot plugins install --skill`を使用して、対話型セッションを開かずにファイル、URL、またはディレクトリからスキルをインストールします。 ```bash # Install for your user account (default scope) copilot plugins install --skill ./my-skill/SKILL.md # Install into the current project (.github/skills; file or URL skills only) copilot plugins install --skill --scope project ./my-skill/SKILL.md ``` ディレクトリをインストールすると、コピーするのではなく、カスタム スキル ソースとして登録されます。 ファイルまたは URL をインストールすると、スキルのコンテンツが個人またはプロジェクトのスキル ディレクトリにコピーされます。 同等の対話型コマンドが `/plugins install --skill [--project] `。 完全なオプション リファレンスについては、 [AUTOTITLE を](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference#copilot-plugins-install-options)参照してください。 ### コマンド (代替スキル形式) コマンドは、`.md`に個々の`.claude/commands/` ファイルとして格納されるスキルの代わりに使用できます。 コマンド名はファイル名から派生します。 コマンド ファイルは簡略化された形式 ( `name` フィールドは不要) を使用し、 `argument-hint`、 `description`、 `allowed-tools`、および `disable-model-invocation`をサポートします。 コマンドの優先順位は、同じ名前のスキルよりも低くなります。 ## カスタム エージェント リファレンス カスタム エージェントは、Markdown ファイルで定義されている特殊な AI エージェントです。 ファイル名 (拡張子を引いた値) がエージェント ID になります。 ファイル拡張子として `.agent.md` または `.md` を使用します。 ### 組み込みエージェント | エージェント | 既定のモデル | 説明 | | ----------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `code-review` | claude-sonnet-4.5 | ノイズに対する信号の比率が高いコードレビュー。 バグ、セキュリティの問題、およびロジック エラーの差分を分析します。 コードを変更しません。 | | `explore` | claude-haiku-4.5 | 高速なコードベース探索。 ファイルを検索し、コードを読み取り、質問に回答します。 300 語以下のフォーカスされた回答を返します。 並列で安全に実行できます。 | | `general-purpose` | claude-sonnet-4.5 | 複雑なマルチステップ タスク用のフル機能エージェント。 別のコンテキスト ウィンドウで実行されます。 | | `research` | claude-haiku-4.5 | 命令に基づいて完全な検索を実行します。 リポジトリ GitHub 検索し、ファイルをフェッチし、クレームを検証し、引用文献を使用して詳細な結果を報告します。 | | `rubber-duck` | 補完モデル | 補完的なモデルを使用して、提案、設計、実装、またはテストの建設的な批判を提供します。 弱点を特定し、改善を提案します。 「[ラバーダックエージェントについて](/ja/copilot/concepts/agents/copilot-cli/rubber-duck)」を参照してください。 | | `security-review` | claude-sonnet-4.5 | セキュリティに重点を置いたコード レビュー。 11 のカテゴリにわたる信頼性の高い脆弱性の変化を分析します。 悪用可能性の確信度が80%を超える問題にのみフラグを付けます。 重大度と信頼度スコアを報告します。 コードを変更しません。 | | `task` | claude-haiku-4.5 | コマンドの実行 (テスト、ビルド、リント)。 成功に関する簡単な概要を返し、失敗した場合は完全な出力を返します。 | ### カスタムエージェントのフロントマター フィールド | フィールド | タイプ | 必須 | 説明 | | ------------------------------------------ | --------- | --- | ------------------------------------------------------------------------------------------------------------------------------------ | | `description` | 文字列 | はい | エージェントの一覧と `task` ツールに表示される説明。 | | `infer` | ブーリアン | いいえ | メイン エージェントによる自動委任を許可します。 既定値: `true`。 | | `mcp-servers` | オブジェクト | いいえ | 接続する MCP サーバー。 | | `~/.copilot/mcp-config.json`と同じスキーマを使用します。 | | | | | `model` | 文字列 | いいえ | このエージェントの AI モデル。 設定を解除すると、外部エージェントのモデルが継承されます。 セッション モデルが `Auto` (サーバー選択) に設定されている場合、サブエージェントは、このフィールドに関係なく、解決されたセッション モデルを常に継承します。 | | `name` | 文字列 | いいえ | 表示名。 デフォルトはファイル名です。 | | `tools` | string\[] | いいえ | エージェントで使用できるツール。 既定値: `["*"]` (すべてのツール)。 | ### カスタム エージェントの場所 | Scope | 場所 | | --------------------------------------- | -------------------- | | プロジェクト | | | `.github/agents/` または `.claude/agents/` | | | User | `~/.copilot/agents/` | | プラグイン | `/agents/` | プロジェクト スコープのエージェントの場合、CLI は現在の作業ディレクトリから Git ルートに上向きに移動し、各先祖レベルで `.github/agents/` および `.claude/agents/` ディレクトリを読み込みます。 つまり、monorepo 内の各パッケージまたはサブディレクトリは、独自のエージェントを提供できます。 パスに複数の `.github/agents/` ディレクトリが存在する場合は、最も深いディレクトリが最も高い優先順位で、すべてが読み込まれます。 `.github/agents/`規則は、同じレベルの`.claude/agents/`よりも優先されます。 ユーザー レベルのエージェントの優先度は、プロジェクト レベルのエージェントよりも低くなります。 プラグイン エージェントの優先度は最も低くなります。 ### エージェント通信 カスタム エージェント内で `list_agents` と `write_agent` を使用して、近くのエージェントを検査し、マルチエージェント セッションで作業を調整します。 #### `list_agents` の関係ラベル 関係ラベルは、可視エージェントと現在のエージェントの関係を識別します。 共有兄弟通信が有効になっている親セッション内でサブエージェントが実行されると、ラベルが表示されます。 | Label | 意味 | この用途: | | ------------------------------- | ------------------------ | ------------------------------ | | `"self"` | 現在のエージェント | アクティブなエージェントを表すエントリを確認する | | `"sibling"` | 同じ親から起動されたエージェント | | | `write_agent` を介してピアエージェントと連携する | | | | `"child"` | 現在のエージェントによって起動されたエージェント | 現在のエージェントから委任されたフォローアップ作業を追跡する | #### スコープ付き一覧 ターゲットを選択する前に、`scope`で`list_agents`を使用してリストを絞り込む。 | `scope` 値 | 返品 | この用途: | | ------------ | -------------------- | --------------------------- | | 省略 | 現在のコンテキスト内の近くのエージェント | 現在のワークフローの既定のワーキング セットを確認する | | `"siblings"` | 兄弟エージェントのみ | 同じ親によって起動されたピア エージェントを検索する | | `"children"` | 現在のエージェントの子エージェントのみ | 現在のエージェントから委任された作業を確認する | | `"all"` | 表示されているすべてのエージェント | 調整に使用せずにセッション ツリー全体を検査する | 単一エージェント セッションでは、既定のビューは子エージェントを中心としています。 マルチエージェント セッションでは、既定のビューには、ツリー全体ではなく、即時のローカル コンテキストが表示されます。 ```text list_agents(scope="siblings") list_agents(scope="children") list_agents(scope="all") ``` #### スコープ付きメッセージング `scope`の`write_agent`を使用して、1 つのメッセージを複数の関連エージェントにブロードキャストします。 共有兄弟通信が有効になっている親セッション内で実行されているサブエージェントからのみ、スコープ付きメッセージングを使用します。 最上位レベルのセッションでは、代わりに明示的な `agent_id` 値を持つエージェントをターゲットにします。 | `scope` 値 | ～に送信 | この用途: | | ------------ | --------------------- | ---------------------- | | `"siblings"` | 表示されているすべての兄弟エージェント | 共有セッションで共同作業を調整する | | `"children"` | 現在のエージェントのすべての子エージェント | 委任された作業に同じフォローアップを送信する | スコープが多すぎるエージェントと一致する場合、`write_agent`はエラーを返し、代わりに`agent_id`から明示的な`list_agents`値を要求します。 ```text write_agent(scope="children", message="Re-check your findings against the updated schema.") write_agent(scope="siblings", message="Post status when your current check completes.") write_agent(agent_id="explore-auth", message="Focus on token refresh flow and report only confirmed issues.") ``` ### サブエージェントの制限 CLI では、エージェントのランナウェイ生成を防ぐために、深度とコンカレンシーの制限が適用されます。 | 制限 | デフォルト | マックス | | ------- | ------ | ----- | | 最大深度 | `6` | `256` | | 最大同時実行数 | プランベース | `32` | **深度** は、互いに入れ子になっているエージェントの数をカウントします。 深度制限に達すると、最も内側のエージェントはサブエージェントをさらに生成できません。 **コンカレンシー** では、セッション ツリー全体で同時に実行されているサブエージェントの数がカウントされます。 制限に達すると、アクティブなエージェントが完了するまで、新しいサブエージェント要求が拒否されます。 既定のコンカレンシー制限は、 Copilot プランによって異なります。 | Plan | 最大同時実行数 | | ---------- | ------- | | 無料 / 教育 | `2` | | Pro/ Pro+ | `4` | | マックス | `8` | | ビジネス | `16` | | Enterprise | `32` | | 使用量ベースの課金 | `32` | 使用量ベースの課金ユーザーは、 `subagents.maxConcurrency` と `subagents.maxDepth` の設定でこれらの制限をオーバーライドできます。 ```json { "subagents": { "maxConcurrency": 16, "maxDepth": 10 } } ``` 有効な範囲外の値はクランプされます。 `maxConcurrency` は `32`で制限され、 `maxDepth` は `256`で制限されます。 使用量ベースの課金を使用しないプランでは、これらの設定は無視されます。 [構成ファイルの設定を](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)参照してください。 ## サイドキック エージェント サイドキック エージェントはバックグラウンドで自動的に実行され、セッションの受信トレイにコンテキストを発行します。 明示的に呼び出されるのではなく、セッション イベントに応答します。 `sidekick:` ブロックを任意のエージェント定義に追加して、それをサイドキック エージェントにします。 ```yaml --- name: Context Gatherer description: Gathers relevant context when the working directory changes sidekick: triggers: - session.context_changed - event: user.message limit: 1 behavior: persistent maxSendsPerTurn: 2 --- Gather useful context about the current repository and working directory. Summarize recent changes and any relevant project structure. ``` ### サイドキックの起動条件 `triggers` の各エントリは、回数に制限なく発生するイベント名のみの文字列、または `event` と省略可能な `limit` を持つオブジェクトのいずれかです。 | イベント | 説明 | | ------------------------- | --------------------------------------------------------------------- | | `user.message` | すべてのユーザー メッセージで実行されます。 | | `session.context_changed` | 作業ディレクトリ、リポジトリ、またはブランチが変更されたときに発生します (たとえば、 `cd` または Git ブランチの切り替え後)。 | | トリガーフィールド | タイプ | デフォルト | 説明 | | --------- | -------- | --------- | ----------------------------------------------------- | | `event` | `string` | 必須 | このエージェントを起動するセッション イベントの種類。 | | `limit` | `number` | Unlimited | このトリガーがセッションごとに発生する可能性がある最大回数。 設定する場合は正の整数にする必要があります。 | ### サイドキック構成フィールド | フィールド | タイプ | デフォルト | 説明 | | --------------------------------------------------------------- | -------- | ------------------------------------------------ | ------------------------- | | `triggers` | | | | | `string[]` または object\[] | 必須 | このエージェントを起動するセッション イベントの種類。 少なくとも 1 つのトリガーが必要です。 | | | `behavior` | `string` | `"restart"` | | | `"restart"`: 前の実行を取り消し、各トリガーで新たに開始します。 | | | | | `"persistent"`: 同じ有効期間の実行を維持し、再起動するのではなく、新しいメッセージを既存のループに配信します。 | | | | | `maxSendsPerTurn` | `number` | `1` | トリガーごとに許可される受信トレイへの送信上限数。 | | `"persistent"` モードでは、配信された各ユーザー メッセージがこの予算をリセットします。 | | | | `"restart"`動作は、ステートレス コンテキスト収集エージェントに適しています。 `"persistent"`動作は、ターン間で状態を蓄積するエージェントに適しています。 ## 権限承認応答 CLI で操作を実行するためのアクセス許可を求められたら、次のキーを使用して応答できます。 | 鍵 | 影響 | | --- | ------------------------------- | | `y` | この特定の要求を 1 回許可します。 | | `n` | この特定の要求を 1 回拒否します。 | | `!` | セッションの残りの部分に対して同様のすべての要求を許可します。 | | `#` | セッションの残りの部分について、同様の要求をすべて拒否します。 | | `?` | 要求に関する詳細情報を表示します。 | 完全なダイアログが表示されたら、次のオプションから選択することもできます。 | オプション | Scope | 固執 | | ----- | ----------- | ------------ | | ある時 | 1 回の使用 | なし | | この場所 | 手動でクリアされるまで | 場所ごとにディスクに保存 | | いつも | 永続的 | 構成ファイル | **この場所**オプションは、CLI が場所キー (Git ルートまたは現在のディレクトリ) を決定できる場合に表示されます。 承認はディスクに保持されるため、次回そのディレクトリで作業するときに、再度プロンプトを表示せずに同じアクセス許可が自動的に付与されます。 `/permissions reset`を使用して、現在のセッションのメモリ内承認をクリアします。 ## セキュリティ ### プラン モード `/plan` は、 Copilot CLI (コパイロット CLI) がコードベースを調査および分析できるが、プロジェクト ファイルの編集がブロックされる計画セッションを開始します。 Specifically: * **プロジェクト ファイルは保護されています。** ワークスペース内のファイルを変更するシェル コマンドの編集、修正プログラムの適用、または実行の試行は自動的にブロックされます。これはモデルに対する単なる提案ではなく、直接適用されるため、動作を選択するモデルに依存しません。 * **プラン自体は引き続き記述できます。** Copilot には、メモを保持し、計画の下書きを行う場所が必要であるため、独自のプライベート計画ワークスペース (確認して承認するプラン ファイルを含む) でファイルを作成および編集できます。 * **委任されたサブタスクも保護されます。** Copilotが質問の一部を調査するためにヘルパー セッションを開始した場合、そのヘルパーは同じ制限を継承し、プロジェクトも編集できません。 * **これは、保証ではなく、セーフティ ネットです。** この保護機能は、ファイルを変更しようとする明白で直接的な試みを検知するように設計されていますが、万全の防御策というわけではありません。 調査が過度に制限されないように意図的に許可されるものもあります。たとえば、効果を事前に明確に判断できないシェル コマンドや、接続した外部/MCP ツールの呼び出しなどです。 実際には、これはほとんど問題ではありませんが、プラン モードは、ディスク上の何も変更できないという絶対的な保証ではなく、"変更を適用する前にレビューが必要です" と考える必要があります。 プランに満足したら、プラン モードを終了することを承認し、 Copilot 実際の変更を行います。 ### コマンドの安全性分析 シェル コマンドは実行前に分析され、潜在的に危険なパターンを特定します。 * ファイルの削除 (`rm -rf`) * システムの変更 (`sudo`、 `chmod 777`) * ネットワーク流出 (機密性の高いパスを使用した `curl`) * 資格情報アクセス ( `.env`、SSH キーの読み取り) * 危険な変数 (たとえば、 `PATH=...`、 `LD_PRELOAD=...`) をオーバーライドするインライン環境変数の割り当て 危険度の高いコマンドでは、追加の警告が表示され、明示的な確認が必要です。 #### 環境変数の拒否リスト CLI は、それ以外の場合は読み取り専用コマンドでも任意のコードを実行するために利用できる環境変数のインライン割り当てをブロックします。 ブロックされるカテゴリは次のとおりです。 | Category | Examples | | ------------------------------------------------------------------------------------------------------------------- | -------- | | 動的リンカーの挿入 | | | `LD_*`、 `DYLD_*` (すべてのプレフィックス) | | | Git インデックス付き構成のオーバーライド | | | `GIT_CONFIG_COUNT`、 `GIT_CONFIG_KEY_*`、 `GIT_CONFIG_VALUE_*` (すべての `GIT_CONFIG_` プレフィックス) | | | Git 外部プログラム用フック | | | `GIT_EXTERNAL_DIFF`、`GIT_PROXY_COMMAND` | | | Git 設定ファイルの上書き | | | `GIT_CONFIG`、`GIT_CONFIG_GLOBAL`、`GIT_CONFIG_SYSTEM` | | | シェルの PATH ファイルとスタートアップ ファイル | | | `PATH`、`BASH_ENV`、`ENV` | | | 既存のブロック済み変数 | | | `PAGER`、`GIT_PAGER`、`GIT_EDITOR`、`VISUAL`、`EDITOR`、`GIT_SSH`、`GIT_SSH_COMMAND`、`GIT_ASKPASS`、`BROWSER`、`GH_BROWSER` | | ### `web_fetch` SSRF 対策 `web_fetch` ツールは、HTTP 要求を行う前に、サーバー側要求フォージェリ (SSRF) 保護を適用します。 * **プロトコル許可リスト**: `http://` および `https://` URL のみが許可されます。 `file://` その他のスキームは拒否されます。 * **IP ブロックリスト**: ループバック アドレス (`127.x.x.x`、 `::1`)、RFC-1918 プライベート範囲 (`10.x`、 `172.16–31.x`、 `192.168.x`)、クラウド メタデータ エンドポイント ( `169.254.169.254` など) への要求は、IP リテラル チェックと DNS 事前解決によってブロックされます。 * **自動リダイレクトなし**: `3xx` リダイレクトは自動的には実行されません。 リダイレクト ターゲット URL は、次の前に同じ IP ブロックリストに対して再検証されます。 開発中に `web_fetch` が `localhost` に到達できるようにするには (たとえば、ローカル ドキュメント サーバーの場合)、次の環境変数を設定します。 ```bash export COPILOT_WEB_FETCH_ALLOW_LOCALHOST=1 ``` ## OpenTelemetry の監視 Copilot CLI (コパイロット CLI) [では、OpenTelemetry (OTel](https://opentelemetry.io/)) を使用してトレースとメトリックをエクスポートできるため、エージェントの対話、LLM 呼び出し、ツールの実行、トークンの使用状況を把握できます。 すべてのシグナル名と属性は、 [OTel GenAI セマンティック規則](https://github.com/open-telemetry/semantic-conventions-genai/tree/main/docs/gen-ai/)に従います。 OTel は既定ではオフで、オーバーヘッドはゼロです。 次のいずれかの条件が満たされるとアクティブになります。 * `COPILOT_OTEL_ENABLED=true` * `OTEL_EXPORTER_OTLP_ENDPOINT` が設定されている * `COPILOT_OTEL_FILE_EXPORTER_PATH` が設定されている OTel 構成は、 VS Codeまたはエンタープライズ全体の `managed-settings.json` ファイルで設定することもできます。 [ ](https://code.visualstudio.com/docs/agents/guides/monitoring-agents#_enable-otel-monitoring)ドキュメントと VS Code で [OTel 監視を有効にする](/ja/copilot/reference/enterprise-managed-settings-reference)を参照してください。 ### OTel 環境変数 | Variable | デフォルト | 説明 | | ----------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------- | | `COPILOT_OTEL_ENABLED` | `false` | 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_EXPORTER_OTLP_PROTOCOL` | `http/json` | OTLP HTTP ワイヤ プロトコル: `http/json` または `http/protobuf`。 | | `otlp-http` エクスポーターにのみ適用されます。 | | | | `OTEL_EXPORTER_OTLP_TRACES_PROTOCOL` | — | | | `OTEL_EXPORTER_OTLP_PROTOCOL` をトレースに対してのみオーバーライドします。 | | | | `OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` | — | メトリックに対してのみ `OTEL_EXPORTER_OTLP_PROTOCOL` をオーバーライドします。 | | `OTEL_SERVICE_NAME` | `github-copilot` | リソース属性のサービス名。 | | `OTEL_RESOURCE_ATTRIBUTES` | — | コンマ区切りの `key=value` ペアとしての追加のリソース属性。 特殊文字にはパーセント エンコードを使用します。 | | `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` | `false` | 完全なプロンプトと応答のコンテンツをキャプチャします。 | | [コンテンツ キャプチャを](#content-capture)参照してください。 | | | | `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 呼び出しとツールの実行。 * **最上位レベルのセッション**と**サブエージェント呼び出し** (探索、タスクなど) の両方で、スパンの種類`INTERNAL` (インプロセス) が使用されます。プロバイダー向けの推論は、子`CLIENT``chat`スパンによって表されます。 * **最上位レベルのセッション** では、さらに `server.address` と `server.port`が実行されます。サブエージェント呼び出しでは実行されません。 | 特性 | 説明 | Scope | | ------------------------------------------ | ----------------------------------------------------------- | -------- | | `gen_ai.operation.name` | `invoke_agent` | 両方とも | | `gen_ai.provider.name` | プロバイダー (たとえば、 `github`、 `anthropic`) | 両方とも | | `gen_ai.agent.id` | 既知の場合は安定したエージェント定義識別子。最上位レベルの既定の使用 `github.copilot.default` | 両方とも | | `gen_ai.agent.name` | エージェント名 (使用可能な場合) | 両方とも | | `gen_ai.agent.description` | エージェントの説明 (使用可能な場合) | 両方とも | | `gen_ai.agent.version` | 既知のエージェント定義バージョン。それ以外の場合はランタイム バージョン | 両方とも | | `gen_ai.conversation.id` | セッション識別子 | 両方とも | | `enduser.pseudo.id` | 使用可能な場合、`analytics_tracking_id` からの仮名Copilotユーザー識別子 | 両方とも | | `gen_ai.request.model` | 要求されたモデル | 両方とも | | `gen_ai.response.finish_reasons` | | | | `["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` | サーバーのホスト名 | 最上位レベルのみ | | `server.port` | サーバー ポート | 最上位レベルのみ | | `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`。 | 特性 | 説明 | | ------------------------------------------ | ------------------------------------------ | | `gen_ai.operation.name` | `chat` | | `gen_ai.provider.name` | プロバイダー名 | | `gen_ai.request.model` | 要求されたモデル | | `gen_ai.request.stream` | ストリーミング モードが使用されたかどうか (ストリーミングのみ) | | `gen_ai.conversation.id` | セッション識別子 | | `gen_ai.response.finish_reasons` | 停止の理由 | | `gen_ai.response.id` | 応答 ID | | `gen_ai.response.model` | 解決済みモデル | | `gen_ai.response.time_to_first_chunk` | 最初のストリーミング チャンクまでの時間 (秒単位)(ストリーミングのみ) | | `gen_ai.usage.cache_creation.input_tokens` | キャッシュされたトークンの作成 | | `gen_ai.usage.cache_read.input_tokens` | キャッシュされたトークンの読み取り | | `gen_ai.usage.input_tokens` | このターンの入力トークン | | `gen_ai.usage.output_tokens` | このターンの出力トークン | | `github.copilot.cost` | 回転費用 | | `github.copilot.aiu` | このターンで使用された AI ユニット | | `github.copilot.server_duration` | サーバー側の期間 | | `github.copilot.initiator` | 要求開始者 | | `github.copilot.turn_id` | ターン識別子 | | `github.copilot.interaction_id` | 相互作用識別子 | | `server.address` | サーバーのホスト名 | | `server.port` | サーバー ポート | | `error.type` | エラー クラス名 (エラー時) | | `gen_ai.input.messages` | JSON としての完全なプロンプト メッセージ (コンテンツ キャプチャのみ) | | `gen_ai.output.messages` | JSON としての完全な応答メッセージ (コンテンツ キャプチャのみ) | | `gen_ai.system_instructions` | システム プロンプト コンテンツを JSON (コンテンツ キャプチャのみ) として | #### `execute_tool` スパン属性 ツール呼び出しごとに 1 つのスパン。 スパン種別: `INTERNAL`。 | 特性 | 説明 | | ---------------------------- | -------------------------------- | | `gen_ai.operation.name` | `execute_tool` | | `gen_ai.provider.name` | プロバイダー名 (使用可能な場合) | | `gen_ai.tool.name` | ツール名 (たとえば、 `readFile`) | | `gen_ai.tool.type` | `function` | | `gen_ai.tool.call.id` | ツール呼び出し識別子 | | `gen_ai.tool.description` | ツールの説明 | | `error.type` | エラー クラス名 (エラー時) | | `gen_ai.tool.call.arguments` | JSON としてのツール入力引数 (コンテンツ キャプチャのみ) | | `gen_ai.tool.call.result` | JSON としてのツール出力 (コンテンツ キャプチャのみ) | ### Metrics #### GenAI 慣例メトリック | メトリクス | タイプ | 単位 | 説明 | | ----------------------------------------------- | ------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `gen_ai.client.operation.duration` | ヒストグラム | s | LLM API 呼び出しとエージェント呼び出し期間 | | `gen_ai.client.token.usage` | ヒストグラム | tokens | 種類別のトークン数 (`input`/`output`) | | `gen_ai.client.operation.time_to_first_chunk` | ヒストグラム | s | 最初のストリーミング チャンクを受信する時間 | | `gen_ai.client.operation.time_per_output_chunk` | ヒストグラム | s | 最初のチャンク後のチャンク間のレイテンシー | | `gen_ai.invoke_agent.inference_calls` | ヒストグラム | `{inference_call}` | 1 つのエージェント呼び出し中に行われたモデル呼び出しの数。プロバイダーのディスパッチ時にカウントされます (失敗した呼び出しと部分的な呼び出しが含まれます。ディスパッチ前にブロックされた要求は除外されます)。 ディメンション: `gen_ai.agent.name`。 | | `gen_ai.invoke_agent.tool_calls` | ヒストグラム | `{tool_call}` | 1 つのエージェント呼び出し中に行われたクライアント側ツール呼び出しの数 (失敗した呼び出しと部分的な呼び出しが含まれます。合成 CLI ツールのライフサイクルとプロバイダーによって実行されるサーバー側ツールは除外されます)。 ディメンション: `gen_ai.agent.name`。 | #### ベンダー固有のメトリック | メトリクス | タイプ | 単位 | 説明 | | -------------------------------------------- | ------ | ----- | -------------------------------- | | `github.copilot.tool.call.count` | カウンタ | calls | | | `gen_ai.tool.name` および `success` によるツールの呼び出し | | | | | `github.copilot.tool.call.duration` | ヒストグラム | s | | | `gen_ai.tool.name` によるツールの実行待機時間 | | | | | `github.copilot.agent.turn.count` | ヒストグラム | 回転 | エージェント呼び出しごとの LLM ラウンドトリップ | | `github.copilot.mcp.server.connection.count` | カウンタ | 試み | トランスポート別および結果別の完了した MCP サーバー接続試行 | | `github.copilot.code.lines_added` | カウンタ | 台詞 | ファイル編集ツールによって追加され、リアルタイムで記録された行 | | `github.copilot.code.lines_removed` | カウンタ | 台詞 | リアルタイムで記録されたファイル編集ツールによって削除された行 | ### Span イベント アクティブな `chat` または `invoke_agent` スパンに記録されたライフサイクル イベント。 | イベント | 説明 | キー属性 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ----------------------------- | | `github.copilot.hook.start` | フックの実行が開始されました | | | `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` | | | ### リソース属性 すべてのシグナルには、これらのリソース属性が含まれます。 | 特性 | 価値 | | ----------------------------------------------- | ----------- | | `service.name` | | | `github-copilot` ( `OTEL_SERVICE_NAME`を介して構成可能) | | | `service.version` | ランタイム バージョン | ### コンテンツ キャプチャ 既定では、プロンプトコンテンツ、応答、またはツール引数はキャプチャされません。モデル名、トークン数、期間などのメタデータのみがキャプチャされます。 完全なコンテンツをキャプチャするには、 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`設定します。 > \[!WARNING] > コンテンツ キャプチャには、コード、ファイル コンテンツ、ユーザー プロンプトなどの機密情報が含まれる場合があります。 これは、信頼できる環境でのみ有効にします。 コンテンツ キャプチャを有効にすると、次の属性が設定されます。 | 特性 | Content | | ---------------------------- | ----------------------- | | `gen_ai.input.messages` | 完全な JSON プロンプト メッセージ | | `gen_ai.output.messages` | 完全な応答メッセージ (JSON) | | `gen_ai.system_instructions` | システム プロンプト コンテンツ (JSON) | | `gen_ai.tool.definitions` | ツール スキーマ (JSON) | | `gen_ai.tool.call.arguments` | ツールの入力引数 | | `gen_ai.tool.call.result` | ツール出力 | ## 詳細については、次を参照してください。 * [GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli) * [GitHub Copilotフックリファレンス](/ja/copilot/reference/hooks-reference) * [GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference) * [GitHub Copilot CLI プログラムリファレンス](/ja/copilot/reference/copilot-cli-reference/cli-programmatic-reference) * [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference)