Claude Code v2.1.232 — fork既定化とセッション間連携の強化

Claude Code v2.1.232は、対話セッションでのサブエージェントforkを既定onに切り替えた更新です。fork既定化は、対話・非対話・Agent SDKで扱いが分かれます。あわせて、「@」メンションによるセッション間連携の強化点と、WindowsからLinuxサンドボックスにまたがる権限修正の束も扱います。

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

対話セッションでは、サブエージェントforkが既定で有効になりました。subagent_type: "fork"のサブエージェントは会話全体とプロンプトキャッシュを引き継ぎます。同じ文脈を使う並列タスクが安く回せます。forkモードが有効な場合、エージェントチーム(agent team)のteammate以外が起動したサブエージェントはバックグラウンドで動作し、Claudeがフォアグラウンド実行を求めることはできません。

「@」でセッションを名指しして送れるようになりました。入力途中の候補から選べばClaudeがSendMessageで直接送信するため、セッションIDを調べたりrefで確認したりする手間が減ります。同じ名前のセッションが複数動いている場合は、送信前にどちらが宛先か確認されます。

PowerShellやGit Bash、ネストしたgitリポジトリの信頼継承など、権限・サンドボックス周りの穴が6件塞がれました。GitLabのトークン系列も伏せ字対応の対象に加わっています。

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

利用形態によって、今回の変更の効き方は大きく分かれます。

個人でサブエージェントを多用する場合

forkを使った並列実行が、これまでより軽く感じられるはずです。プロンプトキャッシュを親セッションと共有するため、同じCLAUDE.mdやツール定義を読み直すコストが乗りません。v2.1.232より前のバージョンでは、この既定onの恩恵を受けるために環境変数の設定が必要でした。

# v2.1.232より前のバージョンで対話セッションのforkを既定onにする場合
export CLAUDE_CODE_FORK_SUBAGENT=1

v2.1.232以降はこの設定なしで対話セッションのforkが既定onになります。

CIや-pで自動化を回している場合

-p実行やAgent SDKでforkを使いたい場合は、CLAUDE_CODE_FORK_SUBAGENT=1をCI側の環境変数に追加する必要があります。

複数マシンやRemote Controlを併用している場合

セッション名の衝突が自動で解消されるようになりました。後発のセッションに別名が自動で付き、その旨が通知されます。Remote Controlも、外出先からの接続が途切れがちな環境で切断されにくくなりました。

PowerShellやGit Bashを使っている場合

PowerShellツールは、Windowsのほか、PowerShell 7以上を入れたLinux・macOS・WSLでも動きます。修正内容は下の「権限・サンドボックスの修正」にまとめています。

GitLabでプラグインマーケットプレイスを運用している場合

使っている場合は、伏せ字対応の対象に加わったトークン系列を、CIのログ出力設定と合わせて確認しておくと安心です。詳細は下の「GitLab対応とマーケットプレイス管理」にまとめています。

主な変更点

v2.1.232で変わったサブエージェントforkの既定値

起動方式によって、コンテキストとプロンプトキャッシュの扱いが変わります。

バックグラウンドで動くサブエージェントは使えるツールが絞られますが、forkはこの制限を受けません。ただしfork自体はさらにforkを起動できません。forkモードがoffの場合は、個別のサブエージェント側でbackground: trueを指定すると、Claudeが結果を待ちたい場面でもバックグラウンドのまま動かせます。forkモードがonのときはClaudeが起動するサブエージェントがすでにバックグラウンドで動くため、この指定の効果はありません。ただしCLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1を設定した場合と、同一プロセス内のagent teamのteammateがサブエージェントを起動した場合は、forkモードでもフォアグラウンドで動きます。

forkはシステムプロンプトとツール定義が親と同一なので、最初のリクエストから親のプロンプトキャッシュをそのまま使えます。同じ文脈が必要なタスクを新規サブエージェントで都度立ち上げるより、安く済む理由です。

既定onになるのは対話セッションだけです。非対話の-p実行とAgent SDKでは引き続きoffで、明示的な設定が必要です。サブエージェントの定義方法や並列実行の設計はClaude Code Sub-agents完全ガイドにまとめています。

