Copilot Runner — VS Code 拡張

GUIからCopilot CLIを簡単に呼び出すことができる拡張機能です。 Markdownのテンプレートを作成することでよく使う指示を再利用することもできます。

使い方

1. 命令を実行する

アクティビティバーの Copilot Runner アイコンをクリック
テンプレートを選択（またはフリー入力）
プロンプトを編集
モデルを選択
言語を選択（auto / en / ja / zh-CN / ko / fr / de / es 他）
▶ 実行 ボタン（または Ctrl+Enter）で実行
結果が新しいエディタで Markdown として開かれる
使用量サマリーがサイドバー下部に表示される

2. テンプレートを作成する

ワークスペースの以下いずれかのディレクトリに .md ファイルを置きます:

ディレクトリ	説明
`.prompts/`	推奨。軽量でわかりやすい
`.vscode/copilot-prompts/`	VS Code 設定に近い場所に置きたい場合
`.copilot/prompts/`	Copilot 関連ファイルとまとめたい場合

コマンドパレットから 「Copilot Runner: テンプレートフォルダを開く」 を実行すると、.prompts/ フォルダが自動作成されます。

プレースホルダー一覧

テンプレート内で以下のプレースホルダーが使えます:

プレースホルダー	説明	例
`${SELECTION}`	アクティブエディタの選択範囲テキスト（未選択なら空）	選択中のコード
`${FILE_PATH}`	アクティブファイルのフルパス（未開なら空）	`/home/user/project/src/main.ts`
`${FILE_NAME}`	アクティブファイルのファイル名（未開なら空）	`main.ts`
`${CURSOR_LINE}`	カーソルの行番号（1始まり、未開なら空）	`42`
`${WORKSPACE_NAME}`	ワークスペース名（未設定なら空）	`my-project`
`${DATE_ISO}`	実行時の ISO 8601 日時	`2026-03-19T06:30:00.000Z`

テンプレート例

# コードレビュー

以下のコードをレビューしてください。

## 対象
- ファイル: ${FILE_NAME}
- 行: ${CURSOR_LINE}

## コード
\`\`\`
${SELECTION}
\`\`\`

## 追加指示
（サイドバーで自由に追記）

設定一覧

settings.json で以下を設定できます:

設定キー	型	既定値	説明
`copilotRunner.cliPath`	`string`	`"copilot"`	Copilot CLI の実行パス
`copilotRunner.defaultModel`	`string`	`"claude-sonnet-4.6"`	既定のモデル名
`copilotRunner.models`	`string[]`	（下記参照）	モデル候補一覧
`copilotRunner.outputLanguage`	`string`	`"auto"`	出力言語コード（`auto` / `en` / `ja` / `zh-CN` / `ko` / `fr` / `de` / `es` 等）。サイドバーからも切替可能
`copilotRunner.yolo`	`boolean`	`true`	`--yolo` フラグを付与するか。サイドバーからも切替可能
`copilotRunner.extraArgs`	`string`	`""`	CLI に追加する引数（シェル風文字列）。`--yolo` はサイドバーのチェックボックスで制御
`copilotRunner.templateGlobs`	`string[]`	`["/.prompts//*.md", ...]`	テンプレート検索用 glob
`copilotRunner.excludeGlobs`	`string[]`	`["/node_modules/", ...]`	検索除外 glob
`copilotRunner.outputToFile`	`boolean`	`false`	結果をファイルに保存するか
`copilotRunner.outputFile`	`string`	`".artifacts/copilot-output.md"`	保存先パス（ワークスペース相対）

設定例

// settings.json
{
  "copilotRunner.cliPath": "/usr/local/bin/copilot",
  "copilotRunner.defaultModel": "gpt-4.1",
  "copilotRunner.extraArgs": "--yolo --quiet",
  "copilotRunner.outputLanguage": "ko",
  "copilotRunner.outputToFile": true,
  "copilotRunner.outputFile": ".artifacts/result.md"
}

既定のモデル一覧

copilotRunner.models のデフォルト値は GitHub Copilot 契約で利用可能な以下のモデルです。設定で自由にカスタマイズできます。

ベンダー	モデル
Anthropic	`claude-sonnet-4.6`, `claude-opus-4.6`, `claude-sonnet-4.5`, `claude-opus-4.5`, `claude-sonnet-4`, `claude-haiku-4.5`, `claude-3.7-sonnet`, `claude-3.5-sonnet`
OpenAI	`gpt-5.4`, `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.2`, `gpt-5.1-codex-max`, `gpt-5.1-codex`, `gpt-5.1-codex-mini`, `gpt-5-mini`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-4o`, `o4-mini`, `o3`, `o3-mini`
Google	`gemini-2.5-pro`, `gemini-2.0-flash`

注意: モデルの利用可否は Copilot プラン・契約内容により異なります。最新情報は GitHub Docs を参照してください。

対応言語一覧

copilotRunner.outputLanguage で設定可能な言語コード（サイドバーのドロップダウンにプリセット済み）:

コード	言語
`auto`	VS Code の表示言語に従う
`en`	English
`ja`	日本語
`zh-CN`	简体中文
`zh-TW`	繁體中文
`ko`	한국어
`fr`	Français
`de`	Deutsch
`es`	Español
`pt`	Português
`it`	Italiano
`ru`	Русский
`ar`	العربية
`hi`	हिन्दी
`th`	ไทย
`vi`	Tiếng Việt
`nl`	Nederlands
`pl`	Polski
`tr`	Türkçe
`sv`	Svenska
`uk`	Українська

設定ファイル (settings.json) では上記以外の任意の言語コードも指定可能です。

トラブルシューティング

CLI が見つからない (`ENOENT`)

Copilot Runner: CLI "copilot" が見つかりません

原因: copilot コマンドが PATH に存在しない、またはインストールされていない。

対処:

ターミナルで which copilot (macOS/Linux) または where copilot (Windows) を実行して確認
フルパスを copilotRunner.cliPath に設定する

テンプレートが見つからない

原因: テンプレートが検索対象ディレクトリに存在しない。

対処:

「Copilot Runner: テンプレートフォルダを開く」で .prompts/ を作成
.md ファイルをそこに配置
copilotRunner.templateGlobs でカスタムパスを追加することも可能

選択範囲が空になる

原因: ${SELECTION} 使用時にテキストを選択していない。

対処: テンプレート実行前にエディタでテキストを選択しておく。

アクティブファイルがない

原因: ${FILE_PATH} や ${FILE_NAME} 使用時にファイルが開かれていない。

対処: 何かファイルを開いた状態でテンプレートを実行する。プレースホルダーは空文字に置換されるため、エラーにはなりません。

CLI がエラーを返す（非ゼロ終了）

原因: CLI 自体のエラー（認証切れ、モデル非対応など）。

対処:

エラーメッセージを確認
ターミナルで直接 CLI を実行して問題を切り分け
copilotRunner.extraArgs の内容を見直す

大きな出力でハングする

通常は発生しません（stdout をストリームで収集しています）。万一フリーズした場合は通知のキャンセルボタンでプロセスを停止できます。

ライセンス

MIT

Copilot Runner

kohta-jrits