読了時間:約8分
GitHub Copilot のエージェントモードを使えば、コードの生成から実行・デバッグまでをAIに一括して任せられます。この記事では、設定方法・実際の手順・よくある失敗と対処法を具体的に解説します。
この記事で分かること:
- ✔ エージェントモードの基本と通常のCopilotとの違いが分かる
- ✔ VS Codeでエージェントモードを有効化する手順が分かる
- ✔ つまずきやすい設定ミスと回避策が分かる
30秒で選ぶなら: → コードの自動生成と実行を1つのプロンプトで完結させたいならエージェントモード一択です。
GitHub Copilot エージェントモードとは何か
GitHub Copilot エージェントモードは、単なるコード補完を超えて「タスクの計画・実行・確認」まで自律的に行うモードです。
通常のCopilot(チャットモード)が「質問に答える」ツールだとすれば、エージェントモードは「指示を受けてタスクを完遂する」ツールです。ファイルの作成・編集・ターミナルでのコマンド実行・エラーの自動修正を、人間の介入なしに連続して行います。
エージェントモードでできること:
- 複数ファイルにまたがるリファクタリングの自動実行
- テストコードの生成と実行結果に基づく自動修正
- パッケージのインストールとセットアップスクリプトの生成
- バグの特定から修正・動作確認までの一連処理
2025年末のGitHub Copilot アップデート以降、エージェントモードはVS Code・JetBrains・Visual Studio等の主要IDEに対応しました。
GitHub Copilot エージェントモードに必要なツールと選び方
エージェントモードを使うには、対応IDEとGitHub Copilotのプランが必要です。
| 比較軸 | VS Code | JetBrains IDE | Visual Studio 2022 |
|---|---|---|---|
| エージェントモード対応 | ✅(最も早く対応) | ✅ | ✅(2025年対応) |
| 推奨Copilotプラン | Business / Enterprise | Business / Enterprise | Business / Enterprise |
| 無料プランでの利用 | △(機能制限あり) | △(機能制限あり) | △(機能制限あり) |
| ターミナル統合 | ✅ ネイティブ対応 | ✅ | ✅ |
| マルチファイル編集 | ✅ | ✅ | ✅ |
| セットアップの容易さ | ◎ | ○ | ○ |
※2026年9月時点。料金・機能は変更の可能性があります。
選び方の基準:
- 普段からVS Codeを使っているなら:VS Code一択。拡張機能のアップデートが最も速く、エージェント機能が真っ先に展開される
- JetBrains系IDEを使っているなら:IntelliJ IDEA・PyCharm等、既存の開発環境のまま移行できる
- Copilotプランの選び方:個人開発なら無料プラン+有料Individual(月額$10、執筆時点の為替レートで約1,500円、1USD=150円換算)で試せる。組織利用はBusinessプランが必須。※為替レートにより変動します。最新料金は公式サイトをご確認ください
GitHub Copilot エージェントモードの手順
最初は何から始めればいいか分からない人がほとんどです。以下の手順を上から順にやれば、初日でエージェントモードが動きます。
ステップ1:拡張機能のインストールと更新
- VS CodeでExtensionsパネルを開く(
Ctrl+Shift+X/Cmd+Shift+X) - 「GitHub Copilot」と「GitHub Copilot Chat」を検索してインストール
- 既にインストール済みの場合は、バージョンが v1.250以降 であることを確認する
ここだけは絶対に確認してください。 バージョンが古いとエージェントモードのUIが表示されません。アップデートを確認せずに「エージェントモードが見つからない」と詰まるケースが最も多いです。
ステップ2:GitHubアカウントのサインイン
- VS Code左下のアカウントアイコンをクリック
- 「Sign in with GitHub to use GitHub Copilot」を選択
- ブラウザで認証を完了させてVS Codeに戻る
Copilot BusinessまたはEnterpriseのシートが割り当てられているアカウントでサインインしてください。個人の無料プランではエージェントモードが制限される場合があります。
ステップ3:エージェントモードの有効化
- VS Codeの設定(
Ctrl+,/Cmd+,)を開く - 検索バーに「
github.copilot.chat.agent」と入力 - 「Chat: Agent Enabled」をオンにする
- VS Codeを再起動する
設定変更後に再起動しないとモードが切り替わらない点は見落とされがちです。
ステップ4:エージェントモードの起動と基本的な使い方
- Copilot Chat(
Ctrl+Shift+I/Cmd+Shift+I)を開く - チャットパネル上部のモード切替から 「Agent」 を選択
- 自然言語でタスクを指示する
指示の書き方:
このように「何を作るか」「使うAPIやライブラリ」「最終的な動作」を1つのプロンプトにまとめると、エージェントが迷わず実行します。
ステップ5:実行の承認と確認
エージェントがファイル操作やターミナルコマンドを実行しようとすると、確認ダイアログが表示されます。
- 変更内容をプレビューで確認する
- 問題なければ「Approve」をクリック
- エラーが発生した場合はエージェントが自動で修正を試みる
やってみると分かるのですが、エージェントは失敗しても諦めずに別のアプローチを取ります。「1回失敗したら終わり」ではなく、数回のイテレーションで完成に近づきます。
よくある失敗と対処法
失敗1:「Agent」モードのボタンが表示されない
原因:拡張機能のバージョンが古い、またはCopilotプランがエージェントモード非対応。
対処法:
- VS Code拡張機能を最新バージョンにアップデート
- コマンドパレット(
Ctrl+Shift+P)で「Developer: Reload Window」を実行 - GitHubの設定ページでCopilotのシートが正しく割り当てられているか確認
この手順を省くと後で必ず詰まります。バージョン確認を最初にやるだけで、大半のトラブルは防げます。
失敗2:エージェントがループして作業が終わらない
原因:指示が曖昧すぎて、エージェントが判断できない状態になっている。または、エラーを修正しようとするたびに別のエラーが発生するループに入っている。
対処法:
- 指示を「1タスク1プロンプト」に絞る。複数の機能を1回の指示で実装させると判断ループが起きやすい
- ループが止まらない場合は「Stop」ボタンで強制停止し、より具体的な指示で再実行する
contextに含めるファイルを手動で指定する(#file:〇〇.py形式)と、エージェントの推測範囲が狭まり精度が上がる
失敗3:ターミナルコマンドの実行が拒否される
原因:VS Codeのターミナル統合設定が無効、またはシェルの権限不足。
対処法:
- VS Code設定で「Terminal › Integrated: Shell Integration」が有効になっているか確認
- macOSの場合は
sudoが必要なコマンドは手動実行に切り替える - WindowsはPowerShellの実行ポリシーを確認(
Set-ExecutionPolicy RemoteSignedが必要な場合がある)
正直、最初は筆者もここでつまずいた。シェル統合の有無でエージェントの実行できるコマンド数が大きく変わります。
よくある質問(FAQ)
Q. GitHub Copilot 無料プランでエージェントモードは使えますか?
A. 無料プランでも一部機能は使えますが、エージェントモードの連続実行回数やターミナル操作に制限があります。本格的に使う場合はCopilot Individualプラン(月額$10、執筆時点で約1,500円、1USD=150円換算)以上が必要です。※為替レートにより変動します。最新料金は公式サイトをご確認ください。
Q. エージェントモードとCopilot Editの違いは何ですか?
A. Copilot Editは「指定したファイルの編集」に特化した機能です。エージェントモードはファイル編集に加えて「ターミナルでのコマンド実行・パッケージインストール・テスト実行・エラー修正」まで自律的に行います。自分でコマンドを実行したくない場合はエージェントモードが向いています。
Q. エージェントモードで実行されたコマンドは取り消せますか?
A. ファイル変更はVS CodeのタイムラインやGitで元に戻せます。ただし、ターミナルで実行されたコマンド(パッケージのインストール・ファイルの削除等)は手動で元に戻す必要があります。重要なリポジトリで使う場合は、事前にgit commitしてから使い始めることを強くすすめます。
まとめ
GitHub Copilot エージェントモードは、設定さえ済ませれば今日から実務に使えます。
個人的にはステップ1のバージョン確認が一番重要だと思う。ここを飛ばして「機能が見つからない」と迷う時間が最もムダです。
まずVS Codeを最新状態にして、エージェントモードを1つの小さなタスクで試してください。「テストコードを書いてもらう」「READMEを自動生成する」程度の作業から始めると、エージェントの挙動を安全に把握できます。
最終更新日:2026年9月23日
