Claude Code v2.1.198 — 背景エージェントが実装からコミットとドラフトPR作成まで自走する

Claude Code v2.1.198は、claude agentsで動く背景エージェントが、worktree(作業ツリー)でのコード作業を終えたときに、コミット・プッシュ・ドラフトプルリクエストの作成まで自動で進めるようになった版です。これまでは作業が一段落すると停止して確認を求めていましたが、本版では止まらずにレビュー待ちの状態まで運びます。あわせて、内蔵のExploreエージェントがメインセッションのモデルを継承(上限はOpus)するようになり、背景エージェントの入力待ち・完了を知らせる通知フックも加わりました。本稿では、これらが離席運用や探索フェーズの作業をどう変えるのかを、利用形態別の早見表と版差分のタイムラインで見ていきます。

このリリースで何ができるようになるか

この版でまず押さえたい変化は、背景エージェントの自動プルリクエスト作成、Exploreエージェントのモデル継承、そして背景エージェントの通知フックという3点です。いずれも「エージェントを起動して自分は別の作業に移る」使い方を後押しする方向の変更です。

1つ目は、背景エージェントの自律度が上がった点です。claude agentsで起動した背景エージェントは、worktreeでのコード作業が完了すると、コミット・プッシュ・ドラフトプルリクエストの作成までを自動で行います。従来は作業を終えると停止して人の確認を待っていましたが、本版ではレビューできる状態まで自分で運ぶため、確認の起点がプルリクエストの差分1か所に集約されます。

2つ目は、探索の質にかかわる変更です。コードベースを調べる内蔵のExploreエージェントが、これまでのhaiku固定から、メインセッションで使っているモデルの継承へ変わりました。継承の上限はOpusで、メインをOpusにしていれば探索も同じ水準のモデルで動きます。サブエージェントとコンテキスト圧縮も拡張思考(extended thinking)の設定を継承するようになり、委譲したタスクの出力品質が上がります。

3つ目は、離席したまま運用するための通知です。背景エージェントが入力を待つときと、作業を完了したときにNotificationフックが発火するようになりました。手元の通知の仕組みと組み合わせると、画面を見ていなくてもエージェントの状態を受け取れます。

あなたの開発フローはどう変わるか

効き方は使い方でかなり分かれます。背景エージェントを離席したまま回す人、大きなコードベースを探索する人、AWS上でClaude Platformやゲートウェイを使う企業環境の人ほど恩恵が大きく、ローカルで短いタスクを対話的に単発で回す使い方なら体感差は限られます。

離席運用や非同期の使い方をする人には、自動プルリクエスト作成と通知フックが効きます。エージェントを起動してから席を立っても、コード作業が終われば自動でドラフトプルリクエストまで作られ、完了はagent_completedで通知されます。戻ってきたときに見る場所が差分レビュー1か所に定まるため、途中経過を逐一追う必要が減ります。worktreeを使った並行作業の進め方は、worktreeの使い方をまとめたガイドもあわせて参照すると、作業ツリーの分離と自動プルリクエストの関係が把握しやすくなります。

探索フェーズの多い人には、Exploreエージェントのモデル継承が効きます。これまで探索はhaiku固定で、メインをOpusにしていても調査部分だけは軽いモデルで動いていました。本版ではメインのモデルを継承するため、探索の読み取り精度とトークンコストのバランスを、メインのモデル選択で一体的に決められます。深い調査が必要な場面ではOpusまで引き上げ、軽い確認では抑える、という調整がしやすくなります。

企業ネットワークやクラウド上で動かす人には、認証とゲートウェイまわりの手当てが効きます。ゲートウェイの上流プロバイダーにClaude Platform on AWS(識別子anthropicAws)が加わり、モデルが見つからない応答でのフェイルオーバーの連鎖が前進するようになりました。AWSやMantleのセッションでSTSトークンが失効したときにPlease run /loginで行き止まりになっていた問題も、awsAuthRefreshの自動実行で解消しています。

長時間の運用や継続的インテグレーション(CI)で回す人には、接続の安定化が効きます。応答の途中に短い切断が起きてもターンが中断しなくなり、ECONNRESETなどはバックオフを挟んで再試行されます。サンドボックスのプロセスが同じホストへ繰り返しアクセスしたときに、背景の分類器へのリクエストが過剰になる問題も直りました。日々の開発フロー全体の組み立ては、Claude Codeのワークフロー設計も参考になります。

主な変更点

この版は、背景エージェントの自律運用を中心に、探索の質・認証・接続の安定化・表示の修正が加わった構成です。テーマごとにまとめ、各項目に「誰に効くか」を1行添えます。

背景エージェントと自律運用

