Microsoft developer platform documentation update: Revert “agentHost/claude: Phase 6 — sendMessage, single-turn, no tools” は、VS CodeのAgent Hostで進められていたClaude連携のPhase 6をいったん取り消した変更です。結論から言うと、通常のVS Code安定版ユーザーがすぐ設定変更する必要は低い一方で、microsoft/vscodeのmain、Insiders相当のビルド、Agent Host、Claude Agent SDK連携、関連ドキュメントやテストを追っている開発者は確認が必要です。

今回のPR #314358は、2026年5月5日にmicrosoft/vscodeのmainへマージされ、直前のPR #314216をrevertしています。PR #314216ではClaude IAgent providerのPhase 6として、sendMessageによる単一ターン送信やClaude Agent SDK経由のストリーミング処理が導入されていましたが、#314358ではその実装・依存関係・テスト・関連ドキュメントが戻されました。なお、2026年5月7日時点で確認する場合は、翌日にre-landされたPR #314533も併せて見る必要があります。(GitHub)

Microsoft developer platformのdocumentation updateで何が変わったか

今回の更新は、「Claude Agent HostのPhase 6機能が正式に無効化された」というより、VS Codeリポジトリ上で一度入った実装を戻し、開発中の状態を再整理した変更と見るのが正確です。

PR #314358の画面では、Reverts #314216と明記されており、PR #314216のマージコミットdea0d3cを戻す内容になっています。変更の概要としては、Claude Agent SDKの依存関係、SDKサービス、セッション実装、メッセージ変換処理、統合テスト、Phase 5/6の計画ドキュメントなどを削除し、Claude providerをPhase 4相当のスケルトン状態へ戻すものです。(GitHub)

確認項目	PR #314216で入った内容	PR #314358で戻された内容
sendMessage	Claude SDKのWarmQueryを使った単一ターン送信	Phase 4相当のスタブ状態へ戻す
ツール利用	canUseTool: 'deny'のまま、ツールなしで送信	Phase 6の送信処理自体を取り消し
SDK依存	@anthropic-ai/claude-agent-sdkを追加	root/remoteの依存関係から削除
実装ファイル	SDKサービス、セッション、プロンプト解決、イベント変換を追加	それらのファイルを削除
テスト	proxy-backed統合テストを追加	統合テストを削除
ドキュメント	Phase 5/6計画、smoke手順を更新	Phase 5/6計画を削除し、Phase 4寄りのsmoke内容へ戻す

変更の中心はClaude Agent HostのPhase 6取り消し

PR #314216のPhase 6では、Claude IAgent providerに対して、最初のsendMessage時にセッションをmaterializeし、Claude Agent SDKへ単一ターンのプロンプトを送り、SDKのメッセージをAgent Host側のAgentSignalへ変換してストリーミングする流れが実装されていました。ツール利用はこの段階では許可されず、canUseTool: 'deny'のままです。(GitHub)

一方、PR #314358では、このPhase 6の実装一式が取り消されました。具体的には、ClaudeAgentSession、claudePromptResolver.ts、claudeMapSessionEvents.ts、claudeAgentSdkService.ts、claudeSessionConfigKeys.tsなどが削除対象に含まれています。さらに、package.jsonとremote/package.jsonから@anthropic-ai/claude-agent-sdkが削除され、Agent HostのDI登録やESLintのimport allowlistも戻されています。(GitHub)

ここで重要なのは、「Claude連携そのものが完全に終了した」と早合点しないことです。今回のrevertは、開発中のPhase 6実装をいったん戻した変更であり、同じ流れの作業は後続PRで再投入されています。開発ブランチやビルド成果物を評価する場合は、どのコミット時点を基準にしているかを必ず確認してください。

誰が対応すべきか

影響範囲は、VS Codeの使い方によって大きく変わります。一般的な拡張機能利用者よりも、Agent HostやClaude providerの実装を追っている開発者、CI担当者、技術記事や社内手順書を整備している人ほど影響を受けやすい変更です。

対象者	影響度	確認すべきこと
VS Code安定版を通常利用しているユーザー	低	通常利用では急いだ対応は不要。Claude Agent Host関連の実験機能を使っていなければ影響は限定的
VS Code Insidersやmainビルドを使う開発者	中	Claude providerが登録される条件、sendMessageの挙動、ログ出力を確認
Agent Host/IAgent周辺を触る拡張機能・社内ツール開発者	高	削除されたAPI、設定キー、SDK依存を参照していないか確認
CI・パッケージング担当者	高	package-lock.json、remote側依存、統合テスト、ビルド設定の差分を確認
ドキュメント・QA担当者	高	Phase 6前提の手順、smoke test、設定値の説明が古くなっていないか確認

特に注意したいのは、sendMessageが使える前提で検証コードや記事を書いていたケースです。#314358時点だけを見ると、その前提は戻されています。後続のre-landまで含めて評価するなら、#314533の内容に合わせて説明を更新する必要があります。

開発者が確認すべき変更点

