GitHub Copilot CLI の構成ディレクトリ

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

ディレクトリの概要

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

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

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

settings.json

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

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

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（コマンドラインインターフェース） を使用するフック」を参照してください。

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

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

config.json

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

permissions-config.json

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

session-state/

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

session-store.db

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

logs/

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

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 に接続する場合)。 このディレクトリは自動的に管理されます。

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

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

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設定します。

安全に削除できる内容

構成ファイルの設定

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

          `COPILOT_HOME`環境変数を使用して、代替パスを指定します。 |

| リポジトリ | .github/copilot/settings.json | 共有リポジトリの構成 (リポジトリにコミット)。 | | Local | .github/copilot/settings.local.json | 個人のオーバーライド (これを .gitignoreに追加します)。 |

ユーザー設定 (~/.copilot/settings.json)

これらの設定は、すべてのセッションとリポジトリに適用されます。 このファイルを直接編集することも、スラッシュ コマンドを使用して個々の値を更新することもできます。

          `--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 | 注意が必要な場合は、聞こえるビープ音を鳴らします。 | | colorMode | "default" | "dim" | "high-contrast" | "colorblind" | "default" | カラー コントラスト モード。 /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 (すべて 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 トレーラーを追加します。 | | 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で設定することもできます。 | | powershellFlags | string[] | ["-NoProfile", "-NoLogo"] | 起動時に PowerShell (pwsh) に渡されるフラグ。 Windows のみ。 | | renderMarkdown | boolean | true | ターミナル出力で Markdown をレンダリングします。 | | respectGitignore | boolean | true | @ ファイルメンション ピッカーから gitignored ファイルを除外します。 falseすると、ピッカーには通常、.gitignoreによって除外されるファイルが含まれます。 | | screenReader | boolean | false | スクリーン リーダーの最適化を有効にします。 | | 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)または画面共有を示すときに便利です。 | | theme | "auto" | "dark" | "light" | "auto" | ターミナルの色のテーマ。 "auto" はターミナルの背景を検出し、それに応じて選択します。 | | updateTerminalTitle | boolean | true | ターミナル タブまたはウィンドウ のタイトルに現在の意図を表示します。 |

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

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

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

          `"rebase"`
          \|
          `"merge"`
         | リポジトリが優先されます | 
          `/pr fix conflicts`の競合解決戦略。 |

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

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

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

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

• GitHub Copilot CLI（コマンドラインインターフェース）
• GITHUB COPILOT CLI コマンド リファレンス
• GitHub Copilot CLI プログラムリファレンス
• GitHub Copilot CLI プラグイン リファレンス
• GitHub Copilot CLI フック リファレンス