GitHub Copilot CLI 構成ディレクトリ

          Copilot CLI では、構成、セッション履歴、ログ、カスタマイズがコンピューター上の 1 つのディレクトリに格納されます。 既定では、このディレクトリは `~/.copilot` (つまり、 `$HOME/.copilot`) です。

この記事では、このディレクトリの内容とその使用方法について説明します。

ディレクトリの概要

          `~/.copilot` ディレクトリには、次の最上位項目が含まれています。

Path	タイプ	説明
`config.json`	File	個人用の構成設定
`mcp-config.json`	File	ユーザーレベルの MCP サーバー定義
`permissions-config.json`	File	プロジェクトごとに保存されたツールとディレクトリのアクセス許可
`agents/`	ディレクトリ	個人用カスタムエージェント定義
`skills/`	ディレクトリ	個人のカスタムスキル定義
`hooks/`	ディレクトリ	ユーザーレベルのフックスクリプト
`logs/`	ディレクトリ	セッションログファイル
`session-state/`	ディレクトリ	セッション履歴とワークスペースデータ
`session-store.db`	File	セッション間データ用の SQLite データベース
`installed-plugins/`	ディレクトリ	インストールされているプラグインファイル
`ide/`	ディレクトリ	IDE 統合状態

メモ

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

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

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

`config.json`

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

一般的な設定は次のとおりです。

鍵	タイプ	説明
`model`	文字列	使用する AI モデル (例: `"gpt-5.2"`、 `"claude-sonnet-4.6"`)
`effortLevel`	文字列	それをサポートするモデルの推論作業レベル
`theme`	文字列	色のテーマ: `"auto"`、 `"dark"`、または `"light"`
`alt_screen`	ブーリアン	代替画面バッファーを使用する (既定値: `true`)
`mouse`	ブーリアン	代替画面モードでマウスのサポートを有効にする (既定値: `true`)
`banner`	文字列	アニメーションバナーの頻度: `"always"`、 `"once"`、または `"never"` (既定値: `"once"`)
`render_markdown`	ブーリアン	応答でマークダウンをレンダリングする (既定値: `true`)
`screen_reader`	ブーリアン	スクリーンリーダーの最適化を有効にする (既定値: `false`)
`auto_update`	ブーリアン	CLI の更新プログラムを自動的にダウンロードする (既定値: `true`)
`stream`	ブーリアン	応答トークンをトークンでストリーム配信する (既定値: `true`)
`includeCoAuthoredBy`	ブーリアン	エージェントによって作成されたコミットに共同編集を追加する (既定値: `true`)
`respectGitignore`	ブーリアン

          `@` ファイル ピッカーから gitignored ファイルを除外する (既定値: `true`) |

構成設定の完全な一覧については、ターミナルに「 copilot help config 」と入力します。

ヒント

一部の設定は、コマンドラインフラグを使用して設定することもできます。たとえば、--alt-screenして--no-alt-screen``alt_screen値を設定し、config.jsonに保持します。 /modelスラッシュコマンドは、モデルの選択内容をこのファイルに書き込み、セッション間で保持されるようにします。

`mcp-config.json`

ユーザーレベルで使用できる MCP (モデルコンテキストプロトコル) サーバーを定義します。これらのサーバーは、使用しているプロジェクトディレクトリに関係なく、すべてのセッションで使用できます。サーバー名が競合する場合、プロジェクトレベルの MCP 構成 ( .mcp.json、 .github/mcp.json、または .vscode/mcp.json) がユーザーレベルの定義よりも優先されます。

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

`agents/`

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

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

`skills/`

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

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

`hooks/`

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

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

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

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

`permissions-config.json`

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

メモ

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

`session-state/`

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

`session-store.db`

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

`logs/`

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

ヒント

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

        **環境変数**: `COPILOT_HOME` を使用するディレクトリのパスに設定します。

Bash

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

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

        **コマンド ライン オプション**: CLI を起動するときに `--config-dir` を使用します。

Bash

copilot --config-dir /path/to/my/copilot-config

copilot --config-dir /path/to/my/copilot-config

        `--config-dir` オプションは`COPILOT_HOME`よりも優先され、既定の`~/.copilot`の場所よりも優先されます。

注意すべき事項

        `COPILOT_HOME` は、 `~/.copilot` パス全体を置き換えます。 設定する値は、構成ファイルとサブディレクトリに使用するディレクトリへの完全なパスである必要があります。

ディレクトリを変更すると、既存の構成、セッション履歴、インストールされているプラグイン、保存されたアクセス許可が新しい場所に見つかりません。 ~/.copilotの内容を保存する場合は、新しい場所にコピーまたは移動します。

        **キャッシュ ディレクトリ** (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) はプラットフォームの規則に従い、`COPILOT_HOME`の影響を受けません。 これは次の場所にあります。

- macOS: `~/Library/Caches/copilot`

        **Linux**: `$XDG_CACHE_HOME/copilot` または `~/.cache/copilot`

- Windows: %LOCALAPPDATA%/copilot

キャッシュディレクトリを個別にオーバーライドするには、 COPILOT_CACHE_HOME設定します。

安全に削除できる内容

品目	安全に削除できますか?	影響
`logs/`	はい	ログファイルは、セッションごとに再作成されます。削除しても機能に影響はありません。
`session-state/`	慎重に	削除すると、セッション履歴が削除されます。過去のセッションを再開できなくなります。
`session-store.db`	慎重に	削除すると、セッション間のデータが削除されます。ファイルは自動的に再作成されます。
`config.json`	慎重に	すべての構成を既定値にリセットします。ユーザー設定を再構成する必要があります。
`permissions-config.json`	慎重に	保存されているすべてのアクセス許可をリセットします。 CLI によって、ツールとディレクトリの承認が再度求められます。
`installed-plugins/`	お勧めしません	代わりに `copilot plugin uninstall` を使用して、 `config.json` 内のプラグインメタデータの一貫性を確保します。
`mcp-config.json`	お勧めしません	ユーザーレベルの MCP サーバー定義が失われます。最初にバックアップします。

          `agents/`、`skills/`、`hooks/` | お勧めしません | 個人のカスタマイズは失われます。 最初にバックアップします。 |

詳細については、次を参照してください。

        [AUTOTITLE](/copilot/how-tos/copilot-cli)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-programmatic-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-plugin-reference)

この記事で