Claude Code v2.1.147 — マルチエージェントを決まった手順で動かすWorkflowツールを追加

⚠️ forceLoginOrgUUID と forceLoginMethod の管理設定(managed-settings)でログイン先の組織やログイン方法を制限している企業環境では、これまでサードパーティプロバイダ経由のセッションとAPIキーのセッションに対してこの制限が効いていませんでした。本版でこの2種類のセッションにもログイン制限が適用されます。管理設定でログインを縛っているチームでは、本版以降で想定どおりに制限が機能します。

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

Claude Code v2.1.147は、マルチエージェントを決まった手順で動かす「Workflow」ツールを追加し、これまでの /simplify をコードレビュー用の /code-review コマンドへ刷新した版です。直前のv2.1.145が claude agents --json でバックグラウンドセッション群を外部ツールから扱えるようにした版だったのに対し、本版はマルチエージェント運用そのものの組み立て方に踏み込み、あわせてサンドボックスとログイン制御を固めた版です。

読者の体験を直接変える主な変更は次の3つです。

• マルチエージェントを決まった手順で動かす「Workflow」ツールが追加されます:複数のエージェントを定型の手順で編成する Workflow ツールが入りました。既定では無効で、環境変数 CLAUDE_CODE_WORKFLOWS=1 を設定すると有効になります。Claudeがその場の判断でサブエージェントを振り分ける従来のAgentツールに対し、Workflowツールは「決定論的(deterministic)」な編成、つまり同じ入力なら同じ手順をたどる組み立てを担うものとして追加されました
• /simplify がコードレビュー用の /code-review コマンドに刷新されます:コマンド名が /simplify から /code-review に変わり、指定したエフォートレベル(例:/code-review high)でコードの正しさに関わる不具合(correctness bug)を報告するようになります。--comment を付けるとGitHubのプルリクエストにインラインコメントとして指摘を投稿できます。旧来の「整理して修正する(cleanup-and-fix)」挙動は削除されました
• ピン留めしたバックグラウンドセッションがアイドル時も生き続けます:claude agents で Ctrl+T を押してピン留めしたバックグラウンドセッションは、アイドル状態になっても終了せず生存し続けます。Claude Code本体の更新はその場で(in-place)再起動して適用され、メモリ逼迫時に解放される対象も、ピン留めしていないセッションをすべて解放したあとに回されます

加えて、REPLとWorkflowツールのサンドボックスがプロトタイプ汚染(prototype pollution)とthenableベースの脱出に対して強化され、自動アップデータが一時的なネットワーク障害をリトライするようになるなど、実行基盤の安全性と更新の確実性まわりの改善が入っています。

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

マルチエージェントを定型の手順で回したい場合

本版で最も大きな追加が Workflow ツールです。これまでClaude Codeでマルチエージェントを動かす経路はAgentツールでした。Agentツールは、Claudeがその場の文脈から「どのサブエージェントに何を任せるか」を判断して振り分ける仕組みで、柔軟な一方、同じ依頼でも実行のたびに段取りが変わりえます。

Workflow ツールは、changelogが「決定論的なマルチエージェント編成(deterministic multi-agent orchestration)」と説明しているとおり、段取りそのものを定義しておき、同じ入力なら同じ順序でエージェントを動かす方向の仕組みとして追加されました。検証パイプラインやリリース前チェックのように「毎回同じ手順を踏みたい」運用と相性がよい仕組みと読めそうです。

ただし Workflow ツールは既定で無効です。試すには環境変数 CLAUDE_CODE_WORKFLOWS=1 を設定する必要があります。既定オフという扱いは、本版時点では実験的な位置付けであることを示しています。マルチエージェント運用を組んでいるチームは、まず検証環境で CLAUDE_CODE_WORKFLOWS=1 を立てて挙動を確かめる、という入り方ができます。

/simplify でコードを整理していた場合

これまで /simplify を使っていた場合、本版ではコマンド名自体が /code-review に変わり、挙動も入れ替わっている点に注意が必要です。

