【実測】Claude Codeのサブエージェントが会話を引き継ぐ｜v2.1.232のfork既定ONと-pで効かない話

2026年8月14日に公開されたClaude Code v2.1.232に、こんな一行が入りました。

サブエージェントの「fork」が既定でオンになった、という意味です。ただしこの一行だけでは、何が変わるのか、自分に関係あるのかが分かりません。

実際に手元で動かして確かめたところ、この変更が効くのはインタラクティブなセッションだけで、-p をつけた自動実行では既定のままオフでした。そして検証の途中で、自分の実験そのものが汚染されていたことにも気づきました。

この記事では、実際に測った数字と、途中で踏んだ失敗をそのまま書きます。

forkとは何か

まず言葉の整理からです。

サブエージェントは、脇道の作業を別の文脈で片付けてもらう仕組みです。調査やログ読みを任せると、その過程は本体の会話に流れ込まず、結果だけが返ってきます。会話が汚れずに済むのが利点です。

ただし裏返しの弱点があります。サブエージェントは白紙の状態から始まるので、これまでの経緯を知りません。「さっき話した設計方針で実装して」と頼んでも、その方針を知らないのです。毎回ゼロから説明し直すことになります。

forkはこの弱点を消します。公式ドキュメントにはこう書かれています。

これまでの会話をまるごと引き継ぐサブエージェント、ということです。同じシステムプロンプト、同じツール、同じモデル、同じメッセージ履歴を持った状態で始まります。それでいて、forkの作業過程は本体の会話には入らず、最終結果だけが返ってきます。

つまり「経緯を知っているのに、作業の記録は持ち込まない」という都合のいい存在です。

実際に引き継ぐのか、確かめた

説明を読むだけでは腑に落ちなかったので、実際に動かしました。

やり方はこうです。まずセッションを1つ作り、そこで合言葉を伝えます。次に同じセッションからサブエージェントを起動し、「知っている合言葉を答えて」とだけ聞きます。合言葉そのものは指示に含めません。引き継いでいれば答えられるはずです。

最初にやったとき、結果はこうなりました。

forkのサブエージェントは合言葉を答えました。ここまでは想定どおりです。ところが比較のために起動した通常のサブエージェントも、同じように答えてしまいました。おかしい。白紙から始まるはずなのに、なぜ知っているのか。

念のため、合言葉をひとことも伝えていない新しいセッションでも試しました。そこでも答えました。

ここでようやく、実験の前提が壊れていることに気づきました。

自分の実験を汚染していた

原因を探すため、合言葉を含むファイルを検索しました。

すると、こんなファイルが出てきました。

~/.claude/projects/-private-tmp/memory/passphrase_ajisai7841.md

最初に「覚えてください」と頼んだとき、Claude Codeがファイルに保存していたのです。中身は「合言葉は「紫陽花7841」。」の一行でした。

インデックスにも追記されていました。つまり2回目以降は、forkだろうと通常のサブエージェントだろうと新しいセッションだろうと、全員がこのファイルを読んで答えていたわけです。会話を引き継いだのではなく、単にメモを読んでいただけでした。

「覚えて」と言えばファイルに書く。考えてみれば自然な挙動です。ただ、検証の文脈ではこれが交絡になります。測りたかったのは会話の引き継ぎなのに、測っていたのはファイルの読み込みでした。

危ないのは、最初の結果だけ見ていれば「forkは会話を引き継ぐ、実証できた」と結論できてしまったことです。しかもその結論は、たまたま正しい。正しい結論に間違った根拠でたどり着いていたことになります。

条件を揃えて測り直した

メモリファイルを削除し、条件を作り直しました。

・合言葉を新しいものに変える

・「絶対にファイルへ保存しないでください。この会話の中だけで覚えてください」と明示する

・保存されていないことをファイル検索で確認してから始める

・同じセッション、同じ指示文で、forkと通常のサブエージェントを両方動かす

結果はきれいに分かれました。

通常のサブエージェント（general-purpose）は「知りません」と答えました。forkは「向日葵5296」と、伝えた合言葉をそのまま答えました。

同じセッションから、同じ指示文で起動して、この差です。forkが会話を引き継いでいることが、これで確認できました。

-pでは既定オフだった

もう一つ、実測でしか分からなかったことがあります。

最初に -p をつけた自動実行でforkを指定したとき、こんなエラーが返りました。

Agent type 'fork' not found. Available agents: claude, Explore, / general-purpose, Plan, statusline-setup

利用できるエージェントの一覧に、forkが入っていません。「既定でオン」と書かれているのに使えない。

公式ドキュメントを読み直すと、理由が書かれていました。

インタラクティブなセッションでは既定オン。-p の自動実行とAgent SDKでは既定オフ。 CHANGELOGの一行には、この条件が書かれていませんでした。

さらに、この既定値そのものがv2.1.232からの変更です。

それ以前は、インタラクティブでも環境変数で明示的にオンにする必要がありました。

自動実行でも使いたいときは

環境変数で上書きできます。

CLAUDE_CODE_FORK_SUBAGENT=1

これを付けて同じコマンドを実行したところ、forkが起動し、合言葉を答えました。値の意味は次のとおりです。

1 を指定すると、-p の自動実行やAgent SDKでもforkが使えるようになります。0 を指定すると、どの種類のセッションでもforkが無効になります。

