# GITHUB COPILOT CLI コマンド リファレンス Copilot CLIを効果的に使用するのに役立つコマンドとキーボード ショートカットを見つけます。 ## コマンドラインコマンド | 命令 | Purpose | | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `copilot` | 対話型ユーザー インターフェイスを起動します。 | | `copilot app` | 現在のディレクトリで GitHub Copilot app を開き、新しいセッションに直接ディープ リンクします。 ディープ リンクを処理できない場合は、ブラウザーでアプリのダウンロード ページを開くことにフォールバックするか、使用できるブラウザーがない場合は手動で開く URL を出力します。 | | `copilot completion SHELL` | | | Copilot CLIのタブ補完を有効にするために使用できる、選択したシェルのシェル スクリプトを印刷します。 サポートされているシェル: `bash`、 `zsh`、 `fish`。 | | | \[ | | | `copilot completion`の使用]\(#using-copilot-completion)を参照してください。 | | | `copilot config [KEY] [VALUE]` | 対話型セッションの外部で、コマンド ラインから Copilot 設定を読み取ったり変更したりします。 | | \[ | | | `copilot config`の使用]\(#using-copilot-config)を参照してください。 | | | `copilot help [TOPIC]` | ヘルプ情報を表示します。 ヘルプ トピックには、 `billing`、 `config`、 `commands`、 `environment`、 `logging`、 `monitoring`、 `permissions`、 `providers`、 `sandbox`などがあります。 | | `copilot init` | このリポジトリ Copilot カスタム命令を初期化します。 | | `copilot login [OPTION]` | OAuth を使用して Copilot で認証します。 | | \[ | | | `copilot login`オプション]\(#copilot-login-options)を参照してください。 | | | `copilot mcp` | コマンド ラインから MCP サーバー構成を管理します。 | | `copilot memories import FILE` | 準備されたメモリを JSONL ファイルからインポートします。 | | [メモリのインポート](#importing-memories)を参照してください。 | | | `copilot plugin` | 一覧表示、有効化、無効化、アンインストールなど、プラグインとプラグイン マーケットプレースを管理します。 | | `copilot plugins`（複数形）はレガシー エイリアスです。 「[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference)」を参照してください。 | | | `copilot instruction` | 現在の作業ディレクトリで検出されたカスタム命令ソースを対話形式で一覧表示しない。 | | \[ | | | `copilot instruction`の使用]\(#using-copilot-instruction)を参照してください。 | | | `copilot lsp` | 非対話形式で構成された言語サーバーを一覧表示します。 | | \[ | | | `copilot lsp`の使用]\(#using-copilot-lsp)を参照してください。 | | | `copilot sandbox ca` | 対話型セッションの外部からサンドボックスのプロキシ証明機関を管理します。 | | \[ | | | `copilot sandbox ca`の使用]\(#using-copilot-sandbox-ca)を参照してください。 | | | `copilot skill` | コマンド ラインからエージェント スキルを管理します (スキルの一覧表示、追加、削除、有効化、無効化)。 | | [非対話形式でのスキルの管理を](#managing-skills-non-interactively)参照してください。 | | | `copilot update` | 最新バージョンをダウンロードしてインストールします。 | | `copilot version` | バージョン情報を表示し、更新プログラムを確認します。 | | `copilot workflow run WORKFLOW-NAME` | チャット プロンプトを送信せずに、既存の動的ワークフローを直接実行します。 実行が完了または停止するまで待機します。 | | \[ | | | `copilot workflow run`の使用]\(#using-copilot-workflow-run)を参照してください。 | | ### `copilot login` のオプション | オプション | Purpose | | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | `--host HOST` | | | GitHub ホスト URL (既定値: `https://github.com`)。 これを使用して、データ所在地 (たとえば、GitHub Enterprise Cloud) を使用する`https://example.ghe.com` インスタンスで認証します。 | | | `--web-flow` | ブラウザー ベース (Web) 認証フローを強制します。これは、ローカル ターミナルの既定値です。 | | `--device-code` | OAuth デバイス コード フローを強制します。これは、リモート ターミナルまたは CI の既定値です。 | | `--with-token` | OAuth フローを開始するのではなく、標準入力から認証トークンを読み取ります。 標準入力がターミナルの場合、入力をエコーせずにプロンプトを表示します。 | | `--web-flow`と`--device-code`との競合。 | | ローカル ターミナル、またはブラウザーにまだ到達できる TTY 以外のローカル プロセス (ディスプレイまたはブラウザー信号を含むデスクトップ OS、Linux など) では、既定の認証モードはブラウザーベースの Web フローです。CLI はブラウザーを開いて承認し、ローカル ループバック コールバックで結果をキャプチャします。 リモート ターミナル (SSH、 GitHub Codespaces、開発コンテナーなど) または CI では、ブラウザーが通常ループバック ポートに到達できないため、CLI は既定で OAuth デバイス コード フローに設定されます。 `--web-flow`または`--device-code`を使用して、自動的に選択されたフローをオーバーライドします。 完了後、認証トークンはシステム資格情報ストアに安全に格納されます。 資格情報ストアが見つからない場合、トークンは、 `~/.copilot/` (または設定されている場合は `COPILOT_HOME` によって指定されたディレクトリ) の下のプレーン テキスト構成ファイルに格納されます。 または、 Copilot 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 # Force the device code flow, for example on a remote terminal copilot login --device-code # Force the browser (web) flow, for example on a local terminal copilot login --web-flow # Read a token from standard input, bypassing the OAuth flow entirely copilot login --with-token < mytoken.txt # Use a fine-grained PAT via environment variable COPILOT_GITHUB_TOKEN=github_pat_... copilot ``` ### `copilot completion` の使用 コマンド `copilot completion SHELL` は、指定されたシェル (bash、zsh、または fish) のスクリプトを出力します。 このスクリプトを利用する (またはシェルの補完ディレクトリに書き込む) と、`copilot` のサブコマンド、コマンドオプション、コマンドオプションの既知の値を選択する際のターミナルでのタブ補完を有効にすることができます。 `copilot config`の場合、補完では、キーの設定、ブール値と列挙値、ならびにパス値の設定用のファイルまたはディレクトリも対象となります。 #### 使用例 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 plugin`を使用して、対話型セッションを開かずに、コマンド ラインからプラグインのインストール、一覧表示、更新、有効化、無効化、アンインストールを行います。 `copilot plugins` (複数形) は、同じコマンドのレガシ エイリアスです。 コマンドとオプションの完全なリファレンスについては、 [AUTOTITLE を](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference)参照してください。 ### `copilot config` の使用 `copilot config`を実行して、対話型セッションの外部にあるコマンド ラインからCopilot設定を読み取って変更します。 これは、`/settings`（または `/config`）スラッシュ コマンドの非対話型の対応物です。 設定ファイルとそのキーの詳細については、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#settingsjson) を参照してください。 ```bash # Print a setting copilot config theme # Set a nested value (dot notation) copilot config footer.showQuota off # Append an item to a list setting (added only if not already present) copilot config allowedUrls github.com # Append an item that starts with a dash copilot config powershellFlags -- -NoProfile # Remove a key, or one list item copilot config --rm theme copilot config --rm allowedUrls github.com # List settings as key=value lines, or as JSON copilot config --list copilot config --repo --list --json ``` | オプション/引数 | 説明 | | ------------------------------ | ------------------------------------------------------------------------------- | | `KEY` | ドット表記でキーを設定します (例: `footer.showQuota`)。 | | `VALUE` | | | `--rm`を使用してリストに設定、追加、または削除する値。 | | | `--list` | 設定を `key=value` 行として一覧表示します。 `KEY`/`VALUE`/`--rm`と競合します。 | | `--json` | JSONとして`--list`を出力します。`--list`が必要です。 | | `--rm` | キー、またはリストから指定された項目のみを削除します。この操作には `KEY` が必要です。 | | `--global` | ユーザー設定ファイル (既定) を使用しますが、`--repo`/`--local`と競合しています。 | | `--repo` | リポジトリの`.github/copilot/settings.json`を使用してください。`--global`/`--local`と競合します。 | | `--local` | リポジトリの`.github/copilot/settings.local.json`を使用してください。`--global`/`--repo`と競合します。 | 値は、設定の型 (ブール値の `on`/`off` または `true`/`false` 、数値設定の数値、または列挙型に対して受け入れられる選択肢) と一致する必要があります。 リストの読み取りでは、1 行に 1 つの項目が出力されます。グループの読み取りでは JSON が出力されます。 未設定のキーではステータス `1` で終了します。 シークレット値は出力から伏せ字にされます。 コマンドでは、既定でユーザー設定ファイル (`$COPILOT_HOME` 内の `~/.copilot`、または設定されている場合は `settings.json` 内) が使用されます。 `--repo` と `--local` は、リポジトリがオーバーライドできる設定のみを受け入れます。[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson) を参照してください。 `copilot help config` を実行して、使用可能な設定を確認します。 ### `copilot instruction` の使用 `copilot instruction list` を実行して、現在の作業ディレクトリで検出されたカスタム指示ソースを非対話的に一覧表示します。 これにより、廃止された `copilot plugins list --kind instruction`が置き換えられます。 ```bash copilot instruction list copilot instruction list --json ``` | オプション | 説明 | | -------------------------- | ----------------------------------------- | | `--json` | テキストの代わりに JSON を出力します。 | | `--config-dir=DIRECTORY` | 構成ディレクトリへのパス。 このオプションは非推奨です。 | | `COPILOT_HOME` を代わりに使用します。 | | 各 `--json` エントリは `{ id, label, description?, location, type, sourcePath, defaultDisabled, applyTo? }` の形式です。 この一覧では、プラグインによって提供された命令がグローバル ユーザー設定に対してのみ解決されます。ライブ セッションが適用されている場合でも、信頼できるリポジトリまたはマネージド設定によって有効になっている命令がここに表示されない可能性があります。 ### `copilot lsp` の使用 `copilot lsp list` を実行して、設定済みの言語サーバーを非対話的に一覧表示します。 これにより、廃止された `copilot plugins list --kind lsp`が置き換えられます。 このコマンドは検査専用です。対話型セッションで `/lsp` スラッシュ コマンドを使用して、言語サーバーを起動、停止、または再読み込みします。 ```bash copilot lsp list copilot lsp list --json ``` | オプション | 説明 | | -------------------------- | ----------------------------------------- | | `--json` | テキストの代わりに JSON を出力します。 | | `--config-dir=DIRECTORY` | 構成ディレクトリへのパス。 このオプションは非推奨です。 | | `COPILOT_HOME` を代わりに使用します。 | | 各 `--json` エントリは `{ id, fileExtensions?, sourcePlugin? }` の形式です。 カスタム エージェントとセッション スコープのフックは、 `copilot instruction`、 `copilot lsp`、 `copilot plugin`、 `copilot mcp`、または `copilot skill`ではカバーされません。 すべてライブ セッションが必要です。 ### 思い出のインポート `copilot memories import`を使用して、JSONL ファイルからユーザー レベルの基本設定とリポジトリ レベルのファクトを検証およびインポートします。 ```shell copilot memories import PATH-TO-FILE ``` | オプション | 説明 | | --------------------------- | --------------------------------------------- | | `--dry-run` | 認証やメモリの送信を行わずに、完全なファイルを検証します。 | | `--on-conflict skip\|error` | 競合するレコードをスキップするか、エラーとして扱います。 既定値は `error` です。 | | `--output json` | 人間が判読できるテキストではなく、JSON としてインポート結果を返します。 | スキーマの検証に失敗した行がある場合、レコードは送信されません。 検証が成功すると、レコードが個別に送信されるため、サービスのエラーによって部分的なインポートが発生する可能性があります。 レコードごとの結果を確認し、失敗したレコードのみを再試行してください。 `--on-conflict skip` オプションは、入力ファイル内の重複 ID と、メモリ サービスによって報告された競合をスキップします。 インポートを繰り返してもメモリの重複が回避されるという保証はありません。 ファイル形式と例については、 [GitHub Copilotのメモリを手動で作成する](/ja/copilot/how-tos/use-copilot-agents/copilot-memory/create-memories#importing-memories-with-copilot-cli) を参照してください。 ### `copilot workflow run` の使用 対話型セッションを開かずに、拡張機能によって提供される動的ワークフローを実行します。 ```shell copy copilot workflow run WORKFLOW-NAME [OPTIONS] ``` `WORKFLOW-NAME` は拡張機能によって登録された名前であり、拡張ファイルへのパスではありません。 コマンドは実行を開始し、実行の完了、一時停止、または停止を待機します。 | オプション | 説明 | | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `--args JSON` または `--args @PATH` | ワークフローの入力を指定します。 ここで "JSON" をインライン JSON に置き換えるか、"PATH" を UTF-8 JSON ファイルへのパスに置き換えます。 省略すると、既定値は `{}` になります。 受け入れられる入力はワークフローによって異なります。 | | `--result-file PATH` | 返された値を標準出力に含めるのではなく、JSON としてファイルに書き込みます。 ワークフローが完了し、結果を返した場合にのみ書き込まれます。 既存のファイルは、新しい結果が正常に書き込まれた後にのみ置き換えられます。 | | `-s`、`--silent` | 進行状況の出力を抑制します。 最終結果は、ファイルへの出力が指定されない限り、出力されます。 エラーと状態の診断は、引き続き標準エラーに表示される場合があります。 | | `--output-format FORMAT` | 標準出力形式を `text` (既定) または `json` (JSONL、1 行に 1 つの JSON レコード) に設定します。 | | `json`と`--silent`を組み合わせて、最終的なワークフロー レコードのみを受け取ります。 | | | `--result-file`の JSON 形式は変更しません。 | | 相対引数ファイルと結果ファイルのパスは、作業ディレクトリから解決されます。 `--silent`しない場合、出力には、ワークフローによって報告されたフェーズと進行状況メッセージが含まれます。 このコマンドでは、CLI の認証、モデル、アクセス許可、サンドボックスの設定が使用されます。 `--allow-tool` や `--allow-url` などの権限オプションは、ワークフローのエージェントに適用されます。 アクセス許可の承認プロンプトは表示されません。 プロンプトとセッション モードのオプションをこのコマンドと組み合わせることはできません。 例としては、`-p`、`-i`、`--agent`、`--fleet`、`--autopilot`、`--resume`、`--continue`があります。 パイプ標準入力は、プロンプトまたはワークフロー引数として使用されません。 詳細については、「[動的ワークフローの使用](/ja/copilot/how-tos/use-copilot-agents/use-dynamic-workflows#running-a-dynamic-workflow-from-the-command-line)」および「[GitHub Copilot CLI プログラムリファレンス](/ja/copilot/reference/copilot-cli-reference/cli-programmatic-reference#running-dynamic-workflows)」を参照してください。 ### `copilot sandbox ca` の使用 `copilot sandbox ca`を実行して、対話型セッション外でサンドボックスのプロキシ証明機関を管理します。たとえば、TTY なしでマネージド デバイスをプロビジョニングする場合などです。 これは、`/sandbox ca` スラッシュ コマンド (`create`、`trust`、`rotate`、`remove`) と `status` チェックを再現します。 ```bash copilot sandbox ca status copilot sandbox ca create copilot sandbox ca trust copilot sandbox ca rotate copilot sandbox ca remove ``` | サブコマンド | 説明 | | ----------------------------------- | ------------------------------------------ | | `copilot sandbox ca status` | 何も変更せずに信頼状態を報告してください。 | | `copilot sandbox ca create` | 必要に応じて、信頼せずに認証局を作成します。 | | `copilot sandbox ca trust [CA.PEM]` | 認証局 (既定: 独自) を OS の信頼ストアに追加します。 | | `copilot sandbox ca rotate` | 現在の信頼状態を維持して、認証局を置き換えます。 | | `copilot sandbox ca remove` | OS の信頼から信頼された認証局を削除します。バンドルベースのパスは動作し続けます。 | これらのコマンドは、管理者特権で実行したり、`SYSTEM` や `root` として実行したりするのではなく、Copilot CLI を実行するユーザーとして実行します。これは、証明機関がそのユーザーの Copilot CLI ホーム ディレクトリに格納されるためです。 無人セットアップガイダンスのために `copilot sandbox ca trust --help` を実行してください。 `--config-dir` (または `COPILOT_HOME`)は、CLI の残りの部分と同じように、これらのコマンドの既定以外の Copilot CLI ホームディレクトリを対象とします。 ## セッションのサイドバー セッションサイドバーは、現在の会話の横にドッキングされたパネルであり、ローカルの GitHub Copilot CLI セッションを簡単に操作できます。 サイドバーにフォーカスがある場合は、次のキーボード ショートカットを使用できます。 | Shortcut | Purpose | | ----------------------------- | --------------------------------------------------------------------------------------------------- | | ← | 会話からサイドバーを開き、その中にフォーカスを移動します (Vim: `h`)。 | | → | フォーカスを会話に戻す。もう一度押してサイドバーを閉じます (Vim: `l`)。 | | ↑/↓ | サイドバー内のセッション間を移動します ( `k`/`j`も)。 | | を入力 | 選択したセッションを開き、会話にフォーカスを戻します。 | | `n` | 新しいセッションを開始します。 | | `x` 2回 | 選択したセッションを閉じます。 | | ↑、次にTab | セッション一覧の上部から、 ↑ はヘッダー ボタンに移動します (**サイドバーを** 閉じる←、新しいセッション **+** )。 タブ が切り替わる。 | | `?` | サイドバーのヘルプを表示します。 | サイドバーもマウスに応答します。 | ジェスチャ | Purpose | | ------------------------------------- | --------------------------------------------- | | セッションをクリックする | そのセッションに切り替えて、会話に戻ります。 | | セッションをダブルクリックする | そのセッションに切り替え、サイドバー表示のままにします。 | | 分割線をドラッグする | サイドバーのサイズを変更します。 | | サイドバーをポイントしてスクロールする | セッションの一覧をスクロールします。 | | ヘッダーのボタンをクリックします | | | **←**でサイドバーを閉じる、**+** で新しいセッションを開始する。 | | | セッションの右側にマウス ポインターを合わせる | 閉じるボタンを表示します ( `sidebar.showCloseButton`が必要)。 | ### セッション状態インジケーター サイドバーの各セッションには、現在の状態のインジケーターが表示されます。 | インジケーター | 意味 | | ------------ | ------------------------------------------------------------------------ | | 緑の `●` (安定) | セッションはアイドル状態です。 次のプロンプトが表示されるのを待ちます。 | | 紫 `●`（脈動） | ターンは飛行中です。 エージェントはアクティブに動作しています。 | | 青い `●` (安定) | 別のセッションを開いている間にエージェントがターンを完了しており、その後まだ開いていません。 セッションを開くと、この未読状態がクリアされます。 | | 黄色の `●` (安定) | エージェントがエラーで停止したか、それ以外の場合は注意が必要です。 | | 灰色 `○` (安定) | 再開可能なセッション。 保存されますが、現在は実行されていません。 | | 黄色 `!` | セッションを続行するには、アクセス許可が必要です。 | | 黄色 `?` | セッションでは、ユーザーが質問に回答したり、選択したりするのを待ちます。 | 上記の色名はガイドです。 正確な色合いは、ターミナルの配色と、 `/theme`で設定したテーマによって異なります。 たとえば、 `github` テーマでは独自の固定色が使用され、 `colorblind` テーマでは緑と赤の代わりに青と黄色が使用されます。 フル カラーサポートのない端末では、ドットはターミナル独自の緑、青、黄色を使用します。 上記の名前の色は、既定のチャット モードに関連します。 プラン モードとオートパイロット モードでは、一部のドットの濃淡が異なります。 セッション名のテキストの色も、これらのモードで変更されます。 端末、テーマ、モードで色が変わる可能性があるため、安定したまたは脈動する形状と、 `!`、 `?`、および `○` マーカーが最も信頼性の高い手掛かりになります。 ### セッションサイドバーの設定 対話型 CLI セッションで `/settings sidebar` スラッシュ コマンドを使用して、セッション サイドバーのこれらの設定を調整します。
Setting 説明 デフォルト
sidebar.enabled セッションサイドバーの表示を許可します。 On
sidebar.showResumableSessions サイドバーには、再開できる以前のセッションが含まれています。 offに設定すると、アクティブなセッションのみが一覧表示されます。 この設定の変更は、次回 Copilot CLI が開始されるときに有効になります。 On
sidebar.showHeaderButtons サイドバー上部に、サイドバーを折りたたむための (←+) ボタンと新しいセッションを開始するための () ボタンの列を表示します。 On
sidebar.showCloseButton X をクリックする代わりに、サイドバーのセッションの右側にマウスを置くと、閉じるセッション ボタンが表示されます。 これをクリックし、もう一度クリックして確定します。 セッションがまだ実行されていたかどうかにかかわらず、セッションは完全に削除されます。 この方法で削除されたセッションを再開することはできません。 オフ
sidebar.hoverFocus フォーカスは、マウス ポインターの場所に応じて、メイン CLI タブからサイドバーに変わります。 オフ
sidebar.coloredHints サイドバーが開き、会話がフォーカスされている間は、サイドバーのアクセントカラーに サイドバーの使用 ヒントを表示して注意を促します。 オフにすると、他のヒントと同じ色が使用されます。 サイドバーが閉じている間は、他のヒントと同じ色が常に使用されます。 On
sidebar.accentActiveSession サイドバーのセッション選択の強調表示を変更します。 オンにすると、会話で現在開いているセッションがメイン強調表示されます。 キーボードの上下の矢印 (またはマウス) で選択されたセッションをオフにすると、メインの強調表示が表示されます。 On
セッション サイドバーの詳細については、「 [複数の GitHub Copilot CLI セッションを扱う](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/work-with-multiple-sessions)」を参照してください。 ## 対話型インターフェイスのグローバル ショートカット | Shortcut | Purpose | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `@ FILENAME` | コンテキストにファイルの内容を含めます。 | | `# NUMBER` | | | GitHubの問題またはプル要求をコンテキストに含めます。 | | | `! COMMAND` | | | Copilotをバイパスして、ローカル シェルでコマンドを実行します。 空のプロンプト `!` 単独で入力して、複数のシェル コマンドを順番に実行するためのシェル モードに入ります。 シェル モードを終了するには、空のプロンプトで Esc キーまたは Ctrl+キーを押します。 | | | `$` | プロンプトで 1 つの`$`を入力し、Enter キーを押して、セッションの作業ディレクトリをルートにした実際の対話型シェル (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 回押します。 ローカル セッションで、モデルがターンへの応答をまだ開始していない場合、2 回目の押すと、編集用のプロンプト がプロンプト ボックスに再び表示されます。 | | Ctrl+C | 操作の取り消し/入力のクリア。 2 回押して終了します。 | | Ctrl+ | シャットダウンする | | + | 外部エディター (`$EDITOR`) でプロンプトを編集します。 | | + | 画面をクリアします。 | | + または Ctrl+ | エージェントが忙しいときに送信するメッセージをキューに入れます。 | | + | コマンド履歴を逆検索します。 | | Ctrl+スペース | 音声入力のオン/オフを切り替える（Ctrl+X を押してから `v` と同じ）。 これは、ターミナルと OS がそれを通過する場合にのみ機能します。 OS またはターミナル キーのバインドでこれを解放する必要がある場合があります。 代わりに Ctrl+X キーを使用し、`v`します。 | | Ctrl+ | クリップボードから添付ファイルとして貼り付けます。 | | Alt+V | クリップボードの画像を添付ファイルとして貼り付けます。 | | + | プロンプトの入力を開始すると、スラッシュ コマンドを実行できます。たとえば、プロンプトを再入力せずにモデルを変更する場合などです。 | | + | 外部エディター (`$EDITOR`) でプロンプトを編集します。 | | + | 実行中のタスクまたはシェル コマンドをバックグラウンドに昇格させます。 | | + | オートパイロット目標パネルを折りたたむか展開します。 | | + | 現在のセッション サイドバーを非表示にします。 | | + | タイムラインから最新のリンクを開きます。 | | + | 音声ディクテーションのオンとオフを切り替えます。 | | + | 現在のセッションを閉じます。 | | Ctrl + + | プロセスをバックグラウンドで中断します (Unix)。 | | + または Option+ (Mac) / Alt+ (Windows/Linux) | 入力に改行を挿入します。 | | Shift+タブ | 標準モード、プラン モード、オートパイロット モードの間を循環します。 | ローカル セッションでは、プロンプト、シェル コマンド、およびサポートされているスラッシュ コマンドをキューに入れ、現在のタスクの完了後に順番に実行できます。 Ctrl+Q キーを押すと、エージェントの実行中に現在の入力をキューに追加できます。 キューに登録されたエントリには "保留中" のラベルが表示され、実行前に個別に取り消すことができます。 プロンプト ボックスが空の状態で ↑ キーを押すと、直近でキューに追加されたプロンプトまたはステアリングプロンプトが、再送信前に編集できるようプロンプト ボックスに呼び戻されます。 これが利用可能な場合、キューの横に "recall" ヒントが表示されます。 送信されたコマンド履歴の非破壊的ナビゲーションには、代わりに Ctrl+Pを使用します。 ローカル セッションで、送信されたプロンプトで Esc キーを 2 回押し、そのターンでモデルが応答を開始していない場合、プロンプトがプロンプト ボックスに戻り、会話から削除されます。 モデルが既に応答を開始している場合、同じ 2 回目の Esc キーを押すと、実行中のターンが中断されます。 その後、空のプロンプト ボックスで ↑ キーを押すと、プロンプト がプロンプト ボックスに戻ります。 ## 対話型インターフェイスのタイムライン ショートカット | Shortcut | Purpose | | ----------------------------------- | --------------------------------------------------------------- | | + | タイムライン検索を開きます。 | | Ctrl+ + O | プロンプト入力には何もありませんが、これにより、 Copilotの応答タイムラインの最近の項目が展開され、詳細が表示されます。 | | Ctrl+E | プロンプト入力には何もありませんが、これにより、 Copilotの応答タイムライン内のすべての項目が展開されます。 | | Ctrl+T | 応答内の推論の表示を展開/折りたたむ。 | | ページアップ/ページダウン | タイムラインを 1 ページ上または下にスクロールします。 | ## \[タスク] ダイアログのショートカット タスク ダイアログが開いている場合 ( `/tasks`を使用して開きます): | Shortcut | Purpose | | ------------------------- | ------------------------------------------------------ | | ↑/K | 選択範囲を上に移動します。 | | ↓/J | 選択範囲を下に移動します。 | | を入力 | タスクの詳細を表示するか、選択したサブエージェント独自のセッション ビューにテレポートします。 | | `a` | すべてのネストされたサブエージェント レベルを表示するか、このレベルのタスクのみを表示するかを切り替えます。 | | `f` | アクティブなサブエージェントだけでなく、完成したサブエージェントとシェルの表示を切り替えます。 | | X | 選択したアクティブなタスクを強制終了します。 | | R | 選択した完了したタスクを削除します。 | | B | 選択した同期タスクをバックグラウンドに昇格させます。 | | Esc | ダイアログを閉じます (または一覧に戻ります)。 | さらに入れ子のサブエージェントを生成したサブエージェントは、インデントされたツリーとして表示されます。移動先の行は「current」として強調表示されます。 サブエージェントのビューにドリルインすると、メイン セッションと同じように、プロンプト ボックスからステアリング メッセージを送信できます。 ## 中断されたセッションの復元 クラッシュやマシンの再起動などの理由で、CLI プロセスが終了してもセッションがまだ開いていた場合、次回の `copilot` スタートアップで復元を提供できるため、代わりにどのセッションを元に戻すか、新たに開始するかを選択できます。 エージェントが途中ターンだったセッションは、復元されるとその作業を自動的に再開します。 この復元動作は、スタートアップ ダイアログが再び作成されている間、一時的にオプトインされます。 `COPILOT_ENABLE_INTERRUPTED_SESSION_RESTORE`環境変数を`1`に設定して有効にします。 「[環境変数](#environment-variables)」を参照してください。 ## セッション ピッカーのショートカット セッション ピッカーが開いている場合 ( `/resume` または `--continue`を使用して開きます)。 | Shortcut | Purpose | | ------------------------- | -------------------------------- | | ↑/↓ | 選択範囲を上下に移動します。 | | を入力 | 選択したセッションを開きます。 | | `s` | 並べ替え順序を循環させます。関連性→作成日時→名前→最後に使用。 | | タブ | ローカル タブとリモート タブを切り替えます。 | | `x` | 選択したセッションを削除します。 | | Esc | ピッカーを閉じます。 | セッションは、次のモードで並べ替えられます。 | モード | 説明 | | ----------- | --------------------------------------- | | `relevance` | 現在の作業ディレクトリと一致してセッションをスコア付けします (既定)。 | | `last used` | 最も最近変更されたセッションを優先表示。 | | `created` | 最新のセッションが最初に表示されます。 | | `name` | セッション名のアルファベット順。名前のないセッションは末尾に並べ替えられます。 | セッションは既に別のウィンドウで開かれているので、関連性のないすべての並べ替えモードで一番上に浮動します。 作業ディレクトリ コンテキストが使用できない場合、 `relevance` モードはスキップされます。 ## 会話前の環境ピッカー 新しいセッションで最初のメッセージを送信する前に、空のプロンプト ボックスで +E を押して、会話を実行する場所 (ローカル コンピューターまたはクラウド環境) を選択します。 環境は、最初のメッセージを送信するときにプロビジョニングされます。 > [!NOTE] > 環境ピッカーでは、`--remote`、`--no-remote`、`--remote-export`、`--no-remote-export`、`--connect` オプションと同じ要件であるクラウド セッションがアカウントで利用可能である必要があります。 > [コマンドライン オプション](#command-line-options)を参照してください。 会話が開始されると、Ctrl+E は他の動作に戻ります。入力中にカーソルを行の末尾に移動するか、プロンプト ボックスが空のときにタイムライン内のすべての項目を展開します。 [対話型インターフェイスのナビゲーション ショートカット](#navigation-shortcuts-in-the-interactive-interface)と[対話型インターフェイスのタイムライン ショートカット](#timeline-shortcuts-in-the-interactive-interface)を参照してください。 ## サイドバーとセッションタブのショートカット 現在のセッションのサイドバーでは、現在のセッションを離れることなく、セッションを閲覧して切り替えることができます。 プロンプト ボックスが空のとき、←/→ で、閉じた状態、タイムラインにフォーカスした状態、サイドバーにフォーカスした状態の 3 つのフォーカス サイクルを移動します。 `sidebar`設定でサイドバーを完全に無効にします。[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings) を参照してください。 | Shortcut | Purpose | | --------------------------------------- | ------------------------------------------------- | | ← (現在のタブ、閉じている) | サイドバーを開きます。タイムラインはフォーカスを維持します。 | | ← (タイムラインに重点を置く) | サイドバーにフォーカスを移動します。 | | → (サイドバーにフォーカス) | タイムラインにフォーカスを戻します。 | | → (タイムラインに重点を置く) | サイドバーを閉じます。 | | /+Tab | タブの切り替え (**現在**、 **セッション**など)。 | | ↑/↓ (サイドバーにフォーカス) | 選択カーソルを移動します。 `j`/`k` はエイリアスです。 | | Enter (サイドバーにフォーカス) | フォアグラウンド セッションを選択したカードに切り替えます。 | | `n` (サイドバーにフォーカス) | 新しいバックグラウンド セッションを生成し、フォアグラウンドに移動します。 | | `s` (サイドバーにフォーカス) | 並べ替え順を切り替えます: 新しい順 → 作成順 → 名前順 → なし。 | | `x`、 `x` (サイドバーにフォーカス) | 選択したカードを閉じます (閉じる前に赤く表示され、1 回のキー操作で閉じられる状態になります)。 | サイドバーの分割線をドラッグしてサイズを変更し、使用可能な最小幅以下に自動的に折りたたむことができます。 各カードには、状態ドット、セッション名、および Git ブランチ (ブランチがない場合は作業ディレクトリ) が表示されます。 手前のセッションのタイトルはアクセントカラーで強調表示され、カードには控えめな塗りが継続して適用されます。 ドットはセッションの状態を示します。 各ドットの意味については、「 [セッション状態インジケーター](#session-status-indicators)」を参照してください。 アクティブな並べ替え順序 (挿入順序の`recent`、 `created`、 `name`、または `none` ) は、再起動後も保持されます。 マウス操作はキーボードをミラーリングします。カードをクリックしてフォアグラウンド セッションを切り替え、カードまたは空のレールスペースをダブルクリックしてサイドバーにフォーカスを合わせ、サイドバーがフォーカスされている間はタイムライン ウィンドウをクリックしてフォーカスを戻します。 \[ **セッション** ] タブには、現在のセッションと、完全な再開可能なセッション履歴が "再開可能" の分周器の下に一覧表示されます。 | Shortcut | Purpose | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------ | | ↑/↓ | 行間を移動します。 | | Shift+↑/↓ | 1ページ上または下へ移動します。 | | を入力 | 選択したセッションを再開します。 | | `n` | 新しいセッションを開始します。 | | `a` | フィルターのスコープを順に切り替える: すべて → ローカル → リモート（クラウド） | | `/` | 名前、ブランチ、作業ディレクトリ、リポジトリ、セッション ID をライブで検索します。 | | `x`、`x` | 選択した行を閉じるか、削除します(1回のキーストロークに対応し、赤で表示してから操作します)。Ctrl+X`x`は引き続き 2 キーエイリアスとして機能します。 | | ←/→ | タブを切り替えます。 | \[ **セッション** ] タブのリモート (クラウド) 行には、オンラインまたはオフラインの状態とリポジトリも表示されます。 行で `x` を 2 回押すと、実行中のセッションが閉じるか、ローカルで再開可能な行の場合は、そのセッションの保存された履歴が完全に削除されます。 Esc キーを押し、他のキーを押すか、強調表示を移動するか、タイムアウトすると、保留中の確認が取り消されます。 ## 差分モードのショートカット 差分モードが開いている場合 ( `/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` | ディレクトリへのアクセスを許可し、そのスキル (`.github/`、 `.agents/`、 `.claude/`) とエージェント (`.github/`、 `.claude/`) を信頼された構成として読み込みます。 サンドボックスが有効になっている場合は、現在のセッションのディレクトリへのアクセス権もサンドボックスに付与します。 | | `/after [DELAY PROMPT]`、`/after` | 現在のセッションの非定期的なプロンプト、スキル、またはスケジュール可能なスラッシュ コマンド ( `/after 30m remind me the time` や `/after 1h /chronicle standup`など) をスケジュールします。 引数を指定しないと、スケジュール マネージャーが表示されます。 実験モードでのみ使用できます。 | | `/agent` | 使用可能なエージェント (存在する場合) を参照して選択します。 「[カスタム エージェント](/ja/copilot/concepts/customizations/custom-agents)」を参照してください。 | | `/app` | | | GitHub Copilot appで現在のセッションを開くか (バージョン 1.1.3 以降が必要)、アプリがインストールされていない場合はダウンロード URL を表示します。 | | | `/ask [QUESTION]`、`/btw [QUESTION]` | 会話履歴に追加せずに、簡単な側面の質問をします。 応答は Markdown としてレンダリングされます。 回答ダイアログで、+Eキーを押して展開し、Ctrl+Yキーを押して完全な回答をコピーします。 現在のセッションで最後に表示したサイド質問への回答を再度開くには、質問を付けずにコマンドを入力します。 「[補足の質問をする GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/ask-a-side-question)」を参照してください。 | | `/allow-all [on\|off\|show]`、`/yolo [on\|off\|show]` | すべてのアクセス許可 (ツール、パス、URL) を有効にします。 これは `/permissions allow-all`の別名です。正規コマンドとそのサブコマンドの `/permissions` 行を参照してください。 | | `/autopilot [OBJECTIVE]`、`/goal [OBJECTIVE]` | 必要に応じて、明示的な目的 (たとえば、 `/goal Refactor the auth module`) を使用して、オートパイロット モードを開始または再フォーカスします。 目的がない場合、autopilot はコンテキストから意図を推論し、ステータス パネルには、推定された目標として最後のプロンプトが表示されます。 `--max-ai-credits N` (たとえば、`/goal Refactor the auth module --max-ai-credits 5`) を使用して、目標に対する AI クレジットの支出を上限にすることができます。 上限に達すると、オートパイロットは一時停止し、上限に算入されたクレジットを表示するパネルを開きます。 新しいクレジット ウィンドウで再開する新しい金額を入力するか、パネルを閉じ、一時停止状態を維持します。 また、パネルを使用せずに、一時停止した目標を自分で再開することもできます。その場合は、目的テキストを使用せずにオプションを単独で実行します (たとえば、 `/goal --max-ai-credits 5`)。 これは、パネルが実行するのと同じアクションです。指定したクレジットの新しいウィンドウが開き (増分ではなく、完全な新しい上限)、目標が続行されます。 `/goal on` と `/goal off` 目的を設定せずにオートパイロット モードを切り替え、 `--max-ai-credits`を受け入れないでください。 アクティブな目標は、プロンプト ボックスの上にピン留めされたパネルとしてレンダリングされ、目標、使用されたクレジット、および todo の進行状況が表示されます。 ターミナルの行数が少ない場合（30行未満）、パネルは自動的に1つのID行まで折りたたまれ、そのしきい値を超えると展開されます。自動サイズ調整を手動で上書きするには、+X を押してから `g` します。 | | `/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/how-tos/copilot-cli/use-copilot-cli/chronicle#using-the-chronicle-slash-command)」を参照してください。 | | | `/clear [PROMPT]`、`/new [PROMPT]`、`/reset [PROMPT]` | 新しい会話を開始します。 `/new worktree` は、現在の会話とその作業ディレクトリを変更せずに、現在のセッションをクリアするのではなく、新しい Git ワークツリーで空のセッションを開始します。 | | `/clikit [COMPONENT]` | CLI ビジネス コンポーネントのプレビュー (クォータ情報など)。 | | `/collect-debug-logs [file\|gist\|share] [PATH]` | デバッグ ログをアーカイブ、GitHub gist として収集するか、GitHub (`share`) にアップロードします。 | | [デバッグ ログの収集と共有を](#collecting-and-sharing-debug-logs)参照してください。 | | | `/compact [FOCUS-INSTRUCTIONS]` | 会話履歴を要約して、コンテキスト ウィンドウの使用量を減らします。 必要に応じて、概要 (たとえば、 `/compact focus on the auth module`) を操作するためのフォーカス指示を指定します。 「[GitHub Copilotのコンテキストの管理](/ja/copilot/concepts/prompting-and-context/context-management#compaction)」を参照してください。 | | `/context` | コンテキスト ウィンドウのトークンの使用状況と視覚化を表示します。 「[GitHub Copilotのコンテキストの管理](/ja/copilot/concepts/prompting-and-context/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)」を参照してください。 | | `/diagnose [PROMPT]`、`/diagnose` | エラー、予期しない動作、その他の問題について、現在のセッション ログを分析します。 必要に応じて、特定の問題に診断を集中させるカスタム プロンプトを含めます。 | | `/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 を終了させ、トランスクリプトのダンプを提案します。 `/exit``/quit` (`print`バリアントを含む) は、エージェントの実行中に Ctrl+Q を使用してキューに入れることもできます。CLI は、現在のターンが終了するとセッションを閉じ、その前にキューに登録されたシェル コマンドが終了します。 | | `/extensions [manage\|mode]`、`/extension` | CLI 拡張機能を管理します。 実験モードでのみ使用できます。 | | `/experimental [on\|off\|show]` | 試験段階の機能の切り替え、設定、または表示を行います。 | | `/feedback`、`/bug` | CLI に関するフィードバックを提供します。 ログ付きフィードバックの手順を案内できます。[デバッグ ログの収集と共有](#collecting-and-sharing-debug-logs)を参照してください。 | | `/fleet [PROMPT]` | タスクの一部の並列サブエージェント実行を有効にします。 「[\`/fleet\` コマンドを使用してタスクの完了を高速化する](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/speed-up-task-completion)」を参照してください。 | | `/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 [config\|list\|show\|add\|edit\|delete\|disable\|enable\|auth\|reload\|search] [SERVER-NAME]` | MCP サーバー構成を管理します。 サブコマンドがない場合、または `config`を使用すると、プラグイン ダッシュボードが MCP サーバー リストにピン留めされて開きます。追加、編集、認証フォームもそのダッシュボード内で開かれるので、フォームを閉じるとサーバー一覧に戻ります。 | | `show`または`show SERVER-NAME`を使用して、構成されているすべてのサーバーを表示するか、使用可能なツールを含む 1 つのサーバーの詳細を直接開き、有効または無効にします。 プラグインが提供するサーバーの場合、 `show SERVER-NAME` はソース属性 (たとえば、 `Source: Plugin my-plugin (1.2.0)`) も表示します。 | | | `list` (エイリアス `ls`)は、接続状態とライブ状態を持つ構成済みサーバーのプレーンテキスト リストを出力します。 ベア `/mcp`、 `config`、 `show`、 `list` (エイリアス `ls`) は読み取り専用またはダッシュボードを開くので、エージェントがターンの処理中に実行できます。 変更サブコマンド (`add`、 `edit`、 `delete`、 `disable`、 `enable`、 `auth`、 `reload`、および `search`) は、ターンが終了するまでブロックされます。 | | | `edit ` は、ユーザー層のウィザードを開く代わりに、ワークスペース由来のサーバー（リポジトリの `.mcp.json` で定義されたもの）を拒否します。これは、保存すると同名のユーザー エントリが警告なしに作成されても、引き続きワークスペース側のエントリに隠されてしまうためです。 このエラーは、直接編集するファイルに名前を付けます。 | | | `delete ` は、ワークスペースソースサーバーの削除を求められたら、同じファイルを報告します。 セキュリティで保護されたローカル サーバーには、 `connected (sandboxed)` 状態が表示されます。 「[GitHub Copilot CLI 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers)」を参照してください。 | | | `/model [--session\|--global\|--repo\|--local] [MODEL\|auto TIER]`、`/models` | 使用する AI モデルを選択するか、**自動** を選択します。モデル ID では大文字と小文字が区別されず、正規 ID が保存されます。 既定では（または `--session`（別名 `-s`）で）、保存された設定に触れることなく、現在のセッションでのみモデル、推論の労力、またはコンテキスト ウィンドウを変更します。 `--repo`/`--local` 代わりにリポジトリ設定で既定のモデルをピン留めします。 `--global` (または `/config model`) は、今後のセッションの既定値を設定します。 長いコンテキストバリアントを持つモデルの Tab キーを押して、コンテキスト列を既定のコンテキスト ウィンドウと長いコンテキスト ウィンドウの間で切り替えます。 選択ウィンドウは、モデルをセクションにグループ化します。 Shift+Tab キーを押して、推奨 (最近、推奨、新規、その他のモデル)、ベンダー、カテゴリの間でグループ化を循環させます。 ピッカーは、選択可能な場合、有効なマネージド既定モデルを既定のバッジでマークします。 ベンダー固有のデータ保持条件を持つモデルには、ベンダーのポリシーへのリンクを含むデータ保持警告バナーが表示されます。 使用可能な途中ターン: エージェントの実行中に要求された変更は、キャンセル可能 (Ctrl+C) コマンドとしてキューに登録され、ライブ モデルの途中要求を切り替える代わりに、現在のターンが終了すると適用されます。 `/model auto TIER` (`efficiency`、`balance`、または`intelligence`) を使用して、特定の自動ルーティング層を直接選択します。これには、自動レベルの推奨事項ヒントの "切り替え" アクションも含まれます。 自動でモデルを選択すると、API によって提供されている場合は、その選択の理由がタイムラインに表示されます。 「[について GitHub Copilotauto model selection](/ja/copilot/concepts/models/auto-model-selection)」を参照してください。 | | `/permissions [default\|assisted\|allow-all\|show]` | アクセス許可モード (`default`、 `assisted`、 `allow-all`) を切り替えるか、現在のモード (`show`) を表示します。 これは、アクセス許可モードの変更に対する正規のコマンドです。 `/allow-all` と `/yolo` はエイリアスとして引き続きサポートされます。 アシスト付きアクセス許可の詳細については、[手動承認なしで安全なコマンドを実行できるようにする](/ja/copilot/concepts/customizations/allowing-safe-commands)を参照してください。 | | `/permissions reset` | 現在のセッションのすべてのメモリ内ツールとパスの承認をリセットします (次回の使用時に再プロンプトが表示されます)。 | | `/plan [PROMPT]` | コーディングする前に実装計画を作成します。 | | `/plugin` | インストールされているプラグインが表示されているプラグイン ダッシュボードを開きます。 プラグインを選択し、 Enter キー を押して詳細と、プラグインの有効化、無効化、更新、アンインストールなどのアクションを実行します。 | | ←キーと→ キーを使用して、\[**インストール済み**]、\[**オンライン**]、\[**Marketplace]** ビューを切り替えます。 ダッシュボードにはプラグインのみが表示されます。MCP サーバーには `/mcp` を使用し、スキルには `/skills` を使用します。 「[GitHub Copilot 用のプラグイン](/ja/copilot/concepts/agents/about-plugins)」を参照してください。 | | | `/plugin install SOURCE` | Marketplace 仕様、 GitHub リポジトリ、git URL、またはローカル パスからプラグインをインストールします。 | | `/plugin update PLUGIN[@MARKETPLACE]` | インストールされているプラグインを更新します。 | | `/plugin uninstall PLUGIN[@MARKETPLACE]`（別名 `remove`、`rm`） | プラグインをアンインストールします。 | | `/plugin list`（別名 `ls`） | インストールされているプラグインを一覧表示します。 チーム プラグインの割り当てでは、チーム メンバーに対して既定で設定できます。 既定で有効なものとして割り当てられたプラグインは有効として表示され、無効にするか、マネージド設定が既定値をオーバーライドしない限り、そのスキルが読み込まれます。 これに対し、エンタープライズ チームの設定を含むマネージド `enabledPlugins`によって適用されるプラグインは、ローカルで無効にすることはできません。 「[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference#cli-commands)」を参照してください。 | | `/plugin marketplace add SOURCE` | マーケットプレースを追加します。 | | `/plugin marketplace remove NAME` | マーケットプレースを削除します。 | | `/plugin marketplace list` | 登録済みのマーケットプレースを一覧表示します。 | | `/plugin marketplace browse NAME` | マーケットプレースでプラグインを参照します。 | | `/plugin marketplace update [NAME]`（別名 `refresh`） | 指定したマーケットプレースのプラグインカタログを再取得します。名前が指定されていない場合は、登録されているすべてのマーケットプレースのプラグインカタログを再取得します。 | | `/pr [view\|create\|fix\|auto\|automerge]` | 現在のブランチのプル要求を管理します。 | | `auto` プル要求を緑に駆動し、停止します。 `automerge` (エイリアス: `agentmerge`) によってプル要求が緑に駆動され、マージされます。 リポジトリに pull request テンプレート (`.github/pull_request_template.md` または `.github/PULL_REQUEST_TEMPLATE/` の下のファイル) がある場合、 `create` は既定でそれに従います。見出し、コメント、チェックリストの項目を保持し、汎用本文を記述する代わりに正確な詳細を入力します。 テンプレートを適用しない場合は、 Copilot にテンプレートをスキップするように依頼します。 「[/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/how-tos/copilot-cli/use-copilot-cli/research-with-copilot-cli)」を参照してください。 | | | `/reset-allowed-tools` | 現在のセッションのアクセス許可をリセットします。 これにより、セッション ツールの承認がクリアされ、アクセス許可モードが手動に戻され（allow-all または assisted permissions のいずれかが有効な場合は、それらをオフにし）、現在の場所に保存されている承認がクリアされます。 | | `--allow-tool`、`--deny-tool`、`--allow-url`、`--deny-url`などの明示的な起動規則は、セッションのベースラインの一部です。 | | | `/restart` | CLI を再起動し、フォアグラウンドセッションだけでなく、現在のプロセスのすべてのライブ セッションを復元します。 ターゲット CLI のバージョンで複数のセッションを復元できない場合は、フォアグラウンド セッションのみを続行するか、取り消すかを確認するメッセージが表示されます。 | | `-w`または`--worktree`で Git ワークツリー内で開始されたセッションは、同じワークツリーで再開されます。 | | | `/model`で選択したモデルは保持されます。 | | | `/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/agent-capabilities/choosing-and-delegating-agent-work/getting-a-second-opinion)」を参照してください。 | | `/sandbox [config\|status\|policy [COMMAND]\|enable\|disable]` | ファイル システムとネットワーク アクセスに関するサンドボックスの制限を管理します。 | | `config` (またはベア `/sandbox`)は設定ダイアログを開きます。これにより、可能な環境シークレットが提案され、保存する前にマスク ホストを追加できます。 ダイアログの \[ **全般** ] タブには、現在のセッションのサンドボックスを有効にしたり、新しいセッションの既定値を設定したりするための個別のオプションがあります。 いずれかのオプションを変更しても、もう一方は変更されません。 | | | `/sandbox enable session` と `/sandbox disable session` は、保存された既定値を変更せずに、現在のセッションのサンドボックスを変更します。 | | | `status` は、現在のセッションでサンドボックスが有効になっているかどうかを示します。 サンドボックスが有効になっている場合、 `policy` には、ソースとアクセスの種類、ネットワーク設定、開発者ツールのアクセス、サンドボックスの機能別にグループ化されたパス許可と制限が表示されます。 必要に応じて、`/sandbox policy npm install` などのコマンドを追加して、実行せずに開発者ツールへのアクセス権を確認します。 | | | `enable` と `disable` は通常、保存した設定を更新します。 組織でサンドボックス化が必要な場合、バイパスが許可されない限り、`disable` は拒否されます。 その場合、無効化は現在のセッションにのみ適用されます。 | | | `/sandbox ca [create\|trust\|rotate\|remove]` | サンドボックスのプロキシ認証局を管理します。 | | `create` はそれを信頼せずにそれを書き込みます。 | | | `trust` は、OS の信頼ストアに追加します。 | | | `rotate` は、その信頼状態を維持しながらそれを置き換えます。 | | | `remove` OS の信頼が失われます。 「[`copilot sandbox ca` の使用](#using-copilot-sandbox-ca)」を参照してください。これにより、たとえばマネージド デバイスで、セッションの外部でも同じ操作を実行できます。 | | | `/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 キー) を平文で表示する代わりにマスクします。 ダイアログには、\[**ユーザー**]、\[**リポジトリ**]、\[**リポジトリ (ローカル)]**、および **\[問題**] タブが表示されます。タブで切り替え/Shift+Tab。別のスコープでオーバーライドされた設定には、どのスコープが優先するかを示すバッジの名前が表示されます。 \[ **問題** ] タブは、注意が必要な設定 (不明または無効なキーなど) のクロススコープ ビューです。そのラベルには、スコープに問題がある場合は `Problems (2)` などのカウントが表示され、それ以外の場合は `Problems`を読み取ります。 ユーザー設定ファイルではなく、ターゲット `--repo`または`--local`に`.github/copilot/settings.json`または`.github/copilot/settings.local.json`を追加します (例: `/settings --repo model gpt-6-astra`)。 この方法で設定できるのは [、リポジトリでオーバーライド可能なキー](/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 [...]` | 現在のセッションを共有します。 サブコマンドがない場合は、何も共有したりエクスポートしたりせずに、共有メニューを開きます。 `link` はセッションを共有し、共有可能な GitHub リンクを出力します。 `off` または `link off` はリンク共有を停止します。 `file [session\|research] [PATH]` マークダウン ファイルにエクスポートします。 `html [session\|research] [PATH]` HTML ファイルにエクスポートします。 `gist [session\|research]` は、 GitHub の要点を作成します。 `research [PATH]` 研究報告書をエクスポートします。 | | `/skills` | \[スキル] タブでプラグイン ダッシュボードを開きます。 | | `/skills list` | 使用可能なすべてのスキルを一覧表示します。 | | `/skills info NAME` | 特定のスキルの詳細を表示します。 | | `/skills add [--project] ` | ファイル、URL、またはディレクトリからスキルを追加する。 `--project` は、ユーザー アカウントではなく、このリポジトリへのファイルまたは URL インストールのスコープを設定します。 | | `/skills remove ` | 名前でスキルを削除するか、カスタム スキル ディレクトリの登録を解除します。 | | `/skills reload` | すべてのディレクトリからスキルを再読み込みします。 「[エージェント スキルの追加 GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。 | | `/statusline`、`/footer` | ステータス行に表示する項目を構成します。 | | `/subagents`、`/agents` | 既定のサブエージェント モデルとエージェントごとのサブエージェント モデルを構成します。 `modelPolicy: "required"`を持つエージェントの場合 (エージェント独自の定義で設定されている場合でも、`subagents`設定のオーバーライドでも)、ピッカーにはロックされた**モデル** エントリと、**モデル強制**行の読み取りが "必須 - オーバーライドできません" (または、エージェント定義自体がポリシーを設定するときに "エージェント定義で必須" と表示されます)。 エージェント定義で必要な場合を除き、ポリシーをピッカーから `"preferred"` に切り替えてオーバーライドを再度許可します。 「[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` | 巻き戻しピッカーを開いて、セッションを以前のユーザー ターンにロールバックします。 会話 **のみ** (会話をロールバックし、ファイルをそのまま残す) または **会話 + ファイル** (そのターンで変更 Copilot ファイルを復元し、後で破棄したターンを変更前のコンテンツに復元し、自分で編集した内容をスキップする) のいずれかを選択します。 ファイルの変更は、編集ツール、シェル コマンド、サブエージェント間で順番に追跡されるため、Git は必要ありません。 | | `/update`、`/upgrade` | CLI を最新バージョンに更新します。 | | `/usage` | セッション使用状況メトリックと統計 (モデルごとのトークンの合計を含む) を表示します。 トークン ベースの課金アカウントの場合、各モデルの行には、独自の AI credit 使用量も表示されます (たとえば、 `1 AIC`)。 トークン数のない課金対象モデルでは、クレジットのみが表示されます。 | | `/user [show\|list\|switch]` | サインインしているアカウントを管理します。 | | `/version` | バージョン情報を表示し、更新プログラムを確認します。 | | `/vim` | プロンプトボックスの Vim モードを切り替えると、Vim スタイルのモーダル編集が可能になります。これには、移動コマンド (`hjkl`、`w`、`b`、`e`、`0`、`$`、`gg`、`G`)、文字検索 (`f`/`F`/`t`/`T`/`;`/`,`)、挿入コマンド (`i`/`a`/`o`)、編集コマンド (`r`/`~`/`J`/`x`/`D`/`C`)、演算子 (`d`/`c`/`y`)、ヤンクとプット (`y`/`p`/`P`)、繰り返し (`.`)、元に戻す/やり直し (`u`/Ctrl+R)、カウント、および Esc キーによるノーマル モードへの復帰などが含まれます。 | | `editorMode`設定で構成することもできます。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#user-settings-copilotsettingsjson)」を参照してください。 | | | `/voice [on\|off\|models\|devices]` | 音声モードの切り替え、使用可能な音声モデルの参照、または入力デバイス (マイク) の選択を行います。 | | `/workflows` | ワークフローの実行、フェーズ、エージェント、進行状況を観察します。 トークン ベースの課金プランが必要です。 | | \[ | | | `copilot workflow run`を使用して登録済みのワークフローを直接実行する]\(#using-copilot-workflow-run)を参照してください。 | | | `/fork [NAME]`、`/branch [NAME]` | 現在のセッションを新しいセッションにフォークします(必要に応じて名前を付けます)。 エージェントの実行中に使用できます。ソース セッションはバックグラウンドで動作し続けます。 `/fork worktree` 現在のセッションをフォークし、会話コンテキストを保持して、 `HEAD`から分岐した新しい Git ワークツリーにフォークします。 | | `/worktree [branch\|task]` | 新しい Git ワークツリーを作成し、それに切り替えて、コミットされていない変更を現在のワークツリーに残します。 ブランチ名、タスクの説明 (複数行サポート、新しいワークツリーの開始プロンプトとして使用) を渡すか、引数を省略して会話からブランチ名を自動生成します。 既定では、現在のチェックアウト (`HEAD`) から分岐します。代わりに、 `worktreeBaseRef` 設定を `"defaultBranch"` に設定して、リモートの既定のブランチから分岐します。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#user-settings-copilotsettingsjson)」を参照してください。 Git リポジトリが必要です。 | | `/worktree new [PROMPT]` | 非推奨 - 代わりに `/new worktree` を使用してください。 新しい Git ワークツリーで新しい会話を開始します。現在の会話とその作業ディレクトリは変更されません。 必要に応じて、最初のプロンプトを指定します。 | | `new` はサブコマンド キーワードとして予約されており、リテラル ブランチ名として使用することはできません。 | | | `/worktree`と同じ`worktreeBaseRef`設定に従います。 | | | `/move [branch\|task]` | コミットされていない変更を新しい Git ワークツリーに移動し、それに切り替えます。 ブランチ名、タスクの説明 (複数行サポート、新しいワークツリーの開始プロンプトとして使用) を渡すか、引数を省略して会話からブランチ名を自動生成します。 Git リポジトリが必要です。 | 使用可能なスラッシュ コマンドの完全な一覧については、CLI の対話型インターフェイスに「 `/help` 」と入力します。 ベア `/every` または `/after`によって開かれたスケジュール マネージャで、 ↑/↓ を使用してエントリを選択し、 `x` して削除します。 スケジュールは、 `/every` または引数を指定した `/after` を使用してプロンプト入力からのみ追加できます。ダイアログ自体は読み取りおよび削除のみです。 `/every`と`/after`が有効になっていない場合でも、セッションにアクティブなスケジュールがある場合、フッターには既定で "N スケジュール済み" インジケーターが表示されます。 `/plugin` は、新しいバージョンがアップストリームで利用可能になったときにインストール済みのプラグインまたはマーケットプレースにフラグを設定し、ダッシュボードから **更新** アクションを提供します。 `/mcp list` / `ls` `/plugin list` / `ls` (ベア `/plugin`を含む) は読み取り専用であり、エージェントがターンの処理中に実行できます。 その他のすべての `/mcp` および `/plugin` サブコマンドは、ターンが終了するまでブロックされます。 > [!NOTE] > 実験用の `/plugins` コマンドが削除されました。 そのリソースは、 `/plugin`、 `/mcp`、および `/skills`に移動されました。 エージェントと手順には、 `/subagents` と `/instructions` を使用します。 ### デバッグ ログの収集と共有 トラブルシューティングのためにデバッグ ログを収集するには、 `/collect-debug-logs [file|gist|share] [PATH]` を使用します。 | Target | 説明 | | ------- | ---------------------------------------------------------- | | `file` | ログを `PATH` のローカル アーカイブに保存します ( `PATH` を省略した場合に使用される既定の場所)。 | | `gist` | ログをシークレット GitHub gist にアップロードします。 | | `share` | ローカル アーカイブを保存し、 GitHubにアップロードします。 | `/collect-debug-logs share`、および `/feedback` で提供される feedback-with-logs ルートでは、最初にローカル アーカイブを保存し、その後、GitHub にアップロードする前に新たに同意を求めます（既定では **No**）。 アップロードは現在、 GitHub スタッフと内部ユーザーのみが利用でき、まだ一般公開されていません。 GitHub外のユーザーは、既存のアーカイブルートと gist ルート、および既存のパブリック フィードバック ルートを引き続き使用します。 ## コマンド ライン オプション | オプション | Purpose | | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | | `--add-dir=PATH` | ディレクトリへのファイル アクセスを許可し、そのスキル (`.github/`、 `.agents/`、 `.claude/`) とエージェント (`.github/`、 `.claude/`) を信頼された構成として読み込みます (複数回使用できます)。 相対パスは、オプションの順序に関係なく、セッション作業ディレクトリ ( `--resume`、 `--worktree`、または `-C` ディレクトリ) に対して解決されます。 パスは既存のディレクトリである必要があります。パスが見つからないか、通常のファイルがフラグ固有のエラーですぐに起動に失敗します。これは、すべてのモードで同じ方法です。 | | | `--add-github-mcp-tool=TOOL` | 既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールを追加します (複数回使用できます)。 すべてのツールに `*` を使用します。 | | | `--add-github-mcp-toolset=TOOLSET` | 既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールセットを追加します (複数回使用できます)。 すべてのツールセットに `all` を使用します。 | | | `--additional-mcp-config=JSON` | このセッション専用の MCP サーバーを追加します。 サーバー構成は、JSON 文字列またはファイル パス ( `@` プレフィックス) として指定できます。 相対 `@file` パスは、オプションの順序に関係なく、セッション作業ディレクトリ ( `--resume`、 `--worktree`、または `-C` ディレクトリ) に対して解決されます。 | | | `~/.copilot/mcp-config.json`から構成を拡張します。 インストール済みの MCP サーバー構成を同じ名前でオーバーライドします。 「[GitHub Copilot CLI 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。 | | | | `--agent=AGENT` | 使用する custom agent を指定します。 「[カスタム エージェント](/ja/copilot/concepts/customizations/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` | モデルの安全性レビューや個々の承認プロンプトなしで、一括ツールのアクセス許可を付与します。 拒否規則とエンタープライズ制限は引き続き適用されます (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` | エージェント クライアント プロトコル サーバーとして起動します。 | | | `--assisted-approval` | 実行時に、安全レビューで適格なアクセス許可要求を承認できるように、assisted permissions を有効にします。 非対話型の実行 (つまり、 `-p` または `--prompt`を使用し、ターミナルが接続されていない環境で実行される実行) に対してのみ有効です。 正常に有効にすると、 `--allow-all-tools`よりも優先されますが、 `--allow-all-paths` や `--allow-all-urls` には影響しません (env: `COPILOT_ASSISTED_APPROVAL`)。 「[手動承認なしで安全なコマンドを実行できるようにする](/ja/copilot/concepts/customizations/allowing-safe-commands)」を参照してください。 | | | `--attachment PATH` | ファイルを最初のプロンプトに添付します (複数回使用できます)。 画像ファイルは受け入れられますが、正常に送信するには、選択したモデルと組織のポリシーで視覚入力を許可する必要があります。 | | | `--autopilot` | オートパイロット継続を有効にします。エージェントは、 `task_complete` が呼び出されるまで動作し続け、対話モードに戻ります。 「[GitHub Copilot CLI での Autopilot モードの使用](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/use-autopilot-mode)」を参照してください。 | | | `--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-client-telemetry` | CLI によって送信されたテレメトリを無効にします。 サーバー側のテレメトリには影響しません。 | | | `--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-mcp-server=SERVER-NAME` | このセッションに対してのみ、設定で無効になっている MCP サーバーを再度有効にします (複数回使用できます)。 この変更は設定に保存されません。 | | | `--enable-memory` | プロンプト モードでメモリを有効にします (既定では無効)。 | | | `--enable-reasoning-summaries` | 非推奨の互換性オプション (受け入れられますが無視されます)。 OpenAI モデルをサポートするための詳細な推論の概要が既定で表示されます。 | | | Ctrl+T キーで切り替えます。 | | | | `--excluded-tools=TOOL ...` | これらのツールはモデルでは使用できません。 複数のツールの場合は、引用符で囲まれたコンマ区切りのリストを使用します。 | | | `--experimental` | 試験的な機能を有効にする ( `--no-experimental` を使用して無効にする)。 | | | `--extension-sdk-path DIRECTORY` | ローカル `@github/copilot-sdk` フォルダーを使用して拡張サブプロセスに挿入されたバンドルされた`copilot-sdk/`をオーバーライドします。 無効なパスは、バンドルされた SDK にフォールバックします。 | | | `--fleet` | フリートモードでプロンプトを実行します（並列サブエージェントオーケストレーション）。 | | | `-i`、`-p`、またはパイプされた標準入力と組み合わせます。 これには、これらのソースのいずれかからのプロンプトが必要であり、それ自体には影響しません。 これは、対話型プロンプトの前に `/fleet` スラッシュ コマンドを付けるのと同じです。 | | | | `-p`またはパイプ入力を使用すると、同じフリートオーケストレーションを非対話的に実行できます。 「[\`/fleet\` コマンドを使用してタスクの完了を高速化する](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/speed-up-task-completion)」を参照してください。 | | | | `-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` | アクティブなオートパイロット目標外の自動継続の最大数 (既定値: 5)。 負以外の整数である必要があります。 形式が正しくない値 (`NaN`、負、小数、または科学的表記) は拒否されます。 「[GitHub Copilot CLI での Autopilot モードの使用](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/use-autopilot-mode)」を参照してください。 | | | `--mode=MODE` | 初期エージェント モード ( `interactive`、 `plan`、 `autopilot`) を設定します。 plan-then-autopilot の `--plan` ( `--plan --mode autopilot`として) と組み合わせる: セッションはプラン モードで開始され、計画の準備ができたら自動的に自動パイロット モードに進みます。これは、人間が承認するのを待つ代わりに行われます。 その他の `--plan --mode MODE` ペアリングは拒否されます。 | | | `--model=MODEL` | 使用する AI モデルを設定します。 | | | `auto`を値として渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。 「[について GitHub Copilotauto model selection](/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` | 削除。 対話型セッション中に `/remote off` を使用して、そのセッションのリモート接続を終了します。 | | | `--no-remote-export` | | | | `--sync-session=off`に名前を変更しました。 | | | | `--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` の短縮形です。 | | | | `--autopilot`と組み合わせることはできません。 plan-then-autopilot の `--mode autopilot` と組み合わせることができます。その他の `--mode` 値は拒否されます。 | | | | `--plain-diff` | リッチ差分レンダリングを無効にします (Git 構成で指定された差分ツールを使用した構文の強調表示)。 | | | `--plugin-dir=DIRECTORY` | ローカル ディレクトリからプラグインを読み込みます (複数回使用できます)。 相対パスは、オプションの順序に関係なく、セッション作業ディレクトリ ( `--resume`、 `--worktree`、または `-C` ディレクトリ) に対して解決されます。 | | | `--plugin-dir` プラグインによって提供されるエージェントは、サーバー モード (`--server`) セッションおよび対話型および`-p` セッションで使用できます。 | | | | `--remote` | 対話型起動または `-p` と併用した場合はサポートされていません。 代わりに、対話型セッション中に `/remote on` を使用してください。 このフラグは、 `--server` または `--headless`を使用したレガシ SDK サーバーの起動で引き続きサポートされます。 「[別のデバイスからの GitHub Copilot CLI セッションのステアリング](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely)」を参照してください。 | | | `--remote-export` | | | | `--sync-session=on`に名前を変更しました。 | | | | `-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`などの他のセッション選択またはセッション開始オプションと組み合わせないでください。これは、開くか作成するかを決定するために競合するためです。 | | | `--trust-folder` | 1 つの新しい非対話型セッション（`-p` またはパイプされた標準入力）に対して、作業ディレクトリのフック、ワークスペース MCP サーバー、リポジトリ プラグイン設定を信頼します。 トラストは `trustedFolders` に保存されず、ツールまたはパスのアクセス許可付与ではありません。 | | | `--resume`、`--continue`、または`--session-id`と組み合わせることはできません。 | | | | `--sandbox` | 保存したサンドボックス設定を変更せずに、このセッションに対してのみ OS レベルのシェル サンドボックスを有効にします。 | | | `-p`で便利です。 | | | | `--no-sandbox` | 保存したサンドボックス設定を変更せずに、このセッションのローカル サンドボックスのみを無効にします。 エンタープライズ管理ポリシーがサンドボックスを適用するように構成されている場合、このオプションは無視されます。 | | | `--share=PATH` | プログラム セッションの完了後にセッションを Markdown ファイルに共有します (既定のパス: `./copilot-session-.md`)。 | | | `--share-gist` | プログラムによるセッションの完了後、シークレット GitHub gist にプログラムセッションを共有します。 | | | `--stream=MODE` | ストリーミング モードを有効または無効にします。このモードでは、完全な応答が到着するまで待機するのではなく、生成された Copilotの応答が段階的に表示されます (モードの選択肢: `on` または `off`、既定: `on`)。 | | | `--sync-session[=on\|off]` | この実行の読み取り専用セッション履歴の同期を有効または無効にします。 値がない場合、同期を有効にします。 リモートコントロールは有効ではありません。 省略した場合は、設定と既定の動作を使用します。 組織のクラウド セッション ストレージ ポリシーがオフになっているか、決定できない場合、同期は拒否されます。 | | | `-v`、`--version` | バージョン情報を表示します。 | | | `-w`、`--worktree[=NAME]` | 既定では、分離された Git ワークツリーを `.worktrees/` で作成または再利用し、その中でセッションを開始します。 `worktreePathTemplate`設定を使用して、場所を構成します。 `NAME` は省略可能です。ブランチ名を自動生成するには省略します。 既定では、現在のチェックアウト (`HEAD`) から分岐します。代わりに、 `worktreeBaseRef` 設定を `"defaultBranch"` に設定して、リモートの既定のブランチから分岐します。 `--resume`、`--continue`、および`--connect`との競合。 | | | `--yolo` | すべてのアクセス許可 ( `--allow-all`と同等) を有効にします。 | | コマンドとオプションの完全な一覧については、 `copilot help`を実行します。 > [!NOTE] > リモート セッション機能を使用するには、アカウントで利用可能である必要があります。 従来の `--remote` オプションは対話型セッション 制御ではなく、 `--no-remote` はサポートされなくなりました。 > > 対話型セッション中にリモート 制御を有効にするには、 `/remote on`を使用します。 リモート接続を終了するには、`/remote off`を使用して終了します。 クラッシュやマシンの再起動などで CLI プロセスが停止してもセッションがまだ開いていた場合は、次回開始したときに `copilot` 復元オプションが提供されます。 代わりに、復元または新しいセッションを開始するために使用できるセッションを確認できます。 エージェントが応答の途中だった復元済みのセッションは、その処理を自動的に再開します。 ### 計画してから自動操縦 Plan-then-autopilot を使用すると、セッションをプラン モードで開始し、プランの準備ができたら自動的にオートパイロット モードに進み、人間が移行を承認するのを待つ必要はありません。 コマンド ライン オプションではなく環境変数のみを挿入できるハーネスの場合は、 `--plan --mode autopilot`または `COPILOT_PLAN_THEN_AUTOPILOT` 環境変数を使用して有効にします。 両方が設定されている場合は、明示的なオプションが優先され、環境変数が無視されたことを示す警告が CLI に表示されます。 ### エンタープライズで管理されるサンドボックス フロア エンタープライズ管理ポリシーでは、OS レベルのシェル サンドボックスを最小レベルとして適用できます。 つまり、 `--no-sandbox`渡しても、ポリシーはサンドボックスを強制的にオンにすることができます。 これはポリシーのオーバーライドであり、オプション自体の失敗ではありません。 これに対し、 `--sandbox` はサンドボックスを有効にし、削除しないため影響を受けません。 有効なポリシーでサンドボックス のバイパスが許可されている場合は、アクティブなバイパスアクセス許可プロンプトに応答しながら、現在のセッションの残りの部分のサンドボックスを明示的に無効にすることができます。 マネージド フロアが有効な `sandbox.allowBypass` の `true` (ポリシーが `sandbox.enabled` のみを `true` に設定した場合の既定値) を使用してサンドボックスを強制的にオンにする場合は、現在のセッションの残りの部分に対してサンドボックスをオプトアウトする `/sandbox disable` を実行します。最初にバイパス プロンプトは必要ありません。 オプトアウトはセッション専用です。 `settings.json`に何も保存されず、新しいセッションが再度サンドボックス化され始め、 `/sandbox enable` は新しいセッションを待たずにすぐにサンドボックスを復元します。 `allowBypass`が`false`場合、`/sandbox disable`は、マネージド ポリシーによってサンドボックスが適用され、無効にできないことを示すメッセージで拒否します。 管理ポリシーによって設定がオーバーライドされると、CLI は対話型タイムライン (または `-p` を使用している場合は stderr) に警告を表示するため、動作が動作しないオプションではなくポリシーの適用に起因することが明らかになります。 ポリシーを変更する必要がある場合は、管理者に問い合わせてください。 セッションの有効な制限を調べるには、 `/sandbox status` または `/sandbox policy` を使用します。 `sandbox.failIfUnavailable` を `true` に設定した管理対象設定を、`true` を `sandbox.enabled` に設定した場合と併せて追加すると、サンドボックスを確立できない場合にサンドボックスの使用が必須になります。 Copilotは、サンドボックスなしでコマンドを実行するフォールバックに頼るのではなく、利用可能なサンドボックス バックエンドでポリシーを検証、コンパイル、または適用できない場合、モデルおよびツールの実行をブロックします。 「[エンタープライズ管理設定](/ja/copilot/reference/enterprise-administrators/enterprise-managed-settings#sandbox)」を参照してください。 また、管理ポリシーが要求しなかったセッションでサンドボックスを有効にした場合、 `--no-sandbox`をオーバーライドした場合だけでなく、CLI によって警告が表示されます。 これには、サーバーで管理される設定はログイン後にのみ使用できるため、起動後にポリシーが到着するセッションが含まれます。 独自設定または `--sandbox` オプションですでにサンドボックス化が要求されている場合は、その場合セッション状態になることが想定されるため、警告は省略されます。 デバイスに読み取りできない管理ポリシーがある場合、CLI は閉じられ、最も制限の厳しいレベルでサンドボックス化が適用されます。 この通知では、ポリシーを特定できなかったことが説明され、解決されるまで待機するように指示されます。 サポートされていないホストのスタートアップ警告では、同じ文言が使用されます。 ### allow-all オプションを制限する `permissions.disableBypassPermissionsMode`が `"disable"` に設定されている場合、すべてのアクセス許可 (`--allow-all-tools`、`--allow-all-paths`、`--allow-all-urls`、`--allow-all`、`--yolo`) を許可するすべてのコマンド ライン オプションは起動時に抑制され、昇格されたアクセス許可を付与するために使用することはできません。 CLI では、CLI がこれらのオプションを抑制すると、ポリシー警告が表示されます。 `/permissions allow-all`スラッシュ コマンドとそのエイリアス`/allow-all`および`/yolo`も抑制されます。 この設定をオフにしても、個別に制御される assisted permissions はオフになりません。 #### 何が`disable`オフになるか `permissions.disableBypassPermissionsMode`の値が`disable`の場合、すべてのアクセス許可を付与するコマンド ライン オプションは無効になります。 これらのオプションは、 `--allow-all-tools`、 `--allow-all-paths`、 `--allow-all-urls`、 `--allow-all`、および `--yolo`です。 この制限は、対話型セッション中にも適用されます。 allow-all モードを有効にするスラッシュ コマンドは引き続き使用できますが、説明メッセージが表示されて拒否されます。 \| 命令 | `disable` を含む結果 | \|---------|------------------------| \| `/permissions allow-all` | Refused | \| `/allow-all`（およびそのエイリアス `/yolo`）を引数なしで、または `on` | Refused | \| `/permissions assisted` | 許可 | \| `/allow-all off`、 `/allow-all show`、 `/permissions default`、 `/permissions show` | 許可 | allow-all コマンドが拒否されると、メッセージは制限の発生元によって異なります。 ご自身の設定からの制限では、"設定でアクセス許可のバイパス モードが無効になりました" と報告されます。 マネージド ポリシーまたは MDM ポリシーからの制限により、アクセス許可のバイパス モードがポリシーによって無効になりました。 詳細については、管理者にお問い合わせください。" #### 認識できない値 `permissions.disableBypassPermissionsMode`がこのバージョンで認識されない値に設定されている場合、CLI はそれを拒否しません。 代わりに、値をログに記録し、安全な既定値として `disable` を適用します。 形式が正しくないポリシーでも、暗黙的に許可されるのではなく、allow-all オプションは引き続き制限されます。 #### 設定の取得元 3 つのソースで `permissions.disableBypassPermissionsMode`を設定できます。 これらは、永続性の増加順に一覧表示されます。 | 情報源 | Scope | アカウント切り替えでクリアされましたか? | | ----------------------------------- | ----- | --------------------------------------------- | | ユーザー設定 (`~/.copilot/settings.json`) | 機械 | No. すべてのアカウントに適用されます。 | | 管理設定（アカウントごとにサーバーから取得） | アカウント | Yes. CLI は、新たにアクティブになったアカウントのポリシーを読み込みます。 | | MDM ポリシー (plist/registry/file) | デバイス | なし デバイス レベルのポリシーは、アカウント スイッチによってオーバーライドされません。 | ### ポリシーを確認できない場合の制限の動作 失敗したポリシー チェックは、セッションを制限されないままにするとは限りません。 CLI は、アンマネージド アカウントまたはデバイスを、該当するマネージド ポリシーを確認できないアカウントまたはデバイスと区別します。 * **未確認の管理ポリシーは、アクセス許可を制限する可能性があります。** ポリシー チェックが保留中の場合、または管理対象アカウントまたはデバイスに対してポリシーを確認できない場合、CLI はアクセス許可のエスカレーションをブロックし、アクションに対して明示的な承認を要求できます。 これは、以前のポリシーで allow-all オプションが無効化されていなくても適用できます。 * **サーバー ポリシーはアカウント固有です。** 更新が失敗した場合、同じアカウントに対して以前に取得したポリシーが有効なままである可能性があります。 アカウントを切り替えると、以前のアカウントのサーバー ポリシーを引き継ぐのではなく、新しいアカウントのポリシーが読み込まれます。 * **デバイスの制限は、アカウント間で保持されます。** アカウントを切り替える場合、MDM の制限やアクセス許可モードを妨げるユーザー設定は削除されません。 設定を省略したサーバー応答は、これらの制限をオーバーライドしません。 ## サポートされているモデル `--model=MODEL`または`COPILOT_MODEL`環境変数を使用して、AI モデルを選択します。 `auto`を渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。 | Model | 最適な用途 | | ------------------- | -------------------- | | `claude-sonnet-5.5` | 汎用コーディング (既定) | | `gpt-6.1-sol` | 推奨、オプトイン (自動既定値ではない) | | `gpt-6.1-terra` | 推奨、オプトイン (自動既定値ではない) | | `gpt-6-astra` | 推奨、オプトイン (自動既定値ではない) | | `gpt-6-luna` | 推奨、オプトイン (自動既定値ではない) | | `claude-opus-5.5` | 推奨される高機能の複雑なタスク | | `claude-haiku-5.5` | 高速で軽量な操作 | | `claude-haiku-4.5` | 高速で軽量な操作 | | `gpt-5.3-codex` | コードに重点を置いたタスク | | `gemini-3.8-flash` | 速いGoogleジェミニの応答 | `/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` | ファクトをエージェント のメモリに格納する。 「[GitHub Copilot Memory について](/ja/copilot/concepts/agents/copilot-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` | すべてのアクセス許可を自動的に許可します ( `--allow-all`と同等)。 | | `true`、`1`、`yes`、`on`、または`y` (大文字と小文字を区別せず、周囲の空白文字は無視されます) を受け入れて有効にします。無効にするには、`false`、`0`、`no`、`off`、`n`、または空の値を使用します。 これを正確に `true` に設定すると、確認を求めることなく作業ディレクトリも信頼し、そのディレクトリのスキル、プラグイン、MCP サーバー、フック（シェル コマンドを実行するフックを含む）を読み込みます。 他の「真」と評価される表記では、ツールのみが自動承認されます。 | | | `COPILOT_ASSISTED_APPROVAL` | 非対話型で実行するには、assisted permissionsを有効にするために`--assisted-approval`に設定します (`true`と同等)。 | | `COPILOT_AUTO_UPDATE` | CLI とファースト パーティ プラグインの自動更新を無効にするには、 `false` に設定します。 | | `COPILOT_CACHE_HOME` | キャッシュ ディレクトリ (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) をオーバーライドします。 プラットフォームの既定値については [、AUTOTITLE](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) を参照してください。 | | `COPILOT_CHILD_OOM_SCORE_ADJ` | Linux のみ。 CLI によって生成されたシェル コマンド プロセス ツリーに適用される `oom_score_adj` バイアスをオーバーライドすることで、カーネルのメモリ不足 (OOM) キラーが、CLI 自体よりも先に暴走した子プロセス ツリー (ビルドなど) を回収できるようにします。 既定値: `300`。 範囲: `-1000` – `1000`。 バイアスを無効にするには、 `off` に設定します。 | | `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | カスタム命令用の追加ディレクトリのコンマ区切りの一覧。 | | `COPILOT_EDITOR` | 対話型編集のためのエディターコマンド（`$VISUAL` および `$EDITOR` の後にチェックされたもの）。 何も設定されていない場合、デフォルトで `vi` になります。 | | `COPILOT_ENABLE_HTTP2` | HTTP/2 トランスポートをオプトインするには、 `1` または `true` に設定します。 HTTP/1.1 が既定値です。 | | `COPILOT_ENABLE_INTERRUPTED_SESSION_RESTORE` | | | `1`に設定すると、クラッシュやマシンの再起動などの理由で、CLI プロセスが停止したときにまだ開いていたセッションの復元が有効になります。 この復元動作は、スタートアップ ダイアログが再び作成されている間、一時的にオプトインされます。 | | | [中断されたセッションの復元を](#restoring-an-interrupted-session)参照してください。 | | | `COPILOT_GH_HOST` | | | GitHub | | | Copilot 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のコンテキストの管理](/ja/copilot/concepts/prompting-and-context/context-management#managing-large-tool-output-for-copilot-cli)」を参照してください。 | | `COPILOT_MCP_TOOL_CACHE` | プロセス全体のローカル MCP サーバー ツール スナップショットの読み込みと永続化を無効にするには、 `false` に設定します。 | | [ツールスナップショットキャッシュを](#tool-snapshot-caching)参照してください。 | | | `COPILOT_MODEL` | AI モデルを設定します。 | | `COPILOT_PLAN_THEN_AUTOPILOT` | 環境変数しか注入できないハーネスで plan-then-autopilot（`on` と同等）を要求するには、`--plan --mode autopilot`、`1`、`true`、または `yes` に設定します。 明示的な `--mode`、 `--autopilot`、または `--plan` オプションが渡された場合、警告付きで無視されます。 | | [「Plan-then-autopilot](#plan-then-autopilot)」を参照してください。 | | | `COPILOT_PROMPT_FRAME` | 入力プロンプトの周囲の装飾 UI フレームを有効にするには、 `1` に設定するか、無効に `0` します。 現在のセッションの実験用機能フラグ `PROMPT_FRAME` オーバーライドします。 | | `COPILOT_PROVIDER_API_KEY_COMMAND` | 各プロバイダー要求の前に新しい Bring Your Own-Key (BYOK) API キーを出力するシェル コマンド。 | | `COPILOT_PROVIDER_API_KEY`環境変数よりも優先されます。 その出力は、 `COPILOT_PROVIDER_HEADERS` を介して設定されたカスタム ヘッダーが競合する場合でも、一致する資格情報ヘッダーを置き換えます。 | | | `COPILOT_PROVIDERS_CONFIG` | bring-your-own-key (BYOK) プロバイダーとモデル レジストリを、 `providers` キーと `models` キーを持つオブジェクトとして定義する JSON ファイルへのパス。 既定値: `/providers.json`。 このファイルが任意のプロバイダーまたはモデルを宣言する場合は、レガシ `COPILOT_PROVIDER_*` 環境変数よりも優先されます。 | | \[ | | | `providers.json` | | | ]\(/copilot/reference/copilot-cli-reference/cli-config-dir-reference#providersjson)を参照してください。 | | | `COPILOT_SKILLS_DIRS` | スキルの追加ディレクトリのコンマ区切りの一覧。 | | `PLUGINS_DASHBOARD` | | | `false`に設定すると、ベア `/plugin`、`/mcp`、`/skills`によって開かれたプラグイン ダッシュボードが無効になり、非対話型の`copilot plugin`/`copilot plugins` コマンドが無効になります。 | | | `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の両方のホスト名 (既定値: `github.com`)。 データ所在地のホスト名を使用して GitHub Enterprise Cloud を設定します。 | | | `COPILOT_GH_HOST` を Copilot 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` に設定します。 | | `USE_TGREP` | | | [常に tgrep](https://github.com/microsoft/tgrep)、トリグラム インデックス検索エンジンを使用するように`true`に設定します。Git リポジトリの外部、仮想化またはネットワーク ファイルシステム (たとえば、GIT チェックアウト用の VFS や SMB/9p マウント) でも、常に ripgrep を使用する`false`。 Git リポジトリの外部で強制的に実行すると、tgrep によって作業ディレクトリ自体のインデックスが作成されるため、ホーム ディレクトリなどの大きな場所に強制的に作成することは避けてください。 クラウド同期フォルダー (OneDrive など) Windowsは、`true`に設定されている場合でも、常に ripgrep を使用します。 設定を解除すると、 Copilot CLI 自動的に ripgrep から tgrep に切り替わるのは、Git リポジトリ内、仮想化されていないファイル システム上、および `TGREP_FILE_COUNT_THRESHOLD` によって設定されたファイル数のしきい値に達した場合のみです。 | | | `USE_TGREP=true`設定すると、このしきい値が完全にバイパスされます。 | | | `USE_TGREP=false` 引き続き tgrep を無効にします。 | | | `TGREP_FILE_COUNT_THRESHOLD` | tgrep インデックス付き自動検索の最小ファイル数 (負以外の整数。既定値: Windowsの`10000`、他の場所`50000`)。 無効な値は、プラットフォームの既定値にフォールバックします。 | | `0` では、ファイル数の要件のみが削除されます。その他の自動開始チェックは引き続き適用されます。 | | ## 構成ファイルの設定 構成ファイルの設定の詳細については、ユーザー設定、リポジトリ設定、ローカル設定の完全な一覧、それらがカスケードされる方法など、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings) を参照してください。 ## Copilot のプロジェクト初期化 対話型セッション内でコマンド `copilot init`またはスラッシュ コマンド `/init` を使用すると、 Copilot はコードベースを分析し、リポジトリ内の `.github/copilot-instructions.md` ファイルを書き込みまたは更新します。 このカスタム命令ファイルには、将来の CLI セッションを改善するプロジェクト固有のガイダンスが含まれています。 通常は、新しいプロジェクトを開始するとき、または既存のリポジトリで`copilot init`の使用を開始するときに、`/init`またはCopilot 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)」を参照してください。 `--sandbox`または`--no-sandbox`を`copilot init`と共に使用して、保存されたサンドボックス設定を変更せずに、初期化セッションに対してのみ OS レベルのシェル サンドボックスを有効または無効にします。 これらのオプションは、他のエントリ ポイントと同じエンタープライズで管理されるサンドボックス フロアの対象となります。 [エンタープライズで管理されるサンドボックス フロア](#enterprise-managed-sandbox-floor)を参照してください。 ### カスタム命令の場所 Copilot CLI これらの場所からカスタム命令を同時に読み込みます (すべてがマージされます)。 | 場所 | Notes | | -------------------------------------------------- | --------------------------- | | `CLAUDE.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `GEMINI.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `AGENTS.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `.github/instructions/**/*.instructions.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `.claude/rules/**/*.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `.github/copilot-instructions.md` | Git のルート ディレクトリと現在の作業ディレクトリ | | `$HOME/.copilot/copilot-instructions.md` | — | | `$HOME/.copilot/instructions/**/*.instructions.md` | — | | `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | 環境変数を使用した追加のディレクトリ。 | Copilot CLIは、`.github/instructions/**/*.instructions.md` ファイルを読み取るのと同じ方法`.claude/rules/**/*.md`から Claude Code ルール ファイルを読み取ります。 `paths` (または`applyTo`) frontmatter キーを使用してファイルを照合するようにルールのスコープを設定します。 ```markdown --- paths: "src/api/**/*.ts" description: API layer conventions --- Use the shared `ApiError` type for all thrown errors in this directory. ``` エージェントが一致するファイルを読み取ったり編集したりすると、リポジトリ ルートと作業ディレクトリのスコープルールが自動的に配信されます。 ### カスタム命令のインポート 命令ファイルでは、 `@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` スラッシュ コマンドを参照) は、`/mcp list` と `connected (sandboxed)` に `copilot mcp list` ステータスが表示されます。 リモート (HTTP/SSE) サーバーはローカルにサンドボックス化されませんが、CLI からの接続はサンドボックスのネットワーク ポリシーによって制限できます。 `copilot mcp list` と `/mcp list` は、無効なサーバーを、テキスト出力では `(disabled)` サフィックスを付けて、または `"enabled": false` 出力ではサーバーごとに `--json` を付けてマークします。 `copilot mcp get` には、 `Status: Enabled`/`Disabled` 行が表示されます。 `/sandbox` を切り替えると、サンドボックス内で起動されるため、ローカル（stdio）の MCP サーバーだけが再起動されます。 リモート (HTTP/SSE) サーバーは接続された状態を維持します。 `/mcp edit ` は、ユーザー層のウィザードを開くのではなく、ワークスペース由来のサーバー（リポジトリの `.mcp.json` で定義されたもの）を拒否します。これは、保存すると、ワークスペース側のエントリに引き続き隠されたままの同名のユーザー エントリが暗黙に作成されてしまうためです。 このエラーは、直接編集するファイルに名前を付けます。 `/mcp delete ` は、ワークスペースソースサーバーの削除を求められたら、同じファイルを報告します。 ### `copilot mcp` サブコマンド `copilot mcp`を使用して、対話型セッションを開始せずにコマンド ラインから MCP サーバー構成を管理します。 | サブコマンド | 説明 | | ------------------------------------ | ------------------------------------------------------------------- | | `list [--json]` | プラグインが提供するサーバーを含め、ソース別にグループ化されたすべての構成済み MCP サーバーを一覧表示します。 | | `get [--json]` | 特定のサーバーの構成とツールを表示します。 プラグインが提供するサーバーの場合は、ソース プラグインの名前とバージョンも表示されます。 | | `add [options] [url]` | ユーザー構成にサーバーを追加します。 | | `~/.copilot/mcp-config.json`に書き込みます。 | | | `enable ` / `disable ` | サーバーを名前で有効または無効にします。 変更はユーザー構成に保持され、今後のセッションに適用されます。 | | `remove ` | ユーザー レベルのサーバーを削除します。 ワークスペース サーバーは、構成ファイルで直接編集する必要があります。 | ローカル (stdio) サーバーの場合は、 `--`後にコマンドを指定します。 ```shell copy copilot mcp add SERVER-NAME -- COMMAND [ARGS...] ``` リモート HTTP または SSE サーバーの場合は、トランスポートを指定し、URL を指定します。 ```shell copy copilot mcp add --transport http SERVER-NAME URL ``` \*\* `copilot mcp add` オプション：\*\* | オプション | 説明 | | ------------------------------------------------------------- | ------------------------------------------------------- | | `-- [args...]` | ローカル (stdio) サーバーのコマンドと引数。 | | `` | リモート サーバーの URL。 | | `--transport ` | トランスポートの種類: `stdio`、 `http`、または `sse`。 既定値は `stdio` です。 | | `--env KEY=VALUE` | 環境変数 (反復可能)。 | | `--header "HEADER: VALUE"` | リモート サーバーの HTTP ヘッダー (反復可能)。 | | `--tools ` | ツール フィルター: `"*"` すべて、コンマ区切りのリスト、または `""` なし。 | | `--timeout ` | ツールの検出とツール呼び出しのタイムアウト (ミリ秒単位)。 既定値: `30000`。 | | `1`から`4294967295`までの小数部、単位サフィックス、符号、または指数を持たない正の整数である必要があります。 | | | `--json` | JSON として追加された構成を出力します。 | | `--show-secrets` | 完全な環境変数とヘッダー値を表示します。 | `/mcp add` / `/mcp edit`対話型フォームで、`env`フィールドをコンマ区切りの`KEY=VALUE`ペアまたは JSON オブジェクト (`{"API_KEY":"secret"}` など) として入力します。 `$PATH` は既定で含まれており、一覧表示する必要はありません。 > [!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` | いいえ | ツールの検出とツール呼び出しのタイムアウト (ミリ秒単位)。 既定値: `30000`。 | | `type` | いいえ | | | `"local"` または `"stdio"`。 既定値: `"local"`。 | | | | `deferTools` | いいえ | | | `"auto"` (既定) または `"never"`。 | | | | `"never"`に設定すると、ツール検索がアクティブな場合でも、このサーバーのツールが常に表示されます。 | | | | `disableToolCache` | いいえ | このサーバーのツール スナップショットの読み込みと永続化をスキップするには、 `true` に設定します。 | | `slowConnectionThresholdMs` | いいえ | | | Copilot CLIのミリ秒前に、このサーバーの接続に予想以上の時間がかかっていることを警告します。 既定値: `10000`。 この設定は、警告が表示された場合にのみ影響します。接続タイムアウトは変更されません。 | | | | `2147483647`以下の正の整数である必要があります。 | | | `slowConnectionThresholdMs` `timeout`は独立しています。`timeout`は実際の接続予算 (`60000` ミリ秒) を設定しますが、`slowConnectionThresholdMs`は、進行中の接続に対する警告Copilot CLI出力するときにのみ制御します。 認証フローの背後にあるサーバーなどで想定される低速なハンドシェイクを抑制するには、ツール呼び出しの許容時間を延ばすことなく、`slowConnectionThresholdMs` を引き上げます。 ### ツール スナップショットキャッシュ Copilot 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 (動的登録をスキップします)。 | | `oauthScopes` | いいえ | リクエストする OAuth スコープ トークンの空でない配列。 | | `oauthClientId` が必要です。 サーバーの `WWW-Authenticate` チャレンジの空でないスコープが引き続き優先されます。それ以外の場合は、検出された `scopes_supported` メタデータがオーバーライドされます。 | | | | `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` | いいえ | ツールの検出とツール呼び出しのタイムアウト (ミリ秒単位)。 既定値: `30000`。 | | `deferTools` | いいえ | | | `"auto"` (既定) または `"never"`。 | | | | `"never"`に設定すると、ツール検索がアクティブな場合でも、このサーバーのツールが常に表示されます。 | | | | `slowConnectionThresholdMs` | いいえ | | | Copilot CLIのミリ秒前に、このサーバーの接続に予想以上の時間がかかっていることを警告します。 既定値: `10000`。 この設定は、警告が表示された場合にのみ影響します。接続タイムアウトは変更されません。 | | | | `2147483647`以下の正の整数である必要があります。 | | | ### OAuth 再認証 OAuth を使用するリモート MCP サーバーでは、トークンの有効期限が切れたとき、または別のアカウントが必要な場合に、 `needs-auth` 状態が表示される場合があります。 `/mcp auth `を使用して、新しい OAuth フローをトリガーします。 ブラウザー認証プロンプトが開き、サインインまたはアカウントの切り替えが可能になります。 フローが完了すると、サーバーは自動的に再接続します。 Windowsでは、Microsoft Entra IDによって保護されたリモート MCP サーバーは、代わりに OS 認証ブローカー (Web アカウント マネージャー) を介して認証されます。通常はプロンプトは表示されません。 OS ブローカーが存在しない Linux および macOS では、CLI は代わりに、`/login` → Microsoft Entra経由で確立された Entra アカウントからリソースごとのトークンをユーザーに通知せず発行します。 そのアカウントが要求を自動的に満たせない場合 (たとえば、サインインしている Entra ID がない、アカウントがあいまいである、または別のクライアントに対して事前承認されたリソースである場合)、サインインは前述のブラウザー フローにフォールバックします。 `--device-code`を渡すと、ブローカーがバイパスされ、ブラウザー フローではなく OAuth デバイス コード フローが強制され、ブローカー ライブラリのないWindowsマシンもブラウザー フローにフォールバックします。 ### アカウント由来の WorkIQ Microsoft Entra アカウントでサインインすると、ホストされている WorkIQ MCP サーバーが`/mcp`で利用可能になります。 既定では無効になっています。 検出だけでは、接続、トークンの取得、またはツールを利用可能にすることは行われません。通常の MCP コントロール (`/mcp enable WorkIQ` または `copilot mcp enable WorkIQ`) でこれを有効にして、最初にサイレント認証を試してください。 `/mcp auth WorkIQ` は回復用に利用できます。 サーバーは、別のサービスに対して発行されたトークンではなく、サインインした Entra アカウントに関連付けられた資格情報を使用します。その有効化は、別のアカウントに転送するのではなく、その Entra ID に紐づきます。 明示的なサーバー構成と無効化、および組織の許可リストまたは拒否リスト ポリシーが引き続き優先されます。 WorkIQ エントリは `mcp-config.json`に書き込まれません。 これは、独立して認証された stdio サーバーとして `npx @microsoft/workiq mcp` を実行する場合とは関係ありません。 ### ヘッドレス 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`。 | | `computer-use` | 画面キャプチャとマウスとキーボードコントロール。 既定で無効になっています。 | | `/mcp enable computer-use` でのセッション中のみ有効にします。 | | `--disable-builtin-mcps`を使用してすべての組み込みサーバーを無効にするか、`--disable-mcp-server SERVER-NAME`を使用して特定のサーバーを無効にします。 組み込みサーバーは、ユーザー、ワークスペース、プラグイン サーバーと共に、 `copilot mcp list`、 `copilot mcp get`、対話型の `/mcp` ビューに表示されます。 #### 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` | ラベル管理。 | ### リソース検出 実験モードでのみ使用できます。 ローカル機能がない場合、エージェントは、組み込みの `discover-resources` スキルを使用して、追加するパブリック MCP サーバーとスキルをリモート カタログで検索できます。 このスキルは、カタログに対して、関連性がランク付けされた MCP サーバーと抽象機能に一致するスキル ("データベース アクセス" や "アーキテクチャダイアグラム" など) を照会し、選択できる候補を提示します。 スキル自体は何もインストールしません。 `/plugin`、`/mcp`、および`/skills`ダッシュボードには、同じリモート結果をローカル リソース リストにブレンドする型指定されたカタログ検索も含まれます。 ### 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 ツールの呼び出しは、既存の承認や、assisted permissions が有効になっている場合はそれも含めて、セッションのアクセス許可規則の対象となります。 外部サービスに対する読み取り専用操作であっても、承認が必要な場合があります。 ### 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)」を参照してください。 ワークスペース構成ファイルに無効なサーバー エントリが含まれている場合、CLI はそのエントリのみをスキップし、その有効な兄弟を読み込み続け、スキップされたエントリごとに `Warning: workspace MCP config "": ` を出力します。 形式が正しくないファイルまたは読み取り不可能なファイル (無効な JSON または無効な最上位レベルの構造) は、引き続き完全にスキップされます。 ### 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 文字。 コロンでは、名前空間付き名前 (たとえば、 `my-plugin:search`) を使用できます。 | | `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` | カスタム | 追加のディレクトリ (コンマ区切り)。 | | `--add-dir ` | ルートを追加しました | | | `--add-dir`、`/add-dir`、または SDK の `additionalDirectories` で追加されたディレクトリ配下の `.github/skills/`、`.agents/skills/`、`.claude/skills/` これは信頼の決定です。追加されたスキルは、プロジェクト のスキルと同じ信頼で実行されます。 | | | | (CLI にバンドル) | 組み込み | CLI に付属するスキル。 優先順位が最も低く、他のソースによってオーバーライドできます。 | | (組織/エンタープライズ) | リモート | AHP リレーを介して中継される、組織または企業でホストされるスキル。 スキルが呼び出されたときに、コンテンツが必要に応じて取得されます。 | リモート スキルは、ローカル スキルと共に投影され、ローカル スキルの名前が同じである場合は、同じ名前ベースの優先順位に従います。 `ignoredSkillsLocations` 設定を使用すると、特定のディレクトリ（およびその配下のディレクトリ）を検出対象から除外できます。通常であれば上記のどの場所によって検出される場合でも除外されます。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)」を参照してください。 2 つのプラグインが同じ名前のスキルを提供する場合、 `/my-plugin/search` や `/other-plugin/search`などのプラグイン修飾呼び出し名を使用して共存します。 修飾なしの名前は、優先度の高いプラグインに振り分けられます。 これはスキルにのみ適用されます。コマンドは、優先順位の高いソースが優先される Standard レベルベースの重複除去を維持します。 ### 非対話的にスキルを管理する `copilot skill`を使用して、対話型セッションを開かずにコマンド ラインからスキルを管理します。 | サブコマンド | 説明 | | ---------------------------------- | ----------------------------------------------- | | `list [--json]` | 検出されたすべてのスキルを一覧表示します。 | | `add [--project]` | ファイル パス、URL、またはディレクトリからスキルを追加します。 | | `remove ` | 個人またはプロジェクトのスキルを削除するか、カスタム スキル ディレクトリの登録を解除します。 | | `enable ` / `disable ` | 名前でスキルを有効または無効にします。 | ```bash # Install a skill for your user account (default) copilot skill add ./my-skill/SKILL.md # Install a skill into the current project (.github/skills; file or URL skills only) copilot skill add --project ./my-skill/SKILL.md # Enable, disable, or remove a skill by name copilot skill enable my-skill copilot skill disable my-skill copilot skill remove my-skill ``` ディレクトリをインストールすると、コピーするのではなく、カスタム スキル ソースとして登録されます。 ファイルまたは URL をインストールすると、スキルのコンテンツが個人またはプロジェクトのスキル ディレクトリにコピーされます。 同等の対話型コマンドが `/skills add [--project] `。 `copilot skill list --json` 行は `{ name, description, source, path, enabled }` の形状です。 `remove`では、スキル名または追加したカスタム スキル ディレクトリへのパスを渡します。スキル名はそのスキルのファイルを削除します。一方、カスタム ディレクトリ パスはディレクトリの登録を解除し、そのファイルをディスク上に残すだけです。 追加した個人およびプロジェクトのスキルのみを削除できます。プラグインまたは組み込みセットによって提供されるスキルは、この方法では削除できません (代わりに無効にします)。 これにより、廃止された `copilot plugins install --skill [--scope project]` と `copilot plugins remove/enable/disable --skill`が置き換えられます。 ### コマンド (代替スキル形式) コマンドは、`.md`に個々の`.claude/commands/` ファイルとして格納されるスキルの代わりに使用できます。 コマンド名はファイル名から派生します。 コマンド ファイルは簡略化された形式 ( `name` フィールドは不要) を使用し、 `argument-hint`、 `description`、 `allowed-tools`、および `disable-model-invocation`をサポートします。 コマンドの優先順位は、同じ名前のスキルよりも低くなります。 ## 拡張モード > [!NOTE] > GitHub Copilot CLI 拡張機能は現在試験的な機能であり、変更される可能性があります。 対話型セッションでは、`/extensions mode` が、拡張機能を実行するかどうかと、Copilot がそれらを管理できるかどうかを制御します。 | モード | 実行された拡張機能 | エージェントは拡張機能を管理できる | | ------------------ | --------- | ----------------- | | **読み込みおよび増強** (既定) | はい | はい | | **読み込み専用** | はい | いいえ | | **Disabled** | いいえ | いいえ | **Load & Augment** モードでは、エージェントには、検出された拡張機能の一覧表示、状態とログの検査、スターター拡張機能のスキャフォールディング、コード変更後の拡張機能の再読み込みを行うツールがあります。 これにより、エージェントはリクエストの一部として拡張コードを作成して読み込むことができます。 エージェント拡張機能管理ツールを提供せずに既存の信頼された拡張機能のセットを実行するには、\[ **読み込み専用** ] を選択します。 エージェントは、実行中の拡張機能によって提供されるツールを引き続き呼び出すことができます。 モードの変更は、現在のセッションですぐに有効になります。 * **Disabled** に切り替えると、拡張機能プロセスの実行が停止し、ツールが削除されます。 * **Disabled** からいずれかの読み込みモードに切り替えると、拡張機能が開始されます。 * **読み込み専用** と **読み込みと拡張** を切り替えると、拡張機能を停止せずに拡張機能管理ツールへのアクセスが変更されます。 拡張機能の無効化は、読み込みモードを選択するまで、今後のセッションで保持されます。 既に実行されている他のセッションは影響を受けません。 拡張機能とその状態を調べるには、 `/extensions manage`を使用します。 検出箇所と実装例については、[GitHub Copilot CLI 用の拡張機能の作成](/ja/copilot/tutorials/create-an-extension)を参照してください。 ## カスタム エージェント リファレンス カスタム エージェントは、Markdown ファイルで定義されている特殊な AI エージェントです。 ユーザー、プロジェクト、および追加ルート エージェントの場合、エージェント ID は、 `agents` ディレクトリを基準としたファイルのパスから派生します。 CLI は、 `.agent.md` または `.md` 拡張機能を削除し、ディレクトリ区切り記号を `--`に置き換えます。 たとえば、 `agents/team/reviewer.agent.md` には ID `team--reviewer`があります。 ### 組み込みエージェント | エージェント | 既定のモデル | 説明 | | ----------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `code-review` | claude-sonnet-4.6 | ノイズに対する信号の比率が高いコードレビュー。 バグ、セキュリティの問題、およびロジック エラーの差分を分析します。 コードを変更しません。 | | `explore` | gpt-5.6-luna | 高速なコードベース探索。 ファイルを検索し、コードを読み取り、質問に回答します。 300 語以下のフォーカスされた回答を返します。 並列で安全に実行できます。 | | `general-purpose` | claude-sonnet-4.6 | 複雑なマルチステップ タスク用のフル機能エージェント。 別のコンテキスト ウィンドウで実行されます。 | | `research` | claude-haiku-4.5 | 命令に基づいて完全な検索を実行します。 リポジトリ GitHub 検索し、ファイルをフェッチし、クレームを検証し、引用文献を使用して詳細な結果を報告します。 | | `rubber-duck` | 補完モデル | 補完的なモデルを使用して、提案、設計、実装、またはテストの建設的な批判を提供します。 弱点を特定し、改善を提案します。 「[ゴムダックエージェントで別の視点を得る](/ja/copilot/concepts/agent-capabilities/choosing-and-delegating-agent-work/getting-a-second-opinion)」を参照してください。 | | `security-review` | claude-sonnet-4.6 | セキュリティに重点を置いたコード レビュー。 11 のカテゴリにわたる信頼性の高い脆弱性の変化を分析します。 悪用可能性の確信度が80%を超える問題にのみフラグを付けます。 重大度と信頼度スコアを報告します。 コードを変更しません。 | | `task` | gpt-5.6-luna (claude-haiku-4.5 にフォールバック) | コマンドの実行 (テスト、ビルド、リント)。 成功に関する簡単な概要を返し、失敗した場合は完全な出力を返します。 | `code-review` `security-review`完全なレビューを別のレビュー エージェントに転送することはありません。1 つを起動すると、レビュー担当者を "使用" または "呼び出す" 要求が既に満たされるため、委任チェーン全体にわたって、入れ子になった`code-review`にタスク全体を委任したり、サブエージェントを再帰的に`security-review`するのではなく、レビュー自体を実行します。 `code-review` 要求のセキュリティに重点を置いた部分については、引き続き専用の `security-review` スペシャリストに引き続き依頼します。両方のエージェントは、 `explore`などのレビュー以外のエージェントに対して、個別に範囲を絞った狭いファクト検索作業を委任できます。 `store_memory`または`vote_memory`を呼び出してメモリを保存または投票できるのは、ルート エージェントだけです。 サブエージェントは、 `read_memories`を介して格納されているメモリへの読み取りアクセスを保持しますが、書き込みや投票はできません。 ### カスタムエージェントのフロントマター フィールド | フィールド | タイプ | 必須 | 説明 | | ---------------------------------------------------------------------------------------------------------------------------------- | --------- | --- | ------------------------------------------------------------------------------------------------------------------------------------ | | `description` | 文字列 | はい | エージェントの一覧と `task` ツールに表示される説明。 | | `include-custom-instructions` | ブーリアン | いいえ | このエージェントがサブエージェントとして実行されるときに、リポジトリ命令ファイル (`copilot-instructions.md`、 `AGENTS.md`、 `CLAUDE.md`) を含めます。 既定値: `false`。 | | [サブエージェントについては、リポジトリのカスタム手順を](#repository-custom-instructions-for-subagents)参照してください。 | | | | | `infer` | ブーリアン | いいえ | メイン エージェントによる自動委任を許可します。 既定値: `true`。 | | `mcp-servers` | オブジェクト | いいえ | 接続する MCP サーバー。 | | `~/.copilot/mcp-config.json`と同じスキーマを使用します。 | | | | | `model` | 文字列 | いいえ | このエージェントの AI モデル。 設定を解除すると、外部エージェントのモデルが継承されます。 セッション モデルが `Auto` (サーバー選択) に設定されている場合、サブエージェントは、このフィールドに関係なく、解決されたセッション モデルを常に継承します。 | | `models` | string\[] | いいえ | 優先順位で作成されたモデル。 ランタイムは、ユーザーのプランがアクセスできる最初のモデルを使用します。何も解決しない場合、ディスパッチはセッションのモデルにフォールバックします。 両方が設定されている場合 `model` をオーバーライドします。 | | `modelPolicy` | 文字列 | いいえ | | | `"preferred"` (既定値) により、`subagents` でオーバーライドされた `model`/`models` を `~/.copilot/settings.json` または `/subagents` のピッカー内でオーバーライドできます。 | | | | | `"required"` によって、作成済みモデルのいずれか 1 つへのディスパッチに固定され、オーバーライドは拒否され、ピッカーの **Model** エントリは無効になります。 | | | | | `name` | 文字列 | いいえ | 表示名。 この値を使用して、 `--agent`など、エージェントを選択することもできます。 既定値はエージェント ID です。 | | `reasoningEffort` | 文字列 | いいえ | このエージェントの既定の推論作業 ( `"low"`、 `"medium"`、 `"high"`など)。 設定を解除すると、外部エージェントの作業が継承されます。 | | `tools` | string\[] | いいえ | エージェントで使用できるツール。 既定値: `["*"]` (すべてのツール)。 | | `*`リスト内の任意の場所に含めて、完全なツール アクセスを許可します。たとえば、`view`だけでなく、すべてのツール`["view", "*"]`許可します。 | | | | `model`、 `models`、 `modelPolicy`、 `reasoningEffort` は、 `task` ツールを使用してエージェントをディスパッチするか、SDK の `session.startSubagent`を通じて直接開始するかを適用します。 モデルと作業は、呼び出しごとの明示的な値、`~/.copilot/settings.json`での`subagents`のオーバーライド、エージェント定義の`model`/`models`/`reasoningEffort` フィールド、親セッションの値など、最も優先順位の高い順に解決されます。 宣言されたモデルまたは取り組みを受け入れることができない場合は、エージェントが `modelPolicy: "required"`を宣言しない限り、ディスパッチを失敗させる代わりにセッションの値にフォールバックします。この場合、ディスパッチは承認されていないモデルをサイレントに置き換えるのではなく拒否されます。 ### カスタム エージェントの場所 CLI は、次の優先順位でカスタム エージェントを読み込みます。 エージェントの ID が同じである場合は、最初に読み込まれたエージェントが使用されます。 | 優先度 | Scope | 場所 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | -------------------- | | 1 (最高) | User | `~/.copilot/agents/` | | 2 | プロジェクト | | | `.github/agents/`、現在の作業ディレクトリから Git ルートディレクトリまでさかのぼって | | | | 3 | プロジェクト | | | `.claude/agents/`、現在の作業ディレクトリから Git ルートディレクトリまでさかのぼって | | | | 4 | ルートを追加しました | | | `/add-dir`、`additionalDirectories`、または SDK の `.claude/agents/` で追加されたディレクトリ配下の `.github/agents/` と `--add-dir` ディレクトリの追加は信頼の決定です。そのエージェントは信頼された構成として読み込まれます。 | | | | 5 | プラグイン | `/agents/` | | 6 (最低) | リモート | 組織またはエンタープライズ エージェント | 各プロジェクト行内で、CLI は現在の作業ディレクトリを最初にチェックし、次に各親ディレクトリを Git ルートまでチェックするため、最も深いディレクトリの優先度が最も高くなります。 すべてのプロジェクト `.github/agents/` ディレクトリは、プロジェクト `.claude/agents/` ディレクトリの前に読み込まれます。 つまり、monorepo 内の各パッケージまたはサブディレクトリは、独自のエージェントを提供できます。 省略可能な `name` frontmatter フィールドは重複除去を制御しません。 同じ `name` を持ち、ID が異なるエージェントは、両方とも読み込まれます。 `--agent`に渡された値が複数のエージェントの ID または`name`と一致する場合、CLI は上記の優先順位で最初に一致するエージェントを使用します。 ### サブエージェントのリポジトリカスタム命令 `task` ツールまたは SDK の`session.startSubagent`を使用してサブエージェントとして生成されたカスタム エージェントは、既定でリポジトリ命令ファイル (`copilot-instructions.md`、`AGENTS.md`、`CLAUDE.md`) を受け取りません。 frontmatter に `include-custom-instructions: true` を設定してオプトインします。 ```markdown --- name: RepoAwareReviewer description: Reviews a change against this repository's conventions tools: ["*"] include-custom-instructions: true --- Review the change and flag anything that violates the repository's conventions. ``` | エージェント | リポジトリの指示を受け取ります | | -------------------------------------------------------- | ------------------------------------------ | | セッション エージェント (既定のエージェント、または `--agent` で選択されたカスタム エージェント) | はい | | `general-purpose` サブエージェント | はい | | 内蔵の `explore`、`task`、`code-review` サブエージェント | いいえ | | サブエージェントとして生成されたカスタム エージェント | 次の場合のみ `include-custom-instructions: true` | サブエージェントが `include-custom-instructions: true` を持っている場合、リポジトリ独自の指示ファイル（`copilot-instructions.md`、`AGENTS.md`、`CLAUDE.md`）を読み込みます。 メイン セッションに対してのみ読み込んだ追加の命令ディレクトリ (たとえば、 `COPILOT_CUSTOM_INSTRUCTIONS_DIRS`でセッションを指した個人用ディレクトリ) は継承されません。 `--no-custom-instructions`を使用したセッションの開始は常に優先されます。このオプションを使用する場合、エージェントはリポジトリ命令を受け取りません (`include-custom-instructions: true`を設定する場合でも)。 コードをレビューまたは編集するエージェントなど、リポジトリの規則に従う必要があるエージェントに対してのみ、設定をオンにします。 リポジトリの指示は、実行するたびにエージェントが処理する内容に追加されるため、不要なエージェント (たとえば、ファイルの検索やテキストの要約のみを行うエージェント) の設定をオフのままにすると、それらのエージェントの実行時間が短縮され、コストが低くなります。 詳細については、「[GitHub Copilot CLI のカスタムエージェントの作成と使用](/ja/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)」を参照してください。 ### エージェント通信 カスタム エージェント内で `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 ルートまたは現在のディレクトリ) を決定できる場合に表示されます。 承認はディスクに保持されるため、次回そのディレクトリで作業するときに、再度プロンプトを表示せずに同じアクセス許可が自動的に付与されます。 シェル コマンドでツールの承認と、許可されたディレクトリの外部のパスへのアクセスが必要な場合、CLI は両方の承認を 1 つのプロンプトで組み合わせることができます。 1 回承認すると、その実行時にのみパスへのアクセスが許可されます。 セッションまたは場所に対して承認すると、セッションの残りの部分のパス アクセスも許可されます。 `/reset-allowed-tools`を使用して、現在のセッションのセッション承認をクリアします。 ## セキュリティ ### プラン モード `/plan` は、 Copilot CLI がコードベースを調査および分析できるが、プロジェクト ファイルの編集がブロックされる計画セッションを開始します。 Specifically: * **プロジェクト ファイルは保護されています。** ワークスペース内のファイルを変更するシェル コマンドの編集、修正プログラムの適用、または実行の試行は自動的にブロックされます。これはモデルに対する単なる提案ではなく、直接適用されるため、動作を選択するモデルに依存しません。 * **プラン自体は引き続き記述できます。** Copilot には、メモを保持し、計画の下書きを行う場所が必要であるため、独自のプライベート計画ワークスペース (確認して承認するプラン ファイルを含む) でファイルを作成および編集できます。 * **委任されたサブタスクも保護されます。** Copilotが質問の一部を調査するためにヘルパー セッションを開始した場合、そのヘルパーは同じ制限を継承し、プロジェクトも編集できません。 * **これは、保証ではなく、セーフティ ネットです。** この保護機能は、ファイルを変更しようとする明白で直接的な試みを検知するように設計されていますが、万全の防御策というわけではありません。 調査が過度に制限されないように意図的に許可されるものもあります。たとえば、効果を事前に明確に判断できないシェル コマンドや、接続した外部/MCP ツールの呼び出しなどです。 実際には、これはほとんど問題ではありませんが、プラン モードは、ディスク上の何も変更できないという絶対的な保証ではなく、"変更を適用する前にレビューが必要です" と考える必要があります。 プランに満足したら、プラン モードを終了することを承認し、 Copilot 実際の変更を行います。 ### コマンドの安全性分析 シェル コマンドは実行前に分析され、潜在的に危険なパターンを特定します。 * ファイルの削除 (`rm -rf`) * システムの変更 (`sudo`、 `chmod 777`) * ネットワーク流出 (機密性の高いパスを使用した `curl`) * 資格情報アクセス ( `.env`、SSH キーの読み取り) * 危険な変数 (たとえば、 `PATH=...`、 `LD_PRELOAD=...`) をオーバーライドするインライン環境変数の割り当て 危険度の高いコマンドは、追加の警告と承認プロンプトをトリガーできます。 要求に承認が必要かどうかは、有効なアクセス許可によって異なります。 サンドボックスが有効で、\[ **サンドボックスのバイパスを許可する** ] 設定がオン (既定) の場合、サンドボックスのファイルシステムまたはネットワーク ポリシーによってブロックされる同期シェル コマンドによって、サンドボックスの外部で再実行するように求められます。モデルのラウンドトリップは必要ありません。 プロンプトを承認すると、コマンドが再実行され、その出力が返されます。 拒否すると、サンドボックス化された（ブロックされた）結果が保持されます。 サンドボックス バイパス プロンプトにも **\[はい] が表示され、このセッションの残りの部分ではサンドボックスが無効になります** 。 これを選択すると、承認されているコマンドだけでなく、現在のセッションの残りのコマンドごとにサンドボックスがオフになります。 これは、現在のセッションにのみ適用されます。 `/new` サンドボックス コマンドを使用して新しいセッションを再度開始します。このオプションは、保存された `sandbox` 構成設定やその他の実行中のセッションには影響しません。 デタッチされた（バックグラウンド実行された）コマンドは、まったくサンドボックス化できません。ツール呼び出しより長く存続するプロセスは、サンドボックスの対象にできないためです。 **\[サンドボックスのバイパスを許可**する] 設定がオンの場合、この設定では、完全に拒否されるのではなく、コマンドが開始される前に承認が求められます。 承認すると、コマンドが最初からアンボックス化されて実行されます。 サンドボックス ポリシーが拒否キャプチャをサポートするWindowsホストでは、ブロックされた対話型シェル コマンドは、完全バイパスに直接ジャンプするのではなく、1 つのステップでエスカレートされます。 ファイルとプロセスの制限がブロックではなく記録されるように設定されたコマンドを再実行することを承認すると (ネットワーク ポリシーは引き続き適用されます)、コマンドがまだブロックされている場合にのみ、公開された完全バイパスにフォールバックします。 エスカレーション全体に対して表示されるプロンプトは 1 つだけです。 ループバック ソケットまたはローカル ネットワーク ソケットへのアクセスが拒否された場合も、(たとえば `127.0.0.1` へのバインドや接続など)、黙って失敗するのではなく、同じエスカレーションが発生します。 再試行の結果は、ネットワーク ポリシーがまだ適用されている場合は "サンドボックス 緩和" というラベルが付けられます。完全にアンサンドボックス化されている場合は "サンドボックス バイパス" というラベルが付けられます。 再試行が失敗しても、ホスト レベルのアクセス許可が引き続き適用されることを示すメッセージが表示されます。 `EPERM` または `EACCES` のうち、サンドボックスによってブロックされたパスを示す診断メッセージを伴って失敗したコマンドで、コマンド ライン自体にそのパスが含まれていない場合でも、サンドボックスの外で実行するオプションが提示されるようになりました。 拒否が原因で、ターゲットがサンドボックス ポリシーによって許可された内容をエスケープするシンボリック リンクが原因である場合、拒否は、許可されたパスのリンクが許可の外側を指し示し、実際のターゲットに名前を付けるので、サンドボックス ポリシーに追加するパスを正確に把握していることを説明します。 詳細については、「[ローカル サンドボックス設定の構成](/ja/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings#allowing-sandbox-bypass)」を参照してください。 #### 環境変数の拒否リスト 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 事前解決によってブロックされます。 * **検証済みのリダイレクト**: `web_fetch` は `3xx` リダイレクト (60 秒のネットワーク予算内で最大 10 ホップ) に従い、各ホップのターゲットを同じ IP ブロックリストに対して再検証してから、それに従います。 元の URL とは異なる配信元へのリダイレクトには、他のクロスオリジン フェッチと同じアクセス許可の承認が必要です。同じ配信元のリダイレクトは、追加のプロンプトなしで実行されます。 最終結果には、コンテンツが `(redirected from )` された時点が記されています。 サンドボックスが有効になっている場合、要求はアクセス許可プロンプトの前にサンドボックス ネットワーク ポリシー (送信アクセス、ローカル およびプライベート ホスト) に対してチェックされるため、ポリシーによってブロックされたターゲットはプロンプトではなく高速に失敗します。 **\[サンドボックス のバイパスを許可する**] 設定がオンで、サンドボックス ネットワーク プロキシが URL に到達できない場合 (ポリシーによって拒否される URL ではなく) `web_fetch`、サンドボックスの外部で要求を再試行するように求められます。 承認すると、フェッチがもう一度試行され、その結果が返されます。 開発中に `web_fetch` が `localhost` に到達できるようにするには (たとえば、ローカル ドキュメント サーバーの場合)、次の環境変数を設定します。 ```bash export COPILOT_WEB_FETCH_ALLOW_LOCALHOST=1 ``` ### サンドボックス ツール ディレクトリのアクセス許可 ローカル サンドボックスが有効になっている場合、 Copilot CLI は、サンドボックス化されたコマンドが必要とする可能性が高いツール ディレクトリを検出し、それぞれ 1 つの **読み取り専用** アクセス権を付与します。そのため、コマンドは、インストールされているツールチェーンを変更せずに実行できます。 検出は、プロセスが開始される前にコマンドごとに実行され、コマンドの環境から 2 種類のソースを読み取ります。 * **`PATH`**(Windowsで`Path`)。 列挙された各ディレクトリは、いずれも付与候補です。 * **名前付きツールチェーン変数。** CLI は、次の表の変数を調べます。 ディレクトリ値は、そのディレクトリへのアクセスを付与します。 パス リストは、オペレーティング システムのパス区切り記号 (Windowsのセミコロン、他の場所のコロン) で分割され、各エントリは候補の許可になります。 Git ファイル変数は、macOS と Linux でのみ検査されます。 ディレクトリ候補は、ディレクトリとして存在する絶対パスである場合にのみ付与されます。 相対パス、見つからないパス、ファイルシステム ルート ( `/` や `C:\`など)、システムクリティカルな場所は検出から除外されます。 除外される場所の例としては、Windows では `/bin`、macOS と Linux では `/sbin`、`/usr/bin`、`/usr/sbin`、`/boot`、`/proc`、`/sys`、`/dev`、および `%WINDIR%` があります。 理由は `sandbox_spawn`に記録されます。 これらの付与は、シンボリック リンクのターゲットを自動的に追加するのではなく、パス表記を維持します。 リンク経由のアクセスがブロックされている場合は、目的のターゲットへのアクセスを明示的に許可します。 重複するディレクトリは、Windowsでは大文字と小文字を区別せずに削除されます。 | Variable | ツールチェーン | 価値 | 通常はオンに設定されます。 | | ----------------------- | ------------------ | -------- | ------------- | | `BAZEL_VC` | Bazel / Visual C++ | 単一ディレクトリ | Windows | | `BAZEL_VS` | バゼル/Visual Studio | 単一ディレクトリ | Windows | | `BAZELISK_HOME` | Bazelisk | 単一ディレクトリ | All | | `BAZELISK_HOME_DARWIN` | Bazelisk | 単一ディレクトリ | macOS | | `BAZELISK_HOME_LINUX` | Bazelisk | 単一ディレクトリ | Linux | | `BAZELISK_HOME_WINDOWS` | Bazelisk | 単一ディレクトリ | Windows | | `CONDA_PREFIX` | Conda | 単一ディレクトリ | All | | `DOTNET_ROOT` | .NET | 単一ディレクトリ | All | | `GIT_CONFIG_SYSTEM` | Git システム構成 | ファイル | macOS と Linux | | `GIT_EXEC_PATH` | Git ヘルパー | 単一ディレクトリ | All | | `GIT_SSL_CAINFO` | Git 証明書バンドル | ファイル | macOS と Linux | | `GIT_SSL_CAPATH` | Git 証明書 | 単一ディレクトリ | All | | `GIT_TEMPLATE_DIR` | Git テンプレート | 単一ディレクトリ | All | | `GOPATH` | Go | パスリスト | All | | `GOROOT` | Go | 単一ディレクトリ | All | | `JAVA_HOME` | Java | 単一ディレクトリ | All | | `LD_LIBRARY_PATH` | 共有ライブラリ | パスリスト | Linux | | `NODE_PATH` | Node.js | パスリスト | All | | `NVM_HOME` | Node.js (nvm) | 単一ディレクトリ | Windows | | `NVM_SYMLINK` | Node.js (nvm) | 単一ディレクトリ | Windows | | `PATH` / `Path` | 実行可能ファイル (すべて) | パスリスト | All | | `PSModulePath` | PowerShell | パスリスト | All | | `PYENV_ROOT` | Python (pyenv) | 単一ディレクトリ | All | | `PYTHONHOME` | Python | 単一ディレクトリ | All | | `PYTHONPATH` | Python | パスリスト | All | | `RUSTUP_HOME` | Rust (rustup) | 単一ディレクトリ | All | | `VCINSTALLDIR` | Visual C++ | 単一ディレクトリ | Windows | | `VCPKG_ROOT` | vcpkg | 単一ディレクトリ | All | | `VIRTUAL_ENV` | Python (venv) | 単一ディレクトリ | All | | `VSINSTALLDIR` | Visual Studio | 単一ディレクトリ | Windows | 2 つの Git ファイル変数を除き、各変数はすべてのプラットフォームで読み取られます。 **通常設定先** 列には、それぞれが通常入力される場所が表示されます。 未設定の変数は何の影響もありません。 `CARGO_HOME` は、選択した Cargo ディレクトリとファイルに対するツール固有の許可によって個別に処理されます。 Cargo ホーム全体へのアクセス権は付与されません。 開発者ツールの付与は、Go キャッシュや NuGet キャッシュなど、再配置されたキャッシュに従うこともできます。 自動付与はこれらだけではありません。 **\[開発ツールのアクセスを許可する]** を有効にすると、Copilot CLI は、macOS および Linux の `~/.local/bin` と `~/.local/lib`、および Windows の `%LOCALAPPDATA%\Programs` の直下のサブディレクトリを含む、選択したユーザー プロファイル アプリケーション ディレクトリへのアクセス権を付与します。 また、ツール固有のキャッシュとレジストリも付与されます。その一部は、npm のキャッシュや共有ビルド キャッシュなど、書き込み可能です。 `/sandbox policy`を実行して、解決されたパスがソースとアクセスによってグループ化されていることを確認します。 **\[開発ツール]** セクションには、現在のディレクトリで検出されたツールとそのパスが一覧表示されます。 `/sandbox policy npm install` などのコマンドを追加して、実行せずにその開発者ツールへのアクセスを検査します。 このレポートは不足しているキャッシュを作成しません。 ポリシーの組み立て方法の背後にある概念については、 [GitHub Copilot CLI のローカル サンドボックスに関するファイルシステム ポリシーを理解する](/ja/copilot/concepts/security-governance-and-network-settings/understanding-local-sandboxing) を参照してください。 ## OpenTelemetry の監視 Copilot 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-administrators/enterprise-managed-settings)を参照してください。 ### 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`)。 | ### 動的認証ヘッダー ユーザー設定またはエンタープライズ管理テレメトリ ポリシーで `telemetry.headersProvider` を設定して、新しい OTLP ヘッダーを指定するためのコマンドを実行します。 リポジトリの設定では、この設定は適用されません。 ```json { "telemetry": { "headersProvider": { "path": "node", "args": ["bin/otel-headers.js"], "refreshIntervalMs": 1740000 } } } ``` | フィールド | 説明 | | ------------------- | -------------------------------------------------------------- | | `path` | 実行可能ファイル名、絶対パス、またはホーム相対パス。 これはシェル コマンドではなく、ワークスペース相対パスは拒否されます。 | | `args` | 省略可能な引数、そのまま渡されます。 スクリプトのインタープリターを明示的に選択します (たとえば、 `node`)。 | | `refreshIntervalMs` | オプションの更新間隔。 既定値: 29 分。 | 動的ヘッダーを無効にするには、 `headersProvider` を `false` に設定します。 * このコマンドは、ホームディレクトリから30秒以内に実行します。 stdout は、文字列ヘッダー値の JSON オブジェクトである必要があります。 空のオブジェクトは、動的ヘッダーをクリアします。 * プロバイダーは、アクティブな HTTP OTLP エクスポーターに対してのみ動作します。 HTTP エンドポイントが警告を生成し、OTLP リダイレクトが拒否されるため、HTTPS を使用します。 * ヘッダーの優先順位 (最高から最下位): マネージド ヘルパー出力、マネージド 静的ヘッダー、ユーザー ヘルパー出力、次に `OTEL_EXPORTER_OTLP_HEADERS`。 マネージド ヘルパーはユーザー ヘルパーをオーバーライドし、マネージド `false` はヘルパーを無効にします。 * 更新が失敗した場合、動的ヘッダーを必要とするエクスポートは、次の更新までブロックされます。 ### 痕跡 ランタイムは、エージェントの相互作用ごとに階層型スパン ツリーを生成します。 各ツリーには、`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` | 使用可能な場合、Copilotからの仮名化された`analytics_tracking_id`ユーザー識別子 | 両方とも | | `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.nano_aiu` | 使用される AI ユニット (ナノ AI ユニット単位) (1 AIU = 1,000,000,000 ナノ AIU) | 両方とも | | `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.nano_aiu` | このターンで使用された AI ユニット (ナノ AI ユニット単位 ) (1 AIU = 1,000,000,000 ナノ AIU) | | `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 としてのツール出力 (コンテンツ キャプチャのみ) | > [!NOTE] > AI ユニットの消費量を測定するには、ルート `invoke_agent`スパンからのみ`github.copilot.nano_aiu`を読み取ります。 この属性は子の `chat` スパンにも付与されるため、すべてのスパンで合算すると二重カウントになります。 > `github.copilot.cost` は、課金計算に使用される要求ごとのモデル乗数です。通貨値ではなく、1 つとして解釈することはできません。 ### 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.duration` | ヒストグラム | s | 1つのエージェント呼び出しのエンドツーエンド時間 | | `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`。 | | `gen_ai.invoke_workflow.duration` | ヒストグラム | s | GenAI ワークフローのエンドツーエンドの所要時間（たとえば、並列サブエージェントをオーケストレーションするフリート モードの実行）。 | #### ベンダー固有のメトリック | メトリクス | タイプ | 単位 | 説明 | | -------------------------------------------- | ------ | -------- | -------------------------------- | | `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` | カウンタ | attempts | トランスポート別および結果別の完了した 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)