GitHub Copilot CLI コマンドリファレンス

コマンドラインコマンド

Command	目的
`copilot`	対話型ユーザーインターフェイスを起動します。
`copilot help [topic]`	ヘルプ情報を表示します。ヘルプトピックには、 `config`、 `commands`、 `environment`、 `logging`、 `permissions`などがあります。
`copilot init`	このリポジトリの Copilot カスタム命令を初期化します。
`copilot update`	最新バージョンをダウンロードしてインストールします。
`copilot version`	バージョン情報を表示し、更新プログラムを確認します。
`copilot login`	OAuth デバイスフローを使用してCopilot で認証します。 GitHub ホスト URL (既定値: `--host HOST`) を指定する`https://github.com`を受け入れます。
`copilot logout`	GitHub からサインアウトし、保存されている資格情報を削除します。
`copilot plugin`	プラグインとプラグインマーケットプレースを管理します。

対話型インターフェイスのグローバルショートカット

Shortcut	目的
`@ FILENAME`	コンテキストにファイルの内容を含めます。

          <kbd>
          </kbd>
          +
          <kbd>
          </kbd>
          | プロンプトの入力を開始すると、スラッシュ コマンドを実行できます。たとえば、プロンプトを再入力せずにモデルを変更する場合などです。 |

対話型インターフェイスのタイムラインショートカット

Shortcut	目的
Ctrl+o	プロンプト入力には何もありませんが、Copilot の応答タイムラインの最近の項目が展開し、詳細を表示します。
Ctrl + e	プロンプトには何もありませんが、Copilot の応答タイムラインのすべての項目が展開します。
Ctrl + t	応答内の推論の表示を展開/折りたたむ。

Shortcut	目的

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | 行の先頭に移動します (入力時)。 |

対話型インターフェース内のスラッシュコマンド

Command	目的
`/add-dir PATH`	ファイルアクセスの許可リストにディレクトリを追加します。
`/agent`	使用可能なエージェント (存在する場合) を参照して選択します。

          `/allow-all`、`/yolo`                               | すべてのアクセス許可 (ツール、パス、URL) を有効にします。 |

使用可能なスラッシュコマンドの完全な一覧については、CLI の対話型インターフェイスに「 /help 」と入力します。

コマンドラインオプション

Option	目的
`--acp`	エージェントクライアントプロトコルサーバーを起動します。
`--add-dir PATH`	ファイルアクセスの許可リストにディレクトリを追加します (複数回使用できます)。
`--add-github-mcp-tool TOOL`	既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールを追加します (複数回使用できます)。すべてのツールに `*` を使用します。
`--add-github-mcp-toolset TOOLSET`	既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールセットを追加します (複数回使用できます)。すべてのツールセットに `all` を使用します。
`--additional-mcp-config JSON`	このセッション専用の MCP サーバーを追加します。サーバー構成は、JSON 文字列またはファイルパス ( `@` プレフィックス) として指定できます。

          `~/.copilot/mcp-config.json`から構成を拡張します。 インストール済みの MCP サーバー構成を同じ名前でオーバーライドします。 |

コマンドとオプションの完全な一覧については、 copilot helpを実行します。

ツールのアクセス許可パターン

          `--allow-tool`オプションと`--deny-tool`オプションは、`Kind(argument)`形式のアクセス許可パターンを受け入れます。 引数は省略可能です。省略すると、その種類のすべてのツールと一致します。

サブタイプ	[説明]	パターンの例
`shell`	シェルコマンドの実行

          `shell(git push)`、`shell(git:*)`、`shell` |

