VS Code 1.130のAgent Hostを使うには、VS Codeを1.130以上に更新し、ユーザー設定でchat.agentHost.enabledを有効化したうえで、新規チャットのハーネス選択からCopilot、Claude、Codexのいずれかを選択します。
設定をオンにしただけでは、既存のチャットが自動的にAgent Hostへ切り替わったとは限りません。新規セッションを作成し、Agent Host対応ハーネスを明示的に選ぶことが重要です。設定がグレーアウトしている、ClaudeやCodexが表示されないといった場合は、組織ポリシー、段階的な機能展開、Copilot契約、拡張機能の導入状況を順番に確認します。
VS Code 1.130.0は2026年7月22日に公開され、Agent Hostの改善が主要機能として案内されました。MicrosoftはAgent Hostを段階的に展開しているため、同じバージョンでもアカウントや管理設定によって表示内容が異なる場合があります。(Visual Studio Code)
VS Code 1.130のAgent Hostとは
Agent Hostは、Copilot、Claude、CodexなどのAIコーディングエージェントを、VS Code本体や拡張機能ホストとは別の専用プロセスで実行する仕組みです。
従来は、エージェントの処理の多くがVS Codeの拡張機能ホスト内で動作していました。Agent Hostではセッションの状態を専用プロセスが保持し、VS Codeの各ウィンドウは、そのセッションを表示・操作するクライアントとして接続します。(Visual Studio Code)
| 比較項目 | 従来のエディター内エージェント | Agent Host |
|---|---|---|
| 主な実行場所 | 拡張機能ホストやVS Codeウィンドウ内 | 専用のAgent Hostプロセス |
| セッションの管理主体 | ウィンドウや拡張機能のライフサイクルに依存 | Agent Hostがセッションを保持 |
| 複数ウィンドウからの接続 | セッションごとに制約がある | 同じセッションへ複数ウィンドウから接続可能 |
| 対応する実装 | VS Codeローカルエージェントなど | Copilot、Claude、Codexの各ハーネス |
| ウィンドウを閉じた場合 | セッションが停止する場合がある | Agent Hostが動いている間は処理を継続可能 |
| リモート実行 | VS Code Remote環境などに依存 | ローカルまたはリモートのAgent Hostに接続可能 |
Agent Hostとの通信には、Microsoftが公開しているAgent Host Protocol、略してAHPが使われます。Agent Hostがセッション状態の正本を持ち、接続中の各クライアントへ変更内容を同期する構造です。(Visual Studio Code)
ただし、専用プロセスで動くことと、安全なサンドボックスで動くことは別です。Agent Hostのエージェントは、設定された権限に応じてファイル編集やターミナルコマンドの実行を行います。最初からすべての操作を自動承認するのではなく、既定の承認設定で試すのが安全です。
Agent Hostを有効化する前に確認する条件
Agent Host自体を有効にしても、利用条件を満たしていないハーネスは選択肢に表示されません。まず、利用したいエージェントごとの条件を確認します。
| ハーネス | 主な確認事項 | 表示されないときの確認先 |
|---|---|---|
| Copilot | GitHubへのサインイン、利用可能なGitHub Copilot契約 | Copilotのアカウント、ライセンス、組織ポリシー |
| Claude | Claude Agent機能が有効、必要に応じてAgent Hostを優先する設定 | github.copilot.chat.claudeAgent.enabled、chat.agents.claude.preferAgentHost |
| Codex | ローカル利用では対応するCopilotプランとOpenAI Codex拡張機能 | 拡張機能の導入・有効化、契約、組織ポリシー |
| 共通 | VS Code 1.130以上、chat.agentHost.enabledが有効 | VS Codeのバージョン、設定の管理状態、段階展開 |
Agent HostのCopilotハーネスはCopilot SDKを利用し、Copilot CLIなどのCopilot製品と近い実行方式を採用しています。ClaudeはAnthropicのClaude Agent SDKを使用します。ローカルのCodexセッションについて、MicrosoftのドキュメントではCopilot Pro+とOpenAI Codex拡張機能が前提条件として案内されています。(Visual Studio Code)
ClaudeやCodexをVS Codeの統合エージェントとして使う場合、認証・課金経路がAnthropicやOpenAIの個人契約ではなく、GitHub Copilot側になる構成があります。大量に実行する前に、選択中のアカウントと利用状況の表示を確認してください。(Visual Studio Code)
VS Code 1.130でAgent Hostを有効にする手順
VS Codeを1.130以上に更新する
最初に、現在のバージョンを確認します。
WindowsまたはLinuxでは、メニューから「ヘルプ」→「バージョン情報」を開きます。更新が必要な場合は「ヘルプ」→「更新の確認」を実行してください。
VS Code 1.130より新しいバージョンを使用している場合、1.130へ戻す必要はありません。Agent Host関連の設定や改善は後続バージョンにも引き継がれています。
ユーザー設定でchat.agentHost.enabledを有効にする
Ctrl + ,で設定画面を開き、検索欄へ次の設定名を入力します。
chat.agentHost.enabled設定項目が表示されたら、チェックを入れて有効化します。
複数のワークスペースやウィンドウで共通して使用するため、通常は「ワークスペース」ではなくユーザー設定で有効にします。
settings.jsonを直接編集する場合は、コマンドパレットから「Preferences: Open User Settings (JSON)」を実行し、次の設定を追加します。
{
"chat.agentHost.enabled": true
}既存の設定がある場合は、JSON全体を置き換えず、既存オブジェクト内へ項目を追加してください。
Agent Hostはオプトイン機能として案内されており、設定を有効にしたあとにハーネス選択からAgent Host対応エージェントを選ぶ必要があります。(Visual Studio Code)
ClaudeをAgent Hostで優先する
Claudeが表示されているものの、従来側の実装で開かれる場合や、Agent Host側のClaudeを明示的に使いたい場合は、次の設定を確認します。
{
"chat.agentHost.enabled": true,
"github.copilot.chat.claudeAgent.enabled": true,
"chat.agents.claude.preferAgentHost": true
}それぞれの役割は次のとおりです。
| 設定 | 役割 |
|---|---|
chat.agentHost.enabled | Agent Host全体を有効にする |
github.copilot.chat.claudeAgent.enabled | Claude Agentセッションを有効にする |
chat.agents.claude.preferAgentHost | ClaudeをAgent Host側で実行する構成を優先する |
chat.agents.claude.preferAgentHostは、VS Code 1.130のリリースノートでもClaudeをAgent Hostで使うための追加設定例として示されています。(Visual Studio Code)
まずはchat.agentHost.enabledだけで確認し、ClaudeがAgent Hostのハーネス一覧に出ない場合に追加設定を確認すると、不要な設定変更を減らせます。
VS Codeを再起動する
設定変更後は、開いているファイルを保存してVS Codeを完全に終了し、再起動します。
ウィンドウの再読み込みだけで確認する場合は、コマンドパレットから次を実行します。
Developer: Reload Windowただし、Agent Hostは別プロセスとして起動するため、トラブルシューティング時は完全に終了してから起動し直す方が確実です。
Copilot・Claude・Codexのハーネスを選択する
Agent Hostを有効にしただけでは、どのハーネスを使うかは決まりません。新規チャットを作成し、ハーネスを選択します。
Ctrl + Alt + Iでチャットビューを開きます。- 「New Chat」または「新しいチャット」を選択します。
- チャット入力欄の下部にある、セッションまたはハーネスの選択欄を開きます。
Copilot、Claude、Codexのいずれかを選択します。- 必要に応じてモデルと承認レベルを選びます。
- プロンプトを送信してセッションを開始します。
VS Code 1.130の公式画面では、ハーネス選択欄にLocal、Cloud、Copilot、Claude、Codexが表示されています。Copilotを選択した場合は、ローカルのAgent Hostプロセス内でCopilot SDKエージェントを実行することが示されます。
最初の動作確認では、いきなりファイルを変更させず、次のような読み取り中心の依頼を送ると安全です。
このリポジトリの構成を確認し、ファイルを変更せずに、
主要なディレクトリの役割と改善候補を3つ説明してください。応答後に、ファイル変更を伴う小さなタスクを依頼し、承認画面や変更差分が正しく表示されるか確認します。
ハーネスとモデルの違い
Agent Hostを使う際に混同しやすいのが、ハーネスとモデルの違いです。
| 選択項目 | 決まるもの | 例 |
|---|---|---|
| ハーネス | エージェントの実行方式、ツール、セッション管理、承認フロー | Copilot、Claude、Codex |
| モデル | ハーネス内で推論に使用する言語モデル | GPT系、Claude系など |
| 承認レベル | ファイル編集やコマンド実行をどこまで自動承認するか | Default Approvals、Assisted permissionsなど |
| 実行場所 | ローカル、クラウド、リモートホストのどこで処理するか | Local、Cloud、Agent Host |
たとえば、Copilotハーネス内でClaude系モデルを選ぶことと、Claudeハーネスを選ぶことは同じではありません。
ClaudeハーネスではClaude Agent SDK側のツールやセッション動作が使用されます。CodexハーネスではOpenAI Codex側のエージェント実装が使用されます。Agent Hostは、各エージェント実装を共通のAHPセッションへ変換するアダプターを持つ構造です。(Visual Studio Code)
利用中のエージェントを確認するときは、モデル名だけでなく、チャット入力欄の左側に表示されるハーネス名も確認してください。
同じAgent Hostセッションを複数ウィンドウで開く方法
Agent Hostの大きな利点は、同じセッションを複数のVS Codeウィンドウから表示・操作できることです。
動作確認は次の流れで行えます。
- VS CodeのウィンドウAでAgent Hostセッションを開始します。
- 別のVS CodeウィンドウBを開きます。
- チャットのセッション一覧を表示します。
- ウィンドウAで開始した既存セッションを選択します。
- 会話履歴、進行状況、変更内容が同期されることを確認します。
ここで「New Chat」を選ぶと別セッションが作られます。複数ウィンドウ接続を試す場合は、必ずセッション一覧から既存の同一セッションを選んでください。
Agent Hostがセッション状態を保持するため、ウィンドウAを閉じても、Agent Hostプロセスが動作していれば、ウィンドウBから処理を確認できます。接続が一時的に切れた場合も、クライアントは状態を再取得して同期する設計です。(Visual Studio Code)
ただし、セッション状態が共有されても、すべてのツールが必ず同じ条件で利用できるとは限りません。拡張機能が提供するツールやブラウザツールなどは、接続中のVS Codeウィンドウ側からAgent Hostへ提供されることがあります。その拡張機能が別ウィンドウで起動していなければ、ツール一覧が変わる可能性があります。(Visual Studio Code)
別のPCから接続する場合
通常の複数ウィンドウ接続は、同じPC上のVS Codeウィンドウを想定しています。
別のPCやブラウザから接続するには、リモートマシン上でAgent Hostを動かし、SSHまたはDev Tunnelを通じて接続する構成が必要です。スタンドアロンのAgent Hostは、VS Code CLIの次のコマンドで起動できます。
code agent hostローカルでは接続トークンで保護され、--tunnelオプションを利用するとDev Tunnel経由で公開できます。リモートAgent Hostを使う場合、ファイル編集やコマンドはソースコードが置かれたリモートマシン側で実行されます。(Visual Studio Code)
VS Code Agent Hostが有効にできないときの設定と展開条件
Agent Hostが使えない場合は、設定値を何度も変更するより、症状から原因を切り分ける方が早く解決できます。
| 症状 | 主な原因 | 対応 |
|---|---|---|
chat.agentHost.enabledが検索に出ない | VS Codeが古い、別ビルドを使用している | バージョン情報を確認し、1.130以上へ更新する |
| 設定がグレーアウトしている | 組織ポリシーで管理されている | 管理者にChatAgentHostEnabledポリシーを確認してもらう |
| 設定を有効にしてもCopilotなどが出ない | 再起動未実施、段階展開、認証不足 | 完全再起動し、新規セッションを作成して確認する |
| Claudeだけ表示されない | Claude Agent設定または組織ポリシーが無効 | github.copilot.chat.claudeAgent.enabledを確認する |
| ClaudeがAgent Host側で開かない | Agent Hostを優先する設定が無効 | chat.agents.claude.preferAgentHostを確認する |
| Codexだけ表示されない | Codex拡張機能、契約、組織ポリシーの条件不足 | OpenAI Codex拡張機能と利用可能なプランを確認する |
| 選択できるが要求が失敗する | Copilot認証、利用上限、プロキシ、通信制限 | GitHubへ再サインインし、契約とネットワークを確認する |
| 別ウィンドウにセッションが出ない | 別アカウント、別プロファイル、別ホストに接続している | 同じアカウント、プロファイル、Agent Hostか確認する |
| 別ウィンドウでツールが減る | 拡張機能がそのウィンドウで動いていない | 必要な拡張機能を同じプロファイルで有効にする |
| ClaudeやCodexの初回起動が遅い | Agent Host用コンポーネントを取得している | 取得完了を待ち、プロキシやCDN制限を確認する |
MicrosoftはAgent Hostを段階的に展開しているため、設定が正しくても、利用権限やサービス側の展開状況によってハーネスが表示されない場合があります。ClaudeやCodexでは、Agent Host向けのコンポーネントが初回利用時に取得される構成もあるため、社内ネットワークではプロキシやダウンロード制限も確認対象になります。(Visual Studio Code)
設定が「組織によって管理されています」と表示される場合
chat.agentHost.enabledは、ユーザーが自由に変更できる通常設定としてだけでなく、企業や学校の管理者がポリシーで固定できる設定です。
主な管理ポリシーは次のとおりです。
| 管理ポリシー | 対応する設定 | 役割 |
|---|---|---|
ChatAgentHostEnabled | chat.agentHost.enabled | Agent Hostプロセスでのエージェント実行を許可する |
ChatAgentMode | chat.agent.enabled | 自律的なエージェントモードを許可する |
Claude3PIntegration | github.copilot.chat.claudeAgent.enabledなど | Claude Agentセッションを許可する |
Codex3PIntegration | chat.agentHost.codexAgent.enabled | Codex Agentセッションを許可する |
AllowedExtensions | extensions.allowed | OpenAI Codexなどの拡張機能を許可する |
ChatAgentExtensionTools | chat.extensionTools.enabled | 拡張機能が提供するツールの利用を許可する |
ポリシーで値が固定されている場合、ユーザーがsettings.jsonへtrueを書いても上書きできません。管理者側でChatAgentHostEnabledを有効にし、利用するハーネスごとのポリシーとライセンスも許可する必要があります。(Visual Studio Code)
組織展開では、次の順序で確認するとトラブルを減らせます。
- 対象端末へVS Code 1.130以上を展開する。
- GitHub Copilotのライセンスをユーザーへ割り当てる。
ChatAgentModeを許可する。ChatAgentHostEnabledを許可する。- ClaudeまたはCodexの統合ポリシーを許可する。
- Codexを使う場合は拡張機能の許可リストを確認する。
- 少人数のテストグループでハーネス表示と通信を確認する。
- 承認レベル、MCP、拡張機能ツールの運用ルールを決めてから全体展開する。
Copilot・Claude・Codexの使い分け
どのハーネスが常に優れているというものではありません。既存の契約、プロジェクトの設定ファイル、利用したいツールに合わせて選びます。
| ハーネス | 適した利用場面 | 確認しておきたい点 |
|---|---|---|
| Copilot | まずAgent Hostを試す、Copilot CLIに近いワークフローを使う | GitHub Copilotのアカウントと利用枠 |
| Claude | Claude Agent SDK固有の操作やCLAUDE.mdを活用する | Claude Agent設定、組織ポリシー、課金経路 |
| Codex | OpenAI Codexのエージェント実装をVS Codeで使う | OpenAI Codex拡張機能、利用可能なプラン |
| Local | 従来のVS Codeローカルエージェントを使う | Agent Hostセッションではない場合がある |
| Cloud | GitHub上のリポジトリをクラウドエージェントへ委任する | クラウドエージェントの利用権限 |
初めて使う場合はCopilotで動作確認し、同じ小規模タスクをClaudeやCodexでも実行すると、ハーネスごとのツール利用、承認要求、変更内容の違いを比較しやすくなります。
比較時はモデルをそろえることよりも、次の条件をそろえる方が重要です。
- 同じGitコミットから開始する
- 同じプロンプトを使用する
- 同じ承認レベルにする
- 同じMCPサーバーと拡張機能を使う
- 変更行数だけでなく、テスト結果とレビュー工数を比較する
複数エージェントを安全に並列実行する
VS Code 1.130では、Agent Host上で動作するCopilot、Claude、Codexについて、AgentsウィンドウからGit worktreeを使った分離実行が強化されています。ClaudeとCodexでも「New Worktree」を利用できるため、同じリポジトリに対して複数セッションを並行実行しやすくなりました。(Visual Studio Code)
たとえば、次のように役割を分けられます。
| セッション | 担当タスク |
|---|---|
| Copilot | API実装 |
| Claude | 設計レビューとエラー処理の確認 |
| Codex | テストコードの作成 |
| 人間 | 差分確認、テスト実行、統合判断 |
同じ作業フォルダーへ複数のエージェントが直接書き込むと、ファイルの上書きや意図しない変更が発生しやすくなります。並列実行では「New Worktree」を有効にし、セッションごとに変更を分離してからレビュー・マージするのが安全です。
また、Agent Hostを専用プロセスで動かしても、エージェントが実行するコマンドの危険性はなくなりません。実運用では次を守ります。
- 最初は
Default Approvalsを使う - 本番環境の認証情報を含むフォルダーで試さない
.envや秘密鍵をエージェントから参照できる状態にしない- Git管理された検証用ブランチまたはworktreeで実行する
- 変更後はテスト結果と差分を人間が確認する
- 自動承認や権限スキップは、隔離された検証環境だけで使用する
まとめ
VS Code 1.130のAgent Hostを使うための基本手順は、次のとおりです。
- VS Codeを1.130以上へ更新する。
- ユーザー設定で
chat.agentHost.enabledをtrueにする。 - VS Codeを完全に再起動する。
- 新規チャットを作成する。
- ハーネス選択から
Copilot、Claude、Codexを選ぶ。 - 既定の承認設定で小さなタスクを実行する。
- 複数ウィンドウでは、新規チャットではなく既存の同一セッションを開く。
- 表示されない場合は、組織ポリシー、契約、拡張機能、段階展開を確認する。
最初に確認すべき設定は、次の1行です。
{
"chat.agentHost.enabled": true
}この設定を有効にしてもハーネスが表示されない場合は、設定値を増やす前に、設定画面へ「組織によって管理されています」と表示されていないか確認してください。管理環境では、ユーザー側のsettings.jsonではなく、管理者側のChatAgentHostEnabledやClaude・Codex統合ポリシーの変更が必要です。
コメント