GitHub Copilot CLI の構成ディレクトリ - GitHub Enterprise Cloud Docs

Copilot CLI (コパイロット 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/`	ディレクトリ	個人のカスタムスキル定義

メモ

これらの項目のすべてがすぐに表示されるわけではありません。一部は、特定の機能を初めて使用したときにオンデマンドで作成されます。たとえば、 installed-plugins/ は、最初のプラグインをインストールした後にのみ表示されます。

ユーザーが編集可能なファイル

次のファイルは、ユーザーが直接編集するか、CLI コマンドを使用して管理するように設計されています。

`settings.json`

これは、 Copilot CLI (コパイロット CLI)のプライマリ構成ファイルです。セッション内では、対話型の /settings コマンドを使用して特定の値を変更したり、 /settings KEY VALUE を実行して 1 つの値を設定したり、テキストエディターで直接ファイルを編集したりできます。このファイルは、コメント付き JSON (JSONC) をサポートしています。

メモ

ユーザーが編集可能な設定は、もともと config.jsonに格納されていました。これらは settings.jsonに移動されました。起動時に config.json に存在するすべてのユーザー設定は、自動的に settings.jsonに移行されます。

設定の完全な一覧と、リポジトリレベルの構成との対話方法については、この記事で後述する構成ファイルの設定を参照してください。

ヒント

ターミナルで copilot help config を実行してクイックリファレンスを確認します。

`copilot-instructions.md`

作業しているプロジェクトに関係なく、すべてのセッションに適用される個人のカスタム指示。このファイルはリポジトリレベルの copilot-instructions.md と同じように動作しますが、グローバルに適用されます。

詳細については、「GitHub Copilot用のリポジトリカスタム命令の追加」を参照してください。

`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 サーバーを追加する」を参照してください。

`lsp-config.json`

ユーザーレベルで使用できる言語サーバープロトコル (LSP) サーバーを定義します。これらのサーバーは、エージェントに言語インテリジェンス (診断、完了など) を提供します。 /lspスラッシュコマンドを使用してこのファイルを管理するか、直接編集します。

詳細については、「LSP サーバーの追加 GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。

`agents/`

個人用カスタムエージェント定義を .agent.md ファイルとしてここに格納します。このディレクトリに配置されたエージェントは、すべてのセッションで使用できます。 Projectレベルのエージェント (.github/agents/) は、同じ名前を共有する場合は、個人エージェントよりも優先されます。

詳細については、「GitHub Copilot CLI（コマンドラインインターフェース）のカスタムエージェントの作成と使用」を参照してください。

`skills/`

個人のカスタムスキル定義をここに格納します。各スキルは、 SKILL.md ファイル ( ~/.copilot/skills/my-skill/SKILL.md など) を含むサブディレクトリに存在します。個人のスキルはすべてのセッションで利用できます。 Projectレベルのスキルは、同じ名前を共有する場合、個人のスキルよりも優先されます。

詳細については、「エージェントスキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。

`hooks/`

ユーザーレベルのフックスクリプトをここに格納します。これらのフックは、すべてのセッションに適用されます。 ~/.copilot/settings.json キーを使用して、ユーザー構成ファイル (hooks) でフックをインラインで定義することもできます。リポジトリレベルのフック ( .github/hooks/) は、ユーザーレベルのフックと共に読み込まれます。

詳細については、「GitHub Copilot CLI（コマンドラインインターフェース）でフックを使用する」を参照してください。

`extensions/`

ユーザーレベルの拡張ファイルをここに格納します。このディレクトリ内の拡張機能は、セッション間で使用できます。

このディレクトリにファイルを手動で作成するか、拡張機能をスキャフォールディングしてから、生成されたファイルを編集できます。

ファイルを自動的に管理する

次の項目は CLI によって管理されます。通常、手動で編集しないでください。

`config.json`

認証データ、インストールされているプラグインメタデータ、その他のランタイム情報など、CLI によって自動的に管理される内部アプリケーションの状態を格納します。通常、このファイルを編集する必要はありません。

メモ

以前のバージョンの Copilot CLI (コパイロット CLI) では、ユーザー設定とアプリケーションの状態の両方が config.jsonに格納されています。ユーザーが編集可能な設定が settings.jsonに配置されるようになりました。起動時に config.json のすべてのユーザー設定が自動的に settings.jsonに移行されます。アプリケーションの状態フィールド ( loggedInUsers、 installedPlugins、 firstLaunchAt、 staffなど) は config.json のままであり、移行されません。

`permissions-config.json`

保存したツールとディレクトリのアクセス許可の決定をプロジェクトの場所別に格納します。ツールを承認するか、ディレクトリへのアクセスを許可すると、CLI によって決定がここに記録されるため、同じプロジェクトで再度プロンプトが表示されることはありません。

メモ

プロジェクトのアクセス許可をリセットする場合は、このファイルから関連するエントリを削除できます。ただし、セッションの実行中にファイルを編集すると、予期しない動作が発生する可能性があります。

`session-state/`

サブディレクトリ内のセッション ID 別に整理されたセッション履歴データが含まれています。各セッションディレクトリには、イベントログ (events.jsonl) とワークスペース成果物 (プラン、チェックポイント、追跡されたファイル) が格納されます。このデータにより、セッションの再開 (--resume または --continue) が有効になります。

このディレクトリからファイルを削除すると、ローカルコピーのみが削除されます。 GitHub アカウントにセッションを同期した場合、同期されたデータは個別に保存され、ローカルファイルの削除の影響を受けません。同期されたセッションは、 GitHub.comから削除したり非表示にしたりできます。詳細については、「セッションデータ GitHub Copilot CLI（コマンドラインインターフェース）について」を参照してください。

`command-history-state/`

対話型インターフェイスの逆引き検索 (Ctrl+R) と履歴ナビゲーションに使用されるコマンド履歴データが含まれています。このディレクトリは自動的に管理されるため、編集しないでください。

`session-store.db`

チェックポイントのインデックス作成や検索などのセッション間データに CLI によって使用される SQLite データベース。このファイルは自動的に管理され、編集しないでください。

このファイルを削除した場合は、 /chronicle reindex コマンドを使用してリビルドできます。インデックスを再作成すると、セッションデータもアカウントに同期されます。

`logs/`

CLI セッションのログファイルが含まれています。各セッションでは、 process-{timestamp}-{pid}.logという名前のログファイルが作成されます。これらのファイルは、問題のデバッグに役立ちます。

CLI では、 logs/extensions/の下に拡張機能固有のログを作成することもできます。

これは、ユーザーが作成した拡張機能コードを格納する ~/.copilot/extensions/とは別です。

ヒント

現在のセッションのログファイルを検索するには、対話型セッションに「 /session 」と入力します。出力には、ログファイルへの完全なパスと、セッション ID、期間、作業ディレクトリなどの他のセッションの詳細が含まれます。

`installed-plugins/`

インストールしたプラグインのファイルが含まれています。マーケットプレースからインストールされたプラグインは、 installed-plugins/{marketplace-name}/{plugin-name}/の下に格納されます。直接インストールされたプラグインは、 installed-plugins/_direct/の下に格納されます。このディレクトリを直接編集するのではなく、 copilot plugin コマンドを使用してプラグインを管理します。

詳細については、「GitHub Copilot CLI プラグインリファレンス」を参照してください。

`plugin-data/`

マーケットプレースとプラグイン名別に整理された、インストールされているプラグインの永続的なデータが含まれています。このデータはプラグイン自体によって管理されるため、手動で編集することはできません。

`ide/`

IDE 統合のロックファイルと状態が含まれます (たとえば、 Copilot CLI (コパイロット CLI) が Visual Studio Code に接続する場合)。このディレクトリは自動的に管理されます。

`mcp-oauth-config/`

キーチェーンベースのストレージが使用できない場合の MCP OAuth トークン、登録、PKCE フォールバックファイルが含まれます。このディレクトリは自動的に管理されます。

`mcp-secrets/`

キーチェーンベースのストレージが使用できない場合のフォールバックファイルストレージと MCP シークレットプレースホルダーのインデックスが含まれます。このディレクトリは自動的に管理されます。

構成ディレクトリの場所の変更

既定の ~/.copilot 場所をオーバーライドするには、 COPILOT_HOME 環境変数を使用するディレクトリのパスに設定します。

Bash

export COPILOT_HOME=/path/to/my/copilot-config

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`	慎重に	すべてのユーザー設定を既定値にリセットします。設定を再構成する必要があります。

構成ファイルの設定

設定はユーザーからリポジトリ、そしてローカルへと階層的に適用され、より具体的なスコープがより一般的なスコープを上書きします。コマンドラインオプションと環境変数は常に最も優先順位が高くなります。

Scope	Location	目的
ユーザー	`~/.copilot/settings.json`	すべてのリポジトリのグローバルな既定値。
`COPILOT_HOME`環境変数を使用して、代替パスを指定します。
リポジトリ	`.github/copilot/settings.json`	共有リポジトリの構成 (リポジトリにコミット)。
Local	`.github/copilot/settings.local.json`	個人のオーバーライド (これを `.gitignore`に追加します)。

CLI では、リポジトリ設定の共有クロスツールサブセット (companyAnnouncements、disableAllHooks、enabledPlugins、extraKnownMarketplaces、hooksなど) の.claude/settings.jsonと.claude/settings.local.jsonも読み取ります。

ユーザー設定 (`~/.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"`
`"default"`	カラーコントラストモード。
`/settings`および`/theme`スラッシュコマンドによって管理されます。
`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[]`	`[]`	無効にするスキル名。一覧表示されたスキルは検出されますが、読み込まれません。
`effortLevel`	`string`	`"medium"`	拡張思考の推論作業レベル: `"low"`、 `"medium"`、 `"high"`、または `"xhigh"`。レベルが高いほど、より多くのコンピューティングが使用されます。
`enabledMcpServers`	`string[]`	`[]`	既定で無効になっている組み込みの MCP サーバー ( `"computer-use"`など) を有効にします。
`enabledPlugins`	`Record<string, boolean>`	`{}`	宣言型プラグインの自動インストール。キーはプラグインの仕様です。値は `true` (有効) または `false` (無効) です。
`experimental`	`boolean`	`false`	試験的な機能を有効にします。
`--experimental`コマンドラインオプションまたは `/experimental` スラッシュコマンドを使用して有効にすることもできます。
`extraKnownMarketplaces`	`Record<string, {...}>`	`{}`	追加のプラグインマーケットプレース。各キーはマーケットプレース名です。この値はソース (`"directory"`、 `"git"`、または `"github"`) を指定します。
`footer`	`object`	—	ステータス行に表示する項目を制御します。サブキーには、 `showModelEffort`、 `showDirectory`、 `showBranch`、 `showContextWindow`、 `showQuota`、 `showAgent`、 `showAiUsed`、 `showCodeChanges`、 `showUsername`、 `showSandbox`、 `showYolo`、 `showCustom` (すべて `boolean`) が含まれます。
`/statusline`スラッシュコマンドによって管理されます。
`hooks`	`object`	—	イベント名でキー指定されたインラインユーザーレベルのフック定義。
`.github/hooks/*.json` ファイルと同じスキーマを使用します。「GitHub Copilot CLI（コマンドラインインターフェース）でフックを使用する」を参照してください。
`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`) は起動時に抑制され、昇格されたアクセス許可を付与するために使用することはできません。
`powershellFlags`	`string[]`	`["-NoProfile", "-NoLogo"]`	起動時に PowerShell に渡されるフラグ。 Windowsでは、CLI は PowerShell 7 以降 (`pwsh`) を優先し、`powershell.exe` が使用できない場合は、Windows PowerShell (`pwsh`) にフォールバックします。 Windows のみ。
`remote`
`"on"`
\|
`"off"`
`"on"`	セッションの同期とリモートアクセスを制御します。セッションデータのみをローカルに保ち、リモートコントロールを無効にするには、 `"off"` に設定します。
`--remote`または`--no-remote`で設定することもできます。
`renderMarkdown`	`boolean`	`true`	ターミナル出力で Markdown をレンダリングします。
`remoteExport`	`boolean`	`true`	セッション同期が使用可能な場合は、セッションをリモートでエクスポートします。既定でリモートエクスポートをオプトアウトするには、 `false` に設定します。
`remoteSessions`または`true` フラグに設定した場合でも、`--remote`設定では、この設定に関係なくエクスポートとステアリングが有効になります。
`respectGitignore`	`boolean`	`true`
`@` ファイルメンションピッカーから gitignored ファイルを除外します。
`false`すると、ピッカーには通常、`.gitignore`によって除外されるファイルが含まれます。
`screenReader`	`boolean`	`false`	スクリーンリーダーの最適化を有効にします。
`showTipsOnStartup`	`boolean`	`true`	CLI の起動時にランダムなコマンドヒントを表示します。
`skillDirectories`	`string[]`	`[]`	カスタムスキル定義を検索する追加のディレクトリ ( `~/.copilot/skills/`に加えて)。
`statusLine`	`object`	—	カスタムのステータスラインの表示。
`type`: `"command"`でなければなりません。
`command`: stdin でセッション JSON を受け取り、状態コンテンツを stdout に出力する実行可能スクリプトへのパス。
`padding`: 省略可能な左埋めスペースの数。
`storeTokenPlaintext`	`boolean`	`false`	システムキーチェーンが使用できない場合に、認証トークンをプレーンテキストで `config.json` に格納できるようにします。
`stream`	`boolean`	`true`	ストリーミング応答を有効にします。
`streamerMode`	`boolean`	`false`	プレビューモデル名とクォータの詳細を非表示にします。
Copilot CLI (コパイロット CLI)または画面共有を示すときに便利です。
`subagents.agents`	`object`	`{}`	エージェント名でキー指定されたエージェントごとのモデル構成。各値は、省略可能な `model` (文字列)、 `effortLevel` (文字列)、および `contextTier` (`"default"`、 `"long_context"`、または `"inherit"`) フィールドを持つオブジェクトです。ディスパッチ時に親セッションの値を使用するには、任意のフィールドを `"inherit"` に設定します。これらの設定を対話形式で構成するには、 `/subagents` スラッシュコマンドを使用します。
`subagents.disabledSubagents`	`string[]`	`[]`	ディスパッチされないようにするエージェント名。
`explore`、`task`、および`rubber-duck`エージェントを無効にすることはできません。
`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`
`"auto"`
\|
`"dark"`
\|
`"light"`
`"auto"`	ターミナルの色のテーマ。
`"auto"` はターミナルの背景を検出し、それに応じて選択します。
`updateTerminalTitle`	`boolean`	`true`	ターミナルタブまたはウィンドウのタイトルに現在の意図を表示します。