旧 /simplify は「コードを整理して修正する」コマンドでしたが、その整理・修正の挙動は削除されました。新しい /code-review は、指定したエフォートレベルでコードの正しさに関わる不具合を報告するコマンドです。/code-review high のようにエフォートを指定でき、--comment を付けるとGitHubのプルリクエストに指摘をインラインコメントとして直接投稿できます。

つまり、コマンドの役割が「整形・修正の実行」から「不具合の検出と報告」に変わりました。/simplify をスクリプトやドキュメント、チームの手順書に組み込んでいた場合は、コマンド名の置き換えに加えて、期待していた「修正まで実行する」挙動が無くなっている点を踏まえて運用を見直す形になります。

バックグラウンドセッションを常駐させたい場合

v2.1.139でエージェントビューが追加されて以降、バックグラウンドセッションは版を追うごとに対話セッションと統合されてきました。本版では、claude agents で Ctrl+T を押してピン留めしたセッションの扱いが変わります。

ピン留めしたセッションは、アイドル状態になっても自動終了せず生き続けます。Claude Code本体のアップデートが入ったときは、ピン留めセッションをその場で再起動して新しいバージョンを適用します。マシンのメモリが逼迫したときも、まずピン留めしていないセッションから解放され、ピン留めセッションは最後まで残されます。

長時間動かし続けたい監視ジョブや、いつでもアタッチして続きを頼みたい常駐セッションを、Ctrl+T で明示的に「残す」と指定できるようになります。

企業の管理設定でログインを縛っている場合

forceLoginOrgUUID(ログイン先の組織を固定する管理設定)と forceLoginMethod(ログイン方法を固定する管理設定)で従業員のログインを制限している企業環境では、本版に重要な修正が入っています。

これまで、この2つの管理設定は、サードパーティプロバイダ経由のセッションとAPIキーで認証するセッションに対しては効いていませんでした。管理設定でログイン先組織やログイン方法を固定していても、これらの経路ではその制限を回避してセッションを開始できる状態でした。本版でこの2種類のセッションにも制限が適用され、管理設定で意図したとおりにログインが縛られます。管理設定でのアクセス統制を前提に導入しているチームでは、本版以降で統制が想定どおりに機能します。

自動アップデートが失敗していた場合

自動アップデータが改善され、一時的なネットワーク障害が起きたときにリトライするようになりました。更新に失敗したときは、エラーの種類とOSのエラーコードを具体的に表示し、あわせて現在のバージョンも示すようになります。

これまでは、回線が不安定な環境やプロキシ越しの環境で自動更新が静かに失敗し、原因が分かりにくいことがありました。本版では、失敗時にどの段階でどんなエラーが起きたかを読み取れるため、社内ネットワークやVPN越しの環境で更新が通らないときの切り分けがしやすくなります。

ヘッドレス / SDKモードで使っている場合

ヘッドレスモードやSDK経由でClaude Codeを使っている場合、いくつかの修正が効きます。これまでヘッドレス / SDKモードでは、存在しないスラッシュコマンドを送ると何も起きずに無言で処理が進んでいましたが、本版ではエラーメッセージが表示されるようになります。スクリプトでコマンド名を間違えたときに、原因不明のまま進む状況が減ります。

あわせて、Agent SDK経由でストリーミングセッションを実行したとき、セッション終了時にキャッチされない例外が出ていた問題が修正されました。SDKでClaude Codeを組み込んでいる場合に、終了処理がより安定します。

WindowsとPowerShellで使っている場合

Windows環境とPowerShellツールまわりの修正が複数入っています。フックの if 条件で PowerShell(git push*) のようなパターンが一切マッチせず、PowerShell(*) しか機能しなかった問題が修正されました。wingetまたはMicrosoft Store経由で pwsh を入れている環境で、PowerShellツールが終了コード1で失敗していた問題も解消されています。

このほか、Windowsで「はい、次回から確認しない」をPowerShellスクリプトの実行に対して選んだとき、以降の実行で実際にマッチするルールが書き込まれるようになり、バックグラウンドジョブのワークツリーを削除する際にNTFSジャンクションをたどってメインリポジトリ側まで削除しに行かない修正も入りました。

主な変更点

追加・改善