既定onを解除したい場合は、CLAUDE_CODE_FORK_SUBAGENT=0を設定するとセッション種別を問わずforkモードがoffになります。forkモード自体は保ちたい場合は、Agent(fork)を拒否ルールに加える方法もあります。Claudeが自発的にforkを起動しなくなり、サブエージェントはバックグラウンドで動き続けます。なお/subtaskにタスクを続けて入力すれば、forkモードのon/offに関わらず自分でforkを起動できます。

セッション間メッセージングの運用強化

クロスセッションメッセージング自体はv2.1.224で導入済みです。v2.1.232が足したのは、セッションを名指しする手間を減らす運用面の機能群です。

プロンプトで「@」を入力し、続けてセッション名の頭文字を入れると、このマシン上で動いている他のセッションが候補に出ます。「@」だけではセッションの候補は出ません。1文字入れてはじめて一覧が開きます。クラウドやRemote Controlのセッションは、Claudeが一度それらを一覧に出すか、宛先として送信したあとで候補に加わります。候補から選ぶと、ClaudeがSendMessageでそのセッションへ直接送信します。

SendMessage自体の挙動も変わりました。宛先名が動いているセッションのちょうど1つに一致する場合は、これまでのようにrefでの確認を挟まず、そのまま送信されます。同じ名前のセッションが複数動いている場合だけ、どちらが宛先か確認が入ります。

同じマシンで同名のセッションが重ならないようにもなりました。セッションを起動またはリネームしようとした名前がすでに使われている場合、新しい方にはname-word-word形式の別名が付き、変更があった旨が伝えられます。

/configには「Dialog expiry」と「Messages from your other sessions」という行が追加されました。「Dialog expiry」は、セッション間メッセージの確認ダイアログが応答なしで自動的に閉じるまでの時間です。既定値は5分です。応答がないままこの時間を過ぎるとダイアログは閉じ、届いたメッセージは破棄されます。ただしバックグラウンドセッションに端末が未接続の間はこの期限を過ぎてもダイアログは開いたままで、接続したあと、無応答のまま期限いっぱいが経過した場合にだけ閉じ、メッセージが破棄されます。受理する値は"60s"・"5m"・"10m"・"never"の4種類で、"never"を指定すると期限なしにできます。「Dialog expiry」の設定はuser設定・managed settings・--settingsフラグの3経路から読み込まれ、CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS環境変数でも上書きできます。

「Messages from your other sessions」は、他セッションからのメッセージを受け入れる・保留する・拒否するかを設定する行です。どちらの行も、--settingsフラグやmanaged settingsでそのキーが指定されている間は表示されません。

/config

あわせて、Coworkセッションはユーザースコープのメモリーファイルにある外部の「@」インポートを、これ以降インラインで取り込まなくなりました。セッション間メッセージングの基本的な使い方はClaude Code SendMessageで複数マシンのエージェントを連携するで解説しています。

権限・サンドボックスの修正

PowerShellのパラメータ経由で$PSDefaultParameterValuesを書き換え、後続コマンドのファイルアクセス先をひそかに変える手口が塞がれました。Git BashがCygwin形式のシンボリックリンクを通常ファイルと誤認して書き込みを許していた挙動も、あわせて修正されています。ネストしたgitリポジトリは、これまで親ディレクトリの信頼設定をそのまま継承していましたが、今後はリポジトリごとに個別の信頼確認が必要です。Bashの< fileによるリダイレクトも、引数で渡すファイルパスと同じ権限チェックを全プラットフォームで受けるようになりました。

このほか、sandbox.ripgrepの上書き元がuser・managed・--settingsの3経路に限定され、project設定では変更できなくなりました。managed settingsの承認ダイアログも、次の3点が改善されています。

• エンドポイントURLの表示
• テレメトリー周りの文言
• 定型的なOpenTelemetry設定では確認を省略

sandbox.bwrapPath・sandbox.socatPath・sandbox.ripgrepをサーバー管理側で上書きする場合は、承認が必須になりました。

個人・チーム・企業でのセキュリティ設定の使い分けはClaude Codeセキュリティ・権限ガイドにまとめています。