@anthropic-ai/claude-agent-sdkを直接依存として扱っていないか

PR #314358では、rootとremoteのpackage.jsonから@anthropic-ai/claude-agent-sdkが削除されています。これにより、VS Code本体側にSDKが含まれている前提でローカル検証やCIを組んでいる場合、依存解決やimportで失敗する可能性があります。(GitHub)

まずは、対象ブランチで次のような参照が残っていないか確認してください。

git grep -n "@anthropic-ai/claude-agent-sdk"
git grep -n "IClaudeAgentSdkService"
git grep -n "ClaudeAgentSession"
git grep -n "claudeMapSessionEvents"
git grep -n "claudePromptResolver"

残っている場合は、その参照が現在のブランチで有効な実装を指しているのか、revert前のコードを前提にした古い参照なのかを切り分けます。特にテストコードや社内メモでは、古いファイル名だけが残りやすいので注意が必要です。

sendMessageの動作確認はコミット時点を明示する

Phase 6のポイントはsendMessageでした。PR #314216では、最初の送信時にセッションをmaterializeし、Claude SDKを通じて単一ターンの応答を流す設計が説明されています。ところが#314358では、その実装が戻されています。(GitHub)

そのため、検証結果を書くときは次のように基準を明確にしてください。

書き方	問題点
「VS CodeのClaude Agent HostはsendMessageに対応した」	どのPR・どのコミット時点か不明で誤解を招く
「PR #314216ではPhase 6としてsendMessageが実装されたが、PR #314358でrevertされた」	変更の流れが分かりやすい
「2026年5月7日時点では、#314533のre-land内容も確認が必要」	後続変更まで踏まえられている

技術記事や社内ナレッジでは、「いつの時点のmainを見ているか」を書かないと、読者が手元の挙動と記事内容の違いに迷います。

smoke testと統合テストの前提を見直す

314358では、src/vs/platform/agentHost/test/node/claudeAgent.integrationTest.tsが削除対象として示されています。これは、Claude SDKやproxy-backedの往復を前提にしたPhase 6の統合テストがrevertされたことを意味します。(GitHub)

CIで似たテストを持っている場合は、次の観点で確認してください。

確認ポイント	見直し内容
統合テストがSDK起動を前提にしている	現在のブランチでSDKサービスが存在するか確認
sendMessageの成功を検証している	Phase 6実装が入っているコミットか確認
smoke手順がPhase 6前提	Phase 4相当の手順に戻すか、re-land後の手順に更新
ログ検証でClaude provider登録を期待している	provider登録条件と設定値を再確認

テスト失敗時に「Claude SDK側の不具合」と決めつけるのは危険です。実際には、参照しているVS Code本体のコミットがrevert後で、そもそもPhase 6実装が存在しない可能性があります。

後続のre-land PR #314533も確認するべき理由

今回のMicrosoft developer platform documentation updateを読むうえで、#314358だけを見ると「Claude Agent Host Phase 6は戻された」で終わってしまいます。しかし、2026年5月6日にPR #314533がマージされ、Phase 5/6の作業がre-landされています。#314533では、PR-reviewの修正、SDKバージョン更新、そしてSDKをVS Codeに同梱せずユーザー指定パスから読み込む方針への変更が含まれています。(GitHub)

特に大きいのは設定の考え方です。#314533では、従来のboolean設定chat.agentHost.claudeAgent.enabledではなく、文字列設定chat.agentHost.claudeAgent.pathを使い、値が空でなければClaude providerを登録する方向に変わっています。また、環境変数もVSCODE_AGENT_HOST_ENABLE_CLAUDEからVSCODE_AGENT_HOST_CLAUDE_SDK_PATHへ、CLIフラグも--enable-claude-agentから--claude-sdk-path <path>へ置き換えられています。(GitHub)

観点	revert時点の見方	re-land後に見るべき点
Claude SDK	依存関係から削除	本体同梱ではなく、ユーザー指定パスから読み込む方針
設定	Phase 6実装が戻され、旧前提の説明は不安定	chat.agentHost.claudeAgent.pathの有無を確認
環境変数	VSCODE_AGENT_HOST_ENABLE_CLAUDE前提の記述は要注意	VSCODE_AGENT_HOST_CLAUDE_SDK_PATHを確認
CLI	--enable-claude-agent前提の手順は要注意	--claude-sdk-path <path>を確認
記事・手順書	#314358だけを根拠にすると古くなる可能性	#314358と#314533をセットで説明する

つまり、実務上は「#314358で戻った」だけではなく、「なぜ戻り、その後どういう形で入れ直されたか」まで追うのが安全です。

移行・設定確認でやるべきこと

ローカル環境では現在のコミットを最初に確認する

まず、手元のVS Codeソースが#314358前後のどこにあるかを確認します。挙動の違いを追うときは、PR番号ではなくコミット履歴を見たほうが確実です。

git log --oneline --decorate --grep="agentHost/claude"
git log --oneline --decorate --grep="Revert \"agentHost/claude"

