# GitHub Copilot CLI の構成ディレクトリ ~/.copilot ディレクトリに関する情報を検索します。Copilot CLIには、構成、セッション データ、およびカスタマイズが格納されます。 Copilot CLI では、構成、セッション履歴、ログ、カスタマイズがコンピューター上の 1 つのディレクトリに格納されます。 既定では、このディレクトリは `~/.copilot` (つまり、 `$HOME/.copilot`) です。 この記事では、このディレクトリの内容とその使用方法について説明します。 ## ディレクトリの概要 `~/.copilot` ディレクトリには、次の最上位項目が含まれています。 | Path | タイプ | 説明 | | ------------------------- | ------ | ------------------------------------------------------- | | `agents/` | ディレクトリ | 個人用カスタム エージェント定義 | | `config.json` | File | 自動的に管理されるアプリケーションの状態 (認証、インストールされているプラグイン、およびその他の内部データ) | | `copilot-instructions.md` | File | 個人のカスタム命令 (すべてのセッションに適用) | | `extensions/` | ディレクトリ | CLI によって読み込まれた個人用拡張機能 | | `hooks/` | ディレクトリ | ユーザー レベルのフック スクリプト | | `ide/` | ディレクトリ | IDE 統合状態 | | `installed-plugins/` | ディレクトリ | インストールされているプラグイン ファイル | | `instructions/` | ディレクトリ | その他の個人用 `*.instructions.md` ファイル | | `logs/` | ディレクトリ | セッション ログ ファイル | | `lsp-config.json` | File | ユーザー レベルの LSP サーバー定義 | | `mcp-config.json` | File | ユーザー レベルの MCP サーバー定義 | | `mcp-oauth-config/` | ディレクトリ | MCP OAuth トークンと登録フォールバック ストレージ | | `mcp-secrets/` | ディレクトリ | MCP シークレット プレースホルダーのローカル フォールバック ストレージとインデックス | | `permissions-config.json` | File | プロジェクトごとに保存されたツールとディレクトリのアクセス許可 | | `plugin-data/` | ディレクトリ | インストールされているプラグインの永続的なデータ | | `providers.json` | File | ユーザー レベルの Bring Your Own-Key (BYOK) プロバイダーとモデル レジストリ | | `session-state/` | ディレクトリ | セッション履歴とワークスペース データ | | `command-history-state/` | ディレクトリ | コマンド履歴データ | | `session-store.db` | File | セッション間データ用の SQLite データベース | | `settings.json` | File | 個人用の構成設定 | | `skills/` | ディレクトリ | 個人のカスタム スキル定義 | > [!NOTE] > これらの項目のすべてがすぐに表示されるわけではありません。 一部は、特定の機能を初めて使用したときにオンデマンドで作成されます。たとえば、 `installed-plugins/` は、最初のプラグインをインストールした後にのみ表示されます。 ## ユーザーが編集可能なファイル 次のファイルは、ユーザーが直接編集するか、CLI コマンドを使用して管理するように設計されています。 ### `settings.json` これは、 Copilot CLIのプライマリ構成ファイルです。 セッション内では、対話型の `/settings` コマンドを使用して特定の値を変更したり、 `/settings KEY VALUE` を実行して 1 つの値を設定したりできます。 「[\`/settings\` コマンドを使用して設定を変更する](/ja/copilot/how-tos/copilot-cli/customize-copilot/change-settings)」を参照してください。 または、テキスト エディターで `settings.json` ファイルを直接編集することもできます。 このファイルは、コメント付き JSON (JSONC) をサポートしています。 既定では、このファイルはユーザー レベルの構成ディレクトリである `~/.copilot` ディレクトリにあります。 これには、すべてのリポジトリのグローバル ユーザー レベルの既定値が含まれています。 このディレクトリの場所を変更するには、 `COPILOT_HOME` 環境変数を別のパスに設定します。 > [!NOTE] > ユーザーが編集可能な設定は、 `settings.json`に格納されます。 これらの設定は、もともと `config.json`に格納されていました。 > `config.json`のすべてのユーザー設定は無視されます。 このファイルは、インストールされているプラグインや信頼されたフォルダーなどの内部状態を格納するために使用されます。 `settings.json`が読み取り、解析、または検証に失敗した場合、Copilot CLIは無効な値を無視し、\*\*\*\* コマンドの `/settings` タブへ誘導する起動時の警告をタイムラインに表示します。 そのタブを開いて特定のエラーを表示し、報告された問題を修正して、影響を受ける設定を復元します。 認識されない設定 (入力ミスなど) ではない最上位のキーが`settings.json`に含まれている場合は、タイムラインまたは stderr ではなく、`/settings` コマンドの \[**問題**] タブに一覧表示Copilot CLI。 タブのラベルには、構成スコープに問題がある場合の数 (たとえば、 `Problems (2)`) が表示されます。 `$schema` は許容され、報告されません。 `~/.copilot/settings.json`がシンボリック リンクである場合 (たとえば、dotfiles リポジトリを介して設定を同期する場合)、`/settings` コマンドからの書き込みは、シンボリック リンクを通常のファイルに置き換えるのではなく、シンボリック リンクに従ってターゲットを更新します。 設定の完全な一覧と、リポジトリ レベルの構成との対話方法については、この記事で後述する [構成ファイルの設定](#configuration-file-settings) を参照してください。 > [!TIP] > ターミナルで `copilot help config` を実行してクイック リファレンスを確認します。 セッションの外部で、シェルから `copilot config` を使用して非対話形式で設定を読み取ったり変更したりします。これは `/settings` スラッシュ コマンドに対応するスクリプトです。 ユーザー設定ファイルではなく、`.github/copilot/settings.json` または `.github/copilot/settings.local.json` をターゲット `--repo` または `--local` に追加します。[リポジトリでオーバーライド可能なキー](#repository-settings-githubcopilotsettingsjson)のみを書き込むことができます。 完全なコマンド リファレンスについては、 [GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#using-copilot-config) を参照してください。 ### `copilot-instructions.md` 作業しているプロジェクトに関係なく、すべてのセッションに適用される個人のカスタム指示。 このファイルはリポジトリ レベルの `copilot-instructions.md` と同じように動作しますが、グローバルに適用されます。 詳細については、「[GitHub Copilot用のリポジトリカスタム命令の追加](/ja/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)」を参照してください。 ### `instructions/` 追加の個人用命令ファイルを `*.instructions.md` ファイルとしてここに格納します。 これらは `copilot-instructions.md` と共に読み込まれ、すべてのセッションに適用されます。 `~/.copilot/instructions/code-style.instructions.md`など、トピックごとに手順を整理できます。 ### `mcp-config.json` ユーザー レベルで使用できる MCP (モデル コンテキスト プロトコル) サーバーを定義します。 これらのサーバーは、使用しているプロジェクト ディレクトリに関係なく、すべてのセッションで使用できます。 Projectレベルの MCP 構成 (`.mcp.json` または `.github/mcp.json`) は、サーバー名の競合時にユーザー レベルの定義よりも優先されます。 詳細については、「[GitHub Copilot CLI 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。 ### `lsp-config.json` ユーザー レベルで使用できる言語サーバー プロトコル (LSP) サーバーを定義します。 これらのサーバーは、エージェントに言語インテリジェンス (診断、完了など) を提供します。 `/lsp`スラッシュ コマンドを使用してこのファイルを管理するか、直接編集します。 詳細については、「[GitHub Copilot CLI 用の LSP サーバーの追加](/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers)」を参照してください。 ### `providers.json` bring your-own-key (BYOK) プロバイダーとモデルのレジストリを、 `providers` キーと `models` キーを持つ JSON オブジェクトとして定義します。 このファイルが任意のプロバイダーまたはモデルを宣言する場合は、レガシ `COPILOT_PROVIDER_*` 環境変数よりも優先されます。 既定では、このファイルは `~/.copilot/providers.json`にあります。 その場所を `COPILOT_PROVIDERS_CONFIG` 環境変数でオーバーライドします。 このファイル内のモデルは、Copilot サブスクリプションによって提供されるモデルに加えて利用できます。 ファイルを手動で編集した後、Copilot CLIを再起動して変更を読み込んでください。 セットアップの手順については、「[GITHUB COPILOT CLI への LLM モデルの追加](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-llm-models)」をご覧ください。 > [!WARNING] > このファイル内の API キー、ベアラー トークン、およびヘッダー値はプレーン テキストとして格納されます。 ファイルをリポジトリにコミットしたり、資格情報を削除せずに共有したりしないでください。 > `$MY_API_KEY`などの値はリテラル文字列であり、環境変数への参照ではありません。 #### プロバイダーの構成 コメントや末尾のコンマを使用せずに JSON オブジェクトを使用します。 ファイルには 2 つの配列が含まれています。 各プロバイダーは接続を定義し、各モデルはそれらのプロバイダーの 1 つを名前で参照します。 次の表では、 `[]` は配列内のエントリを意味します。 たとえば、`models[].capabilities.supports.vision` は、モデル エントリ内の `vision` 内の `capabilities` 内にある `supports` 設定です。 | フィールド | タイプ | 必須 | Default | 説明 | | ----------------------------------------- | --------- | --- | ------- | ------------------- | | `providers` | オブジェクトの配列 | いいえ | `[]` | プロバイダー接続。 | | [プロバイダーの設定](#provider-settings)を参照してください。 | | | | | | `models` | オブジェクトの配列 | いいえ | `[]` | これらの接続を介して使用できるモデル。 | | [モデルの設定](#model-settings)を参照してください。 | | | | | 存在しないファイルまたは空のファイル、またはプロバイダーまたはモデルエントリのないファイルを使用すると、CLI は `COPILOT_PROVIDER_*` 環境変数にフォールバックできます。 いずれかの配列の値が `null` の場合は、空の配列として扱われます。 無効な JSON または無効なプロバイダーまたはモデル エントリを含むファイルでは、代わりに構成エラーが発生します。 CLI の起動時に構成済みのモデルを使用するには、`PROVIDER-NAME/MODEL-ID` を `--model` オプションに指定します。 `PROVIDER-NAME` はプロバイダーの `name` 値であり、 `MODEL-ID` はモデルの `id` 値です。 たとえば、 `copilot --model local/qwen3:8b`を実行します。 または、対話型セッション中に、`/model` を入力し、ピッカーからモデルを選択することもできます。 このファイルは、 Copilot CLIで使用するための接続、モデル機能、およびモデル命令を構成します。 このファイル内の JSON は、プロバイダー API 要求本文ではありません。 このファイルに設定を追加しても、設定はプロバイダーに渡されません。 #### プロバイダー設定 `providers`の各エントリは、次のフィールドを受け入れます。 必要なのは常に`name`と`baseUrl`だけです。 認証要件はプロバイダーによって異なります。 | フィールド | タイプ | 必須 | Default | 説明 | | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `providers[].name` | String | はい | なし | | | `"local"`や`"my-anthropic"`など、この接続の一意の名前。 | | | | | | `/`を含めてはなりません。 モデルは、 `provider` フィールドを使用してこの名前を参照します。 | | | | | | `providers[].type` | String | いいえ | `"openai"` | 接続の種類: `"openai"`OpenAI 互換 API 用、`"azure"`Azure OpenAI 用、`"anthropic"`Anthropic の Messages API 用、または `llama-server``"local_model"` によって提供されるローカル モデル用。 | | `providers[].baseUrl` | URL またはファイル パスを含む文字列 | はい | なし | プロバイダーの API ベース URL。 OpenAI 互換 API の場合は、`https://api.openai.com/v1` などの必要な API プレフィックスを含めます。Ollama の場合は `http://127.0.0.1:11434/v1` を含めます。 Anthropicに直接アクセスするには、`https://api.anthropic.com`を使用します。 Azureの場合は、リソース エンドポイントを使用します。 | | `"type": "local_model"` を使用すると、代わりに `.gguf` モデル ファイルへのパスを指定できます。 | | | | | | `providers[].wireApi` | String | いいえ | `"completions"` | OpenAI 接続と Azure 接続の API 形式: Chat Completions の`"completions"`、または Responses API の`"responses"`。 Anthropicでは無視されます。 | | `providers[].transport` | String | いいえ | `"http"` | | | `"http"` または `"websockets"` を指定できます。 WebSocket には `"type": "openai"` と `"wireApi": "responses"`が必要であり、プロバイダーはそのトランスポートをサポートする必要があります。 | | | | | | `providers[].apiKey` | String | プロバイダーに依存 | 未設定 | プロバイダーの API キー。 認証されていないローカル サーバーの場合は省略できます。 | | `providers[].bearerToken` | String | プロバイダーに依存 | 未設定 | プレフィックス `Bearer ` のないベアラー トークン。 両方が設定されている場合、`apiKey` より優先されます。 これは静的トークンであり、トークン更新コマンドではありません。 | | `providers[].headers` | Object | いいえ | 未設定 | ヘッダー名をキーとして、文字列を値として使用する追加の HTTP ヘッダー。 | | `providers[].headers.` | String | いいえ | 未設定 | ヘッダーの値 ( `"X-Project": "my-project"`など)。 標準プロバイダー認証には、 `apiKey` または `bearerToken` を使用します。 | | `providers[].azure` | Object | いいえ | 未設定 | Azure固有のオプション。 以下で説明する `apiVersion` フィールドが含まれます。 | | `providers[].azure.apiVersion` | String | いいえ | 未設定 | 要求する Azure API のバージョン。 エンドポイントでサポートされている空でないバージョン文字列に設定すると、CLI はバージョン付きデプロイ API を使用します。 省略すると、CLI はバージョンレスの `/openai/v1` API を使用します。 | | `providers[].localModel` | Object | いいえ | 未設定 | CLI マネージド `.gguf` モデルのサーバー オプション。 | | [「ローカル モデル サーバーの設定」](#local-model-server-settings)を参照してください。 | | | | | | `providers[].modelProvider` | String | いいえ | 接続から推論される | テレメトリにのみ使用されるプロバイダー ラベル。 認識される値は、 `"openai"`、 `"anthropic"`、 `"azure_openai"`、 `"ollama"`、 `"lm_studio"`、 `"foundry_local"`、および `"llama_cpp"`です。 接続プロトコルまたはモデルの動作を変更しません。 | | `providers[].hasBearerTokenProvider` | ブール値 | いいえ | `false` | SDK を使用するアプリケーションがコールバックを介してトークンを提供することを示します。 CLI を手動で構成する場合は、これを省略します。 このファイルで `true` に設定しても、トークン プロバイダーは登録されません。 | 名前付きプロバイダー ファイルは、 `apiKeyCommand`をサポートしていません。 資格情報またはトークン更新コマンドは、 `metadata` または `localModel.args`に配置しないでください。 #### ローカル モデル サーバーの設定 これらの設定は、 `providers[].type` が `"local_model"` され、 `baseUrl` が `.gguf` ファイルへのパスである場合にのみ適用されます。 CLI は、モデルが最初に使用されたときに開始されます`llama-server`。 実行可能ファイルをインストールし、`PATH`で利用可能にする必要があります。 CLI を起動するディレクトリに依存しないように、絶対モデル パスを使用します。 `baseUrl`が HTTP または HTTPS URL の場合、CLI はその既存のサーバーに接続し、これらのスタートアップ設定を使用しません。 また、Ollama やその他の OpenAI 互換サーバーも設定しません。 `providers[].localModel`内のすべてのフィールドは省略可能です。 | フィールド | タイプ | Default | 説明 | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------- | | `providers[].localModel.ctxSize` | 非負整数 | | | | `llama-server` 既定 | トークン単位で要求されるコンテキスト サイズ。`--ctx-size` として渡されます。 実際の割り当ては、要求されたサイズよりも小さくなることがあります。 | | | | `providers[].localModel.nGpuLayers` | 非負整数 | | | | `llama-server` 既定 | GPU にオフロードするモデル レイヤーの数。 `--n-gpu-layers`として渡されます。 | | | | `providers[].localModel.parallel` | 非負整数 | `1` | | | `--parallel`として渡されるサーバー スロットの数。 複数のスロットで、使用可能なコンテキストを要求間で分割できます。 | | | | | `providers[].localModel.args` | 文字列の配列 | `[]` | 追加の `llama-server` 引数。 各引数は、`["--threads", "8"]` のような個別の文字列です。 これらは、上記のフィールドから生成された引数です。 | | `providers[].localModel.persist` | ブール値 | `false` | CLI が正常終了した後もマネージド サーバーが実行されたままになるように要求し、後の CLI プロセスで再利用できるようにします。 それ以外の場合、CLI は終了時にサーバーをクリーンアップします。 | | `providers[].localModel.logs` | ファイル パスを含む文字列または `"inherit"` | 破棄された出力 | サーバーの標準出力とエラー出力を指定したファイルに追加します。 絶対パスを使用します。 | | `"inherit"` は出力をターミナルに送信し、CLI の表示を妨げる可能性があります。 | | | | CLI は、サーバーのモデル パス、ホスト、ポートを管理します。 `args`などのフォームを含め、`--port=8080`、`--model`、`-m`、または`--host`を`--port`経由で渡すことはできません。 #### モデルの設定 `models`の各エントリは、次のフィールドを受け入れます。 `id`と`provider`のみが必要です。 | フィールド | タイプ | 必須 | Default | 説明 | | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --- | ------------------------ | ------------------------------------------------------------------- | | `models[].id` | String | はい | なし | CLI で使用されるモデル識別子。 プロバイダー内で一意である必要があります。 | | `wireModel`が設定されていない限り、プロバイダーのモデル名としても使用されます。 | | | | | | `models[].provider` | String | はい | なし | | | `name`内のエントリの`providers`と一致する必要があります。 | | | | | | `models[].wireModel` | String | いいえ | | | | `id` の値 | プロバイダーに送信されるモデルまたはデプロイメント名。 これは、CLI で選択する ID とは異なる名前をプロバイダーが想定している場合に使用します。 | | | | | `models[].modelId` | String | いいえ | | | | `id` の値 | CLI のモデル固有の動作と既定値を検索するために使用されるモデル ID。 エイリアスまたはデプロイ名の場合は、基になるモデルの認識 ID に設定します。 これにより、プロバイダーに送信されるモデル名は変更されません。 | | | | | `models[].name` | String | いいえ | `PROVIDER-NAME/MODEL-ID` | モデルの表示名。 選択IDは変わりません。 | | `models[].maxPromptTokens` | Integer | いいえ | モデル依存 それ以外 `128000` | 入力トークンの上限。 モデルとデプロイに一致する正の整数を使用します。 | | `models[].maxContextWindowTokens` | Integer | いいえ | 既知のモデル制限。該当しない場合は未設定 | 入力トークンと出力トークンを含むコンテキスト ウィンドウの合計制限。 これは、CLI が認識しない制限を持つモデルに対して設定します。 | | `models[].maxOutputTokens` | Integer | いいえ | モデルおよびプロバイダーに依存 | 出力トークンの予算 プロバイダーとモデルの推論要件により、出力がさらに制約される可能性があります。 | | `models[].capabilities` | Object | いいえ | モデルの既定値 | サポートされている機能と制限について説明します。 | | [モデルの性能](#model-capabilities)を参照してください。 | | | | | | `models[].systemMessage` | Object | いいえ | 標準 CLI の手順 | このモデルのシステム命令を追加、置換、またはカスタマイズする | | [モデル システム メッセージを](#model-system-messages)参照してください。 | | | | | | `models[].metadata` | Object | いいえ | 未設定 | モデルが検出されたときに保存された情報を含む、追加の説明データ。 | | [モデルメタデータ](#model-metadata)を参照してください。 | | | | | 3 つのトークン制限フィールドは、 `0` から `4294967295`までの整数を受け入れます。 制限を無効にする方法として `0` に依存するのではなく、デプロイに適した正の値を使用します。 これらの設定は、使用する上限を CLI に指示しますが、モデルの実際の容量は増やしません。 #### モデル機能 `models[].capabilities` オブジェクトはモデルを記述します。 機能を `true` に設定しても、その機能をサポートしていないモデルには追加されません。 | フィールド | タイプ | 説明 | | ----------------------------------------------------- | ------ | -------------------------------------------------------------------- | | `models[].capabilities.family` | String | モデルファミリーを説明する識別子。 CLI のモデル固有の動作を指定するには、このフィールドではなく `modelId` を使用します。 | | `models[].capabilities.supports` | Object | サポートされている機能。 | | [サポートされているモデル機能を](#supported-model-features)参照してください。 | | | | `models[].capabilities.limits` | Object | トークンとイメージの制限。 | | [モデル機能の制限を](#model-capability-limits)参照してください。 | | | すべての機能フィールドは任意です。 オブジェクトはモデルの既定値にマージされ、配列は対応する既定の配列に置き換えられます。 #### サポートされているモデル機能 次のフィールドは、 `models[].capabilities.supports`内に属しています。 | フィールド | タイプ | 説明 | | -------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------- | | `models[].capabilities.supports.vision` | ブール値 | モデルが画像を受け入れるかどうか。 既定では、他に利用可能な機能情報がない場合、`false` が使用されます。 | | `models[].capabilities.supports.toolCalls` | ブール値 | モデルがツール呼び出しをサポートしているかどうか。 この表記 `tool_calls` も受け入れられ、両方が存在する場合は優先されます。 ここでは、ツールを実行するための実行の許可ではなく、サポートについて説明します。 | | `models[].capabilities.supports.streaming` | ブール値 | モデルがストリーム応答をサポートしているかどうか。 これは機能情報であり、応答ストリーミングのオンとオフを切り替える設定ではありません。 | | `models[].capabilities.supports.adaptive_thinking` | 文字列またはブール値 | モデルのAnthropic適応型思考のサポート。 以下で説明する文字列値のいずれかを指定してください。 互換性のために、 `true` は `"optional"` を意味し、 `false` は `"unsupported"`を意味します。 | | `models[].capabilities.supports.reasoning_effort` | 文字列の配列 | モデルがサポートする推論の労力レベル。 これにより、要求に使用するレベルではなく、使用可能なレベルがアドバタイズされます。 CLI では、モデル固有の制限も適用されます。 | | `models[].capabilities.supports.thinking` | ブール値 | モデル検出で保存できる説明的なサポート情報。 単独で思考を設定したり、推論作業の制御を有効にしたりすることはありません。 | | `models[].capabilities.supports.reasoningEffort` | ブール値または文字列の配列 | 互換性フィールド。 ブール値では、推論作業の制御は有効になりません。また、配列は CLI 機能間で一貫して使用されません。 サポート対象レベルのリストには `reasoning_effort` を使用します。 | `adaptive_thinking`値の意味は次のとおりです。 | Value | 意味 | | ----------------- | ------------------------------------------------------------------- | | `"unsupported"` | モデルは適応型思考をサポートしていません。 これは、他の形式の推論を排除するものではありません。 | | `"optional"` | モデルはアダプティブ思考をサポートしますが、アダプティブ思考は必須ではありません。 | | `"required"` | 思考が有効になっている場合、モデルには手動の思考の割り当てではなく適応型思考が必要です。 Thinking は引き続き無効にできます。 | | `"adaptive_only"` | モデルには適応型思考が必要であり、思考を無効にすることはできません。 | `reasoning_effort`の場合、CLI は`"none"`、`"minimal"`、`"low"`、`"medium"`、`"high"`、`"xhigh"`、および`"max"`を認識します。 `["low", "medium", "high"]` など、モデルでサポートされているレベルのみを一覧表示してください。 省略されたリストまたは空のリストの場合、CLI はそのモデル固有の既定値を使用します。 `--reasoning-effort`または使用可能な場合はモデル ピッカーを使用してレベルを選択します。 #### モデル機能の制限 次のフィールドは、 `models[].capabilities.limits`内に属しています。 すべて省略可能です。 | フィールド | タイプ | 説明 | | --------------------------------------------------------------------------------- | ------- | ----------------------------------------------- | | `models[].capabilities.limits.max_prompt_tokens` | Integer | 入力トークンの上限。 に相当します。 | | `models[].capabilities.limits.max_context_window_tokens` | Integer | コンテキストウィンドウの合計上限。 に相当します。 | | `models[].capabilities.limits.max_output_tokens` | Integer | 出力トークン数の上限。 に相当します。 | | `models[].capabilities.limits.vision` | Object | 以下のフィールドを含む画像制限。 | | `models[].capabilities.limits.vision.supported_media_types` | 文字列の配列 | | | `"image/jpeg"`、`"image/png"`、`"image/webp"`など、受け入れ可能な画像 MIME の種類。 これら 3 つの型が既定です。 | | | | `models[].capabilities.limits.vision.max_prompt_images` | Integer | プロンプトあたりのイメージの最大数。 既定値は `1` です。 | | `models[].capabilities.limits.vision.max_prompt_image_size` | Integer | 各イメージの最大サイズ (バイト単位)。 既定値は `3145728` (3 MiB) です。 | トークンの予算を手動で設定する場合は、モデルの `maxPromptTokens`、 `maxContextWindowTokens`、および `maxOutputTokens` フィールドを使用します。 Discoveryでは、制限を両方の場所に保存できます。 異なる CLI 操作が 2 つの表現を読み取るため、重複する値の一貫性を保ちます。 CLI で管理されるローカル サーバーの場合、実測されたコンテキスト制限値が構成された値よりも優先される場合があります。 トークン数と画像サイズには負以外の整数を使用し、画像数には正の整数を使用します。 トークン数と画像数は、`4294967295`から`0`の範囲内に収まる必要があります。 画像のサイズは、トークンではなくバイト単位で測定されます。 #### モデルシステムメッセージ `models[].systemMessage` は、汎用サブエージェントを含め、CLI がこのモデルの標準プロンプトを作成するときに使用されるシステム命令を制御します。 これらのパスでは、セッション全体のシステム メッセージ構成よりも優先されます。 これは、選択したカスタム エージェントまたは特殊なサブエージェントの指示に代わるものではありません。 追加の指示のみが必要な場合は、`"mode": "append"` をお勧めします。 組み込みの命令を置き換えたり削除したりすると、CLI のツールの使用やその他の予期される動作が変わる可能性があります。 `systemMessage`に設定するのではなく、`null`を省略して標準命令を保持します。 | フィールド | タイプ | 必須 | 説明 | | ------------------------------------------------------------------- | ---------------------------- | --- | --------------------------------------- | | `models[].systemMessage.mode` | String | いいえ | | | `"append"` (既定値)、 `"replace"`、または `"customize"`。 以下のモードの表を参照してください。 | | | | | `models[].systemMessage.content` | String | | | | `replace` モード | 追加するテキスト、または置換手順として使用するテキスト。 | | | | `customize` モードでは、セクションの変更後に追加されます。 | | | | | `models[].systemMessage.sections` | Object | いいえ | セクションの変更。`customize` モードでのみ利用可能です。 | | [システム メッセージ セクション](#system-message-sections)を参照してください。 | | | | | `models[].systemMessage.contentBlocks` | オブジェクトの配列 | いいえ | 置換命令はブロックに分割され、 `replace` モードでのみ使用できます。 | | [システムメッセージ コンテンツ ブロック](#system-message-content-blocks)を参照してください。 | | | | モードに一覧表示されているフィールドのみが許可されます。 たとえば、`sections`を設定せずに`"mode": "customize"`を追加すると、構成エラーが発生します。 | Mode | 対応フィールド | 影響 | | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | -- | | `"append"` | | | | `mode`、`content` | 標準プロンプトを保持し、 `content`を追加します。 | | | `mode`を省略すると、このモードが選択されます。 | | | | `"replace"` | | | | `mode`、`content`、`contentBlocks` | 標準手順を置き換えます。 | | | `content` は、`contentBlocks`を指定する場合でも、文字列として存在する必要があります。 CLI では、引き続き該当する環境とエージェント コンテキストを追加できます。 | | | | `"customize"` | | | | `mode`、`sections`、`content` | 標準プロンプトの名前付きセクションを変更し、必要に応じて `content`追加します。 変更しないセクションは既定値を保持します。 | | 代替コンテンツでは、使用可能な場合、`{{copilot:memories}}` により CLI のメモリ命令とコンテキストが挿入されます。 #### システムメッセージのセクション `customize` モードでは、`models[].systemMessage.sections`はセクション名をオブジェクトにマップします。 各オブジェクトは、`action`を指定し、必要に応じて、`content`を指定します。 たとえば、`models[].systemMessage.sections.tone` はトーン セクションを変更します。 | フィールド | タイプ | 必須 | 説明 | | ---------------------------------------------------------------- | ------ | ----------- | ----------------------------- | | `models[].systemMessage.sections.` | Object | いいえ | 以下に示すセクションまたはグループのいずれかに対する変更。 | | `models[].systemMessage.sections..action` | String | はい、各エントリごとに | | | `"replace"`、`"remove"`、`"append"`、`"prepend"`、または `"preserve"`。 | | | | | `models[].systemMessage.sections..content` | String | いいえ | | | `replace`、`append`、または`prepend`で使用されるテキスト。 省略されたコンテンツは空として扱われます。 | | | | | `remove`または`preserve`には必要ありません。 | | | | 使用可能な操作は次のとおりです。 | アクション | 影響 | | ---------------------------- | ----------------------------------------------------------------- | | `"replace"` | セクションまたはグループを `content`に置き換えます。 | | `"remove"` | セクションまたはグループを削除します。 グループを削除しても、独自のエントリを持つセクションは `sections`内に残ります。 | | `"append"` | セクションまたはグループの後に `content` を追加します。 | | `content`に必要なスペースまたは改行を含めます。 | | | `"prepend"` | セクションまたはグループの前に `content` を追加します。 | | `content`に必要なスペースまたは改行を含めます。 | | | `"preserve"` | セクションは変更されず、グループによる削除から保護されます。 グループ置換からは保護されません。 | `transform` アクションは、保存された JSON 構成ではなく、アプリケーション コールバックを必要とするため、`providers.json`ではサポートされていません。 `sections`では、次のセクションまたはグループ名をキーとして使用します。 | Name | サブタイプ | 対象範囲 | | ----------------------------- | ----- | -------------------------------------- | | `preamble` | セクション | アシスタントの導入時の役割に関する指示。 | | `tone` | セクション | トーンと応答のスタイル。 | | `tool_efficiency` | セクション | 効率的なツールの使用に関するガイダンス。 | | `environment_context` | セクション | 作業環境に関する情報。 | | `code_change_rules` | セクション | コードを変更するためのガイダンス。 | | `guidelines` | セクション | エージェントの動作に関するその他のガイドライン。 | | `safety` | セクション | 安全に関するガイダンスと環境の制限。 | | `custom_instructions` | セクション | カスタム指示を読み込みました。 | | `runtime_instructions` | セクション | セッション用に組み立てられた追加の指示。 | | `last_instructions` | セクション | プロンプトの最後に配置された指示。 | | `identity` | Group | ID、相互作用、トーン、委任、ツール効率、バージョン、モデル、タスクの指示。 | | `environment_context`は含まれません。 | | | | `tool_instructions` | Group | ツールの紹介とツールの使用手順。 | 個々のセクションの変更は、グループの変更前に適用されます。 グループ置換は、個別にカスタマイズしたセクションを含め、すべてのメンバー セクションを置き換えます。 #### システムメッセージのコンテンツブロック `replace` モードでは、`models[].systemMessage.contentBlocks`はプレーンな`content`文字列の代わりに置換命令を提供します。 構成形式で必要なため、`content` はそのまま残してください。 すべてのブロックには `content` 文字列が必要です。 | フィールド | タイプ | 必須 | Default | 説明 | | -------------------------------------------------------- | ------ | --- | -------------- | ------------------------------------------------------------------------------ | | `models[].systemMessage.contentBlocks[].content` | String | はい | なし | このブロックのテキスト（配列の順序で）。 | | `models[].systemMessage.contentBlocks[].isStatic` | ブール値 | いいえ | 静的としてマークされていない | プロンプト コンテンツの変更とは別にキャッシュできるコンテンツをマークします。 | | `models[].systemMessage.contentBlocks[].cacheBreakpoint` | ブール値 | いいえ | 明示的なブレークポイントなし | 明示的なプロンプト キャッシュをサポートするプロバイダーに対して、このブロックの後にキャッシュ境界を要求します。 プロバイダーのキャッシュは保証されません。 | #### モデルメタデータ `models[].metadata` は、値として任意の有効な JSON 値を取れるオブジェクトです。 これは説明データであり、API 要求パラメーターや資格情報を指定する方法ではありません。 メタデータを手動で追加する必要はありません。 モデル検出では、次の文字列フィールドを保存できます。 既存の検出値はそのままにします。 | フィールド | タイプ | 説明 | | -------------------------------------- | ------ | ------------------------------------------------------------ | | `models[].metadata.adapterId` | String | | | `"ollama"` などの検出インテグレーションを識別します。 | | | | `models[].metadata.providerKind` | String | | | `"ollama"` などの、検出されたプロバイダーの種類。 | | | | `models[].metadata.providerInstanceId` | String | プロバイダー インスタンス ( `"ollama:http://127.0.0.1:11434"`など) を識別します。 | | `models[].metadata.providerDigest` | String | プロバイダーによって提供されるモデル ダイジェスト (使用可能な場合)。 | #### プロバイダー構成の例 この例では、既存の Ollama サーバーに接続し、モデルの機能とシステム命令がどのように入れ子になっているかを示します。 `qwen3:8b`がインストールされていることを前提としています。 トークンの制限は予算の例であり、モデルの最大容量を示すものではありません。 サーバーで構成されているコンテキストに合わせて調整してください。 ```json copy { "providers": [ { "name": "local", "type": "openai", "baseUrl": "http://127.0.0.1:11434/v1", "modelProvider": "ollama" } ], "models": [ { "id": "qwen3:8b", "provider": "local", "name": "Qwen 3 8B", "maxPromptTokens": 6144, "maxContextWindowTokens": 8192, "maxOutputTokens": 2048, "capabilities": { "supports": { "vision": false, "toolCalls": true } }, "systemMessage": { "mode": "customize", "sections": { "tone": { "action": "append", "content": "\nUse concise explanations." } } } } ] } ``` CLI を再起動した後、`copilot --model local/qwen3:8b` または `/model` ピッカーを使用してこのモデルを選択してください。 いずれかの配列にオブジェクトを追加して、追加のプロバイダーとモデルを構成します。 ### `agents/` 個人用カスタム エージェント定義を `.agent.md` ファイルとしてここに格納します。 このディレクトリに配置されたエージェントは、すべてのセッションで使用できます。 個人エージェントとプロジェクト レベルのエージェントが同じ ID を持っている場合 (たとえば、両方の最上位ファイルに `reviewer.agent.md`名前が付けられている場合)、個人用エージェントが優先されます。 省略可能な `name` frontmatter フィールドは重複除去を制御しないため、同じ `name` で ID が異なるエージェントは両方とも読み込まれます。 詳細については、「[GitHub Copilot CLI のカスタムエージェントの作成と使用](/ja/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)」を参照してください。 ### `skills/` 個人のカスタム スキル定義をここに格納します。 各スキルは、 `SKILL.md` ファイル ( `~/.copilot/skills/my-skill/SKILL.md` など) を含むサブディレクトリに存在します。 個人のスキルはすべてのセッションで利用できます。 Projectレベルのスキルは、同じ名前を共有する場合、個人のスキルよりも優先されます。 詳細については、「[エージェント スキルの追加 GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。 ### `hooks/` ユーザー レベルのフック スクリプトをここに格納します。 これらのフックは、すべてのセッションに適用されます。 `~/.copilot/settings.json` キーを使用して、ユーザー構成ファイル (`hooks`) でフックをインラインで定義することもできます。 リポジトリ レベルのフック ( `.github/hooks/`) は、ユーザー レベルのフックと共に読み込まれます。 詳細については、「[GitHub Copilot CLI でフックを使用する](/ja/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。 ### `extensions/` ユーザー レベルの拡張ファイルをここに格納します。 このディレクトリ内の拡張機能は、セッション間で使用できます。 このディレクトリにファイルを手動で作成するか、拡張機能をスキャフォールディングしてから、生成されたファイルを編集できます。 ## ファイルを自動的に管理する 次の項目は CLI によって管理されます。 通常、手動で編集しないでください。 ### `config.json` 認証データ、インストールされているプラグイン メタデータ、その他のランタイム情報など、CLI によって自動的に管理される内部アプリケーションの状態を格納します。 通常、このファイルを編集する必要はありません。 > [!NOTE] > 以前のバージョンの Copilot CLI では、ユーザー設定とアプリケーションの状態の両方が `config.json`に格納されています。 ユーザーが編集可能な設定が `settings.json`に配置されるようになりました。 > `config.json`に残されている設定は無視されます。 このファイルは、インストールされているプラグインや信頼されたフォルダーなどの内部状態のみを保持します。 ### `permissions-config.json` 保存したツールとディレクトリのアクセス許可の決定をプロジェクトの場所別に格納します。 ツールを承認するか、現在の場所のディレクトリへのアクセスを許可すると、CLI によって決定がここに記録されるため、同じリポジトリまたはディレクトリに再度プロンプトが表示されることはありません。 > [!NOTE] > プロジェクトのアクセス許可をリセットする場合は、このファイルから関連するエントリを削除できます。 ただし、セッションの実行中にファイルを編集すると、予期しない動作が発生する可能性があります。 CLI は、場所パスがディスク上に存在しなくなったエントリを自動的に削除します。 #### ファイルの場所 Copilot CLI は、構成ディレクトリからファイルを解決します。 | 優先度 | Source | 使用されるファイル | | --- | ------------------------ | --------------------------------------- | | 1 | `--config-dir=DIRECTORY` | `DIRECTORY/permissions-config.json` | | 2 | `COPILOT_HOME` | `$COPILOT_HOME/permissions-config.json` | | 3 | Default | `~/.copilot/permissions-config.json` | CLI では、この順序で最初に適用できる構成ディレクトリのみが使用されます。 優先順位の低い場所から `permissions-config.json` も読み込まれません。 `--config-dir` オプションは従来のオプションです。 構成ディレクトリを変更する必要がある場合は、 `COPILOT_HOME` を優先します。 Windowsでは、既定のファイルは通常次のようになります。 ```text C:\Users\YOUR-USER\.copilot\permissions-config.json ``` 以前のビルドでは、 `permissions-config`という名前の拡張子のないファイルが使用されています。 `permissions-config.json`が存在しないが、拡張子のないファイルが存在する場合、CLI はレガシ ファイルを引き続き受け入れられます。 新しい編集には `permissions-config.json` を使用します。 以前の XDG ベースの構成場所は、`~/.copilot`が設定されていない場合、起動時に`COPILOT_HOME`に移行されます。 #### 位置キー 最上位レベルの `locations` オブジェクトは、絶対パスによってキーが設定されます。 * Git リポジトリの場合は、アクセス許可のスコープに使用される Git ルートを使用します。 * リンクされたワークツリーはメイン リポジトリのルートを参照するため、メインワークツリーと権限を共有します。 * サブモジュールは、独自の作業ディレクトリを使用します。 * Git リポジトリにないディレクトリの場合は、正規化された現在の作業ディレクトリを使用します。 キーは、 Copilot CLI が実行されている場所と一致する必要があります。 キーが一致しない場合、保存された承認は適用されません。 CLI は、セッションの開始時とアクティブな作業ディレクトリの変更時に、一致する場所の承認を読み込みます。 #### Schema ファイルには JSON オブジェクトが含まれている必要があります。 | フィールド | タイプ | 必須 | Default | 使用できる値 | 説明 | | ---------------------------------------------------------------------------------------------------------------------------------- | ------------- | --------------------------------------- | ------- | ------------------- | ------------------------------------------------------------------ | | `locations` | Object | いいえ | `{}` | 絶対パス キー | 保存済みの承認に対する場所キーのマップ。 | | `locations.` | Object | いいえ | `{}` | 任意の絶対位置キー | 1 つのリポジトリまたはディレクトリの承認を保存しました。 | | `locations..tool_approvals` | Array | いいえ | `[]` | 承認オブジェクト | この場所に対して承認されたツール。 | | `locations..allowed_directories` | 文字列の配列 | いいえ | `[]` | 絶対ディレクトリ パス | パス ゲートがこの場所にアクセスできる追加のディレクトリ。 CLI が構成を適用する場合は、各ディレクトリが存在する必要があります。 | | `locations..tool_approvals[].kind` | String | はい | なし | | | | `commands`、 `read`、 `write`、 `mcp`、 `mcp-sampling`、 `memory`、 `custom-tool`、 `extension-management`、 `extension-permission-access` | 承認の種類を選択します。 | | | | | | `commandIdentifiers` | 文字列の配列 | はい、`commands` に対してです | なし | コマンド識別子 | 承認するシェル コマンドの識別子。 | | `serverName` | String | はい。 `mcp` と `mcp-sampling` | なし | MCP サーバー名 | 承認対象のMCPサーバー。 | | `toolName` | 文字列または `null` | はい、`mcp` に対してです | なし | MCP ツール名、または `null` | 承認用のMCPツール。 | | `null`を使用して、サーバー上のすべてのツールを承認します。 | | | | | | | `toolName` | String | はい、`custom-tool` に対してです | なし | カスタム ツール名 | 正確な名前で承認するカスタム ツール。 | | `operation` | String | いいえ、`extension-management`については | 省略 | 拡張機能の操作名 | 承認が必要な拡張機能の管理操作。 すべての拡張機能管理操作を承認するには、このフィールドを省略します。 | | `extensionName` | String | はい、`extension-permission-access` に対してです | なし | 拡張機能の名前 | アクセス許可が制限された機能へのアクセスが承認されている拡張機能。 | `permissions-config.json` では、拒否ルール、"ask" ルール、既定のモード、URL ルール、ツール のフィルター処理、またはリポジトリローカル共有ポリシーはサポートされていません。 これらの動作では、 `--deny-tool`、 `--available-tools`、 `--excluded-tools`、 `--allow-url`、 `--deny-url`などのコマンド ライン オプションを使用します。 保存された URL ルールは、`settings.json`ではなく、`permissions-config.json`に格納されます。 不明なフィールドはスキーマの一部ではありません。 CLI では無視され、後で書き込みによって削除される場合があります。 #### 承認の種類 `tool_approvals`の各項目は、次のいずれかのオブジェクトである必要があります。 | `kind` | 必須フィールド | オプションフィールド | 意味 | | ----------------------------------------------------------- | -------------------- | ----------- | ------------------------------------------------------------------ | | `commands` | `commandIdentifiers` | なし | 一致するシェル コマンド識別子を承認します。 | | `read` | なし | なし | 読み取りツールへのリクエストを承認します。 対話型 CLI セッションでは既に読み取りが自動的に承認されているため、通常は不要です。 | | `write` | なし | なし | ファイルの作成と変更ツールの要求を承認します。 パス プロンプトは、許可されたディレクトリの外部のパスに対して引き続き適用できます。 | | `mcp` | | | | | `serverName`、`toolName` | なし | | | | `toolName`が`null`されたときに、1 つの MCP ツールまたはサーバー上のすべてのツールを承認します。 | | | | | `mcp-sampling` | `serverName` | なし | 1 台のサーバーに対する MCP サンプリング要求を承認します。 | | `memory` | なし | なし | メモリの書き込みと投票の要求を承認します。 | | `custom-tool` | `toolName` | なし | 正確な名前でカスタム ツールを承認します。 | | `extension-management` | なし | `operation` | 拡張機能の管理を承認します。 | | `operation`を省略すると、すべての拡張機能管理操作が一致します。 | | | | | `extension-permission-access` | `extensionName` | なし | アクセス許可が制限された機能への拡張機能のアクセスを承認します。 | MCP 承認の場合、 `serverName` は構成された MCP サーバー名と正確に一致する必要があります。 サニタイズされたツール名プレフィックスではなく、MCP 構成の生サーバー名を使用します。 #### シェルコマンドの照合 `permissions-config.json` では、正規表現や一般的な glob パターンはサポートされていません。 文字列値は文字どおりに一致します。ただし、シェル `:*` 値内の末尾の `commandIdentifiers` は、`:*` より前のテキスト（そのテキスト単独の場合と、その後にスペースと追加のテキストが続く場合の両方）に一致します。 プレーンな `*` には特別な意味がないため、 `git*` は `git status`と一致しません。 | Pattern | 一致 | 一致しない | | ----------------------------------- | -------------- | -------------------- | | `git status` | `git status` | `git status --short` | | `git:*` | | | | `git`、`git status`、`git push` | `gitea` | | | `gh pr:*` | | | | `gh pr`、`gh pr view`、`gh pr create` | `gh repo view` | | #### ディレクトリ マッチング `allowed_directories` エントリを使用すると、 Copilot CLI は個別のパス プロンプトなしで、これらのディレクトリ内のパスにアクセスできます。 ツール操作自体は承認されません。 たとえば、許可されたディレクトリ内のファイルを編集するには、引き続き `write` の承認が必要な場合があります。 各 `allowed_directories` エントリは、絶対、空でない、アクセス可能なディレクトリである必要があります。 CLI は、パスを比較する前にシンボリック リンクを解決し、UNC ネットワーク パスは拡張長ローカル パスでない限り許可せず、Windows では大文字と小文字を区別せずにパスを比較し、その他のプラットフォームでは大文字と小文字を区別してパスを比較します。 エントリを適用できない場合、CLI は警告をログに記録し、そのエントリをスキップします。 #### Examples すべての Git サブコマンドを許可し、追加のローカル ディレクトリにアクセスします。 ```json copy { "locations": { "C:\\src\\my-repo": { "tool_approvals": [ { "kind": "commands", "commandIdentifiers": ["git:*"] } ], "allowed_directories": ["C:\\src\\shared-docs"] } } } ``` ファイルの書き込み前に確認しながら、選択したコマンドを許可します。 ```json copy { "locations": { "/Users/YOUR-USER/src/my-repo": { "tool_approvals": [ { "kind": "commands", "commandIdentifiers": [ "git status", "git diff", "git log", "npm test", "npm run build" ] } ] } } } ``` リポジトリのファイル書き込みと 1 つの MCP サーバーを承認します。 ```json copy { "locations": { "/home/YOUR-USER/src/my-repo": { "tool_approvals": [ { "kind": "write" }, { "kind": "mcp", "serverName": "github-mcp-server", "toolName": null } ] } } } ``` 1つのMCPツール、メモリへの書き込み、拡張機能の権限へのアクセスを承認する: ```json copy { "locations": { "C:\\src\\my-repo": { "tool_approvals": [ { "kind": "mcp", "serverName": "github-mcp-server", "toolName": "search_code" }, { "kind": "memory" }, { "kind": "extension-permission-access", "extensionName": "my-extension" } ] } } } ``` ### `session-state/` サブディレクトリ内のセッション ID 別に整理されたセッション履歴データが含まれています。 各セッション ディレクトリには、イベント ログ (`events.jsonl`) とワークスペース成果物 (プラン、チェックポイント、追跡されたファイル) が格納されます。 このデータにより、セッションの再開 (`--resume` または `--continue`) が有効になります。 このディレクトリからファイルを削除すると、ローカル コピーのみが削除されます。 GitHub アカウントにセッションを同期した場合、同期されたデータは個別に保存され、ローカル ファイルの削除の影響を受けません。 同期されたセッションは、 GitHub.comから削除したり非表示にしたりできます。 詳細については、「[GitHub Copilot のセッション データについて](/ja/copilot/concepts/security-governance-and-network-settings/session-data#deleting-session-data)」を参照してください。 ### `command-history-state/` 対話型インターフェイスの逆引き検索 (Ctrl+R) と履歴ナビゲーションに使用されるコマンド履歴データが含まれています。 このディレクトリは自動的に管理されるため、編集しないでください。 ### `session-store.db` チェックポイントのインデックス作成や検索などのセッション間データに CLI によって使用される SQLite データベース。 このファイルは自動的に管理され、編集しないでください。 このファイルを削除した場合は、 `/chronicle reindex` コマンドを使用してリビルドできます。 インデックスを再作成すると、セッション データもアカウントに同期されます。 ### `logs/` CLI セッションのログ ファイルが含まれています。 各セッションでは、 `process-{timestamp}-{pid}.log`という名前のログ ファイルが作成されます。 これらのファイルは、問題のデバッグに役立ちます。 CLI では、 `logs/extensions/`の下に拡張機能固有のログを作成することもできます。 これは、ユーザーが作成した拡張機能コードを格納する `~/.copilot/extensions/`とは別です。 > [!TIP] > 現在のセッションのログ ファイルを検索するには、対話型セッションに「 `/session` 」と入力します。 出力には、ログ ファイルへの完全なパスと、セッション ID、期間、作業ディレクトリなどの他のセッションの詳細が含まれます。 ### `installed-plugins/` インストールしたプラグインのファイルが含まれています。 マーケットプレースからインストールされたプラグインは、 `installed-plugins/{marketplace-name}/{plugin-name}/`の下に格納されます。 直接インストールされたプラグインは、 `installed-plugins/_direct/`の下に格納されます。 このディレクトリを直接編集するのではなく、 `copilot plugin` コマンドを使用してプラグインを管理します。 詳細については、「[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference)」を参照してください。 ### `plugin-data/` マーケットプレースとプラグイン名別に整理された、インストールされているプラグインの永続的なデータが含まれています。 このデータはプラグイン自体によって管理されるため、手動で編集することはできません。 ### `ide/` IDE 統合のロック ファイルと状態が含まれます (たとえば、 Copilot CLI が Visual Studio Code に接続する場合)。 このディレクトリは自動的に管理されます。 ### `mcp-oauth-config/` キーチェーンベースのストレージが使用できない場合の MCP OAuth トークン、登録、PKCE フォールバック ファイルが含まれます。 このディレクトリは自動的に管理されます。 ### `mcp-secrets/` キーチェーンベースのストレージが使用できない場合のフォールバック ファイル ストレージと MCP シークレット プレースホルダーのインデックスが含まれます。 このディレクトリは自動的に管理されます。 ## 構成ディレクトリの場所の変更 既定の `~/.copilot` 場所をオーバーライドするには、 `COPILOT_HOME` 環境変数を使用するディレクトリのパスに設定します。 ```bash copy export COPILOT_HOME=/path/to/my/copilot-config ``` ### 注意すべき事項 * `COPILOT_HOME` は、 `~/.copilot` パス全体を置き換えます。 設定する値は、構成ファイルとサブディレクトリに使用するディレクトリへの完全なパスである必要があります。 * ディレクトリを変更すると、既存の構成、セッション履歴、インストールされているプラグイン、保存されたアクセス許可が新しい場所に見つかりません。 `~/.copilot`の内容を保存する場合は、新しい場所にコピーまたは移動します。 * **キャッシュ ディレクトリ** (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) はプラットフォームの規則に従い、`COPILOT_HOME`の影響を受けません。 これは次の場所にあります。 * **macOS**: `~/Library/Caches/copilot` * **Linux**: `$XDG_CACHE_HOME/copilot` または `~/.cache/copilot` * **Windows**:`%LOCALAPPDATA%/copilot` キャッシュ ディレクトリを個別にオーバーライドするには、 `COPILOT_CACHE_HOME`設定します。 ## 安全に削除できる内容 | 品目 | 安全に削除できますか? | 影響 | | ---------------------------------------------------- | ----------- | --------------------------------------------------------------------------------- | | `agents/`、`skills/`、`hooks/` | お勧めしません | 個人のカスタマイズは失われます。 最初にバックアップします。 | | `config.json` | 慎重に | 認証を含むアプリケーションの状態をリセットします。 再認証が必要になり、CLI は次回の起動時に内部状態を再検出します。 | | `copilot-instructions.md`、`instructions/` | お勧めしません | 個人のカスタム命令は失われます。 最初にバックアップします。 | | `extensions/` | お勧めしません | 個人の拡張機能は失われます。 最初にバックアップします。 | | `installed-plugins/` | お勧めしません | 代わりに `copilot plugin uninstall` を使用して、 `config.json` のプラグイン メタデータが正確なままになるようにします。 | | `logs/` | はい | ログ ファイルは、セッションごとに再作成されます。 削除しても機能に影響はありません。 | | `lsp-config.json` | お勧めしません | ユーザー レベルの LSP サーバー定義が失われます。 最初にバックアップします。 | | `mcp-config.json` | お勧めしません | ユーザー レベルの MCP サーバー定義が失われます。 最初にバックアップします。 | | `mcp-oauth-config/` | 慎重に | ローカル MCP OAuth フォールバック状態をクリアします。 MCP サーバーの再認証が必要になる場合があります。 | | `mcp-secrets/` | 慎重に | ローカル MCP シークレットのフォールバック状態とマッピングをクリアします。 シークレットベースの MCP サーバーの再構成が必要な場合があります。 | | `permissions-config.json` | 慎重に | 保存されているすべてのアクセス許可をリセットします。 CLI によって、ツールとディレクトリの承認が再度求められます。 | | `plugin-data/` | はい | プラグインの永続データは、必要に応じて再作成されます。 | | `providers.json` | お勧めしません | BYOK プロバイダーとモデルの構成が失われます。 最初にバックアップします。 | | `session-state/` | 慎重に | 削除すると、セッション履歴が削除されます。 過去のセッションを再開できなくなります。 | | `command-history-state/` | 慎重に | 削除すると、コマンド履歴が削除されます。 | | Ctrl+R を使用して前のコマンドを検索できなくなります。 | | | | `session-store.db` | 慎重に | 削除すると、セッション間のデータが削除されます。 ファイルは自動的に再作成されます。 | | `settings.json` | 慎重に | すべてのユーザー設定を既定値にリセットします。 設定を再構成する必要があります。 | ## 構成ファイルの設定 設定は次の順序で適用されます (後でオーバーライドします)。 1. 組み込みの既定値 2. モバイルデバイス管理（MDM）の管理対象設定 3. ユーザー設定 (`~/.copilot/settings.json`) 4. リポジトリの設定 (`.github/copilot/settings.json`) 5. ローカル設定 (`.github/copilot/settings.local.json`) 6. 環境変数 7. コマンド ライン フラグ MDM マネージド設定は起動時に読み込まれ、ポリシー ベースラインとしてユーザー設定とマージされます。 ほとんどのキーでは、ユーザー設定がそのベースラインをオーバーライドできます。 `permissions.disableBypassPermissionsMode` の場合、`"disable"` の MDM 値が常に優先されます。 マネージド `sandbox` 設定も例外です。 オーバーライドできるのではなく、各管理対象の `sandbox` 値は、緩和できない下限を設定します。 独自の設定の方が許容度が高い場合は、マネージド値が優先されます。 `sandbox.failIfUnavailable`設定は、管理者のみが設定できます。 詳細については、「 [MDM の管理設定](#mdm-managed-settings)」を参照してください。 | Scope | Location | 目的 | | ----------------------------------- | ------------------------------------- | ------------------------------------ | | ユーザー | `~/.copilot/settings.json` | すべてのリポジトリのグローバルな既定値。 | | `COPILOT_HOME`環境変数を使用して、代替パスを指定します。 | | | | リポジトリ | `.github/copilot/settings.json` | 共有リポジトリの構成 (リポジトリにコミット)。 | | Local | `.github/copilot/settings.local.json` | 個人のオーバーライド (これを `.gitignore`に追加します)。 | CLI では、リポジトリ設定の共有クロスツール サブセット (`.claude/settings.json`、`.claude/settings.local.json`、`companyAnnouncements`、`disableAllHooks`、`enabledPlugins`など) の`extraKnownMarketplaces`と`hooks`も読み取ります。 リポジトリの既定値は任意です。`enabledPlugins` エントリをリポジトリローカル設定で `false` に設定して、リポジトリの既定値をオーバーライドします。 マネージドの必須またはブロックされたプラグイン エントリが常に優先されます。 「[GitHub Copilot CLI のプラグインの検索とインストール](/ja/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing#turn-off-a-repository-default)」を参照してください。 ### ユーザー設定 (`~/.copilot/settings.json`) これらの設定は、すべてのセッションとリポジトリに適用されます。 `/settings`スラッシュ コマンドを使用して対話型ダイアログを実行したり、特定のスラッシュ コマンドを使用して個々の値を更新したり、このファイルを直接編集したりできます。 | 鍵 | タイプ | Default | 説明 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `allowedUrls` | `string[]` | `[]` | URL またはドメインは、プロンプトなしで許可されます。 正確な URL、ドメイン パターン、ワイルドカード サブドメイン ( `"*.github.com"` など) をサポートします。 | | `askUser` | `boolean` | `true` | エージェントが明確な質問をすることを許可します。 完全に自律的な操作を行うために `false` に設定します。 | | `--no-ask-user`で設定することもできます。 | | | | | `autoTier` | | | | | `"efficiency"` | | | | | \| | | | | | `"balance"` | | | | | \| | | | | | `"intelligence"` | | | | | 設定解除する | 選択したモデルが `auto`されている場合の新しい会話の既定の自動ルーティング層。 | | | | `/model`スラッシュ コマンドを参照してください。 | | | | | `"fast"` は選択できなくなり、警告が設定されている場合は `"balance"` にフォールバックします。 | | | | | `autoUpdate` | `boolean` | `true` | CLI の更新プログラムを自動的にダウンロードし、各セッションの開始時にファースト パーティプラグインを更新します。 | | `autoUpdatesChannel` | | | | | `"stable"` | | | | | \| | | | | | `"prerelease"` | | | | | `"stable"` | チャネルを更新します。 プレリリース更新プログラムを受け取る `"prerelease"` に設定します。 | | | | `banner` | | | | | `"always"` | | | | | \| | | | | | `"once"` | | | | | \| | | | | | `"never"` | | | | | `"once"` | アニメーションバナーの表示頻度。 | | | | `bashEnv` | `boolean` | `false` | bash シェル `BASH_ENV` サポートを有効にします。 | | `--bash-env`または`--no-bash-env`で設定することもできます。 | | | | | `beep` | `boolean` | `true` | 注意が必要な場合は、聞こえるビープ音を鳴らします。 | | `beepOnSchedule` | `boolean` | `true` | スケジュールされた `/every` または `/after` の実行が完了したときに、聞こえるビープ音を再生します。 | | `colorMode` | | | | | `"default"` | | | | | \| | | | | | `"github"` | | | | | \| | | | | | `"dim"` | | | | | \| | | | | | `"high-contrast"` | | | | | \| | | | | | `"colorblind"` | | | | | `"github"` | | | | | `theme`の非推奨のエイリアス。 | | | | | `theme`を優先します。 | | | | | `commandHistoryMaxSize` | `number` | `50` | 入力履歴と逆引き検索用に保持される最近のコマンドの最大数。 | | `1`と`1000`の間の整数である必要があります。 | | | | | `compactPaste` | `boolean` | `true` | 大きな貼り付け (10 行を超える) をコンパクト トークンに折りたたみます。 | | `companyAnnouncements` | `string[]` | `[]` | 起動時にランダムに表示されるカスタム メッセージ。 CLI が開始されるたびに 1 つのメッセージがランダムに選択されます。 チームのお知らせやリマインダーに便利です。 | | `connectors` | `boolean` | `true` | 使用可能な場合は、 Copilot コネクタを有効にします。 無効にするには、 `false` に設定します。 | | `continueOnAutoMode` | `boolean` | `false` | レートが制限されている場合は、自動モードに自動的に切り替わります。 | | `true`すると、対象となるレート制限エラーによって自動モードへの自動切り替えがトリガーされ、再試行されます。 グローバル レート制限または BYOK プロバイダーには適用されません。 | | | | | `copyOnSelect` | `boolean` | | | | `true` (macOS)、 `false` (その他) | マウスで選択したテキストをシステム クリップボードに自動的にコピーします。 | | | | `customAgents.defaultLocalOnly` | `boolean` | `false` | ローカル カスタム エージェントのみを使用します (リモート組織またはエンタープライズ エージェントは使用しません)。 | | `defaultMode` | | | | | `"interactive"` | | | | | \| | | | | | `"plan"` | | | | | \| | | | | | `"autopilot"` | | | | | `"interactive"` | 新しい対話型セッションの開始時に使われるエージェント モード | | | | `--mode`、`--autopilot`、および`--plan`のオプションが優先されます。 再開されたセッションは独自のモードを維持し、`-p`/`--prompt`、`--server`、および `--acp` の実行時にはこの設定は無視されます。 | | | | | `defaultPermissionMode` | | | | | `"manual"` | | | | | \| | | | | | `"assisted"` | | | | | \| | | | | | `"allow-all"` | | | | | 場合により異なる | 新しい対話型セッションの優先するアクセス許可モード。 | | | | `permissions.defaultMode` の管理対象設定がこの設定よりも優先されます。 どちらの既定値も設定されていない場合、セッションは手動モードまたは支援モードで開始できます。 | | | | | `"manual"`を設定して、まだ許可されていない要求のたびに確認するか、`"assisted"`を使用して対象となる要求をモデル レビューにかけるか、または`--allow-all`を`"allow-all"`と同等の広範なアクセス許可を付与するように設定します。 拒否規則とエンタープライズ制限は引き続き適用されます。 「[手動承認なしで安全なコマンドを実行できるようにする](/ja/copilot/concepts/customizations/allowing-safe-commands)」を参照してください。 再開されたセッションは、独自のモードを維持します。 この設定は非対話型の実行には適用されず、 `--allow-all` または `--yolo` が優先されます。 アシスト付きスタートアップの既定設定は、リモート セッションには適用されません。 構成済みのモードが使用できないか、エンタープライズ ポリシーによってブロックされている場合、CLI は手動承認から始まり、その理由を通知します。 | | | | | `"assisted"`または`"allow-all"`を`defaultMode: "autopilot"`と対にして、構成されたアクセス許可モードを適用できる場合は、自動パイロットのアクセス許可の確認をスキップします。 | | | | | `deniedUrls` | `string[]` | `[]` | 常に拒否される URL またはドメイン。 拒否規則は、許可規則よりも優先されます。 | | `disableAllHooks` | `boolean` | `false` | すべてのフック (リポジトリ レベルとユーザー レベルの両方) を無効にします。 | | `disabledMcpServers` | `string[]` | `[]` | 無効にする MCP サーバー名。 一覧表示されたサーバーは構成されていますが、起動されていません。 | | `disabledSkills` | `string[]` | `[]` | 無効にするスキル名。 一覧表示されたスキルは検出されますが、読み込まれません。 | | `dynamicRetrieval` | `{ skills?: boolean }` | 設定解除する | 埋め込みベースの動的命令取得のカテゴリごとの制御。 | | `skills`を`false`に設定して、スキルの取得を無効にします。 | | | | | `editorMode` | | | | | `"normal"` | | | | | \| | | | | | `"vim"` | | | | | `"normal"` | 入力コンポーザー編集モード。 | | | | `/vim`スラッシュコマンドの切り替えで設定します。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#slash-commands-in-the-interactive-interface)」を参照してください。 | | | | | `effortLevel` | `string` | `"medium"` | 拡張思考の推論作業レベル: `"low"`、 `"medium"`、 `"high"`、または `"xhigh"`。 レベルが高いほど、より多くのコンピューティングが使用されます。 | | `enabledMcpServers` | `string[]` | `[]` | 既定で無効になっている組み込みの MCP サーバーを有効にします。 | | `enabledPlugins` | `Record` | `{}` | 宣言型プラグインの自動インストール。 キーはプラグインの仕様です。値は `true` (有効) または `false` (無効) です。 | | `experimental` | `boolean` | `false` | 試験的な機能を有効にします。 | | `--experimental`コマンド ライン オプションまたは `/experimental` スラッシュ コマンドを使用して有効にすることもできます。 | | | | | `extraKnownMarketplaces` | `Record` | `{}` | 追加のプラグイン マーケットプレース。 各キーはマーケットプレース名です。この値は、必要な `source` (`"directory"`、 `"git"`、または `"github"`) を指定します。 エントリに `autoUpdate: true` を設定して、マーケットプレースにインストールされているプラグインをファースト パーティのプラグインと同じセッション開始自動更新にオプトインします。 このオプトインは、対話型セッションと `-p` セッションにのみ適用されます。SDK セッションとサーバー セッションは自動更新されません。 オプトインは、独自のユーザー設定または管理対象 (MDM/サーバー) 設定で設定されている場合に適用されます。 同じ名前の競合では、組み込みのファースト パーティ マーケットプレースが優先され、マネージド エントリ (同じ名前のユーザー エントリ全体が置き換えられるため、 `"autoUpdate": true` のないマネージド エントリによってユーザーのオプトインが削除されます)、その後、ユーザー自身のエントリが削除されます。 | | `footer` | `object` | — | ステータス行に表示する項目を制御します。 サブキーには、 `showModelEffort`、 `showDirectory`、 `showBranch`、 `showContextWindow`、 `showQuota`、 `showAgent`、 `showAiUsed`、 `showCodeChanges`、 `showUsername`、 `showSandbox`、 `showYolo`、 `showCustom` (すべて `boolean`) が含まれます。 | | `/statusline`スラッシュ コマンドによって管理されます。 | | | | | `hooks` | `object` | — | イベント名でキー指定されたインライン ユーザー レベルのフック定義。 | | `.github/hooks/*.json` ファイルと同じスキーマを使用します。 「[GitHub Copilot CLI でフックを使用する](/ja/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。 | | | | | `ide.autoConnect` | `boolean` | `true` | 起動時に IDE ワークスペースに自動的に接続します。 | | `false`しても、`/ide` コマンドを使用して手動で接続できます。 | | | | | `ide.openDiffOnEdit` | `boolean` | `true` | 接続されている IDE でファイルの編集差分を開いてレビュー/承認します。 | | `false`すると、ファイル編集の承認はターミナルにのみ表示されます。 | | | | | `ignoredSkillsLocations` | `string[]` | `[]` | 通常であればどの場所で検出される場合でも、検出対象から除外されるスキルディレクトリ（およびその配下のディレクトリ）。 | | `~`に対する相対パスをサポートします。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#skill-locations)」を参照してください。 | | | | | `includeCoAuthoredBy` | `boolean` | `true` | エージェントによって行われた git コミットに `Co-authored-by` トレーラーを追加します。 | | `inlineImages` | `boolean` | `true` | キティ グラフィックス プロトコルを使用してイメージをインラインでレンダリングします。 サポートされているターミナル (Ghostty、kitty、WezTerm、またはグラフィックス レンダラーが有効になっている herdr ペイン。サポートは自動的に検出されます) が必要です。 無効にすると、画像添付ファイルにテキスト プレースホルダーが表示されます。 | | `keepAlive` | | | | | `"on"` | | | | | \| | | | | | `"off"` | | | | | \| | | | | | `"busy"` | | | | | `"off"` | CLI の起動時に適用されるキープアライブ モード。 | | | | `"on"` は常にシステムのスリープを防ぎ、 `"busy"` はエージェントの実行中にのみスリープ状態を防ぎ、 `"off"` はキープアライブを無効にします。 | | | | | `/keep-alive`スラッシュ コマンドを使用して構成することもできます。 | | | | | `logLevel` | | | | | `"none"` | | | | | \| | | | | | `"error"` | | | | | \| | | | | | `"warning"` | | | | | \| | | | | | `"info"` | | | | | \| | | | | | `"debug"` | | | | | \| | | | | | `"all"` | | | | | \| | | | | | `"default"` | | | | | `"default"` | ログの冗長度。 | | | | `mergeStrategy` | | | | | `"rebase"` | | | | | \| | | | | | `"merge"` | | | | | — | | | | | `/pr fix conflicts`の競合解決戦略。 | | | | | `"rebase"`に設定すると、ベース ブランチにリベースすることで競合が解決されます。 | | | | | `"merge"`に設定すると、ベース ブランチがフィーチャ ブランチにマージされます。 構成されていない場合は、ピッカー ダイアログが表示されます。 | | | | | `model` | `string` | 変化する | 使用する AI モデル。 | | `"auto"`に設定すると、使用可能な最適なモデルCopilot自動的に選択できるようになります。 | | | | | `/model`スラッシュ コマンドによって管理されます。 | | | | | `mouse` | `boolean` | `true` | マウスのサポートを有効にします。 | | `--mouse`または`--no-mouse`で設定することもできます。 | | | | | `permissions.disableBypassPermissionsMode` | `string` | — | すべての許可オプション (`--allow-all-paths`、`--allow-all-urls`、`--allow-all`、`--yolo`、`"disable"`) をブロックするには、`--allow-all-tools`に設定します。 この設定では、個別に制御されるassisted permissionsはブロックされません。 その他の値は `"disable"` のエイリアスとして扱われ、警告がログに書き込まれます。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the-allow-all-options)」を参照してください。 | | `pinnedPrompts` | `boolean` | `true` | タイムラインをスクロールしながら、現在のセクションのユーザー プロンプトを上部のバーのすぐ下にピン留めして、表示される出力がどの要求に属するかを明確に保つ。 CLI UI のみ - モデルに送信されたプロンプトには影響しません。 | | `powershellFlags` | `string[]` | `["-NoProfile", "-NoLogo"]` | 起動時に PowerShell に渡されるフラグ。 Windowsでは、CLI は PowerShell 7 以降 (`pwsh`) を優先し、`powershell.exe` が使用できない場合は、Windows PowerShell (`pwsh`) にフォールバックします。 Windows のみ。 | | `proxyKerberosServicePrincipal` | `string` | 設定解除する | Kerberos/Negotiate プロキシ認証用のサービス プリンシパル名 (SPN)。派生された `HTTP/` を上書きします。 | | `proxyUrl` | `string` | 設定解除する | HTTP(S) 要求のプロキシ URL (たとえば、 `http://proxy.corp.example:3128`)。 | | `http`、`https`、または SOCKS スキームを使用し、ホストを含め、1 から 65535 までのポートを使用する必要があります。 無効な値は保存時に拒否されます。 | | | | | `HTTP_PROXY` または `HTTPS_PROXY` という環境変数 (大文字と小文字を問わない) によって上書きされます。 | | | | | `remoteSessions` | `boolean` | `false` | リモート コントロールが使用可能な場合は、対話型セッションに対して既定でリモート コントロールを有効にします。 | | `/remote on`または`/remote off`を使用して、現在のセッションのリモート制御を変更します。 これは、セッション同期の `remoteExport` 設定とは別です。 | | | | | `renderHexColors` | `boolean` | `true` | インライン コード ( `` `#FF0000` `` など) として記述された 6 桁の 16 進数のカラー コードをカラー 見本として表示します。 | | `renderMarkdown` | `boolean` | `true` | ターミナル出力で Markdown をレンダリングします。 | | `remoteExport` | `boolean` | `true` | セッション同期が利用可能な場合、セッション履歴をアカウントに同期します。 | | `false` に設定すると、既定でオプトアウトになります。 | | | | | `remoteSessions: true`でリモート コントロールを有効にすると、この設定に関係なくエクスポートも有効になります。 同期履歴自体では、リモート 制御は有効になりません。 | | | | | `--sync-session=on`または`--sync-session=off`を使用して、特定の実行に対する履歴同期をオーバーライドします。 組織のクラウド セッション ストレージ ポリシーがオフになっているか、決定できない場合、同期は拒否されます。 | | | | | `respectGitignore` | `boolean` | `true` | | | `@` ファイルメンション ピッカーから gitignored ファイルを除外します。 | | | | | `false`すると、ピッカーには通常、`.gitignore`によって除外されるファイルが含まれます。 | | | | | `sandbox.allowBypass` | `boolean` | `true` | サンドボックス化されたコマンドが特定の操作のバイパスを要求できるようにする (アクセス許可プロンプトが表示されます)。そのため、 `grep` や `glob` などのツールは、サンドボックスでブロックされる場合に動作し続けます。 また、有効なポリシーでバイパスが許可されている場合は、現在のセッションの残りの部分のサンドボックスを無効にすることもできます。 オプトアウトするには、 `false` に設定します。 | | `sandbox.enabled` | `boolean` | `false` | シェル コマンド、MCP/LSP サーバー、および組み込みのファイル/Web ツールを、ファイル システムとネットワーク アクセスが制限されたサンドボックス環境に制限します。 | | `/sandbox`ダイアログまたは`/sandbox enable`で有効にします。 | | | | | `sandbox.auth.git` | `boolean` | `true` | サンドボックス内で実行されているコマンドが Git で認証できるように、Git 資格情報をサンドボックスに挿入します。 オプトアウトするには、 `false` に設定します。 `sandbox.gitAuth`から名前が変更されました。古いキーは移行を行わず、引き続き表示される場所では無視されます。 | | `sandbox.auth.gh` | `boolean` | `true` | | | GitHub CLI (`gh`) 資格情報をサンドボックスに挿入して、その中で実行されているコマンドがGitHub CLIで認証できるようにします。 オプトアウトするには、 `false` に設定します。 `sandbox.ghAuth`から名前が変更されました。古いキーは移行を行わず、引き続き表示される場所では無視されます。 | | | | | `sandbox.credentials` | `object` | 設定解除する | サンドボックス プロセスで選択した環境変数をマスクします。 各エントリの空でない`envVars`配列を持つ、変数名でキー指定された`injectHosts`オブジェクトを格納します。 プロセスはプレースホルダーを受け取り、ローカル プロキシはそれらのホストへの HTTPS 要求ヘッダー内でのみ実際の値を提供します。 シークレット値ではなく、変数名とホスト規則を格納します。 サンドボックスを有効にする必要があります。 \[ `/sandbox` ] ダイアログの \[ **資格情報** ] タブの \[ **マスクされた環境変数** ] から設定します。 「[ローカル サンドボックス設定の構成](/ja/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings#masking-environment-variables)」を参照してください。 | | `sandbox.userPolicy.network.allowLocalNetwork` | `boolean` | `false` | ローカル開発サーバーへの接続など、ローカル ネットワーク アクセスを制御します。 サンドボックス コマンドへの影響は、オペレーティング システムによって異なります。 サポートされているWindows ホストで、この設定を有効にすると、ホストの localhost への接続も許可されます。 以前のWindowsバージョンでは、この設定を有効にしても localhost をブロックしたままにします。 Windows のプロキシ処理とホスト ルールでは、これが`true`である必要があります。 | | `sandbox.userPolicy.network.proxy` | `object` | 設定解除する | HTTP (S) プロキシを介してサンドボックス化されたネットワーク トラフィックをルーティングします。 フィールド: `url` (必須)、 `username` (省略可能)、 `password` (省略可能)。 URL に資格情報を含めてはなりません。 パスワード フィールドをマスクする `/sandbox` ダイアログの \[ **ネットワーク** ] タブで資格情報を構成します。 リテラル パスワードは、使用可能な場合は OS 資格情報ストアを使用し、ローカル ファイルフォールバックを使用します。 | | `settings.json` はシークレット リファレンスを保持します。 代わりに、パスワードにはフィールド全体の`${VAR}`または`$VAR`環境変数参照を使用できます。 プロキシの適用は、次に示すようにプラットフォームによって異なります。 | | | | | `sandbox.userPolicy.network.allowedHosts` | `string[]` | `[]` | サンドボックス化されたコマンドからのアクセスが許可されているホスト。 エントリは正確なホスト名、IP アドレス、またはサブドメイン用の `*.example.com` ですが、ルート ドメインではありません (`*` はすべてのホストに一致します)。 CIDR ブロックはサポートされていません。 URL またはポートは含めないでください。 空でないリストは、送信ネットワーク アクセスとローカル ネットワーク アクセスの両方が有効になっている場合に、 `localhost`、 `127.0.0.1`、および `::1` を除き、一致しないホストをブロックします。 これらの自動エントリでは、保存したリストは変更されません。 明示的な拒否規則とエンタープライズ許可リストは引き続き適用されます。 | | `/sandbox` ダイアログの \[**ネットワーク**] タブの \[**ホストルール**] から構成します。 | | | | | `sandbox.userPolicy.network.blockedHosts` | `string[]` | `[]` | | | `allowedHosts` と同じ方法で照合され、サンドボックス化されたコマンドの到達をホストが拒否しました。 | | | | | `blockedHosts` は常に一致する `allowedHosts` エントリよりも優先され、ドメインを拒否するとサブドメインも拒否されます。 | | | | | `/sandbox` ダイアログの \[**ネットワーク**] タブの \[**ホストルール**] から構成します。 | | | | | `sandbox.userPolicy.filesystem.deniedPaths` | `string[]` | `[]` | セキュリティで保護されたコマンドのアクセスが拒否されるパス。 Windows には、アクセスが拒否されたパスをサポートするバージョンが必要です。 ホストがそれらを強制できない場合、コマンドは弱い制限で実行されるのではなく失敗します。 アクセス拒否対象のパスとその親が見つからない場合、起動前にディレクトリとして作成され、`.env` などの名前であっても自動的に削除されません。 準備エラーのため起動できません。 読み取り専用の `/sandbox policy` プレビューでは何も作成されません。Linux では、不足している拒否パスは省略されます。 | | `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | macOS のみ。 セキュリティで保護されたコマンドにシステム キーチェーンへのアクセス権を付与します。 | | `/sandbox`でのみ構成でき、`/settings`または`settings.json`経由では構成できません。 | | | | | `screenReader` | `boolean` | `false` | スクリーン リーダーの最適化を有効にします。 | | `scrollbar` | `boolean` | `true` | スクロール可能なビューでスクロール バーを表示します。 | | `false`に設定して非表示にし、完全な端子幅を使用します。 | | | | | `shellShortcut` | `boolean` | `true` | プロンプトで 1 つ `$` し、 Enter キーを押して、セッションの作業ディレクトリをルートとする対話型シェルを開きます (実際の TTY でローカルで信頼されたアイドル 状態のセッションに対してのみアクティブ化されます)。 ユーザー スコープまたは管理対象スコープのみで、リポジトリによるオーバーライドはできません。 | | `showReasoning` | `boolean` | なし | タイムラインにモデルの推論を表示します。 これは、 `/config` または `/settings`で設定することも、 Ctrl+T キーで切り替えることもできます。 設定はセッションをまたいで保存されます。 | | `showTimestamps` | `boolean` | `true` | タイムラインのユーザー メッセージの横に、dim `HH:mm` タイムスタンプを表示します。 | | `showTipsOnStartup` | `boolean` | `true` | CLI の起動時にランダムなコマンド ヒントを表示します。 | | `sidebar` | `boolean` | `true` | 現在のセッション サイドバーを有効にします。 | | `false` に設定すると、完全に無効になり、コンポーザーのヒントと ← で開くジェスチャーが非表示になります。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#sidebar-and-sessions-tab-shortcuts)」を参照してください。 | | | | | `skillDirectories` | `string[]` | `[]` | カスタム スキル定義を検索する追加のディレクトリ ( `~/.copilot/skills/`に加えて)。 | | `statusLine` | `object` | — | カスタムのステータスラインの表示。 | | `type`: `"command"`でなければなりません。 | | | | | `command`: stdin でセッション JSON を受け取り、状態コンテンツを stdout に出力する実行可能スクリプトへのパス。 | | | | | `padding`: 省略可能な左埋めスペースの数。 | | | | | `refreshInterval`: イベントに対してのみではなく、タイマーでコマンドを再実行する秒数 (`1`\~ `2147483`) (省略可能)。セッション状態が変化した場合にのみ更新するには省略します。 コマンドが生成に失敗した場合、0 以外の状態を終了した場合、または stdin で状態 JSON を受信できない場合、CLI は継続的なエラー エピソードごとに 1 回警告をログに記録し、状態行は警告なしで失敗するのではなく空白のままにします。 | | | | | `--log-level all`で実行して、基になるエラーの詳細を確認します。 | | | | | `stayInAutopilot` | `boolean` | `true` | 各タスクが完了した後も、オートパイロット モードのままです。 有効にすると、タスクの完了後に入力する次のプロンプトもオートパイロット モードで処理されます。 詳細については、「[GitHub Copilot CLI での Autopilot モードの使用](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/use-autopilot-mode)」を参照してください。 | | `storeTokenPlaintext` | `boolean` | `false` | システム キーチェーンが使用できない場合に、認証トークンをプレーン テキストで `config.json` に格納できるようにします。 | | `stream` | `boolean` | `true` | ストリーミング応答を有効にします。 | | `streamerMode` | `boolean` | `false` | プレビュー モデル名、クォータの詳細、プロンプト のタイムスタンプ、および更新可能な通知を非表示にします。 | | Copilot CLIまたは画面共有を示すときに便利です。 | | | | | `subagents.agents` | `object` | `{}` | エージェント名でキー指定されたエージェントごとのモデル構成。 各値は、省略可能な `model` (文字列)、 `modelPolicy` (`"preferred"` または `"required"`)、 `effortLevel` (文字列)、および `contextTier` (`"default"`、 `"long_context"`、または `"inherit"`) フィールドを持つオブジェクトです。 ディスパッチ時に親セッションの値を使用するには、 `model`、 `effortLevel`、または `contextTier` を `"inherit"` に設定します。 | | `modelPolicy` は、エージェント定義自体が `modelPolicy: "required"`を設定しても影響を与えません。ここでロックをオーバーライドすることはできません。 これらの設定を対話形式で構成するには、 `/subagents` スラッシュ コマンドを使用します。 | | | | | `subagents.agents["rubber-duck"].autoInvoke` | `boolean` | `false` | Copilotが指示されなくてもラバーダック エージェントに自発的に相談できるようにします。 これを変更するには、 `/subagents`を実行し、 `rubber-duck`選択して **Enter キー**を押してから、 **プロアクティブ呼び出し**を切り替えます。 | | `subagents.disabledSubagents` | `string[]` | `[]` | オフになっているサブエージェントの名前。 対話型セッションで、\*\*\*\* ピッカー内の各エージェントに対して`/subagents` コントロールを使用して、この一覧を管理します。 | | `subagents.maxConcurrency` | `number` | プランベース | このセッションで同時実行可能なサブエージェントの最大数。 使用量ベースの課金ユーザーにのみ適用されます。他のすべてのプランでは無視されます。 | | `32`で上限。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits)」を参照してください。 | | | | | `subagents.maxDepth` | `number` | `6` | サブエージェントの入れ子の深さの最大値。 使用量ベースの課金ユーザーにのみ適用されます。他のすべてのプランでは無視されます。 | | `256`で上限。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits)」を参照してください。 | | | | | `tabs.enabled` | `boolean` | `true` | ホーム タブ バーを表示します。 完全に非表示にするには、 `false` に設定します。 | | `tabs.hide` | `string[]` | `[]` | 非表示にするタブ識別子。 使用可能な値: `"copilot"`、`"agents"`、`"issues"`、`"pull-requests"`、`"gists"`（大文字と小文字を区別せずに照合されます）。 | | `tabs.sort` | `string[]` | `[]` | タブが表示される順序。 一覧にないタブは、リストされているタブの後に既定の相対順序を保持します。 不明な識別子は無視されます。 | | `taskbarPresence` | `boolean` | `true` | Windows タスク バー (エージェント アイコンとホバー カード) にライブ Copilot セッションを表示します。 オプトアウトするには、 `false` に設定します。スタートアップのみ。は、次回の起動時に有効になります。 Windows のみ。 | | `terminalNotifications` | `boolean` | `false` | デスクトップ通知が有効になっている場合は、サポートされているターミナル (Ghostty、WezTerm) でターミナル所有の OSC 777 通知を優先し、サポートされていない場合や配信に失敗した場合はネイティブ OS 通知にフォールバックします。 | | `terminalProgress` | `boolean` | `true` | エージェントの作業中に、OSC 9;4 のターミナル進捗インジケーターを出力します。 サポートされるターミナルには、Windows ターミナル、iTerm2、Ghostty、ConEmu などがあります。 | | `theme` | | | | | `"default"` | | | | | \| | | | | | `"github"` | | | | | \| | | | | | `"dim"` | | | | | \| | | | | | `"high-contrast"` | | | | | \| | | | | | `"colorblind"` | | | | | `"github"` | ターミナル出力のカラー パレット。 | | | | `/settings`および`/theme`スラッシュ コマンドによって管理されます。 | | | | | `colorMode` は、この設定の非推奨のエイリアスです。 | | | | | `toolSearch` | `boolean` | モデルと機能に依存 | ツールの検索を制御します（ツールの遅延読み込み）。 | | `toolSearch: false`を設定して、ツール検索をオプトアウトします。 | | | | | `transcriptView` | | | | | `"default"` | | | | | \| | | | | | `"concise"` | | | | | `"default"` | タイムラインでツール アクティビティを展開可能な作業の概要にグループ化するには、 `"concise"` に設定します。 完全なネイティブ トランスクリプトを表示するには、 `"default"` に設定します。 | | | | `updateTerminalTitle` | `boolean` | `true` | ターミナル タブまたはウィンドウ のタイトルに現在の意図を表示します。 | | `worktreeBaseRef` | | | | | `"head"` | | | | | \| | | | | | `"defaultBranch"` | | | | | `"head"` | | | | | `/worktree`、`/worktree new`、`/new worktree`、`/move`、`--worktree`によって作成された新しいワークツリーの開始点。 | | | | | `"defaultBranch"` は、現在のチェックアウトではなく、リモートの既定のブランチから開始されます。 | | | | | `/fork worktree` は、この設定に関係なく、常に `HEAD` から分岐します。 | | | | | `worktreePathTemplate` | `string` | 設定解除する | | | `/worktree`、`/move`、`/new`、`--worktree`ワークツリー (`~/src/worktrees/{repo}/{branch}`など) を作成します。 | | | | | `{repoPath}`、`{repo}`、`{branch}`、および`{branchSlug}`のプレースホルダーをサポートします。 設定を解除すると、既定のレイアウト `.worktrees/`が使用され、ブランチ名のスラッシュはダッシュにフラット化されます。 | | | | > [!TIP] > サポートされているホストとすべての`sandbox`設定キーを含む、完全なサンドボックス リファレンスについては、`copilot help sandbox` を実行します。 `/sandbox`ダイアログでは、Git 認証、\*\*\*\* 認証、マスクされた環境変数が専用の `gh` タブの下にグループ化され、現在のサンドボックス構成が格納されている `settings.json` パスが表示されます。 \[ **ファイルシステム** ] タブでは、構成済みのパスの一覧がアクセス許可 (たとえば、 `2 read/write, 1 read-only`) ごとに **ユーザー設定パス** 行の下で要約されます。 その行の Enter キーを押して完全なリストを開きます。このリストは、 Esc キーを押すまでカーソルとタブ バーを引き継ぎます。構成されたパスは、 `./`相対または `~`短縮形式ではなく、絶対パスとして表示されます。 パスを追加するときに「 `~/path` 」と入力しても、ホーム ディレクトリに展開されます。 \[`/sandbox`] ダイアログで Ctrl+Eキーを押して保留中の変更を保存し、エディター (`COPILOT_EDITOR`、`VISUAL`、または`EDITOR`) で`settings.json`を開き、`/settings`で同じショートカットに一致させます。 ファイルを編集して保存すると、ダイアログによってディスクからその状態が再読み込みされます。 ホスト規則と `sandbox.userPolicy.network.proxy` は、組み込みのローカル プロキシを使用します。 両方が構成されている場合、ローカル プロキシは、アップストリーム プロキシにトラフィックを転送する前にホスト 規則を適用します。 アップストリームの資格情報は、サンドボックス化された子プロセスの外部にとどまります。 送信アクセスがオフの場合、ホストルールとプロキシ設定は非アクティブになります。 サンドボックス設定でプロキシが設定されていない場合、ローカル プロキシは、ホスト上でこの順序で `HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY` のうち最初に空でない環境変数からアップストリーム プロキシを選択します。 `socks5` と `http://` プロキシのみがサポートされ、`https://` はサポートされません。 ホストの `NO_PROXY` に一致する宛先は、この継承されたアップストリーム プロキシだけをバイパスします。 サンドボックスのローカル プロキシは引き続きこれらの接続を処理し、そのホスト規則を適用します。 サンドボックス設定で構成されたプロキシは、`NO_PROXY`を無視します。 macOS と Linux では、サンドボックスによって直接接続が制限されるため、プログラムはプロキシを回避できません。 Windowsでは、サンドボックスはプロキシ設定に従うプログラムに依存します。 その結果、Windowsのプロキシ設定を無視するプログラムは直接接続し、ホストルールを回避できます。 Windowsプロキシとホスト ルールでは、サポートされているホストと`allowLocalNetwork: true`も必要です。これはプライベート ネットワーク アクセスを許可します。 Linux では、プロキシ設定では、 `[::]` デュアルスタック ワイルドカード以外の IPv6 アドレス リテラルが拒否されます。 IPv4 エンドポイントまたは IPv4 サポートのホスト名を使用します。 サンドボックス設定は、ユーザー レベルまたは企業管理です。 これらはリポジトリでオーバーライドできません。 構成手順とネットワークの制限事項については、 [ローカル サンドボックス設定の構成](/ja/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings) を参照してください。 サンドボックスは[Microsoft eXecution Container (MXC)](https://github.com/microsoft/mxc?utm_source=cli-config-directory-reference-article-microsoft-mxc\&utm_medium=docs\&utm_campaign=universe-2026)によって実現されており、プラットフォーム固有の分離バックエンドを提供します。 Copilot CLIでは、macOS では Seatbelt、Linux では Bubblewrap、Windowsでは ProcessContainer が使用されます。 ### リポジトリの設定 (`.github/copilot/settings.json`) リポジトリの設定は、リポジトリ内で作業するすべてのユーザーに適用されます。 これらはリポジトリにコミットされ、コラボレーターと共有されます。 > [!NOTE] > リポジトリ構成ファイル (`enabledPlugins` および `extraKnownMarketplaces`) 内のプラグイン関連のキーも、Copilot in the cloudだけでなく、Copilot CLIによって読み取られます。 これにより、1 つのファイルから両方のクライアントに対して同じプラグインを有効にすることができます。 プラグインの詳細については、 [GitHub Copilot 用のプラグイン](/ja/copilot/concepts/customizations/plugins) を参照してください。 リポジトリ レベルでは、次の表に示すキーのみがサポートされています。 その他のキー (ユーザー構成ファイルで有効なキーを含む) は、暗黙的に無視されます。 サポートされている各キーには、オーバーライドがフェールクローズかつ安全な状態に保たれるようにする方向性を持つマージポリシーがあります。 | 鍵 | タイプ | マージ動作 | 説明 | | ------------------------------------------- | ------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `companyAnnouncements` | `string[]` | 置き換え — リポジトリが優先されます | 起動時にランダムに表示されるメッセージ。 | | `contextTier` | | | | | `"default"` | | | | | \| | | | | | `"long_context"` | | | | | 置き換え — リポジトリが優先されます | 既定のコンテキスト層をピン留めします。 | | | | `deniedUrls` | `string[]` | Union - リポジトリはエントリを追加でき、削除することはできません | URL またはドメインがブロックされました。 | | `disableAllHooks` | `boolean` | リポジトリが優先されます | すべてのフックを無効にします。 | | `disabledMcpServers` | `string[]` | Union - リポジトリはエントリを追加でき、削除することはできません | MCP サーバーが構成されているが、開始されていません。 | | `disabledSkills` | `string[]` | Union - リポジトリはエントリを追加でき、削除することはできません | スキルが検出されましたが、読み込まれていません。 | | `effortLevel` | `string` | 置き換え — リポジトリが優先されます | 既定の推論レベルを固定します。 | | `enabledPlugins` | `Record` | マージ - リポジトリが同じキーのユーザーをオーバーライドする | 宣言型プラグインの自動インストール。 | | `extraKnownMarketplaces` | `Record` | マージ - リポジトリが同じキーのユーザーをオーバーライドする | このリポジトリで利用できるプラグイン マーケットプレース。 各エントリの `source` が必要です。 エントリの `autoUpdate: true` はリポジトリ レベルで受け入れられますが、現在は無視されています。自動更新オプトインは、ユーザー自身の設定または管理対象 (MDM/サーバー) 設定で設定されている場合にのみ適用されます。 | | `hooks` | `object` | マージ - リポジトリが同じキーのユーザーをオーバーライドする | このリポジトリにスコープが設定された定義をフックします。 「[GitHub Copilot CLI でフックを使用する](/ja/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。 | | `includeCoAuthoredBy` | `boolean` | 置き換え — リポジトリが優先されます | コミットに `Co-authored-by` トレーラーを追加する。 | | `mergeStrategy` | | | | | `"rebase"` | | | | | \| | | | | | `"merge"` | | | | | 置き換え — リポジトリが優先されます | | | | | `/pr fix conflicts`の競合解決戦略。 | | | | | `model` | `string` | 置き換え — リポジトリが優先されます | このリポジトリの既定のモデルをピン留めします。 | | `respectGitignore` | `boolean` | 強化のみ — リポジトリでは有効化のみ可能で、無効化はできません | | | `@` ファイルメンション ピッカーから gitignored ファイルを除外します。 | | | | `model`、 `effortLevel`、および `contextTier` オーバーライドは、作業ディレクトリが [信頼されている](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools)場合にのみ適用されます。 リポジトリの `enabledPlugins` を介してのみ有効になっているプラグインは、そのリポジトリにスコープが設定されます。これは、宣言するリポジトリに自動インストールおよびアクティブ化されますが、グローバルに無効のままであるため、関連のないプロジェクトではアクティブ化されません。 リポジトリまたはプラグインを無効にするリポジトリを離れると、MCP サーバーが破棄され、セッションのエージェントとスキルが非アクティブ化されます。 ### リポジトリ レベルのモデルの許可リスト (`.github/allowed_models.txt`) 現在の作業ディレクトリのリポジトリ ルート (またはリポジトリの外部にある作業ディレクトリ自体) から解決された、 `.github/allowed_models.txt`のプレーンテキスト許可リストでリポジトリが使用できる組み込みモデルを制限します。 各行は、モデル ID に一致する glob パターン、または構成済みまたは要求されたモデルが許可されていない場合に使用するモデルに名前を付ける `fallback:` ディレクティブです。 ```text # .github/allowed_models.txt fallback: gpt-6-astra gpt-6-astra gpt-6-sol claude-sonnet-* ``` | ルール | 説明 | | -------------------- | ---------------------------------------------------- | | `*` | すべてのモデルを許可します (ファイルがない場合は既定値)。 | | `MODEL-ID` | 正確なモデル ID を許可します。 | | `GLOB-PATTERN` | glob と一致するモデル ID を許可します (例: `claude-sonnet-*`)。 | | `fallback: MODEL-ID` | 1 回だけ必要です。 モデル Copilot は、アクティブなモデルが許可されていない場合に使用します。 | | `#` | コメント行。 | 否定パターン (`!pattern`) はサポートされていません。フォールバック モデルは、(glob ではなく) 正確な ID である必要があり、フォールバック モデル自体が構成された glob のいずれかに一致している必要があります。 Copilot CLI `/cd`でポリシーを再評価し、実行前にエラーが発生した無効なファイルを拒否します。 許可リストは、 Copilotの組み込みモデルのみを管理します。 Bring Your Own API Keys (BYOK) メソッドを使用して追加されたカスタム モデルを除外することはできません。 BYOK モデルは、構成するパターンに関係なく一覧表示され、選択可能なままであり、 `fallback:` ディレクティブは適用されません。 詳細については、「[エンタープライズでのGitHub Copilotのカスタム モデルの有効化](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models)」および「[組織内のGitHub Copilotのカスタム モデルを有効にする](/ja/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models)」を参照してください。 ### ローカル設定 (`.github/copilot/settings.local.json`) コミットすべきでない個人用オーバーライドの `.github/copilot/settings.local.json` をリポジトリに作成します。 このファイルを `.gitignore`に追加します。 ローカル構成ファイルは、リポジトリ構成ファイル (`.github/copilot/settings.json`) と同じスキーマを使用し、そのスキーマよりも優先されます。 ## MDM で管理される設定 IT 管理者は、ユーザーごとの構成を必要とするのではなく、モバイル デバイス管理 (MDM) の管理対象設定を使用してベースライン ポリシーをプッシュできます。 これらの設定では、サポートされているキーのデバイス レベルの既定値が適用され、ユーザー設定の前に読み込まれます。 マネージド設定は、対話型、 `-p`、 `--acp`、 `--ahp-host`、 `--server`など、すべてのセッション ホスティング モードに均一に適用されるため、エンタープライズ MCP、アクセス許可、プラグイン ポリシーは、別のエントリ ポイントを介してセッションを開始することによってバイパスできません。 Copilot CLI また、MDM に加えて、起動時にサーバーで管理される設定も読み込まれます。 デバイス管理（MDM）設定とサーバー管理設定は、**キーごとに**適用されます。MDM で設定されたキーでは MDM の値が優先され、MDM で未設定のキーはサーバーの値で補われます。 これにより、組織は MDM ( `permissions` など) を使用してポリシーを設定しながら、サーバーから他の管理対象の既定値 ( `model` など) を受け取ります。 実行時間の長いセッションでは、1 時間ごとに管理設定の再フェッチと再適用が行われるので、ポリシーの変更 (たとえば、 `permissions.disableBypassPermissionsMode`を有効にする組織) は、セッションを再起動せずに有効になります。 ### MDM 管理対象設定の提供元 Copilot CLI は、プラットフォーム固有の MDM またはファイル ベースの場所からマネージド設定を読み取ります。 | Platform | ソースタイプ | Location | | -------- | --------- | ------------------------------------------------------------------ | | macOS | MDM plist | `com.github.copilot` | | macOS | File | `/Library/Application Support/GitHubCopilot/managed-settings.json` | | Windows | MDM レジストリ | `HKLM\SOFTWARE\Policies\GitHubCopilot` | | Windows | File | `%ProgramFiles%\GitHubCopilot\managed-settings.json` | | Linux | File | `/etc/github-copilot/managed-settings.json` | > [!NOTE] > POSIX システムでは、Copilot CLI は、シンボリックリンクであるか、root に所有されていないか、または誰でも書き込み可能なファイルベースの管理対象設定を拒否します。 ### ファイル形式 ファイル ベースのマネージド設定を JSON として書き込みます。 ```json { "model": "auto", "permissions": { "disableBypassPermissionsMode": "disable" } } ``` > [!NOTE] > `model` は最上位のキーです。 `permissions.model`として入れ子にした古い構成は引き続き機能します。最上位の`model` キーがない場合はランタイムはその場所にフォールバックしますが、最上位レベルに`model`を持つ新しい構成を書き込みます。 ### サポートされているキー MDM 管理設定では、次のキーのみがサポートされます。 | 鍵 | 説明 | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `allowedMcpServers` | ユーザーが読み込む MCP サーバーの許可リストは、 `serverUrl`、 `serverCommand`、または `serverName`によって照合されます。 信頼されたファースト パーティ サーバー (組み込みの GitHub MCP サーバーなど) は常に除外されます。 このキーを未設定のままにすると、既定以外のすべてのサーバーが許可されます。空の配列は、それらのすべてを拒否します。 | | [管理対象 MCP サーバーの許可/拒否リスト](#managed-mcp-server-allowdeny-list)を参照してください。 | | | `autoTier` | | | `model`が`auto`に設定されているセッションの既定の自動ルーティング層 (`"efficiency"`、`"balance"`、または`"intelligence"`) を設定します。 ベア文字列は階層を厳密にロックし、ユーザーとリポジトリの設定をオーバーライドし、 `/settings`から非表示にします。 代わりに、 `{"overridable": "TIER"}` を使用して、ユーザーとリポジトリが引き続きオーバーライドできる組織の既定値を設定します。 | | | `"fast"` は選択できなくなり、警告が表示された `"balance"` にフォールバックします。 | | | `communication.support.url` | 組織のヘルプ ページの絶対 `http` URL または `https` URL。 情報のみ。 クライアントは、通常はユーザーに管理者への連絡を案内する箇所ならどこでも、それへのリンクを設置できます。 | | `communication` ブロック全体は、それを提供する最も優先度の高いチャネルから取得されます。 | | | `deniedMcpServers` | 読み込む必要がない MCP サーバーの拒否リストが、 `allowedMcpServers`と同じ方法で一致しました。 一致する既定以外のサーバーは、許可リストに関係なくブロックされます。拒否は常に優先されます。 | | [管理対象 MCP サーバーの許可/拒否リスト](#managed-mcp-server-allowdeny-list)を参照してください。 | | | `enabledPlugins` | 特定のプラグインを有効または無効にする | | `extraKnownMarketplaces` | 信頼できるプラグイン マーケットプレースを追加する | | `forceLoginOrgs` | サインイン先を、承認済みの GitHub 組織群（大文字と小文字を区別せずに照合される組織ログイン名の配列）に限定します。 | | Copilot 少なくとも 1 つの組織に属するアカウントに対してのみ実行されます。個人アカウント、他の企業にのみ属するアカウント、または BYOK/API キー認証は、操作可能なエラーで拒否されます。 キーを削除せずにピンをオフにするには、空の配列を設定します。 このキーは、開発者の最初のサインインをリダイレクトできる必要があるため、デバイス チャネル (MDM plist/registry、または `managed-settings.json`) を介して展開します。サーバー管理チャネルは、組織に既に認証されているアカウントにのみ到達します。 このキーは閉じられません。使用できない値、または既知のマネージド デバイスで読み取ることができない管理ポリシーは、固定されるまですべてのサインインをブロックします。 | | | `forceRemoteSettingsRefresh` | キャッシュされた新しいポリシーが存在する場合でも、起動時にサーバーで管理される新しい設定のフェッチが必要です。 キャッシュされたポリシーは、鮮度要件を満たすことはできません。 フェッチが失敗した場合、影響を受ける操作は、現在のポリシーが確認されるまで制限されたままになります。 デバイス (MDM) の値は、キャッシュされたサーバー値よりも優先されます。 | | `model` | すべてのユーザーの既定のモデルを設定します ( `--model` フラグまたは再開セッション モデルによってオーバーライドされます)。 | | `effortLevel`と`contextTier``model`対応する[リポジトリ設定](#repository-settings-githubcopilotsettingsjson)キーと同じマネージド推論作業とコンテキスト層を適用しますが、マネージド モデルが明示的な作業/コンテキスト オプションをサポートしている場合にのみ適用されます。 | | | `permissions` | | | `disableBypassPermissionsMode`、`deny` / `ask` / `allow`ルール配列、`limitTo` ドメイン境界配列など、マネージド権限を設定します。 | | | [管理アクセス許可規則](#managed-permission-rules)と[ドメイン境界 (`limitTo`)](#domain-boundary-limitto) を参照してください。 | | | `policyHelper` | 最も優先度の低いマネージド設定レイヤーを提供する実行可能ファイルを登録します。 フィールド: `path` (必須)、オプションの `args`、 `timeoutMs`、および `refreshIntervalMs`。 デバイス (MDM) とサーバー ポリシーの両方が `policyHelper`を登録すると、デバイスの登録が優先されます。 | | `remoteControl` | このデバイス上のセッションを他のデバイスから制御できるかどうかを制御します。 | | `mode` が `"enabled"`、 `"disabled"`、または `"requireSSO"` (設定時に `githubDotComOrganizations` が必要)。 | | | `requireBase64ImageAttachments` | | | `true` の場合は、添付ファイルの URL ではなく、base64 でエンコードされた画像添付ファイルが必要です。 | | | `false` または未設定のままにすると、既存の動作が維持されます。 | | | `sandbox` | ユーザーがリラックスできないサンドボックス ポリシー フロアを設定します。 サポートされている設定には、 `enabled`、 `failIfUnavailable`、 `allowBypass`、 `addCurrentWorkingDirectory`、 `sandboxMcpServers`、 `sandboxLspServers`、 `auth.git`、 `auth.gh`、 `allowDevToolAccess`、 `learningMode`、および `userPolicy.*` ファイルシステムとネットワークルールが含まれます。 管理値は、常にユーザー自身の値よりも安全な方向に優先されます。 サンドボックスをオンにし、成功を要求し、MCP サーバーと LSP サーバーのサンドボックス化をオフにすることはできません。 バイパスまたは資格情報の挿入を無効にして再度有効にすることはできません。 ファイルシステム許可リストは絞り込みのみ可能で、拒否されたパスは追加することしかできません。 | | `failIfUnavailable` は管理者のみが設定でき、サンドボックスを確立できない場合はセッションをブロックします。 ユーザーが自分で設定できる設定については、「 [ユーザー設定](#user-settings-copilotsettingsjson) 」を参照するか、 `copilot help sandbox`を実行します。 | | | `shellShortcut` | すべてのユーザーの `$` 対話型シェル ショートカットを強制的に有効または無効にします。 マネージド値は、常にユーザー独自の `shellShortcut` 設定をオーバーライドします。 | | `strictKnownMarketplaces` | プラグインを既知のマーケットプレースの許可リスト (マーケットプレース スペックの JSON 配列) に制限します。 また、allowlist は、設定後に組み込みのマーケットプレースを管理します。空の配列 (`[]`) は、ユーザーまたはリポジトリが追加されたマーケットプレースだけでなく、組み込みも含め、すべてのマーケットプレースを非表示にしてブロックします。 | | `telemetry` | プッシュ ベースライン OpenTelemetry エクスポート構成: `enabled`、 `endpoint`、 `protocol`、 `headers`、 `resourceAttributes`、 `captureContent`、 `lockCaptureContent`、 `serviceName`、および `headersProvider`。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring)」を参照してください。 | > [!NOTE] > \* > `policyHelper.path` は、絶対パス、ホーム相対パス (`~/...`)、または `PATH`から解決されたベア プログラム名を受け取ります。 その他の相対フォームは拒否されます。 登録は受け入れられ、検証されますが、ランタイムはまだヘルパーを呼び出していません。ヘルパー実行は将来のリリースで提供されます。 > \* > `remoteControl.mode`が`"requireSSO"`されたら、`remoteControl.githubDotComOrganizations`で許可されている組織を一覧表示します。 クライアントは、一覧表示された組織のうち少なくとも 1 つに対して SSO 認可されている必要があります。すべての組織に対して認可されている必要はなくなりました。 > \* > `permissions.disableBypassPermissionsMode`を MDM 管理設定で`"disable"`に設定して、デバイス レベルですべて許可するオプションをブロックします。 アカウントの切り替えでこのポリシーを無効にすることはできません。 認識できない値が設定されている場合、CLI は問題をログに記録し、フェールクローズの既定値として `"disable"` を適用します。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the-allow-all-options)」を参照してください。 > > * ほとんどのマネージド キーは行全体をロックします。ローカル編集は、次の読み込み時にマネージド値によって自動的にオーバーライドされます。 > `enabledPlugins` > `extraKnownMarketplaces`は例外です。マネージド レイヤーは、これらのマップを完全に置き換えるのではなく、フィールドごとに独自のエントリとマージします。 つまり、ロックはキー全体ではなく **、エントリごとに**適用されます。マネージド ポリシーによってピン留めされたプラグインやマーケットプレースをローカルで再有効化、無効化、または再ポイントすることはできませんが、同じマップ内の他のエントリは完全にユーザー制御のままです。 > * `sandbox.learningMode`はWindows専用であり、ネイティブ MDM (Intune やレジストリなど) 経由でのみ設定できます。`managed-settings.json` ファイルの値は無視されます。 拒否キャプチャを使用するホストで、既定のレコードおよび拒否モードではなく、レコードアンド許可モードでサンドボックス シェル コマンドを開始するように `"allow"` に設定し、各ファイルシステムまたはプロセスのアクセスを記録し、拒否するのではなく許可します (ネットワーク ポリシーは引き続き適用されます)。 これにより、管理者は、コーホートをロックダウンする前に、コーホートのコマンドに何が必要かを観察できます。これはコンテインメント モードではありません。 状態行には `sandbox relaxed` が表示され、シェル呼び出しは適用されている間 `(sandbox relaxed)` を表示します。 `deny`値 (既定値) またはキーを削除すると、通常の強制サンドボックスにコーホートが返され、マネージド チャネルからの`deny`は常に`allow`よりも優先されます。 ユーザー設定と SDK ホストでは、このキーを設定できません。 ### マネージド アクセス許可ルール マネージド `permissions` キーの下に`deny`、`ask`、および`allow`ルール リストを追加して、すべてのユーザーにアクセス許可ポリシーを適用します。 これは、 `permissions.disableBypassPermissionsMode` が設定されているかどうかに関係なく機能します。 ```json { "permissions": { "deny": ["Shell(rm -rf *)", "Domain(*.evil.example)"], "ask": ["Shell(git push *)"], "allow": ["Read(**)"] } } ``` | ルール ファミリー | 一致 | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------- | | `Bash(...)`、`Shell(...)` | シェル コマンド。 コマンド プレフィックスと一致するには、 ` *` ( `git push *` など) を使用します。それ以外の場合は、ルールが正確なテキストと一致します。 | | `PowerShell(...)` | PowerShell コマンドは、 `Shell(...)`と同じ方法で一致しました。 | | `Read(...)` | ファイルの読み取り/表示パス。 glob パターンをサポートします。ワークスペース ルートの `/` 、ホーム ディレクトリの `~/` 、現在の作業ディレクトリの `./` 。 | | `Edit(...)`、`Write(...)` | ファイルの書き込み/編集パスは、 `Read(...)`と同じ方法で一致しました。 | | `Domain(...)` | URL ルールと同様に一致する [URL](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns) ホスト名。 | ルールは、固定の優先順位を持つマネージド ソース間で結合されます。拒否は常に優先され、次に要求され、許可されます。 `deny` ルールに一致すると、 `allow` ルールも一致する場合でも要求がブロックされます。 `deny` と `ask` は、すべてのマネージド ソース (サーバー、MDM) で共用化されます。 `allow` では、`allow` リストを宣言するすべてのソースでその操作が許可されている必要があります。つまり、和集合ではなく積集合として扱われます。 `deny`、`ask`、または `allow` のいずれかが設定されている場合、それらのいずれにも一致しない操作は、暗黙にフォールスルーするのではなく、既定で `ask` になります。 `Edit(...)` および `Write(...)` ルールは、組み込みのファイル ツールよりも多くの場合に適用されます。 また、シェル コマンドによって直接書き込まれたファイルについても説明します。 Copilot CLI は、これらの書き込みの固定セットを認識します。 Bash 出力リダイレクト (`>`、 `>>`、 `>|`、 `&>`、 `&>>`)、PowerShell 出力リダイレクト (`>`、 `>>`、 `*>`、 `*>>`)、および少数のインプレース `sed` 編集 (`sed -i` または `--in-place`、BSD フォームの `-i ''` と `-I ''`) について説明します。 Copilot CLIコマンドからターゲット ファイルを処理できる場合は、一致する`deny`ルールによって書き込みがブロックされ、一致する`ask`ルールによって最初にプロンプトが表示されます。 これは、 `Shell(*)` のような広範なルールでコマンドが許可される場合でも適用されます。 パスが変数から取得された場合など、ターゲット ファイルを事前に処理できない場合があります。 その場合、これらのパスルールは適用されず、代わりに通常のシェルコマンドルールによってコマンドがチェックされます。 ### ドメイン境界 (`limitTo`) マネージド `limitTo` キーの下に、`deny`、`ask`、および`allow`と共に`permissions`配列を追加して、クローズド ワールド ドメイン許可リストを適用します。 ```json { "permissions": { "limitTo": ["github.com", "*.github.com"] } } ``` `Domain(...)`では、`limitTo`エントリのみがサポートされます。 リスト外のドメインに対するエージェント ネットワーク要求は、プロンプトなしで拒否され、ユーザー ルール、保存された承認、およびすべて許可モードでも、この許可範囲を広げることはできません。 シェル要求で検出された URL は、`Domain` 要求として扱われ、境界条件も満たす必要があります。 `limitTo` 自体では、`shell`、`read`、または `write` の操作を制限しません。 空の `limitTo` リストは、すべてのドメイン要求を拒否します。 無効なリストまたは無効なエントリは、管理ポリシーの残りの部分を破棄するのではなく、空のリスト (および構成エラーとして報告) として扱われます。 `deny` 引き続き `limitTo`よりも優先されます。 `ask` と `allow` は、既に境界内にある要求のみを絞り込みます。 `allow`と同様に、`limitTo`はマネージド ソース全体にわたる交差集合です。`limitTo` リストを宣言するすべてのマネージド ソースは、そのリクエストを受け入れなければなりません。 ## 管理対象 MCP サーバーの許可/拒否リスト 管理者は、エンタープライズ MCP 許可リストに関係なく、MDM で管理された設定を使用して [MCP](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#enterprise-mcp-allowlist) サーバーを直接管理できます。 マネージド設定ソースで `allowedMcpServers` または `deniedMcpServers` を設定します。 ```json { "allowedMcpServers": [ { "serverUrl": "https://mcp.example.com/*" }, { "serverCommand": ["npx", "-y", "@example/mcp-server"] } ], "deniedMcpServers": [ { "serverName": "untrusted-server" } ] } ``` 各エントリは、次のいずれかのマッチャーによってサーバーを識別します。 | マッチャー | 一致 | 注記 | | ---------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `serverUrl` | URLで指定されたリモートの HTTP/SSE サーバー | | | `*` ワイルドカードを使用できます。スキームとホストの照合では大文字と小文字を区別しませんが、パスでは区別します。 | | | | `${VAR}` 参照は照合前に展開されます。 | | | | `serverCommand` | コマンドと引数が順序も含めて完全に一致する stdio サーバー | | | `${VAR}` 参照は照合前に展開されます。 | | | | `serverName` | 割り当てられたラベルで識別されたサーバー | 許可リスト エントリは `[A-Za-z0-9_./-]+` に制限されます (大文字と小文字が区別され、ワイルドカードはありません。`microsoft/playwright-mcp` などのレジストリ名は受け入れられます); 拒否リスト エントリは空でない文字列を受け入れます。 | 準則： * **信頼されたファースト パーティ サーバー** (組み込みの GitHub MCP サーバーなど) は、常に両方のリストから除外されます。 * **`allowedMcpServers`の設定を解除する**では、既定以外のすべてのサーバーが許可されます。**空の配列**は、それらすべてをブロックします (deny-all)。 * **設定解除または空の `deniedMcpServers`** は何もブロックしません。 * **拒否は常に優先**されます。 `deniedMcpServers` に一致するサーバーは、 `allowedMcpServers`にも一致する場合でもブロックされます。 * リモート サーバーの場合、一致は`serverUrl`エントリから取得する必要があります。`serverName``serverUrl`エントリが存在しない場合にのみカウントされます。 stdio サーバーの場合、一致は`serverCommand`エントリから取得する必要があります。`serverName``serverCommand`エントリが存在しない場合にのみカウントされます。 ## 詳細については、次を参照してください。 * [GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli) * [GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference) * [GitHub Copilot CLI プログラムリファレンス](/ja/copilot/reference/copilot-cli-reference/cli-programmatic-reference) * [GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference) * [GitHub Copilotフックリファレンス](/ja/copilot/reference/hooks-reference)