GitLab対応とマーケットプレイス管理

GitLabのトークン系列(glrt-、gloas-、glptt-、glagent-、glimt-、glsoat-、glcbt-、glft-、glffct-)が伏せ字対応の対象になりました。ルーティング可能なglpat-・gldt-は全体伏せ字です。glab CLIの設定ストアもghと同じサンドボックス・資格情報パス保護を受けます。

プラグインマーケットプレイスもGitLabに対応しました。gitlab.com上の素のリポジトリURLは、ネストしたサブグループを含めてgithub.comと同じようにクローンできます。クローンに失敗したときのヒントも、実際のgitホスト名で表示されるようになりました。

/plugin marketplace add https://gitlab.com/company/plugins.git

設定キーの別名も追加されました。additionalMarketplacesはextraKnownMarketplaces、allowedMarketplacesはstrictKnownMarketplacesの分かりやすい別名として使えます。エンタープライズ側では、blockedMarketplacesに素のリポジトリURLを指定すると、CLIがそれをgit cloneと分類した場合にブロックが効くようになりました。

マーケットプレイスの追加・信頼設定の基本はClaude Codeプラグイン(Plugins)完全ガイドで扱っています。

Remote Controlの信頼性改善

Remote Controlまわりは8件の修正が入りました。ネットワークが不安定なときの挙動が中心です。

• 接続が途切れても約30分は再接続を試み続けるようになり、1時間の間に何度か途切れても切断されにくくなった
• claude.aiやアプリ側でセッションが削除された状態から会話を再開しようとすると、ログインエラーで失敗する代わりに新しいセッションを開始する(v2.1.227で入ったリグレッションの修正)
• クラウドセッション内の、ブリッジ経由のRemote Controlセッションが、そのクラウドセッションの会話履歴や資格情報を引き継いでしまう問題を修正
• Claude DesktopやIDEから始めたRemote Controlセッションは、ローカルセッションを再開するたびclaude.ai上で新規セッション扱いになっていた。修正後は既存セッションへ再接続するように変更
• アイドル中のRemote Controlセッションが新規接続クライアントから到達不能に見える問題を修正
• ブリッジ経由のRemote Controlセッションで、セッションワーカー再起動時に会話履歴が復元されない問題を修正
• 会話再開時に、同じマシンの別のClaude CodeからRemote Controlをひそかに奪わなくなった(移したい場合は元のセッションで/remote-controlを実行)
• 端末側の表示が改善され、セッションが別デバイスに奪われたか・別アプリから終了したか・削除されたかを区別して表示し、それを取り消す再接続の提案もしなくなった

Gatewayとエンタープライズ設定

Gatewayのdesktop:オーバーレイは、これまで手作業でリストしていた11個の設定キーだけに限定されていました。今回からは、リリース済みのDesktop設定すべてを受け付けるようになりました。起動時にDesktop自身のスキーマで検証され、未知のキーや不正な値があれば起動が失敗します。

managed.policies[].match.groupsやadmin.admin_groupsが空のとき、あるいはemail_domainが空や@・空白・カンマを含む不正な値のときがあります。これまでは、こうした設定でも誰にも一致しない、あるいは意図せず管理者権限を与えてしまう挙動でした。今回からは、こうした設定ミスがあると起動時に失敗するようになりました。

Fable 5とそのほかの改善

Fableへのアクセスを持つ組織では、/advisorから再びFable 5を選べます。利用クレジットの同意は/model fableから設定します。

