Claude Codeでサブエージェントを並列実行すると結果が消える・止まることがある——Windowsで踏んだ症状と回避策

Claude Code には、複数のサブエージェントを並列に走らせて調査や実装を分担させる機能があります。手元の作業を早く終わらせたくて、大きめの調査タスクをこの並列実行に任せたところ、Windows環境で「結果が返ってこない」系の症状にいくつも遭遇しました。エラーで落ちるならまだ分かりやすいのですが、厄介なのは「動いているように見えるのに、結果だけが手元に来ない」という止まり方だったことです。

先に断っておくと、これは2026年7月時点の、うちの環境（Windows）で起きた事象の記録です。原因の内部的な仕組みまでは特定できておらず、全環境・全バージョンで同じことが起きると言い切るものではありません。ただ、同じ並列実行の仕組みを使っていて「結果が来ない」で困っている人には、症状の当てはまりと、うちで効いた回避策が参考になるかもしれません。

症状：4つの「結果が来ない」パターン

並列実行させたサブエージェントの作業自体は進んでいる様子なのに、こちらの手元で結果を受け取ろうとすると、次の4つの形で詰まりました。

①〜④はどれも「エラーで止まる」のではなく「終わったはずなのに、終わった証拠が手元にちゃんと届かない」という共通点があります。ログを見ても「進行中」に見えてしまうので、実際には完了しているのか、まだ動いているのか、こちらからは判断がつきません。

実際に気づいたきっかけは、拍子抜けするくらい静かなものでした。画面には「結果を待っています」という趣旨の表示が出ていて、待っても待っても状況が変わりません。さすがに様子を見に行ったところ、返ってきたのは「エラーが出ています」という一言。待っている間、それらしい予兆があったわけでもなく、静かに詰まっていたことに気づいたのはこのときでした。

効いた対処：返り値に頼らず、エージェント自身に書かせる

いろいろ試した中で、実際に効いたのは一つだけでした。大きな結果を呼び出し側への「返り値」として運ぶのをやめて、サブエージェント自身に、結果をファイルとして保存させるという形です。呼び出し側は、その返り値を待つのではなく、エージェントが書いたファイルを後から読みにいきます。

図にすると、こういう向きの変更です。

この形にたどり着くまで、最初から一発で決まったわけではありません。うちの記録には「3回目の実行でようやく安定した」とだけ残っていて、1回目・2回目に何を試して外れたかまでは書き留めていませんでした。ここは正直に、記録に無いことは書かないでおきます。

これも、同じ現場で積み上がる地雷

この一件でうちが学んだのは、AIにどこまで任せるかで書いた「戻せるか」の物差しに、もう一つ隣接する注意点があるということでした。並列実行そのものは戻せる作業（読み取り・調査）に振っていても、その結果を受け取る経路自体が詰まることがある——ここは可逆性の話とは別の軸です。大きな結果ほど、返り値という一本の細い経路に全部乗せず、ファイルという確認できる形に一度落としておくと、詰まったときに「どこまで進んでいたか」を後から見に行けます。

Windows環境ならではの引っかかりという意味では、起動時の60秒タイムアウトや許可設定の棚卸しで書いた話とも地続きです。同じ現場で、同じツールを、同じOS上で使い続けているからこそ積み上がる地雷が確かにあります。並列実行・権限・起動——ここまでで踏んだものを一通りまとめたのがClaude Code実務運用ガイドなので、他の章もあわせてどうぞ。