• 自動コミット・プッシュ・ドラフトプルリクエスト:claude agentsの背景エージェントが、worktreeでのコード作業完了時に、コミット・プッシュ・ドラフトプルリクエストの作成まで自動で進めます。従来は停止して確認を求めていました(離席したまま背景エージェントを回す人)。
• 通知フックの追加:入力待ちでagent_needs_input、完了でagent_completedが発火します(エージェントの状態を離席中に受け取りたい人)。
• サブエージェントへの指示の扱い:サブエージェントは起動元エージェントのメッセージを通常のタスク指示として扱います。ただしエージェントからのメッセージは、ユーザーの承認とは決して見なされません(エージェント同士を連携させて運用する人)。
• focus modeの改善:ターン内で起動したサブエージェントを活動サマリーに表示し、完了通知を1カウントに集約します(focus modeで並行作業を追う人)。
• /agentsウィザードの削除:サブエージェントの作成ウィザードは削除されました。サブエージェントはClaudeに依頼して作るか、.claude/agents/を直接編集して定義します(サブエージェントを新しく用意する人)。

探索とサブエージェントの品質

• Exploreエージェントのモデル継承:内蔵のExploreエージェントが、haiku固定からメインセッションのモデルの継承へ変わりました。継承の上限はOpusです(大きなコードベースを探索する人)。
• 拡張思考の継承:サブエージェントとコンテキスト圧縮が拡張思考(extended thinking)の設定を継承し、委譲タスクの出力品質が上がります(サブエージェントに重い作業を任せる人)。
• /datavizスキルの追加:チャートやダッシュボードの設計指針に加え、実行できるカラーパレット検証ツールが付きます(可視化の配色や設計を詰める人)。

認証・ゲートウェイ・企業ネットワーク

• ゲートウェイの上流プロバイダー追加:Claude Platform on AWS(識別子anthropicAws)が上流に加わり、モデルが見つからない応答でのフェイルオーバーの連鎖が前進します(ゲートウェイ経由で複数プロバイダーを束ねる人)。
• STSトークン失効の修正:AWSやMantleのセッションで、STSトークンが切れたときにPlease run /loginで行き止まりになる問題を、awsAuthRefreshの自動実行で直しました(AWS認証でClaude Codeを使う人)。
• ローカルネットワーク到達性の修正:macOSの背景エージェントがローカルネットワーク上のホストへ「no route to host」になる問題を、Local Networkの権限宣言で解消しました(社内ホストへ背景エージェントから接続する人)。

接続と再試行の安定化

• 短い切断でのターン継続:応答中の短い切断でターンが中断していた問題を直し、ECONNRESETなどはバックオフ付きで再試行します(不安定な回線や長い応答で作業する人)。
• サンドボックスの分類器負荷の修正:サンドボックスのプロセスが同じホストへ繰り返しアクセスしたときに、背景の分類器へのリクエストが過剰になる問題を直しました(サンドボックスで多数のアクセスを行う人)。
• 接続不能セッションの事前拒否:claude --bgと--print(-p)の併用で、接続できないセッションが黙って作られる問題を、競合するフラグの事前拒否で防ぎます(バッチ実行で背景セッションを組む人)。
• API再試行のUX改善:2回目以降の再試行でエラー理由を表示し、過負荷時にはステータスページへのリンクを出します(混雑時に再試行の状況を知りたい人)。

タスクパネルと表示の修正

• タスクパネルの停滞の修正:web・desktop・VS Codeのタスクパネルが、完了後や再開後に「Running」のまま固まる問題を直しました(タスクパネルで進捗を追う人)。
• エージェントチームの復帰:APIエラーで落ちたメンバーがリードに「failed」を報告し、停止したメンバーへのメッセージで即時に再試行します(エージェントチームで並行作業する人)。
• /diffパネルの更新:ブランチ切り替えやセッション外のコミットで/diffパネルが更新されない問題を直しました(/diffで差分を確認する人)。
• 「Reconnecting…」表示の修正:macOSでagentsビューを開いている間、約52秒ごとに「Reconnecting…」が出る問題を直しました(agentsビューを長く開く人)。
• 構文ハイライトの精度向上:highlight.jsを11へ更新し、構文ハイライトの精度が上がりました(コードを多く表示する人)。
• markdown表とURLの修正:フルスクリーンでmarkdown表の右境界がはみ出る問題と、macOSのWarpでCmd+クリックがURLを開かない・ダブルクリック選択がスキームを含むURL全体を選ぶ挙動を直しました(フルスクリーンやWarpで作業する人)。

エージェント運用まわりの細かい修正

• ワークフロー進捗ビューの修正:SDKとdesktopアプリで、ワークフローの進捗ビューが最古のエージェントを落とす問題を直しました(多数のエージェントを並べて追う人)。
• /desktopの作業ディレクトリ特定:worktreeへ出入りしたあとに/desktopが作業ディレクトリを特定できない問題を直しました(worktreeと/desktopを併用する人)。
• /branchの既定フォーク名:既定のフォーク名が圧縮要約由来になる問題を直し、最初の実プロンプト由来の名前になります(/branchでセッションを分ける人)。
• plan modeの自動許可:plan mode開始時に、読み取り専用のツール呼び出しが自動で許可されない問題を直しました(plan modeで計画を立てる人)。
• 条件付きルールの読み込み:.claude/rules/の条件付きルールが、symlink経由の対象ファイルで読み込まれない問題を直しました(symlinkでファイルを参照する人)。
• 操作系の細かい修正:claude attach <id>内で←を押すとシェルへ抜ける問題を直し、claude agentsビューから/loginでサインインダイアログが開くようにし、MacからSSH接続したときのショートカット表示をopt/cmdにしました(これらの操作を使う人)。

