Feature Deep Dive
ワークショップの Part 2。 本章はデモ中に何度も戻ってくるリファレンスです。モデル、エージェントモード、コンテキスト管理、カスタマイズ全般(指示・エージェント・スキル・フック・MCP・メモリ)、権限、サンドボックス、Bring-Your-Own-Key を扱います。所要時間は約 75 分です。
CLI は毎週進化します。ここに記載した具体値は「執筆時点で GitHub ドキュメントに照らして検証済み」として扱い、
/help、/model、copilot help <topic>でライブに確認してください(Best practices)。
これらの機能を動画で見る
GitHub 公式の Dev Days 動画 2 本が、本章の大半をエンドツーエンドでデモします: Less // TODO: more done with GitHub Copilot CLI(モード、/env、Auto モデル、組み込みエージェント、/review、/rubber-duck、/fleet + /tasks、Copilot Memory、サーバーモード)と Build with the Copilot CLI — Mona Mayhem(plan モード、autopilot と YOLO、プラグイン/awesome-copilot、/fleet、/delegate)。詳細は References → トーク・デモ を参照。
モデルとモデル選択
/model(または --model フラグ)でいつでも、セッション途中でもモデルを切り替えられます(About Copilot CLI)。ただし、ワークショップ資料を 1 つの固定モデル名に依存させないでください。モデルカタログ、既定値、プランごとの利用可否、Enterprise のポリシー制御は頻繁に変わります。
代わりに次の判断表を使います。
| ニーズ | CLI での選び方 | 注意点 |
|---|---|---|
| 安定した日常的なワークショップ進行 | Auto または /model に表示される既定モデルから開始 |
Auto は明示的なモデル制御よりも、可用性を見たルーティングを優先する |
| 複雑なアーキテクチャ、難しいデバッグ、大きなリファクタ | /model に表示される推論対応のプレミアムモデルを選ぶ |
高い reasoning や extended context は AI クレジット消費を増やす |
| 高速な機械的編集や大量チェック | プランで表示される高速/小型の coding model を選ぶ | 出力はテストで検証する。高速さは品質保証ではない |
| Enterprise 管理のモデル戦略 | 組織/Enterprise ポリシーで /model に公開されたモデルを使う |
管理者が代替モデルや外部プロバイダーモデルを有効化する必要がある場合がある |
| ローカル/外部プロバイダー検証 | BYOK 設定を使う(BYOK を参照) | モデルはツール呼び出しとストリーミングをサポートする必要がある |
モデルのライフサイクルは短い
最近の changelog だけでも、GPT-4.1 は 2026-06-01 に deprecated、GPT-5.2 と GPT-5.2-Codex は 2026-06-05 に多くの Copilot 体験で deprecated、Opus 4.6 (fast) は 2026-06-29 に deprecated 予定です(GPT-4.1 deprecated、GPT-5.2 and GPT-5.2-Codex deprecated、Upcoming deprecation of Opus 4.6 fast)。ワークショップ実施前に /model、supported models、GitHub Blog Copilot changelog を確認してください。
固定の演習手順にしない範囲で、最近の追加として押さえるべき点は次のとおりです。
- Gemini 3.1 Pro (Preview) と Gemini 3.5 Flash は、プランとポリシーが許せば Copilot CLI で利用できます。Business/Enterprise 管理者はモデルポリシーで opt in する必要があります(Gemini models in Copilot CLI)。
- MAI-Code-1-Flash は Copilot Business および Copilot Enterprise で一般提供(GA)になりました(管理者はポリシーを有効化する必要があります)。Copilot CLI でもプランごとに段階的に提供されます(MAI-Code-1-Flash for Copilot Business and Copilot Enterprise、MAI-Code-1-Flash available on more Copilot surfaces)。
- Enterprise 管理者が構成した外部プロバイダーモデルは Copilot CLI の model picker に表示されます。一方で個人ユーザーはクライアント側 BYOK プロバイダーも構成できます(Copilot CLI supports enterprise BYOK models)。
- Free および Student プランは Copilot の auto モデル選択を既定かつ唯一の方式とするようになり、Microsoft 提供モデルからは
(Preview)ラベルが廃止されます。固定の一覧ではなく/modelで最新の利用可否を確認すべきもう一つの理由です(Changes to model selection for Free and Student plans)。 - 対応モデルでは 拡張(100 万トークン)コンテキスト と 調整可能な推論レベル が使えます。GitHub は、日常タスクでは既定設定を使い、複雑な複数ファイル作業でのみ extended context や higher reasoning を使うことを推奨しています。どちらも AI クレジット消費を増やします(Larger context windows and configurable reasoning levels)。
エージェントモードの詳細
Plan モード
誤解のコストが高いときに Plan モードを使います。複数ファイル変更、移行、新機能、セキュリティに関わるコード変更などです。Shift+Tab または /plan <prompt> で Plan モードに入ると、Copilot は次を行います(Best practices)。
- リクエストとコードベースを分析する。
- スコープを合わせるために 確認の質問 をする。
- セッションフォルダに、チェックボックス付きの構造化された
plan.mdを書く。 - コードを書く前に 承認を待つ。
Ctrl+Y で計画を Markdown エディタで開いて編集できます。難しいタスクで推奨されるループは次のとおりです。
explore → plan → review → implement → verify → commit
> Read the authentication files but don't write code yet
> /plan Implement password reset flow
> Proceed with the plan
> Run the tests and fix any failures
> Commit these changes with a descriptive message
Autopilot
Autopilot はタスクが完了するまで自律的に作業を続けます。Shift+Tab で切り替えます。利用中のビルドで experimental と表示される場合は、--experimental または /experimental で有効化します(README)。CLI 1.0.63 では、エージェントモードがセッション単位で追跡されるようになり、新規作成・clear・切り替え時に持ち越されなくなりました(copilot-cli changelog 1.0.63)。無人実行では サンドボックス と併用しましょう。
Autopilot ≠ YOLO モード
この 2 つは解決する問題が異なり、混同されがちです(Mona Mayhem 動画で両方を実演しています)。
- Autopilot は エージェントモード で、Copilot がどれだけ自分で判断して進めるか を変えます。開発者のように反復(計画 → 実行 → テスト → 検証)し、タスクが完了するまで続けます(autopilot)。
- YOLO モード(
/yolo、--yolo、または--allow-all)は 権限設定 で、Copilot が実行前に確認を取るかどうか を変えます。すべてのツール呼び出しを自動承認し、確認を求めなくなります(CLI command reference)。
両者は独立に組み合わせられます: autopilot は 次に何をするか を、YOLO は 先に聞くかどうか を決めます。自分のマシンで autopilot を YOLO と併用するのは最大限手放しであり、同時に最大限リスクでもあります——autopilot は サンドボックス と組み合わせるのが推奨です。
並列化: /fleet とサブエージェント
大きなタスクでは、プロンプトの先頭に /fleet を付けると、Copilot が作業をサブエージェントが実行する並列サブタスクに分割します(Best practices)。サブエージェントの作業コンテキストはメインスレッドにすべて流れ込まず、結果の要約を見る形になります。広範な探索には有効ですが、最後に統合結果をテスト・検証するステップは必要です。
コンテキスト管理と無限セッション
Copilot CLI には 無限セッション があります。会話がトークン上限の約 95% に近づくと、作業を中断せずバックグラウンドで履歴を自動圧縮します(About Copilot CLI)。
| コマンド | 目的 |
|---|---|
/context |
トークン使用量の視覚的な内訳(システム/ツール、履歴、空き、バッファ) |
/compact |
履歴を手動で圧縮(通常は不要) |
/usage |
セッション統計: 使用した AI クレジット、所要時間、編集行数、モデル別トークン内訳 |
/session |
現在のセッションの情報 |
/session checkpoints [N] |
圧縮チェックポイントの一覧/表示 |
/session files |
このセッションで作成された一時成果物 |
/session plan |
現在の計画(あれば) |
/clear または /new |
無関係なタスクの間でリセット(品質が向上) |
セッション状態はディスクに永続化されます(Best practices)。
~/.copilot/session-state/{session-id}/
├── events.jsonl # full session history
├── workspace.yaml # metadata
├── plan.md # implementation plan (if created)
├── checkpoints/ # compaction history
└── files/ # persistent artifacts
作業は --resume//resume で再開でき、copilot --continue で直近のセッションに戻れます(Using Copilot CLI)。
セッションは集中させる
無限 ≠ 無限に有用、です。無関係なタスクの間では /clear や /new を使いましょう。同僚との会話を新しく始めるのと同じです(Best practices)。
管理者にとって、/usage はローカル/セッション単位の表示にすぎません。組織/Enterprise の所有者は Copilot usage metrics API も監視します。2026-06-19 時点で、ユーザーレベルのレポートに ai_credits_used が追加され、ユーザーごとの Copilot 活動全体の AI クレジット消費を把握できるようになりました(AI credits consumed per user now in the Copilot usage metrics API)。
カスタマイズのサーフェス
これらのファイルと設定により、CLI をチームのワークフローに沿って動かせます。多くは IDE・SDK サーフェスとも共有されます。
graph TD
subgraph Repo[".github/ — repository scope"]
CI[copilot-instructions.md]
INST["instructions/**/*.instructions.md"]
AG[agents/*.agent.md]
SK[skills/*/SKILL.md]
WMCP[.github/mcp.json]
end
subgraph Global["~/.copilot — user scope"]
GCI[copilot-instructions.md]
GAG[agents/]
MCPC[mcp-config.json]
end
subgraph Root["Git root"]
AGENTS[AGENTS.md]
end
CI --> Agent[Copilot CLI agent]
INST --> Agent
AG --> Agent
SK --> Agent
WMCP --> Agent
GCI --> Agent
GAG --> Agent
MCPC --> Agent
AGENTS --> Agent
カスタム指示
プロンプトに自動的に含まれる自然言語の Markdown です。Copilot CLI は複数の場所から読み込み、それらは結合されます(優先フォールバックではない)。競合時はリポジトリの指示がグローバルより優先されます(Best practices、Adding custom instructions)。
| 場所 | スコープ |
|---|---|
~/.copilot/copilot-instructions.md |
全セッション(グローバル) |
.github/copilot-instructions.md |
リポジトリ |
.github/instructions/**/*.instructions.md |
リポジトリ(モジュラー、パススコープ) |
AGENTS.md(Git ルートまたは cwd) |
リポジトリ |
Copilot.md、GEMINI.md、CODEX.md |
リポジトリ |
簡潔かつ実行可能に保ちましょう。冗長な指示は効果を薄め、矛盾する指示は非決定的な挙動を招きます(Best practices)。
カスタムエージェント
カスタムエージェントは、独自の専門性・ツール・指示を持つ Copilot の特化版です。Copilot CLI は組み込みエージェントを同梱し、独自に定義することもできます(Using Copilot CLI)。
組み込みエージェント:
| エージェント | 役割 |
|---|---|
| Explore | メインのコンテキストを汚さずにコードベースを素早く分析 |
| Task | テスト/ビルドを実行。成功時は短い要約、失敗時は全出力 |
| General purpose | 複雑な複数ステップのタスクを別コンテキストで実行 |
| Code review | 本当に重要な問題だけを浮かび上がらせ、ノイズを最小化 |
| Research | コード・リポジトリ・Web を横断する深い調査を、引用付きで実施 |
| Rubber duck | セカンドオピニオン を与える建設的な批評役。/rubber-duck で呼び出し、メインエージェントが自動で相談することもある。あえて 補完的なモデル(作業をしたモデルとは別のモデルファミリー)で動くため、単一モデルが見落としがちな問題を捉える(rubber duck agent) |
独自に定義 するには Markdown の「エージェントプロファイル」を使います。
| 種別 | 場所 | スコープ |
|---|---|---|
| ユーザー | ~/.copilot/agents/ |
すべてのプロジェクト |
| リポジトリ | .github/agents/ |
現在のプロジェクト |
| 組織/Enterprise | .github-private リポジトリ内の /agents |
組織/Enterprise 配下の全プロジェクト |
エージェントは 3 通りで呼び出します(Using Copilot CLI)。
> /agent # pick from a list
> Use the refactoring agent to clean this up # natural language
$ copilot --agent=refactor-agent -p "Refactor this block"
Demo 6 で 1 つ作成します。
GitHub は Agent finder も展開しています。これは許可されたレジストリから MCP サーバー、スキル、キャンバス、エージェント、ツールを検索し、ランキングされた候補を返します。リソースを勝手にインストールするものではなく、managed settings と registry policy の範囲内で、何を配線すべきかを発見するための仕組みです(Agent finder for GitHub Copilot)。
スキル
スキルは、特化したタスク向けに指示・スクリプト・リソースで Copilot を強化するもので、SKILL.md フォルダとしてパッケージ化します(Adding agent skills、About agent skills)。Demo 6 でも扱います。
プラグインと awesome-copilot マーケットプレイス
プラグインは、関連する指示・スキル・エージェント・フックを 1 つのインストール可能な単位にまとめたもので、プラグイン マーケットプレイス を通じて配布されます。セッション内では /plugin(シェルからは copilot plugin)で管理します(About GitHub Copilot plugins、CLI command reference)。
> /plugin marketplace list # 登録済みマーケットプレイスを一覧
> /plugin list # インストール済みプラグインを確認
> /plugin install <name>@awesome-copilot # 特定のプラグインをインストール
GitHub のコミュニティコレクション github/awesome-copilot(gh.io/awesome-copilot)は、すぐ使える指示・エージェント・スキル・フック・プラグインを数百提供し、最近の CLI ビルドでは マーケットプレイスとして既定登録済み です。未登録の場合は /plugin marketplace add github/awesome-copilot で一度登録します。Mona Mayhem 動画では、そこから探してインストールする様子をライブで示します。
サードパーティ製のカスタマイズはコードと同じように扱う
awesome-copilot のコンテンツはコミュニティ提供です。指示ファイル・エージェント・スキル・プラグインは、自分で書くコードと同じくシェルコマンドやツール権限を含みうるため、インストール前に必ず中身を確認してください。
フック
フックは、エージェントのライフサイクルの要所でカスタムシェルコマンドを実行できます。検証・権限チェック・ロギング・セキュリティスキャンなどに使えます(About hooks for GitHub Copilot)。フックは CLI・IDE・クラウドエージェントでサポートされます。
Copilot Memory
Copilot は、リポジトリの規約やパターンに関する持続的な「メモリ」を推論して保存でき、プロンプトでの繰り返しの説明を減らせます(About GitHub Copilot Memory)。
MCP サーバー
CLI は GitHub MCP サーバーをあらかじめ構成 して同梱しているため、GitHub.com の操作がすぐに使えます。他のツール/データに到達するにはサーバーを追加します(Using Copilot CLI)。
> /mcp # list configured servers
> /mcp add # add a server (Tab between fields, Ctrl+S to save)
> /mcp search # browse the GitHub MCP Registry and install a server
ユーザーレベルのサーバー定義は ~/.copilot 配下の mcp-config.json に保存されます(COPILOT_HOME で上書き可)。/mcp add や /mcp search で追加したサーバーは CLI を再起動せずにすぐ利用できます(Copilot CLI: New terminal interface is generally available)。最近の CLI では .github/mcp.json からワークスペース MCP 設定も自動ロードされます。また、deferTools のような新しい MCP 設定キーも changelog で追加されています(copilot-cli changelog 1.0.61、copilot-cli changelog 1.0.63)。Demo 5 でカスタムサーバーを配線します。
権限と許可ツール
Copilot がファイルを変更・実行しうるツール(例: touch、chmod、node、sed)を初めて使うとき、確認します(About Copilot CLI)。
1. Yes
2. Yes, and approve TOOL for the rest of the running session
3. No, and tell Copilot what to do differently (Esc)
ツールはフラグやスラッシュコマンドで事前に許可(または禁止)します。
| 仕組み | 効果 |
|---|---|
--allow-all-tools |
確認なしで任意のツールを許可(危険) |
--allow-tool='shell(git:*)' |
すべての git コマンドを許可 |
--allow-tool='write' |
ファイル書き込みを許可 |
--deny-tool='shell(git push)' |
git push を禁止(deny が 優先) |
--allow-tool='MyServer' / --deny-tool='MyServer(tool)' |
MCP サーバーのツールを許可/禁止 |
/allow-all または /yolo |
セッション内ですべての権限を有効化 |
/reset-allowed-tools |
以前に許可したツールをリセット |
# Allow all git EXCEPT push; deny destructive rm
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)' --deny-tool='shell(rm)'
チーム向けの最小権限パターン。
| ワークフロー | 安全な開始点 |
|---|---|
| 読み取り中心のレビュー/レポート | shell(git:*) を許可。レポートファイルを書く場合だけ write を許可 |
| CI の prompt mode | git push、git reset、rm、デプロイコマンドを禁止。プロンプトは冪等にする |
| 移行/リファクタ | テストコマンドとファイル書き込みを許可。ブランチ作業と人間の差分レビューを必須にする |
| 信頼できないリポジトリや生成コード | 広い権限を与える前にローカルまたはクラウドサンドボックスを使う |
自動承認 = あなたの全権限
--allow-all-tools/--yolo を使うと、Copilot はレビューなしであなたと同じコマンドを実行できます。破壊的なものも含みます。サンドボックスや使い捨て環境に限定してください(Security considerations)。
サンドボックス
Copilot が代わりに取る操作(ツール実行、コマンド実行、ファイル変更)が増えるほど、エージェント的ワークフローを安全に採用するための 隔離・可搬性・ポリシー制御 が必要になります。サンドボックスは Copilot を どこで 動かすかを選べるようにする仕組みで、現在は Copilot CLI セッションに適用されます(クラウドサンドボックスは Copilot アプリのセッションにも適用)(About cloud and local sandboxes、public preview)。
| 種別 | 方法 | 使うとき |
|---|---|---|
| ローカルサンドボックス | セッション内で /sandbox enable |
自分のマシン上で、ファイルシステム・ネットワーク・システム機能へのアクセスを制限して Copilot を実行。標準の Copilot seat に追加費用なしで含まれる |
| クラウドサンドボックス | copilot --cloud |
GitHub がホストする、完全に隔離された一時的な Linux 環境で Copilot を実行。強い隔離、別デバイスからの継続、計算量の多い作業、並列タスクに使う(従量課金) |
認証は共有される
サンドボックスは既存の Copilot CLI 認証を再利用します。別のクラウドプロバイダー、API キー、インフラの管理は不要です。Copilot CLI にサインインでき Copilot にアクセスできれば、サンドボックスを使えます。クラウドサンドボックスはさらに、組織/Enterprise の所有者が Cloud Sandbox access ポリシーを有効化する必要があります(About cloud and local sandboxes)。
ローカルサンドボックス
ローカルサンドボックスは、自分のマシン上で直接 Copilot をサンドボックス内で動かし、ファイルシステム・ネットワーク接続・システム機能へのアクセスを制限します。セッション内で有効化し、対話的な /sandbox UI で微調整します(設定は設定ディレクトリの settings.json の sandbox キー配下に永続化されます)(Configuring local sandbox settings)。
> /sandbox enable # サンドボックスを有効化
> /sandbox # General / Filesystem / Network の設定を開く(Tab で切替、Esc で保存)
> /sandbox disable # 無効化
| タブ | 主な設定 |
|---|---|
| General | Sandboxing enabled; Allow keychain access(git/gh の credential helper 用の macOS Keychain。資格情報の読み取りを防ぐにはオフ) |
| Filesystem | Include working directory(プロジェクトに自動で read/write); Clear policy on exit(セッションごとに権限をリセット); 作業ディレクトリ外の場所に対するパス単位の read-only または read/write ルール |
| Network | Allow outbound connections(完全に隔離するにはオフ); Allow local network(localhost/LAN) |
ホスト単位のネットワークルールはセキュリティ境界ではない
allowedHosts/blockedHosts のフィルタはプラットフォーム間で信頼できません。macOS では allow ルールが無制限のアウトバウンドに静かに劣化し、block ルールは未対応です。Linux では、アウトバウンド無効時にホストルールで特定ホストだけを確実に許可することはできません。実際の隔離には、ホスト単位のルールではなく Allow outbound connections のトグルを使ってください(Configuring local sandbox settings)。
- クロスプラットフォーム: macOS と Linux で利用可能。Windows は Windows Insiders ビルドが必要です。各 OS が異なるサンドボックスバックエンドを使うため、隔離の挙動は OS ごとに異なります(About cloud and local sandboxes)。
- Enterprise ポリシー適用: ローカルサンドボックスのポリシーは Microsoft Intune などの MDM プラットフォームで集中構成・強制でき、管理対象デバイス上で Copilot がローカルリソースにどう触れるかを管理者が制御できます(About cloud and local sandboxes)。
- 課金: 標準の Copilot seat に追加費用なしで含まれます。
クラウドサンドボックス
クラウドサンドボックスは、CLI セッションを GitHub がホストする、完全に隔離された一時的な Linux 環境 内で実行します。ローカルマシンからも他のセッションからも隔離されます。Azure Container Apps Sandboxes 上に構築され、GitHub が ID・ポリシー・課金のレイヤーを提供します(About cloud and local sandboxes)。
copilot --cloud # クラウドサンドボックス内で対話セッションを開始
Copilot が実行するコマンドは、自分のマシンではなくクラウド環境で実行されます。これにより 3 つのパターンが可能になります。
- デバイス間で継続 — セッションが GitHub ホストのインフラ上にあるため、ファイルをコピーしたり依存関係を再インストールしたりせずに、どのデバイスからでも再開できます。
- 計算量の多い作業をオフロード — ローカルを軽量・快適に保ったまま、複数の Copilot タスクをクラウドで並列実行できます。
- 統一されたガバナンス — クラウドサンドボックスのポリシーは Copilot cloud agent のポリシーと同じ構成を共有するため、既存のファイアウォール/セキュリティ制御が追加設定なしで自動的に拡張されます。
クラウドサンドボックスのセッションは 3 つの状態を遷移します。停止時に状態をスナップショットするため、後で再開できます(About cloud and local sandboxes)。
| 状態 | 意味 |
|---|---|
| Active | 実行中で、Copilot CLI から対話できる |
| Stopped | 実行されていないが状態はスナップショット済み。再開するとファイル・環境変数・作業途中の状態が復元される |
| Deleted | 実行環境 と スナップショットが削除される。復元不可 |
組織での有効化と課金
メンバーが使えるようにするには、組織/Enterprise の所有者がクラウドサンドボックスアクセスを有効化する必要があります(組織設定 → Sandboxes → Enabled for all members)(Enabling or disabling cloud sandboxes)。利用は 3 つの軸で計測されます。長時間のセッション前に最新の pricing を確認してください。
| メーター | 計測対象 | 単位 | 価格(USD) |
|---|---|---|---|
| Compute | セッションが実行されている時間 | Compute 秒 | $0.000024 |
| Memory | 実行中に割り当てられたメモリ | GiB 秒 | $0.000003 |
| Storage | 停止したセッションのスナップショット保管 | GiB 月 | $0.005 |
詳細は Billing for cloud and local sandboxes と public preview の発表 を参照してください。
Copilot Anywhere: リモートコントロール CLI からクラウドサンドボックスまで
Microsoft Developer のデモ 「GitHub Copilot Anywhere: From Remote Control CLIs to Cloud Sandboxes」(DEM305) は、これらを 1 つのストーリーにまとめています。エージェントを 1 つのターミナルに張り付いて見守る必要はありません。Copilot を リモートコントロール し、重い・リスクの高い・長時間の作業を、どこからでも再参加できる GitHub ホストの隔離サンドボックスで実行させられます(デモを見る)。
本ワークショップが既に扱っている「リモートコントロール」のサーフェスは、サンドボックスと自然に組み合わさります。
| やりたいこと | 使うもの | 扱う章 |
|---|---|---|
| 対話 UI なしでタスクを起動(SSH、CI、スクリプト) | copilot -p "…" prompt mode |
Demo 4 · CI/CD 自動化 |
| 別のエディタ/ツールから CLI を駆動 | ACP サーバー | インタフェースと相互運用 |
| 長いタスクを GitHub のサーバーに委譲 | /delegate <prompt> |
Best practices |
| 隔離・並列・計算量の多い作業を実行 | copilot --cloud |
本節 |
| 別マシンでセッションを再開 | クラウドサンドボックスのセッション継続 | 本節 |
graph LR
Dev[あなた — 任意のデバイス] -->|"copilot -p / ACP"| CLI[Copilot CLI エージェント]
CLI -->|"/sandbox enable"| Local[ローカルサンドボックス<br/>自分のマシン上]
CLI -->|"copilot --cloud"| Cloud[一時的なクラウドサンドボックス<br/>Azure Container Apps]
Cloud -->|"stop → snapshot"| Snap[(保存されたセッション状態)]
Snap -->|"どこからでも再開"| Dev2[あなた — 別のデバイス]
CLI -->|"/delegate"| Agent[Copilot cloud agent]
style Cloud fill:#c8e6c9
style Local fill:#bbdefb
自律性の安全な既定
無人実行では autopilot とサンドボックスを併用しましょう。ローカルサンドボックスは Copilot が自分のマシン上で触れられる範囲を制限し、クラウドサンドボックスは実行を完全にマシン外へ移します。どちらもホスト上の --allow-all-tools/--yolo よりはるかに安全です(権限と許可ツール)。
Bring Your Own Key(BYOK)
環境変数で、GitHub ホスト型モデルの代わりに独自のモデルプロバイダーを CLI に向けられます(About Copilot CLI)。
BYOK には 2 つの経路があります。
- Enterprise 管理のプロバイダーモデル: 管理者が外部プロバイダーモデルを構成し、対象ユーザーの
/modelに表示されます(Copilot CLI supports enterprise BYOK models)。 - クライアント側 BYOK: 個人ユーザーが、環境変数でローカル CLI を OpenAI 互換、Azure OpenAI、Anthropic、ローカルプロバイダーに向けます。
| 変数 | 意味 |
|---|---|
COPILOT_PROVIDER_BASE_URL |
プロバイダー API のベース URL |
COPILOT_PROVIDER_TYPE |
openai(既定。Ollama/vLLM を含む OpenAI 互換)、azure、anthropic |
COPILOT_PROVIDER_API_KEY |
API キー(キー不要のローカルプロバイダーでは省略) |
COPILOT_MODEL |
使用するモデル(または --model) |
要件と注意点。
- モデルは ツール呼び出しとストリーミングをサポート する必要があります。コンテキストは 128k 以上を目安に(About Copilot CLI)。
- 組み込みサブエージェントはプロバイダー設定を継承します。コスト見積もりは非表示ですが、トークン数は表示されます(Best practices)。
/delegateは依然として GitHub サインインが必要です。プロバイダーではなく GitHub のサーバーサイド Copilot に転送されます(Best practices)。- 完全なセットアップは
copilot help providersを実行してください。
本リポジトリの Copilot SDK チュートリアル — BYOK レシピ にプログラム的な等価例があります。
インタフェースと相互運用
| 機能 | 方法 | 出典 |
|---|---|---|
| モデルを介さずにシェルコマンドを実行 | 先頭に !、例: !git status |
Using Copilot CLI |
| プロンプトにファイルを追加 | @path/to/file |
Using Copilot CLI |
| 別ディレクトリで作業 | /add-dir、/cwd、/cd、/list-dirs |
Using Copilot CLI |
| プロンプトをスケジュール | /every <interval>、/after <delay> |
Using Copilot CLI |
| UI 作業のための画像 | ドラッグ&ドロップ、Ctrl+V、または @mockup.png |
Best practices |
| ローカル音声入力 | Space を長押し、または Ctrl+X のあと V |
Copilot CLI improved UI, rubber duck, scheduling, and voice input |
| 推論の可視化を切り替え | Ctrl+T | Using Copilot CLI |
| セカンドオピニオンを得る | /rubber-duck |
Copilot CLI improved UI, rubber duck, scheduling, and voice input |
| セキュリティに絞ったローカルレビュー | /security-review(全ユーザーが利用可能) |
copilot-cli changelog 1.0.64 |
| worktree を作成/切り替え | /worktree(alias /move) |
copilot-cli changelog 1.0.61 |
| セッションの変更をレビュー | /diff |
copilot-cli changelog |
| 他ツールのエージェントとして使う(ACP) | Agent Client Protocol サーバー | About Copilot CLI |
| クラウドエージェントに委譲 | /delegate <prompt> |
Best practices |
次へ
これで機能の全体像が手に入りました。Demo Scenarios で実践しましょう。まずは Issue → Branch → PR 自動化 から。