{"meta":{"title":"GitHub Copilot CLI の構成ディレクトリ","intro":"`~/.copilot` ディレクトリに関する情報を検索します。Copilot CLI (コパイロット CLI)には、構成、セッション データ、およびカスタマイズが格納されます。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/reference","title":"リファレンス"},{"href":"/ja/copilot/reference/copilot-cli-reference","title":"              Copilot CLI (コパイロット CLI) リファレンス"},{"href":"/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"CLI 構成ディレクトリ"}],"documentType":"article"},"body":"# GitHub Copilot CLI の構成ディレクトリ\n\n`~/.copilot` ディレクトリに関する情報を検索します。Copilot CLI (コパイロット CLI)には、構成、セッション データ、およびカスタマイズが格納されます。\n\n```\n          Copilot CLI (コパイロット CLI) では、構成、セッション履歴、ログ、カスタマイズがコンピューター上の 1 つのディレクトリに格納されます。 既定では、このディレクトリは `~/.copilot` (つまり、 `$HOME/.copilot`) です。\n```\n\nこの記事では、このディレクトリの内容とその使用方法について説明します。\n\n## ディレクトリの概要\n\n```\n          `~/.copilot` ディレクトリには、次の最上位項目が含まれています。\n```\n\n| Path                      | タイプ    | 説明                              |\n| ------------------------- | ------ | ------------------------------- |\n| `config.json`             | File   | 個人用の構成設定                        |\n| `mcp-config.json`         | File   | ユーザー レベルの MCP サーバー定義            |\n| `permissions-config.json` | File   | プロジェクトごとに保存されたツールとディレクトリのアクセス許可 |\n| `agents/`                 | ディレクトリ | 個人用カスタム エージェント定義                |\n| `skills/`                 | ディレクトリ | 個人のカスタム スキル定義                   |\n| `hooks/`                  | ディレクトリ | ユーザー レベルのフック スクリプト              |\n| `logs/`                   | ディレクトリ | セッション ログ ファイル                   |\n| `session-state/`          | ディレクトリ | セッション履歴とワークスペース データ             |\n| `session-store.db`        | File   | セッション間データ用の SQLite データベース       |\n| `installed-plugins/`      | ディレクトリ | インストールされているプラグイン ファイル           |\n| `ide/`                    | ディレクトリ | IDE 統合状態                        |\n\n> \\[!NOTE]\n> これらの項目のすべてがすぐに表示されるわけではありません。 一部は、特定の機能を初めて使用したときにオンデマンドで作成されます。たとえば、 `installed-plugins/` は、最初のプラグインをインストールした後にのみ表示されます。\n\n## ユーザーが編集可能なファイル\n\n次のファイルは、ユーザーが直接編集するか、CLI コマンドを使用して管理するように設計されています。\n\n### `config.json`\n\nこれは、 Copilot CLI (コパイロット CLI)のプライマリ構成ファイルです。 テキスト エディターで直接編集したり、 `/model` や `/theme` などの対話型コマンドを使用してセッション内から特定の値を変更したりできます。 このファイルは、コメント付き JSON (JSONC) をサポートしています。\n\n一般的な設定は次のとおりです。\n\n| 鍵       | タイプ | 説明                                                      |\n| ------- | --- | ------------------------------------------------------- |\n| `model` | 文字列 | 使用する AI モデル (たとえば、 `\"gpt-5.2\"`、 `\"claude-sonnet-4.6\"`)。 |\n\n```\n          `Auto`に設定すると、使用可能な最適なモデルCopilot自動的に選択できるようになります。 |\n```\n\n\\| `effortLevel` | 文字列 | それをサポートするモデルの推論作業レベル |\n\\| `theme` | 文字列 | 色のテーマ: `\"auto\"`、 `\"dark\"`、または `\"light\"` |\n\\| `mouse` | ブーリアン | 代替画面モードでマウスのサポートを有効にする (既定値: `true`) |\n\\| `banner` | 文字列 | アニメーションバナーの頻度: `\"always\"`、 `\"once\"`、または `\"never\"` (既定値: `\"once\"`) |\n\\| `renderMarkdown` | ブーリアン | 応答でマークダウンをレンダリングする (既定値: `true`) |\n\\| `screenReader` | ブーリアン | スクリーン リーダーの最適化を有効にする (既定値: `false`) |\n\\| `autoUpdate` | ブーリアン | CLI の更新プログラムを自動的にダウンロードする (既定値: `true`) |\n\\| `stream` | ブーリアン | 応答トークンをトークンでストリーム配信する (既定値: `true`) |\n\\| `includeCoAuthoredBy` | ブーリアン | エージェントによって作成されたコミットに共同編集を追加する (既定値: `true`) |\n\\| `respectGitignore` | ブーリアン |\n`@` ファイル ピッカーから gitignored ファイルを除外する (既定値: `true`) |\n\\| `allowedUrls` | string\\[] | プロンプトを表示せずに許可される URL またはドメイン |\n\\| `deniedUrls` | string\\[] | 常に拒否される URL またはドメイン |\n\\| `logLevel` | 文字列 | ログの詳細度: `\"none\"`、 `\"error\"`、 `\"warning\"`、 `\"info\"`、 `\"debug\"`、 `\"all\"`、または `\"default\"` (既定値: `\"default\"`) |\n\\| `disableAllHooks` | ブーリアン | すべてのフックを無効にする (既定値: `false`) |\n\\| `hooks` | オブジェクト | インラインのユーザーレベルフック定義 |\n\n構成設定の完全な一覧については、ターミナルに「 `copilot help config` 」と入力します。\n\n> \\[!TIP]\n> 一部の設定は、コマンド ライン フラグを使用して設定することもできます。 たとえば、 `/model` スラッシュ コマンドは、セッション間で保持されるように、モデルの選択をこのファイルに書き込みます。\n\n### `mcp-config.json`\n\nユーザー レベルで使用できる MCP (モデル コンテキスト プロトコル) サーバーを定義します。 これらのサーバーは、使用しているプロジェクト ディレクトリに関係なく、すべてのセッションで使用できます。 Projectレベルの MCP 構成 (`.mcp.json` または `.github/mcp.json`) は、サーバー名の競合時にユーザー レベルの定義よりも優先されます。\n\n詳細については、「[GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)」を参照してください。\n\n### `agents/`\n\n個人用カスタム エージェント定義を `.agent.md` ファイルとしてここに格納します。 このディレクトリに配置されたエージェントは、すべてのセッションで使用できます。 Projectレベルのエージェント (`.github/agents/`) は、同じ名前を共有する場合は、個人エージェントよりも優先されます。\n\n詳細については、「[GitHub Copilot CLI（コマンドラインインターフェース） のカスタムエージェントの作成と使用](/ja/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)」を参照してください。\n\n### `skills/`\n\n個人のカスタム スキル定義をここに格納します。 各スキルは、 `SKILL.md` ファイル ( `~/.copilot/skills/my-skill/SKILL.md` など) を含むサブディレクトリに存在します。 個人のスキルはすべてのセッションで利用できます。 Projectレベルのスキルは、同じ名前を共有する場合、個人のスキルよりも優先されます。\n\n詳細については、「[エージェント スキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。\n\n### `hooks/`\n\nユーザー レベルのフック スクリプトをここに格納します。 これらのフックは、すべてのセッションに適用されます。\n`config.json` キーを使用して、`hooks`でフックをインラインで定義することもできます。 リポジトリ レベルのフック ( `.github/hooks/`) は、ユーザー レベルのフックと共に読み込まれます。\n\n詳細については、「[GitHub Copilot CLI（コマンドラインインターフェース） を使用するフック](/ja/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。\n\n## ファイルを自動的に管理する\n\n次の項目は CLI によって管理されます。 通常、手動で編集しないでください。\n\n### `permissions-config.json`\n\n保存したツールとディレクトリのアクセス許可の決定をプロジェクトの場所別に格納します。 ツールを承認するか、ディレクトリへのアクセスを許可すると、CLI によって決定がここに記録されるため、同じプロジェクトで再度プロンプトが表示されることはありません。\n\n> \\[!NOTE]\n> プロジェクトのアクセス許可をリセットする場合は、このファイルから関連するエントリを削除できます。 ただし、セッションの実行中にファイルを編集すると、予期しない動作が発生する可能性があります。\n\n### `session-state/`\n\nサブディレクトリ内のセッション ID 別に整理されたセッション履歴データが含まれています。 各セッション ディレクトリには、イベント ログ (`events.jsonl`) とワークスペース成果物 (プラン、チェックポイント、追跡されたファイル) が格納されます。 このデータにより、セッションの再開 (`--resume` または `--continue`) が有効になります。\n\n### `session-store.db`\n\nチェックポイントのインデックス作成や検索などのセッション間データに CLI によって使用される SQLite データベース。 このファイルは自動的に管理され、編集しないでください。\n\n### `logs/`\n\nCLI セッションのログ ファイルが含まれています。 各セッションでは、 `process-{timestamp}-{pid}.log`という名前のログ ファイルが作成されます。 これらのファイルは、問題のデバッグに役立ちます。\n\n> \\[!TIP]\n> 現在のセッションのログ ファイルを検索するには、対話型セッションに「 `/session` 」と入力します。 出力には、ログ ファイルへの完全なパスと、セッション ID、期間、作業ディレクトリなどの他のセッションの詳細が含まれます。\n\n### `installed-plugins/`\n\nインストールしたプラグインのファイルが含まれています。 マーケットプレースからインストールされたプラグインは、 `installed-plugins/{marketplace-name}/{plugin-name}/`の下に格納されます。 直接インストールされたプラグインは、 `installed-plugins/_direct/`の下に格納されます。 このディレクトリを直接編集するのではなく、 `copilot plugin` コマンドを使用してプラグインを管理します。\n\n詳細については、「[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference)」を参照してください。\n\n### `ide/`\n\nIDE 統合のロック ファイルと状態が含まれます (たとえば、 Copilot CLI (コパイロット CLI) が Visual Studio Code に接続する場合)。 このディレクトリは自動的に管理されます。\n\n## 構成ディレクトリの場所の変更\n\n既定の `~/.copilot` の場所は、次の 2 つの方法でオーバーライドできます。\n\n* ```\n          **環境変数**: `COPILOT_HOME` を使用するディレクトリのパスに設定します。\n  ```\n\n  ```bash copy\n  export COPILOT_HOME=/path/to/my/copilot-config\n  ```\n\n* ```\n          **コマンド ライン オプション**: CLI を起動するときに `--config-dir` を使用します。\n  ```\n\n  ```bash copy\n  copilot --config-dir /path/to/my/copilot-config\n  ```\n\n  ```\n          `--config-dir` オプションは`COPILOT_HOME`よりも優先され、既定の`~/.copilot`の場所よりも優先されます。\n  ```\n\n### 注意すべき事項\n\n* ```\n          `COPILOT_HOME` は、 `~/.copilot` パス全体を置き換えます。 設定する値は、構成ファイルとサブディレクトリに使用するディレクトリへの完全なパスである必要があります。\n  ```\n* ディレクトリを変更すると、既存の構成、セッション履歴、インストールされているプラグイン、保存されたアクセス許可が新しい場所に見つかりません。\n  `~/.copilot`の内容を保存する場合は、新しい場所にコピーまたは移動します。\n* ```\n          **キャッシュ ディレクトリ** (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) はプラットフォームの規則に従い、`COPILOT_HOME`の影響を受けません。 これは次の場所にあります。\n  ```\n\n  \\-\n  **macOS**: `~/Library/Caches/copilot`\n  -------------------------------------\n\n  ```\n          **Linux**: `$XDG_CACHE_HOME/copilot` または `~/.cache/copilot`\n  ```\n\n  \\-\n  **Windows**: `%LOCALAPPDATA%/copilot`\n\n  キャッシュ ディレクトリを個別にオーバーライドするには、 `COPILOT_CACHE_HOME`設定します。\n\n## 安全に削除できる内容\n\n| 品目                           | 安全に削除できますか? | 影響                                                                            |\n| ---------------------------- | ----------- | ----------------------------------------------------------------------------- |\n| `logs/`                      | はい          | ログ ファイルは、セッションごとに再作成されます。 削除しても機能に影響はありません。                                   |\n| `session-state/`             | 慎重に         | 削除すると、セッション履歴が削除されます。 過去のセッションを再開できなくなります。                                    |\n| `session-store.db`           | 慎重に         | 削除すると、セッション間のデータが削除されます。 ファイルは自動的に再作成されます。                                    |\n| `config.json`                | 慎重に         | すべての構成を既定値にリセットします。 ユーザー設定を再構成する必要があります。                                      |\n| `permissions-config.json`    | 慎重に         | 保存されているすべてのアクセス許可をリセットします。 CLI によって、ツールとディレクトリの承認が再度求められます。                   |\n| `installed-plugins/`         | お勧めしません     | 代わりに `copilot plugin uninstall` を使用して、 `config.json` 内のプラグイン メタデータの一貫性を確保します。 |\n| `mcp-config.json`            | お勧めしません     | ユーザー レベルの MCP サーバー定義が失われます。 最初にバックアップします。                                     |\n| `agents/`、`skills/`、`hooks/` | お勧めしません     | 個人のカスタマイズは失われます。 最初にバックアップします。                                                |\n\n## 詳細については、次を参照してください。\n\n* [GitHub Copilot CLI（コマンドラインインターフェース）](/ja/copilot/how-tos/copilot-cli)\n* [GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot CLI プログラムリファレンス](/ja/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}