リポジトリの設定 (`.github/copilot/settings.json`)

リポジトリの設定は、リポジトリ内で作業するすべてのユーザーに適用されます。これらはリポジトリにコミットされ、コラボレーターと共有されます。

メモ

リポジトリ構成ファイル (enabledPlugins および extraKnownMarketplaces) 内のプラグイン関連のキーも、Copilot クラウドエージェントだけでなく、Copilot CLI (コパイロット CLI)によって読み取られます。これにより、1 つのファイルから両方のクライアントに対して同じプラグインを有効にすることができます。プラグインの詳細については、 GitHub Copilot プラグインについてを参照してください。

リポジトリレベルでは、次の表に示すキーのみがサポートされています。その他のキー (ユーザー構成ファイルで有効なキーを含む) は、暗黙的に無視されます。

鍵	タイプ	マージ動作	説明
`companyAnnouncements`	`string[]`	置き換え — リポジトリが優先されます	起動時にランダムに表示されるメッセージ。
`disableAllHooks`	`boolean`	リポジトリが優先されます	すべてのフックを無効にします。
`enabledPlugins`	`Record<string, boolean>`	マージ - リポジトリが同じキーのユーザーをオーバーライドする	宣言型プラグインの自動インストール。
`extraKnownMarketplaces`	`Record<string, {...}>`	マージ - リポジトリが同じキーのユーザーをオーバーライドする	このリポジトリで利用できるプラグインマーケットプレース。
`hooks`	`object`	連結—リポジトリのフックはユーザーフックの後に実行されます	このリポジトリにスコープが設定された定義をフックします。「GitHub Copilot CLI（コマンドラインインターフェース）でフックを使用する」を参照してください。
`mergeStrategy`
`"rebase"`
\|
`"merge"`
リポジトリが優先されます
`/pr fix conflicts`の競合解決戦略。

ローカル設定 (`.github/copilot/settings.local.json`)

コミットすべきでない個人用オーバーライドの .github/copilot/settings.local.json をリポジトリに作成します。このファイルを .gitignoreに追加します。

ローカル構成ファイルは、リポジトリ構成ファイル (.github/copilot/settings.json) と同じスキーマを使用し、そのスキーマよりも優先されます。