• Workflow ツールを追加 — 決定論的なマルチエージェント編成を担うツール。既定で無効、CLAUDE_CODE_WORKFLOWS=1 で有効化。Claudeがその場で振り分ける従来のAgentツールに対し、定型の手順で複数エージェントを動かす用途向け
• /simplify を /code-review に刷新 — 指定したエフォートレベル(例:/code-review high)でコードの正しさに関わる不具合を報告。--comment でGitHubプルリクエストにインラインコメント投稿。旧来の整理・修正挙動は削除
• ピン留めしたバックグラウンドセッションの常駐化 — claude agents で Ctrl+T でピン留めしたセッションは、アイドル時も生存、更新はその場で再起動して適用、メモリ逼迫時は非ピン留めセッションを解放したあとに回される
• 自動アップデータの改善 — 一時的なネットワーク障害をリトライ、失敗時にエラーの種類とOSエラーコードを表示、更新失敗時に現在のバージョンも表示
• 大きいファイル編集のdiff描画性能を改善
• プロンプト履歴が連続する重複を記録しないように — 上矢印で呼び出したプロンプトをそのまま送信し直しても、履歴にもう1件複製が増えない

主な修正(セキュリティ)

• 企業向けログイン制限の適用漏れを修正 — forceLoginOrgUUID と forceLoginMethod の管理設定が、サードパーティプロバイダ経由のセッションとAPIキーのセッションに対して適用されていなかった問題を修正
• REPLとWorkflowツールのサンドボックスを強化 — プロトタイプ汚染(prototype pollution)と、thenableを使ったサンドボックス脱出への対策を追加

主な修正(Windows / PowerShell)

• フックの if 条件で PowerShell(git push*) のようなパターンが一切マッチせず、PowerShell(*) しか機能しなかった問題を修正
• PowerShellツールが、既定のフォーマッタに依存するコマンドの出力を取りこぼしていた問題を修正
• Windowsで「はい、次回から確認しない」をPowerShellスクリプトの実行に対して選んだとき、以降の実行で実際にマッチするルールが書き込まれるように
• wingetまたはMicrosoft Store経由で pwsh を入れた環境で、PowerShellツールが終了コード1で失敗していた問題を修正
• バックグラウンドジョブのワークツリー削除時に、NTFSジャンクションをたどってメインリポジトリ側まで削除しに行かない修正(Windows)
• Windows Terminalでアタッチ中のバックグラウンドセッションが、Claudeのストリーミング中に全画面で明滅する問題を修正

主な修正(その他)