314358のマージコミット付近にいる場合、Phase 6のsendMessage実装は戻されている可能性があります。#314533以降にいる場合は、re-land後の設定・SDK読み込み方式を前提に確認してください。

設定名を古いまま案内していないか確認する

社内Wiki、検証メモ、ブログ記事、READMEで次の文字列を検索してください。

git grep -n "chat.agentHost.claudeAgent.enabled"
git grep -n "chat.agentHost.claudeAgent.path"
git grep -n "VSCODE_AGENT_HOST_ENABLE_CLAUDE"
git grep -n "VSCODE_AGENT_HOST_CLAUDE_SDK_PATH"
git grep -n "--enable-claude-agent"
git grep -n "--claude-sdk-path"

古い設定名と新しい設定名が混在している場合、読者はどちらを使えばよいか判断できません。記事や手順書では、対象コミットまたは対象ビルドを明記したうえで、必要なら「#314358時点」と「#314533以降」を分けて説明しましょう。

SDKを同梱前提にしない

314533では、SDKをVS Codeへ同梱せず、ユーザーがインストールした場所から読み込む方針が説明されています。理由として、SDK更新後にプラットフォーム別のネイティブclaude実行ファイルが大きくなり、ビルドやパッケージング上の問題が出たことが挙げられています。(GitHub)

そのため、今後の検証では次の前提でチェックすると失敗を減らせます。

チェック項目	実務での判断基準
SDKがnode_modulesにあるか	VS Code本体のproduction依存として存在するとは限らない
SDKパス設定があるか	chat.agentHost.claudeAgent.pathが空ならproviderが登録されない可能性がある
環境変数が渡っているか	Agent Host側にVSCODE_AGENT_HOST_CLAUDE_SDK_PATHが届いているか確認
ディレクトリ指定かファイル指定か	ディレクトリの場合、package.jsonのexportsまたはmainから解決される前提を確認

失敗しやすいポイント

「revert＝機能終了」と解釈してしまう

revertは、必ずしも機能の中止を意味しません。今回のように、開発中の実装を一度戻し、修正を加えて再投入するケースがあります。特にMicrosoft developer platformやVS Codeのmainを追う場合、revert後のre-landまで確認するのが基本です。

古い設定名をそのまま使う

chat.agentHost.claudeAgent.enabledやVSCODE_AGENT_HOST_ENABLE_CLAUDEを案内している資料は、#314533以降の前提では古い可能性があります。手元のブランチがどちらの状態か分からない場合は、設定名で決め打ちせず、git grepで実装を確認してください。

安定版VS Codeへの影響として大きく書きすぎる

今回の変更は、VS Codeの公開安定版ユーザーに対して「今すぐ設定を変えるべき」という種類の更新ではありません。影響が大きいのは、主に開発中のAgent Host/Claude provider、Insiders相当の検証、CI、ドキュメント作成です。記事化する場合は、一般ユーザー向けの緊急対応のように書かないほうが正確です。

Phase 6の範囲を広げて説明してしまう

PR #314216のPhase 6は、あくまでsendMessage、単一ターン、ツールなしの段階です。ツール実行、fork、Plan Mode UI、会話履歴再構築などは後続Phaseに回されています。Phase 6を「Claude Agent Hostの完成版」と表現すると誤解を招きます。(GitHub)

記事・社内手順書を更新する場合の書き換え例

古い説明をそのまま残すより、変更の流れを短く書くと読者が迷いません。

古い書き方	推奨する書き方
Claude Agent HostはPhase 6でsendMessageに対応しました	PR #314216でPhase 6のsendMessage実装が入りましたが、PR #314358で一度revertされ、PR #314533で修正込みでre-landされています
chat.agentHost.claudeAgent.enabledを有効化します	対象コミットによって設定名が異なります。#314533以降ではchat.agentHost.claudeAgent.pathを確認します
VS CodeにClaude Agent SDKが含まれます	#314533以降の方針では、SDKは本体同梱ではなく、ユーザー指定パスから読み込む形が説明されています
Phase 6でClaudeのツール利用が可能です	Phase 6ではツール利用はdenyのままで、ツール連携は後続Phaseの範囲です

次に取るべき行動

今回のMicrosoft developer platform documentation updateで確認すべきことは、単に「PR #314358がrevertした」という事実だけではありません。実務では、対象ブランチが#314358時点なのか、#314533以降なのかを見極めたうえで、依存関係、設定名、環境変数、テスト、ドキュメントを更新する必要があります。

まずは手元のリポジトリで、@anthropic-ai/claude-agent-sdk、chat.agentHost.claudeAgent.*、VSCODE_AGENT_HOST_*CLAUDE*、ClaudeAgentSession、sendMessageの参照を検索してください。そのうえで、記事や社内手順書には「2026年5月5日の#314358で一度revertされ、2026年5月6日の#314533でre-landされた」という時系列を明記すると、読者が現在の状態を判断しやすくなります。