cronやCIでClaude Codeを回している方は、ここを意識しておくと挙動の違いに戸惑わずに済みます。「手元では動くのに自動実行だと動かない」の正体がこれ、という場面がありそうです。

トークンはどう変わったか

forkは会話とプロンプトキャッシュを引き継ぎます。これが数字にどう出るかも見ました。

同じセッションで測ったところ、キャッシュ作成のトークンに差が出ました。forkが起動できずエラーになった回は11,952トークン、forkが成功した回は533トークンでした。約22分の1です。

ただしこの数字は、同じ作業を並べて比べたものではありません。エラーで終わった回と、サブエージェントが実際に走った回の比較なので、そのまま「forkは22倍安い」とは読めません。キャッシュを引き継ぐぶん作り直しが減る、という方向性が見えた、という程度に受け取ってください。

正確なコスト比較をするなら、同じ作業を通常のサブエージェントとforkで1回ずつ実行して、合計トークンを並べる必要があります。そこまでは今回やっていません。

自分で起動する方法

Claudeに任せるだけでなく、自分でforkを立てることもできます。

/subtask draft unit tests for the parser changes so far

このコマンドはfork modeがオンでもオフでも使えます。実行するとプロンプトの下にパネルが出て、forkがバックグラウンドで走り始めます。本体の会話は止まりません。終わると結果がメッセージとして返ってきます。

バージョンによってコマンド名が違う点だけ注意が必要です。v2.1.212以降は /subtask、v2.1.161からv2.1.211までは /fork でした。

走っているforkは、パネル上で矢印キーで選び、Enterで中身を開いて追加の指示を送れます。xで止められます。

fork modeがオンだと何が変わるか

forkが使えるようになる、以外にも変化があります。

Claudeが起動したサブエージェントは、forkでも名前付きのものでも、すべてバックグラウンドで走るようになります。そしてClaude側から「これは前面で実行したい」と要求する手段（run_in_background パラメータ）が取り除かれます。

前面で実行されるのは、環境変数で背景実行を禁止している場合など、限られた条件だけです。

もう一つ、地味ですが効く違いがあります。バックグラウンドで走るサブエージェントは、通常なら使えるツールが絞り込まれます。ところがforkはこの絞り込みを受けません。本体の会話とまったく同じツールを持ったまま動きます。

「作る」から「分ける」へ

同じv2.1.232に、こんな一行も入っています。

サブエージェントを自作しましょう、という起動時の案内が削除されました。 /powerup のツアーからも同様の誘導が消えています。

forkが既定になったことと並べると、意図が見えてきます。これまでは「専門特化したサブエージェントを定義して使い分ける」のが推奨の形でした。役割ごとにファイルを作り、システムプロンプトを書き、ツールを絞る。手間はかかりますが、その代わり文脈が汚れない。

forkは逆の発想です。定義せず、いまの会話をそのまま複製する。説明する手間がゼロになります。

もちろん自作のサブエージェントが不要になったわけではありません。同じ役割を繰り返し使うなら、定義したほうが安定します。ただ「まず自作しましょう」という入口の案内は消えました。サブエージェントは、作るものから分けるものへ、重心が移ったように見えます。

使い分けの目安

実際に触ってみて、こう整理しました。

forkが向いているのは、経緯の説明が面倒な脇道です。いま議論している設計のまま別案を試したい、この文脈のままテストケースを書かせたい、といった場面。名前付きのサブエージェントに同じことをさせようとすると、背景説明だけで長くなります。

自作のサブエージェントが向いているのは、繰り返す定型作業です。コードレビュー、調査、特定形式の文書作成。毎回同じ指示を書くくらいなら定義しておくほうが早く、ツールを絞れるぶん事故も減ります。

通常の（白紙の）サブエージェントが向いているのは、本体の文脈が邪魔になる作業です。先入観なしに調べてほしいとき、白紙から始まるほうが素直な結果が返ってきます。今回の実験のように、引き継いでいないことが前提の検証もここに入ります。

まとめ

Claude Code v2.1.232でサブエージェントのforkが既定オンになりました。実際に動かして分かったことを並べます。

forkは会話をまるごと引き継ぎます。同じセッションから同じ指示で起動して、通常のサブエージェントが「知りません」と答えた質問に、forkは正しく答えました。

ただし既定オンになるのはインタラクティブなセッションだけです。-p の自動実行とAgent SDKでは既定オフのままで、fork を指定してもエラーになります。使いたい場合は CLAUDE_CODE_FORK_SUBAGENT=1 を指定します。CHANGELOGの一行にはこの条件が書かれていないので、自動実行で使っている方は引っかかる可能性があります。

そして今回いちばん学びになったのは、機能そのものより検証の作法でした。「覚えて」と頼んだ内容がファイルに保存され、その後の全部の結果が汚染されていました。最初の結果だけ見ていれば、正しい結論に間違った根拠でたどり着いていたはずです。

測る前に、測りたいもの以外の経路を潰す。 当たり前のことですが、今回はそれを怠って一度やり直しました。同じ轍を踏まないよう、条件を作り直した手順も含めて記録しておきます。

あわせて読みたい関連記事：

 Claude Codeの最新情報と実測は @ai_hack_dx（X）で毎日発信しています。フォローして最新情報をチェックしてください。