# 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/` | ディレクトリ | インストールされているプラグインの永続的なデータ | | `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/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/change-settings)」を参照してください。 または、テキスト エディターで `settings.json` ファイルを直接編集することもできます。 このファイルは、コメント付き JSON (JSONC) をサポートしています。 既定では、このファイルはユーザー レベルの構成ディレクトリである `~/.copilot` ディレクトリにあります。 これには、すべてのリポジトリのグローバル ユーザー レベルの既定値が含まれています。 このディレクトリの場所を変更するには、 `COPILOT_HOME` 環境変数を別のパスに設定します。 > \[!NOTE] > ユーザーが編集可能な設定は、もともと `config.json`に格納されていました。 これらは `settings.json`に移動されました。 起動時に `config.json` に存在するすべてのユーザー設定は、自動的に `settings.json`に移行されます。 `settings.json`が読み取り、解析、または検証に失敗した場合、Copilot CLIは無効な値を無視し (認識された`config.json`値はマージされます)、タイムラインに起動警告が表示され、`/settings` コマンドの \[**問題**] タブに移動します。 そのタブを開いて特定のエラーを表示し、報告された問題を修正して、影響を受ける設定を復元します。 認識されない設定 (入力ミスなど) ではない最上位のキーが`settings.json`に含まれている場合は、タイムラインまたは stderr ではなく、`/settings` コマンドの \[**問題**] タブに一覧表示Copilot CLI。 タブのラベルには、構成スコープに問題がある場合の数 (たとえば、 `Problems (2)`) が表示されます。 `$schema` は許容され、報告されません。 `~/.copilot/settings.json`がシンボリック リンクである場合 (たとえば、dotfiles リポジトリを介して設定を同期する場合)、`/settings` コマンドからの書き込みは、シンボリック リンクを通常のファイルに置き換えるのではなく、シンボリック リンクに従ってターゲットを更新します。 設定の完全な一覧と、リポジトリ レベルの構成との対話方法については、この記事で後述する [構成ファイルの設定](#configuration-file-settings) を参照してください。 > \[!TIP] > ターミナルで `copilot help config` を実行してクイック リファレンスを確認します。 ### `copilot-instructions.md` 作業しているプロジェクトに関係なく、すべてのセッションに適用される個人のカスタム指示。 このファイルはリポジトリ レベルの `copilot-instructions.md` と同じように動作しますが、グローバルに適用されます。 詳細については、「[GitHub Copilot用のリポジトリカスタム命令の追加](/ja/enterprise-cloud@latest/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/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。 ### `lsp-config.json` ユーザー レベルで使用できる言語サーバー プロトコル (LSP) サーバーを定義します。 これらのサーバーは、エージェントに言語インテリジェンス (診断、完了など) を提供します。 `/lsp`スラッシュ コマンドを使用してこのファイルを管理するか、直接編集します。 詳細については、「[GitHub Copilot CLI 用の LSP サーバーの追加](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers)」を参照してください。 ### `agents/` 個人用カスタム エージェント定義を `.agent.md` ファイルとしてここに格納します。 このディレクトリに配置されたエージェントは、すべてのセッションで使用できます。 Projectレベルのエージェント (`.github/agents/`) は、同じ名前を共有する場合は、個人エージェントよりも優先されます。 詳細については、「[GitHub Copilot CLI のカスタムエージェントの作成と使用](/ja/enterprise-cloud@latest/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/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。 ### `hooks/` ユーザー レベルのフック スクリプトをここに格納します。 これらのフックは、すべてのセッションに適用されます。 `~/.copilot/settings.json` キーを使用して、ユーザー構成ファイル (`hooks`) でフックをインラインで定義することもできます。 リポジトリ レベルのフック ( `.github/hooks/`) は、ユーザー レベルのフックと共に読み込まれます。 詳細については、「[GitHub Copilot CLI でフックを使用する](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。 ### `extensions/` ユーザー レベルの拡張ファイルをここに格納します。 このディレクトリ内の拡張機能は、セッション間で使用できます。 このディレクトリにファイルを手動で作成するか、拡張機能をスキャフォールディングしてから、生成されたファイルを編集できます。 ## ファイルを自動的に管理する 次の項目は CLI によって管理されます。 通常、手動で編集しないでください。 ### `config.json` 認証データ、インストールされているプラグイン メタデータ、その他のランタイム情報など、CLI によって自動的に管理される内部アプリケーションの状態を格納します。 通常、このファイルを編集する必要はありません。 > \[!NOTE] > 以前のバージョンの Copilot CLI では、ユーザー設定とアプリケーションの状態の両方が `config.json`に格納されています。 ユーザーが編集可能な設定が `settings.json`に配置されるようになりました。 起動時に `config.json` のすべてのユーザー設定が自動的に `settings.json`に移行されます。 アプリケーションの状態フィールド ( `loggedInUsers`、 `installedPlugins`、 `firstLaunchAt`、 `staff`など) は `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 CLI について](/ja/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/chronicle#managing-your-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/enterprise-cloud@latest/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/` | はい | プラグインの永続データは、必要に応じて再作成されます。 | | `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 値が常に優先されます。 詳細については、「 [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`も読み取ります。 ### ユーザー設定 (`~/.copilot/settings.json`) これらの設定は、すべてのセッションとリポジトリに適用されます。 `/settings`スラッシュ コマンドを使用して対話型ダイアログを実行したり、特定のスラッシュ コマンドを使用して個々の値を更新したり、このファイルを直接編集したりできます。 | 鍵 | タイプ | Default | 説明 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `allowedUrls` | `string[]` | `[]` | URL またはドメインは、プロンプトなしで許可されます。 正確な URL、ドメイン パターン、ワイルドカード サブドメイン ( `"*.github.com"` など) をサポートします。 | | `askUser` | `boolean` | `true` | エージェントが明確な質問をすることを許可します。 完全に自律的な操作を行うために `false` に設定します。 | | `--no-ask-user`で設定することもできます。 | | | | | `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` の実行が完了したときに、聞こえるビープ音を再生します。 | | `builtInAgents.rubberDuck` | `boolean` | `true` | エージェントの計画に対して批判的なフィードバックを提供するラバーダックのサブエージェントを有効にします。 | | `builtInAgents.rubberDuckAutoInvoke` | `boolean` | `false` | 自動ラバーダック呼び出しのプロアクティブなプロンプトを含めます。 エージェントの応答中に追加のラバーダックによるヒントを受け取るには、`true` に設定します。 | | `colorMode` | | | | | `"default"` | | | | | \| | | | | | `"github"` | | | | | \| | | | | | `"dim"` | | | | | \| | | | | | `"high-contrast"` | | | | | \| | | | | | `"colorblind"` | | | | | `"github"` | | | | | `theme`の非推奨のエイリアス。 | | | | | `theme`を優先します。 | | | | | `commandHistoryMaxSize` | `number` | `50` | 入力履歴と逆引き検索用に保持される最近のコマンドの最大数。 | | `1`と`1000`の間の整数である必要があります。 | | | | | `compactPaste` | `boolean` | `true` | 大きな貼り付け (10 行を超える) をコンパクト トークンに折りたたみます。 | | `companyAnnouncements` | `string[]` | `[]` | 起動時にランダムに表示されるカスタム メッセージ。 CLI が開始されるたびに 1 つのメッセージがランダムに選択されます。 チームのお知らせやリマインダーに便利です。 | | `continueOnAutoMode` | `boolean` | `false` | レートが制限されている場合は、自動モードに自動的に切り替わります。 | | `true`すると、対象となるレート制限エラーによって自動モードへの自動切り替えがトリガーされ、再試行されます。 グローバル レート制限または BYOK プロバイダーには適用されません。 | | | | | `copyOnSelect` | `boolean` | | | | `true` (macOS)、 `false` (その他) | マウスで選択したテキストをシステム クリップボードに自動的にコピーします。 | | | | `customAgents.defaultLocalOnly` | `boolean` | `false` | ローカル カスタム エージェントのみを使用します (リモート組織またはエンタープライズ エージェントは使用しません)。 | | `deniedUrls` | `string[]` | `[]` | 常に拒否される URL またはドメイン。 拒否規則は、許可規則よりも優先されます。 | | `disableAllHooks` | `boolean` | `false` | すべてのフック (リポジトリ レベルとユーザー レベルの両方) を無効にします。 | | `disabledMcpServers` | `string[]` | `[]` | 無効にする MCP サーバー名。 一覧表示されたサーバーは構成されていますが、起動されていません。 | | `disabledSkills` | `string[]` | `[]` | 無効にするスキル名。 一覧表示されたスキルは検出されますが、読み込まれません。 | | `dynamicRetrieval` | `{ skills?: boolean }` | 設定解除する | 埋め込みベースの動的命令取得のカテゴリごとの制御。 | | `skills`を`false`に設定して、スキルの取得を無効にします。 | | | | | `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/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。 | | | | | `ide.autoConnect` | `boolean` | `true` | 起動時に IDE ワークスペースに自動的に接続します。 | | `false`しても、`/ide` コマンドを使用して手動で接続できます。 | | | | | `ide.openDiffOnEdit` | `boolean` | `true` | 接続されている IDE でファイルの編集差分を開いてレビュー/承認します。 | | `false`すると、ファイル編集の承認はターミナルにのみ表示されます。 | | | | | `includeCoAuthoredBy` | `boolean` | `true` | エージェントによって行われた git コミットに `Co-authored-by` トレーラーを追加します。 | | `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` | — | | | `"disable"`に設定すると、起動時にすべての許可フラグ (`--allow-all-tools`、`--allow-all-paths`、`--allow-all-urls`、`--allow-all`、`--yolo`) が抑制され、昇格されたアクセス許可を付与するために使用できなくなります。 `"allow-auto-only"` に設定すると、完全な allow-all は引き続き禁止しながら、`/allow-all auto` (LLM 支援による自動承認) は許可できます。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/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_PROXY` または `HTTPS_PROXY` という環境変数 (大文字と小文字を問わない) によって上書きされます。 | | | | | `remote` | | | | | `"on"` | | | | | \| | | | | | `"off"` | | | | | `"on"` | セッションの同期とリモート アクセスを制御します。 セッション データのみをローカルに保ち、リモート コントロールを無効にするには、 `"off"` に設定します。 | | | | `--remote`または`--no-remote`で設定することもできます。 | | | | | `renderHexColors` | `boolean` | `true` | インライン コード ( `` `#FF0000` `` など) として記述された 6 桁の 16 進数のカラー コードをカラー 見本として表示します。 | | `renderMarkdown` | `boolean` | `true` | ターミナル出力で Markdown をレンダリングします。 | | `remoteExport` | `boolean` | `true` | セッション同期が使用可能な場合は、セッションをリモートでエクスポートします。 既定でリモート エクスポートをオプトアウトするには、 `false` に設定します。 | | `remoteSessions`または`true` フラグに設定した場合でも、`--remote`設定では、この設定に関係なくエクスポートとステアリングが有効になります。 | | | | | `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.userPolicy.network.allowLocalNetwork` | `boolean` | `true` | セキュリティで保護されたコマンドがローカル ネットワーク アドレス (ローカル開発サーバーなど) に到達できるようにします。 オプトアウトするには、 `false` に設定します。 | | `sandbox.userPolicy.network.proxy` | `object` | 設定解除する | HTTP プロキシを介してセキュリティで保護されたネットワーク トラフィックをルーティングします。 フィールド: `url` (必須)、 `username` (省略可能)、 `password` (省略可能)。 パスワード フィールドをマスクする `/sandbox` ダイアログの \[ **ネットワーク** ] タブから構成します。 パスワード自体は、 `settings.json`ではなく OS キーチェーンに格納されるため、 `/settings`を使用して編集することはできません。 Linux および macOS では、プロキシは協調的です (厳密には適用されません)。Windowsによって適用されます。 | | `sandbox.userPolicy.deniedPaths` | `string[]` | `[]` | セキュリティで保護されたコマンドのアクセスが拒否されるパス。 Windows では、ProcessContainer サンドボックス バックエンドはパスごとの拒否ルールを適用できないため、エントリは効果がありません。したがって、Windows 上の機密性の高いディレクトリを保護する目的で `deniedPaths` を頼りにしないでください。 | | `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | macOS のみ。 セキュリティで保護されたコマンドにシステム キーチェーンへのアクセス権を付与します。 | | `/sandbox` ダイアログから切り替えることもできます。 | | | | | `screenReader` | `boolean` | `false` | スクリーン リーダーの最適化を有効にします。 | | `scrollbar` | `boolean` | `true` | スクロール可能なビューでスクロール バーを表示します。 | | `false`に設定して非表示にし、完全な端子幅を使用します。 | | | | | `shellShortcut` | `boolean` | `true` | プロンプトで 1 つ `$` し、 Enter キーを押して、セッションの作業ディレクトリをルートとする対話型シェルを開きます (実際の TTY でローカルで信頼されたアイドル 状態のセッションに対してのみアクティブ化されます)。 ユーザー スコープまたは管理対象スコープのみで、リポジトリによるオーバーライドはできません。 | | `showTimestamps` | `boolean` | `true` | タイムラインのユーザー メッセージの横に、dim `HH:mm` タイムスタンプを表示します。 | | `showTipsOnStartup` | `boolean` | `true` | CLI の起動時にランダムなコマンド ヒントを表示します。 | | `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 が自律的に動作できるようにする](/ja/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/autopilot#staying-in-autopilot-mode-between-tasks)」を参照してください。 | | `storeTokenPlaintext` | `boolean` | `false` | システム キーチェーンが使用できない場合に、認証トークンをプレーン テキストで `config.json` に格納できるようにします。 | | `stream` | `boolean` | `true` | ストリーミング応答を有効にします。 | | `streamerMode` | `boolean` | `false` | プレビュー モデル名、クォータの詳細、プロンプト のタイムスタンプ、および更新可能な通知を非表示にします。 | | Copilot CLIまたは画面共有を示すときに便利です。 | | | | | `subagents.agents` | `object` | `{}` | エージェント名でキー指定されたエージェントごとのモデル構成。 各値は、省略可能な `model` (文字列)、 `effortLevel` (文字列)、および `contextTier` (`"default"`、 `"long_context"`、または `"inherit"`) フィールドを持つオブジェクトです。 ディスパッチ時に親セッションの値を使用するには、任意のフィールドを `"inherit"` に設定します。 これらの設定を対話形式で構成するには、 `/subagents` スラッシュ コマンドを使用します。 | | `subagents.disabledSubagents` | `string[]` | `[]` | ディスパッチ対象から除外するエージェント名。 この設定では、 `rubber-duck` エージェントのみを無効にすることはできません。 | | `explore`、`task`、`code-review`、`general-purpose`、`research`、`security-review`など、他のすべての組み込みエージェントを無効にすることができます。 | | | | | `subagents.maxConcurrency` | `number` | プランベース | このセッションで同時実行可能なサブエージェントの最大数。 使用量ベースの課金ユーザーにのみ適用されます。他のすべてのプランでは無視されます。 | | `32`で上限。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits)」を参照してください。 | | | | | `subagents.maxDepth` | `number` | `6` | サブエージェントの入れ子の深さの最大値。 使用量ベースの課金ユーザーにのみ適用されます。他のすべてのプランでは無視されます。 | | `256`で上限。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/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[]` | `[]` | タブが表示される順序。 一覧にないタブは、リストされているタブの後に既定の相対順序を保持します。 不明な識別子は無視されます。 | | `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`を設定して、ツール検索をオプトアウトします。 | | | | | `updateTerminalTitle` | `boolean` | `true` | ターミナル タブまたはウィンドウ のタイトルに現在の意図を表示します。 | | `worktreeBaseRef` | | | | | `"head"` | | | | | \| | | | | | `"defaultBranch"` | | | | | `"head"` | | | | | `/worktree`、`/worktree new`、および`--worktree`によって作成された新しいワークツリーの開始点。 | | | | | `"defaultBranch"` は、現在のチェックアウトではなく、リモートの既定のブランチから開始されます。 | | | | > \[!TIP] > サポートされているホストとすべての`sandbox`設定キーを含む、完全なサンドボックス リファレンスについては、`copilot help sandbox` を実行します。 `/sandbox`ダイアログは、専用**の \[認証**] タブの下に`git`、`gh`、およびキーチェーン アクセスをグループ分けし、現在のサンドボックス構成が格納されている`settings.json` パスを示します。 \[`/sandbox`] ダイアログで Ctrl+Eキーを押して保留中の変更を保存し、エディター (`COPILOT_EDITOR`、`VISUAL`、または`EDITOR`) で`settings.json`を開き、`/settings`で同じショートカットに一致させます。 ファイルを編集して保存すると、ダイアログによってディスクからその状態が再読み込みされます。 サンドボックスは[Microsoft eXecution Container (MXC)](https://github.com/microsoft/mxc)によって実現されており、プラットフォーム固有の分離バックエンドを提供します。 Copilot CLIでは、macOS では Seatbelt、Linux では Bubblewrap、Windowsでは ProcessContainer が使用されます。 ### リポジトリの設定 (`.github/copilot/settings.json`) リポジトリの設定は、リポジトリ内で作業するすべてのユーザーに適用されます。 これらはリポジトリにコミットされ、コラボレーターと共有されます。 > \[!NOTE] > リポジトリ構成ファイル (`enabledPlugins` および `extraKnownMarketplaces`) 内のプラグイン関連のキーも、Copilot cloud agentだけでなく、Copilot CLIによって読み取られます。 これにより、1 つのファイルから両方のクライアントに対して同じプラグインを有効にすることができます。 プラグインの詳細については、 [GitHub Copilot プラグインについて](/ja/enterprise-cloud@latest/copilot/concepts/agents/about-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/enterprise-cloud@latest/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/enterprise-cloud@latest/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-5.2 gpt-5.2 gpt-5.4 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/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models)」および「[組織内のGitHub Copilotのカスタム モデルを有効にする](/ja/enterprise-cloud@latest/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) の管理対象設定を使用してベースライン ポリシーをプッシュできます。 これらの設定では、サポートされているキーのデバイス レベルの既定値が適用され、ユーザー設定の前に読み込まれます。 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)を参照してください。 | | | `deniedMcpServers` | 読み込む必要がない MCP サーバーの拒否リストが、 `allowedMcpServers`と同じ方法で一致しました。 一致する既定以外のサーバーは、許可リストに関係なくブロックされます。拒否は常に優先されます。 | | [管理対象 MCP サーバーの許可/拒否リスト](#managed-mcp-server-allowdeny-list)を参照してください。 | | | `enabledPlugins` | 特定のプラグインを有効または無効にする | | `extraKnownMarketplaces` | 信頼できるプラグイン マーケットプレースを追加する | | `forceRemoteSettingsRefresh` | キャッシュされた新しいポリシーが存在する場合でも、起動時にサーバーで管理される新しい設定のフェッチが必要です。 フェッチが失敗した場合でも、キャッシュされたエントリはフォールバックとして保持されます。 デバイス (MDM) の値は、キャッシュされたサーバー値よりも優先されます。 | | `model` | すべてのユーザーの既定のモデルを設定します ( `--model` フラグまたは再開セッション モデルによってオーバーライドされます) | | `permissions` | | | `disableBypassPermissionsMode`や`deny` / `ask` / `allow`ルール配列など、マネージド アクセス許可を設定します。 | | | [管理アクセス許可ルール](#managed-permission-rules)を参照してください。 | | | `policyHelper` | 最も優先度の低いマネージド設定レイヤーを提供する実行可能ファイルを登録します。 フィールド: `path` (必須)、オプションの `args`、 `timeoutMs`、および `refreshIntervalMs`。 デバイス (MDM) とサーバー ポリシーの両方が `policyHelper`を登録すると、デバイスの登録が優先されます。 | | `remoteControl` | このデバイス上のセッションを他のデバイスから制御できるかどうかを制御します。 | | `mode` が `"enabled"`、 `"disabled"`、または `"requireSSO"` (設定時に `githubDotComOrganizations` が必要)。 | | | `shellShortcut` | すべてのユーザーの `$` 対話型シェル ショートカットを強制的に有効または無効にします。 マネージド値は、常にユーザー独自の `shellShortcut` 設定をオーバーライドします。 | | `strictKnownMarketplaces` | プラグインを既知のマーケットプレースに制限する | | `telemetry` | ベースラインの OpenTelemetry エクスポート構成をプッシュ: `enabled`、`endpoint`、`protocol`、`headers`、`resourceAttributes`、`captureContent`、`lockCaptureContent`、および `serviceName`。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring)」を参照してください。 | > \[!NOTE] > `policyHelper.path` は、絶対パス、ホーム相対パス (`~/...`)、または `PATH`から解決されたベア プログラム名を受け取ります。 その他の相対フォームは拒否されます。 登録は受け入れられ、検証されますが、ランタイムはまだヘルパーを呼び出していません。ヘルパー実行は将来のリリースで提供されます。 > \[!NOTE] > `remoteControl.mode`が`"requireSSO"`されたら、`remoteControl.githubDotComOrganizations`で許可されている組織を一覧表示します。 クライアントは、一覧表示された組織のうち少なくとも 1 つに対して SSO 認可されている必要があります。すべての組織に対して認可されている必要はなくなりました。 > \[!NOTE] > デバイス レベルで制限を適用するには、 `permissions.disableBypassPermissionsMode` を MDM 管理設定で `"disable"` に設定します。 アカウントの切り替えでこのポリシーを無効にすることはできません。 完全な allow-all への権限昇格を禁止しながら、`/permissions assisted` (LLM 支援によるアクセス許可の承認) を許可するには、`"allow-auto-only"` に設定します。 「[GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options)」を参照してください。 > \[!NOTE] > ほとんどのマネージド キーは行全体をロックします。ローカル編集は、次の読み込み時にマネージド値によって自動的にオーバーライドされます。 > `enabledPlugins` > `extraKnownMarketplaces`は例外です。マネージド レイヤーは、これらのマップを完全に置き換えるのではなく、フィールドごとに独自のエントリとマージします。 つまり、ロックはキー全体ではなく **、エントリごとに**適用されます。マネージド ポリシーによってピン留めされたプラグインやマーケットプレースをローカルで再有効化、無効化、または再ポイントすることはできませんが、同じマップ内の他のエントリは完全にユーザー制御のままです。 ### マネージド アクセス許可ルール マネージド `deny` キーの下にある`ask`、`allow`、および`permissions`ルール リストをプッシュして、`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/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns) ホスト名。 | ルールは、固定の優先順位を持つマネージド ソース間で結合されます。拒否は常に優先され、次に要求され、許可されます。 `deny` ルールに一致すると、 `allow` ルールも一致する場合でも要求がブロックされます。 `deny` と `ask` は、すべてのマネージド ソース (サーバー、MDM) で共用化されます。 `allow` では、`allow` リストを宣言するすべてのソースでその操作が許可されている必要があります。つまり、和集合ではなく積集合として扱われます。 `deny`、`ask`、または `allow` のいずれかが設定されている場合、それらのいずれにも一致しない操作は、暗黙にフォールスルーするのではなく、既定で `ask` になります。 ## 管理対象 MCP サーバーの許可/拒否リスト 管理者は、エンタープライズ MCP 許可リストに関係なく、MDM で管理された設定を使用して [MCP](/ja/enterprise-cloud@latest/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_-]+` (ワイルドカードなし) に制限されます。拒否リスト エントリは空でない文字列を受け入れます。 | 準則： * **信頼されたファースト パーティ サーバー** (組み込みの GitHub MCP サーバーなど) は、常に両方のリストから除外されます。 * **`allowedMcpServers`の設定を解除する**では、既定以外のすべてのサーバーが許可されます。**空の配列**は、それらすべてをブロックします (deny-all)。 * **設定解除または空の `deniedMcpServers`** は何もブロックしません。 * **拒否は常に優先**されます。 `deniedMcpServers` に一致するサーバーは、 `allowedMcpServers`にも一致する場合でもブロックされます。 * リモート サーバーの場合、一致は`serverUrl`エントリから取得する必要があります。`serverName``serverUrl`エントリが存在しない場合にのみカウントされます。 stdio サーバーの場合、一致は`serverCommand`エントリから取得する必要があります。`serverName``serverCommand`エントリが存在しない場合にのみカウントされます。 ## 詳細については、次を参照してください。 * [GitHub Copilot CLI](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli) * [GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference) * [GitHub Copilot CLI プログラムリファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference) * [GitHub Copilot CLI プラグイン リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference) * [GitHub Copilotフックリファレンス](/ja/enterprise-cloud@latest/copilot/reference/hooks-reference)