• /code-reviewのhigh・xhigh・max effortが、ほかのeffortと同じくバックグラウンドエージェントで動くように変更
• /plugin install plugin@marketplace実行時にマーケットプレイスを先に更新するようになり、新しく公開されたプラグインが手動更新なしにインストールできる
• /feedbackと/bugが、Claudeが応答中でもターン終了を待たずすぐ開くように変更
• フルスクリーンストリーミングを改善し、会話全体を毎回再正規化しなくなったことで長いセッションでも操作が重くなりにくい
• MCPサーバーがプロトコルバージョンの確認に応答しない・不正な返答を送る場合、30秒のタイムアウトいっぱいまで固まっていた問題を修正
• mTLSクライアント証明書をローテーションすると再起動が必要だった問題を解消し、接続エラー時にはローテーション後の証明書と鍵を自動で読み込むようになった
• AWSやVertexで不正なリージョン値がそのままリクエストURLに使われていたバグを直し、既定リージョンへ自動でフォールバックする挙動に改めた
• Bedrock・Vertex・Gateway経由のデプロイでは、ストリームのアイドルタイムアウトを即座にリクエスト失敗として扱っていた挙動を見直し、回復を試みる仕様にした
• 完了したサブエージェントがエージェントパネルからすぐ隠れるようになり、/tasksを案内するフッターと「↓N件」の表示位置も見やすく調整
• 貼り付け・クリップボード画像の読み込みがイベントループをブロックしなくなった
• バックグラウンドエージェントを再開したときのメッセージが短縮
• カスタムサブエージェント作成を促す起動時のヒントと/powerupツアー内の案内を削除

細かな修正

• Cloud Gatewayの/loginは、managed settingsの読み込みに失敗するとエラーを出さずに終了したり「Press Enterで続行」のあと反応しなくなったりしていた。修正後は失敗理由を表示するようになった
• ネイティブビルドの音声モードは、音声サービスに接続を拒否されると「listening…」の表示のまま固まっていたが、これを直し拒否をすぐ表示するようにした
• コンテンツサイズに合わせたオーバーレイでは、切り詰めたテキストが1列分広くレンダリングされる不具合と、先頭切り詰めのテキストが省略記号だけに潰れる不具合を解消した
• 長いシェルコマンドやエージェント説明のプレビューで、絵文字の途中に文字列が切れて文字化けする不具合も直った
• known_marketplaces.jsonへの同時書き込みが起動時のレースコンディションを招き、プラグインマーケットプレイスが気づかないうちに登録解除されることがあった問題はなくなった
• 再起動をまたいでも続く作業があるとき、/updateと/tuiが再起動を拒否していた挙動を改めた
• SDKやリモートセッションで、使用量上限に達したときの案内が使えないスラッシュコマンドを勧めてしまう問題があったが、これも直した
• 対話的な--advisor fable起動時の同意メッセージが、すでに終了した対話セッションへ向けて/model fableの実行を促していた食い違いを修正した

fork既定化は、対話と自動化でコストをどう変えるか

対話セッションだけforkを既定onにしたのは、線引きが明快だからです。人が画面の前でサブエージェントの動きを見ながら使う対話セッションでは、プロンプトキャッシュ共有によるコスト削減を優先します。CIやSDK経由の自動化では、既存のワークフローが暗黙に依存している「毎回新規コンテキストで動く」という前提を崩さない選択です。

実務上の効きどころは、対話でどれだけ並列サブエージェントを回しているかで変わります。単発のコード生成や調査を1回ずつ頼む使い方では、fork既定化の恩恵はほとんど体感できません。一方、探索・実装・レビューを次々起動する使い方では、プロンプトを読み直すコストが目に見えて減ります。この効き方の差がどれだけ大きいかは、実測での検証が必要です。

もう一点、非teammateのエージェント起動が対話セッションでも既定でバックグラウンド実行になった点は見落とされがちです。Claudeはフォアグラウンド実行を求められなくなったため、画面を占有せず複数のサブエージェントが同時に動く前提へと運用が寄っています。v2.1.232より前はCLAUDE_CODE_FORK_SUBAGENT=1が要ったため、その前提で組んだ手順書やチーム内の共有メモは読み替えが必要です。

まとめ

v2.1.232の中心は、対話セッションでのサブエージェントfork既定化、セッション間メッセージングの運用機能、そして権限・サンドボックス周りの修正の3つです。fork既定化は対話セッションだけが対象です。

PowerShellやGit Bashを使っている場合は、権限バイパスの修正が直接効きます。複数マシンやRemote Controlを併用しているチームは、セッション再アタッチの改善で切断のストレスが減るはずです。GitLabでマーケットプレイスを運用している組織は、トークン伏せ字対応とURL指定の挙動を確認しておくと安心です。

関連ガイド

• Claude Code完全ガイド