Claude in Chromeが一般提供(GA)を開始しました。更新後はバージョンを確認できます。

npm install -g @anthropic-ai/claude-code
claude --version

背景エージェントはclaude agentsから起動します。

claude agents

背景エージェントの自動PR自走で「離席したまま実装からレビュー待ちまで」が成立する

本版の中核は、背景エージェントが停止せずにドラフトプルリクエストまで作る点にあります。これまでの背景エージェントは、worktreeでのコード作業が一段落すると止まり、コミットするかどうかを人の判断に委ねていました。本版では、作業完了時にコミット・プッシュ・ドラフトプルリクエストの作成までを自動で行うため、人が関与する最初の地点が「プルリクエストの差分レビュー」に定まります。

この変化は、レビューの回数ではなく場所を変えます。作業の途中でエージェントの状態を何度も確認する運用から、完了通知を受けてから差分1か所を見る運用へ移ると、確認のための文脈の切り替えが減ります。通知フックのagent_needs_inputとagent_completedが加わったことで、待つべきタイミングと戻るべきタイミングを手元の通知で受け取れるため、離席や非同期の運用が現実的な形で組めるようになりました。

一方で、自動でプルリクエストが作られるということは、レビュー前のコードがブランチとプルリクエストに増えることも意味します。並行してエージェントを走らせるほど、レビュー待ちのプルリクエストや継続的インテグレーションの実行が積み上がるため、どれをいつ見るかという運用の設計は残ります。ここは各チームの体制次第で、効果の大きさが変わる部分だと読めそうです。

v2.1.195から本版までの版差分タイムライン

ここ数版で、運用に効く変更がどう積み上がってきたかを時系列で並べます。番号上の直前はv2.1.197(2026-06-30)で、v2.1.194はchangelogに掲載のない欠番です。

記事化された直前のClaude Code v2.1.197は、既定モデルをClaude Sonnet 5に切り替え、ネイティブで1Mトークンの文脈を扱えるようにした版でした。本版はそこから、モデルの土台の上でエージェントの自律度を上げ、探索に使うモデルも格上げする方向へ重心を移した版という流れで読めます。組織向けの統制を整えたClaude Code v2.1.196や、背景エージェントの信頼性を手当てしたClaude Code v2.1.195からの積み増しとして見ると、既定モデルの更新(v2.1.197、6月30日)と自律運用の強化(本版、7月1日)が相次いだ流れが見えてきます。なお、v2.1.194はchangelogに掲載がないため、この並びには含めていません。

利用形態別の影響早見表

自分の使い方でどの程度効くかは、次の早見表で確認できます。全員が一律に急いで動く種類の変更ではなく、利用形態ごとに濃淡が分かれます。

背景エージェントを離席・非同期で回す人と、大きなコードベースを探索する人にとっては、自動プルリクエスト作成とExploreエージェントのモデル継承という点で「明確な恩恵あり」に寄ります。AWS上でゲートウェイやClaude Platformを使う人は、anthropicAwsの追加やSTS失効の修正が効くかどうかが環境に依存するため「条件次第」に置いています。CIやサンドボックスで短い応答を多用する人も、短い切断の再試行や分類器負荷の修正が効く場面があるかどうかで濃淡が出ます。ローカルで慣れたタスクを対話的に単発で回すだけなら、自律運用や探索という前提に当てはまらず、体感の変化は小さくなります。

まとめ

Claude Code v2.1.198は、claude agentsで動く背景エージェントが、worktreeでのコード作業完了時にコミット・プッシュ・ドラフトプルリクエストの作成まで自動で進めるようになった版です。あわせて、ExploreエージェントがメインセッションのモデルをOpusまで継承し、入力待ちと完了を知らせる通知フックが加わりました。ゲートウェイへのClaude Platform on AWSの追加、STSトークン失効の修正、短い切断での再試行など、認証と接続の安定化も入っています。

背景エージェントを離席したまま回す人には、自動プルリクエスト作成と通知フックで、確認の起点を差分レビュー1か所へ寄せられる点に更新の価値があります。大きなコードベースを探索する人には、Exploreエージェントのモデル継承が探索の質とコストの調整をしやすくします。AWS上でゲートウェイやClaude Platformを使う人は、anthropicAwsの追加やSTS失効の修正が自分の環境に該当するかを確認すると、認証の引っかかりが解消する場合があります。ローカルで短いタスクを単発で回すだけなら体感差は小さいため、手の空いたタイミングでの更新で問題ありません。既定モデルの更新から自律運用の強化までは前版v2.1.197からの流れの延長として読め、運用視点で追ってきた人はまとめて確認する価値があります。Claude Code全体の使い方はClaude Code完全ガイドを参照してください。