• ヘッドレス / SDKモードで、存在しないスラッシュコマンドが無言で何もしなかった問題を修正。エラーメッセージを表示するように
• Agent SDK経由のストリーミングセッションで、終了時にキャッチされない例外が出ていた問題を修正
• 自動モードが、ユーザーやスキルが明示的に頼っている場合でも AskUserQuestion を抑制していた問題を修正。自動モードの分類器がユーザーの回答を意図のシグナルとして見るように
• バックグラウンドセッションが、「次回から確認しない」で既に許可したツール権限を再度確認していた問題を修正
• 貼り付けたテキストが、実際の内容ではなく [Pasted text #N] というプレースホルダのままエージェントに渡っていた問題を修正
• ページングするMCPサーバで、2ページ目以降のリソース・テンプレート・プロンプトが取りこぼされていた問題を修正
• プラグインのエージェントが tools: フロントマターで複数の Agent(...) 型を宣言したとき、最後の1件以外がすべて落ちていた問題を修正
• /effort がスライダーを誤った位置で開いていた問題を修正。現在のエフォートの位置で開くように
• /help が小さいターミナルでタブヘッダを崩し、1ページに1コマンドしか表示しなかった問題を修正
• 単一のアンダースコアで始まる名前のユーザー定義関数を、シェルのスナップショットが取りこぼしていた問題を修正(その関数を参照するエイリアスが壊れていた)

v2.1.145とv2.1.147を機能体験で並べると何が違うか

番号上の直前にあたるv2.1.146は欠番のため、changelog上の直前はv2.1.145です。v2.1.145は claude agents --json でバックグラウンドセッション群を外部ツールから機械的に扱えるようにし、Bashコマンドの環境変数代入による権限プロンプトのバイパスを塞いだ版でした。本版v2.1.147は、そのマルチエージェント運用に対して編成の組み立て方そのもの(Workflow ツール)を加え、コードレビューのコマンドを刷新し、サンドボックスとログイン制御を固めた版です。

v2.1.145が「マルチエージェントのセッション群を外側から観測・操作する口」を開けた版だったのに対し、本版v2.1.147は「マルチエージェントの動かし方そのものを定義する口」を Workflow ツールとして開けた版と読めそうです。観測の口(--json)と編成の口(Workflow)が前後する版で揃ったことで、マルチエージェント運用が「組んで・動かして・外から見る」の3要素を持つ方向に進んでいると言えそうです。

運用形態別の影響度早見表

本版の変更が利用形態別にどの程度効くかを示すと、次のとおりです。

特に /simplify をチームの手順書やスクリプトに組み込んでいた運用は、コマンド名と挙動の両方が変わるため、本版で確認が必要です。Workflow ツールに関心があるチームは、既定オフの実験的機能である点を踏まえ、まず検証環境で CLAUDE_CODE_WORKFLOWS=1 を立てて挙動を確かめる入り方になります。

Workflowツールの追加はマルチエージェント運用を何に変えるか

本版の Workflow ツール追加は、単体の機能追加以上に、Claude Codeのマルチエージェント運用の設計思想に関わる動きと読めそうです。

これまでClaude Codeでマルチエージェントを動かす仕組みは、Agentツールによる「Claudeがその場で判断して振り分ける」モデルが中心でした。柔軟である一方、同じ依頼でも実行のたびに段取りや呼び出すサブエージェントが変わりえます。試行錯誤のフェーズや探索的なタスクには向きますが、CIの検証パイプラインやリリース前チェックのように「毎回まったく同じ手順を踏みたい」運用では、再現性の低さが扱いにくさになります。

Workflow ツールは、この再現性の問題に「決定論的な編成」という形で応えるものと位置付けられます。changelogの説明は短く、本版時点では既定で無効の実験的機能ですが、「同じ入力なら同じ手順をたどる」編成を公式の仕組みとして提供する方向が示されたことには意味があります。エージェントの判断に任せる柔軟な編成(Agentツール)と、手順を固定する再現性重視の編成(Workflow ツール)を、用途で使い分けられる設計に進む布石と見ることもできます。

v2.1.139のエージェントビュー、v2.1.145の claude agents --json と続いてきたバックグラウンド・マルチエージェントまわりの整備の流れに、本版の Workflow ツールが「編成の定義」という層を加えた格好です。あわせてREPLとWorkflowツールのサンドボックスがプロトタイプ汚染とthenableベースの脱出に対して強化された点も、複数エージェントやコード実行を安全に重ねて動かす基盤を固める動きとして同じ方向を向いていると言えそうです。

まとめ

Claude Code v2.1.147は、マルチエージェントを決まった手順で動かす Workflow ツールを追加し、/simplify をコードレビュー用の /code-review コマンドへ刷新した版です。Workflow ツールは既定で無効で、CLAUDE_CODE_WORKFLOWS=1 を設定すると有効になります。これに加えて、Ctrl+T でピン留めしたバックグラウンドセッションがアイドル時も生存して更新も自動適用されるようになり、企業向けのログイン制限がサードパーティ / APIキーのセッションにも適用され、REPLとWorkflowツールのサンドボックスがプロトタイプ汚染とthenableベースの脱出に対して強化されています。

マルチエージェントを定型フローで運用しているチーム、/simplify を手順に組み込んでいたチーム、バックグラウンドセッションを常駐させたいチーム、管理設定でログインを統制している企業では、本版で運用の前提が動きます。特に /simplify を使っていた場合は、コマンド名と挙動の両方が変わるため、本版での確認が必要です。直前のv2.1.145がマルチエージェントのセッション群を外部から扱える口を開けた流れを、本版v2.1.147は「編成そのものを定義する口」まで広げた版と読めそうです。更新は claude update で取得でき、claude --version で 2.1.147 になっていれば本版の変更が反映されています。