| write | ファイルの作成または変更 | write、write(src/*.ts) | | read | ファイルまたはディレクトリの読み取り | read、read(.env) | | SERVER-NAME | MCP サーバーツールの呼び出し | MyMCP(create_issue)、MyMCP | | url | Web フェッチまたはシェル経由の URL アクセス | url(github.com)、url(https://*.api.com) | | memory | ファクトをエージェントのメモリに格納する | memory |

          `shell`ルールの場合、`:*`サフィックスはコマンド ステムと一致し、その後にスペースが続き、部分的な一致が防止されます。 たとえば、 `shell(git:*)` は `git push` と `git pull` に一致しますが、 `gitea`と一致しません。

拒否規則は、 --allow-all が設定されている場合でも、許可規則よりも常に優先されます。

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-tool 'shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool 'MyMCP'

環境変数

Variable	[説明]
`COPILOT_MODEL`	AI モデルを設定します。
`COPILOT_ALLOW_ALL`	すべてのアクセス許可を自動的に許可するように `true` に設定します ( `--allow-all`と同等)。
`COPILOT_AUTO_UPDATE`	自動更新を無効にするには、 `false` に設定します。
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	カスタム命令用の追加ディレクトリのコンマ区切りの一覧。
`COPILOT_SKILLS_DIRS`	スキルの追加ディレクトリのコンマ区切りの一覧。
`COPILOT_EDITOR`	対話型編集のためのエディターコマンド（`$VISUAL` および `$EDITOR` の後にチェックされたもの）。何も設定されていない場合、デフォルトで `vi` になります。
`COPILOT_GITHUB_TOKEN`	認証トークン。

          `GH_TOKEN`と`GITHUB_TOKEN`よりも優先されます。 |

構成ファイルの設定

ユーザー設定は ~/.copilot/config.jsonに格納されます。プロジェクトレベルの設定は、 .copilot/settings.json (リポジトリにコミット済み) または .copilot/settings.local.json (個人用オーバーライド - .gitignoreに追加) に配��できます。設定はユーザーからプロジェクト、さらにはローカルへの順に受け継がれ、より詳細なスコープがより一般的なスコープを上書きします。コマンドラインフラグと環境変数は常に最も高い優先順位を使用します。

Key	タイプ	既定値	[説明]
`allowed_urls`	`string[]`	`[]`	URL またはドメインは、プロンプトなしで許可されます。
`alt_screen`	`boolean`	`false`	ターミナルの代替画面バッファーを使用します。
`auto_update`	`boolean`	`true`	CLI の更新プログラムを自動的にダウンロードします。
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | アニメーションバナーの表示頻度。 |

フックリファレンス

フックは、セッション中に特定のライフサイクルポイントで実行される外部コマンドであり、カスタム自動化、セキュリティ制御、統合を有効にします。フック構成ファイルは、リポジトリ内の .github/hooks/*.json から自動的に読み込まれます。

フック構成形式

フック構成ファイルでは、バージョン 1で JSON 形式が使用されます。

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

フィールド	タイプ	必須	[説明]
`type`	`"command"`	イエス

          `"command"`である必要があります。 |

| bash | 文字列 | の 1 つ bash/powershell | Unix のシェルコマンド。 | | powershell | 文字列 | の 1 つ bash/powershell | Windows のシェルコマンド。 | | cwd | 文字列 | いいえ | コマンドの作業ディレクトリ (リポジトリルートまたは絶対ディレクトリに対する相対ディレクトリ)。 | | env | オブジェクト | いいえ | 設定する環境変数 (変数拡張をサポート)。 | | timeoutSec | 数値 | いいえ | タイムアウト (秒単位)。既定値: 30。 |

フックイベント

Event	次の場合に起動します。	処理された出力
`sessionStart`	新しいセッションまたは再開されたセッションが開始されます。	いいえ
`sessionEnd`	セッションが終了します。	いいえ
`userPromptSubmitted`	ユーザーがプロンプトを送信します。	いいえ
`preToolUse`	各ツールが実行される前。	はい — 許可、拒否、または変更できます。
`postToolUse`	各ツールの処理が完了した後。	いいえ
`agentStop`	メインエージェントがターンを終了します。	はい — 継続をブロックして強制できます。
`subagentStop`	サブエージェントが作業を完了しました。	はい — 継続をブロックして強制できます。
`errorOccurred`	実行中にエラーが発生します。	いいえ

          `preToolUse` デシジョン コントロール

          `preToolUse` フックは、JSON オブジェクトを stdout に書き込むことでツールの実行を制御できます。

フィールド	価値観	[説明]
`permissionDecision`

          `"allow"`、`"deny"`、`"ask"` | ツールが実行されるかどうか。 空の出力では、���定の動作が使用されます。 |

          `agentStop`
           / 
          `subagentStop` デシジョン コントロール

フィールド	価値観	[説明]
`decision`

          `"block"`、`"allow"` | 
          `"block"` は、別のエージェントがプロンプトとして `reason` を使用するように強制します。 |

| reason | 文字列 | decisionが"block"されたら、次のターンを求めるメッセージを表示します。 |

フックマッチング用のツール名

ツール名	[説明]
`bash`	シェルコマンド (Unix) を実行します。
`powershell`	シェルコマンドを実行する (Windows)。
`view`	ファイルの内容を読み取ります。
`edit`	ファイルの内容を変更します。
`create`	新しいファイルを作成します。
`glob`	パターンでファイルを検索します。
`grep`	ファイルの内容を検索します。
`web_fetch`	Web ページを取得します。
`task`	サブエージェントタスクを実行します。

同じ種類の複数のフックが構成されている場合は、順番に実行されます。 preToolUseの場合、フックが"deny"を返した場合、ツールはブロックされます。フックエラー (0 以外の終了コードまたはタイムアウト) はログに記録され、スキップされます。エージェントの実行はブロックされません。

MCP サーバーの構成

MCP サーバーは、CLI エージェントに追加のツールを提供します。 ~/.copilot/mcp-config.jsonで永続的なサーバーを構成します。 --additional-mcp-configを使用して、1 つのセッションのサーバーを追加します。

トランスポートの種類

タイプ	[説明]	必須フィールド
`local` / `stdio`	stdin/stdout を介して通信するローカルプロセス。

          `command`、`args` |

| http | ストリーミング可能な HTTP トランスポートを使用するリモートサーバー。 | url | | sse | Server-Sent イベントトランスポートを使用するリモートサーバー。 | url |

ローカルサーバー構成フィールド

フィールド	必須	[説明]
`command`	イエス	サーバーを起動するコマンド。
`args`	イエス	コマンド引数 (配列)。
`tools`	イエス	有効にするツール: すべてのツールの `["*"]` 、または特定のツール名の一覧。
`env`	いいえ	環境変数。

          `$VAR`、`${VAR}`、および`${VAR:-default}`展開をサポートします。 |

| cwd | いいえ | サーバーの作業ディレクトリ。 | | timeout | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 | | type | い��え | "local" または "stdio"。既定値: "local"。 |

リモートサーバー構成フィールド

フィールド	必須	[説明]
`type`	イエス

          `"http"` または `"sse"`。 |

フィルターマッピング

サーバーの構成の filterMapping フィールドを使用して、MCP ツールの出力を処理する方法を制御します。

モード	[説明]
`none`	フィルター処理なし。
`markdown`	出力を Markdown として書式設定します。
`hidden_characters`	非表示または制御文字を削除します。 Default.

組み込みの MCP サーバー

CLI には、追加のセットアップなしで使用できる組み込みの MCP サーバーが含まれています。

Server	[説明]
`github-mcp-server`	GitHubAPI 統合: イシュー、プル要求、コミット、コード検索、および GitHub Actions。
`playwright`	ブラウザーの自動化: 移動、クリック、入力、スクリーンショット、フォーム処理。
`fetch`

          `fetch` ツールを使用した HTTP 要求。 |

| time | 時間ユーティリティ: get_current_time と convert_time。 |

          `--disable-builtin-mcps`を使用してすべての組み込みサーバーを無効にするか、`--disable-mcp-server SERVER-NAME`を使用して特定のサーバーを無効にします。

スキルのリファレンス

スキルは、CLI で実行できる機能を拡張する Markdown ファイルです。各スキルは、 SKILL.md ファイルを含む独自のディレクトリに存在します。 ( /SKILL-NAME 経由で、またはエージェントによって自動的に) 呼び出されると、スキルのコンテンツが会話に挿入されます。

スキルのフロントマッターフィールド

フィールド	タイプ	必須	[説明]
`name`	文字列	イエス	スキルのユニークID。文字、数字、ハイフンのみ。最大 64 文字。
`description`	文字列	イエス	スキルが実行する内容と、それを使用するタイミング。最大 1024 文字。
`allowed-tools`	string または string[]	いいえ	スキルがアクティブな場合に自動的に許可されるツールのコンマ区切りリストまたは YAML 配列。すべてのツールに `"*"` を使用します。
`user-invocable`	ブーリアン	いいえ	ユーザーが `/SKILL-NAME`を使用してスキルを呼び出すことができるかどうか。既定値: `true`。
`disable-model-invocation`	ブーリアン	いいえ	エージェントがこのスキルを自動的に呼び出さないようにします。既定値: `false`。

スキルの場所

スキルは、これらの場所から優先順位に従って読み込まれます（名前が重複した場合は、最初に見つかったものが使用されます）。

ロケーション	Scope	[説明]
`.github/skills/`	プロジェクト	プロジェクト固有のスキル。
`.agents/skills/`	プロジェクト	別のプロジェクトの場所。
`.claude/skills/`	プロジェクト	Claude 互換の場所。
親 `.github/skills/`	継承済み	Monorepo 親ディレクトリのサポート。
`~/.copilot/skills/`	個人用	すべてのプロジェクトに必要な個人のスキル。
`~/.claude/skills/`	個人用	Claude 互換の個人用ロケーション。
プラグインディレクトリ	プラグイン	インストールされているプラグインのスキル。
`COPILOT_SKILLS_DIRS`	Custom	追加のディレクトリ (コンマ区切り)。

Agent	既定のモデル	[説明]
`explore`	claude-haiku-4.5	高速なコードベース探索。ファイルを検索し、コードを読み取り、質問に回答します。 300 語以下のフォーカスされた回答を返します。並列で安全に実行できます。
`task`	claude-haiku-4.5	コマンドの実行 (テスト、ビルド、リント)。成功に関する簡単な概要を返し、失敗した場合は完全な出力を返します。
`code-review`	claude-sonnet-4.5	ノイズに対する信号の比率が高いコードレビュー。バグ、セキュリティの問題、およびロジックエラーの差分を分析します。
`general-purpose`	claude-sonnet-4.5	複雑なマルチステップタスク用のフル機能エージェント。別のコンテキストウィンドウで実行されます。

カスタムエージェントのフロントマターフィールド

フィールド	タイプ	必須	[説明]
`name`	文字列	いいえ	表示名。デフォルトはファイル名です。
`description`	文字列	イエス	エージェントの一覧と `task` ツールに表示される説明。
`model`	文字列	いいえ	このエージェントの AI モデル。設定を解除すると、外部エージェントのモデルが継承されます。
`tools`	string[]	いいえ	エージェントで使用できるツール。既定値: `["*"]` (すべてのツール)。
`mcp-servers`	オブジェクト	いいえ	接続する MCP サーバー。

          `~/.copilot/mcp-config.json`と同じスキーマを使用します。 |

カスタムエージェントの場所

Scope	ロケーション
プロジェクト

          `.github/agents/` または `.claude/agents/` |

プロジェクトレベルのエージェントは、ユーザーレベルのエージェントよりも優先されます。プラグインエージェントの優先度は最も低くなります。

権限承認応答

CLI で操作を実行するためのアクセス許可を求められたら、次のキーを使用して応答できます。

Key	影響
`y`	この特定の要求を 1 回許可します。
`n`	この特定の要求を 1 回拒否します。
`!`	セッションの残りの部分に対して同様のすべての要求を許可します。
`#`	セッションの残りの部分について、同様の要求をすべて拒否します。
`?`	要求に関する詳細情報を表示します。

セッションの承認は、 /clear を実行するか、新しいセッションを開始するとリセットされます。

フラグ	レベル	[説明]
`AUTOPILOT_MODE`	`experimental`	自律動作モード。
`BACKGROUND_AGENTS`	`staff`	バックグラウンドでエージェントを実行します。
`QUEUED_COMMANDS`	`staff`	エージェントの実行中にコマンドをキューに入れます。
`LSP_TOOLS`	`on`	言語サーバープロトコルツール。
`PLAN_COMMAND`	`on`	対話型計画モード。
`AGENTIC_MEMORY`	`on`	セッション間の永続的なメモリ。
`CUSTOM_AGENTS`	`on`	カスタムエージェント定義。

GitHub Copilot CLI コマンドリファレンス

この記事の内容

コマンドラインコマンド

対話型インターフェイスのグローバルショートカット

対話型インターフェイスのタイムラインショートカット

対話型インターフェイスのナビゲーションショートカット

対話型インターフェース内のスラッシュコマンド

コマンドラインオプション

ツールのアクセス許可パターン

環境変数

構成ファイルの設定

フックリファレンス

フック構成形式

フックイベント

フックマッチング用のツール名

MCP サーバーの構成

トランスポートの種類

ローカルサーバー構成フィールド

リモートサーバー構成フィールド

フィルターマッピング

組み込みの MCP サーバー

スキルのリファレンス

スキルのフロントマッターフィールド

スキルの場所

コマンド (代替スキル形式)

カスタムエージェント参照

組み込みエージェント

カスタムエージェントのフロントマターフィールド

カスタムエージェントの場所

権限承認応答

GitHub Copilot CLI コマンド リファレンス

この記事の内容

GitHub Copilot CLI コマンドリファレンス