環境変数

CLAUDE_CODE_FORK_SUBAGENT

フォークモードを制御する。フォークモードは既定で有効であり、Claude が自分自身でフォークを開始できるようになる。フォークモードが有効な間、Claude は自分のマシン上の対話型ターミナル、VS Code、デスクトップセッションでサブエージェントを待つことができなくなる。0 を設定するとフォークモードをオフにできる。バージョンについては、Turn fork mode off を参照。

使い方・用途

  • 対話型ターミナル、VS Code、デスクトップセッションでサブエージェントの完了を待たせたい場合に、fork モードを無効化できる。
  • fork サブエージェントだけを個別に拒否するのではなく、fork 機能そのものをオフにしたい場合に使える。
  • 外部ビルドや非対話型セッション (claude -p、Agent SDK) で fork サブエージェントを明示的に有効化したい場合に使える。
英語原文(公式ドキュメントより)

Controls fork mode, which is on by default and lets Claude start forks on its own. While fork mode is on, Claude also can't wait for a subagent in interactive terminal, VS Code, or desktop sessions on your machine. Set to 0 to turn fork mode off. For versions, see Turn fork mode off

関連ドキュメント

関連する変更履歴

v2.1.302(1件)

Changed
フォークサブエージェント（subagent_type: 'fork'）を、ターミナルと同様に claude -p、Agent SDK、デスクトップアプリ、VS Code でデフォルトで有効に変更した。CLAUDE_CODE_FORK_SUBAGENT=0 で無効化でき、claude mcp serve では提供されない
英語原文を表示
Changed fork subagents (subagent_type: "fork") to be on by default in claude -p, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; CLAUDE_CODE_FORK_SUBAGENT=0 turns them off, and claude mcp serve never offers them

変更後

headless モード (claude -p)、Agent SDK、デスクトップアプリ、VS Code でも fork サブエージェントがデフォルトで使えるようになり、端末と同じく会話履歴を受け継いだサブエージェントに脇作業を任せられる。背景説明をやり直さずに済み、プロンプトキャッシュも共有されるため待ち時間やコストの無駄が減る。

関連ドキュメント

v2.1.285(1件)

Fixed
CLAUDE_CODE_FORK_SUBAGENT=1 付きの claude -p を修正した。サブエージェント自身の Agent 呼び出しがフォアグラウンドで実行されるようになり、サブエージェントが子の結果を受け取れる
英語原文を表示
Fixed claude -p with CLAUDE_CODE_FORK_SUBAGENT=1: a subagent's own Agent call now runs in the foreground, so the subagent gets the child's result

関連ドキュメント

v2.1.121(1件)

Changed
SDK および claude -p において、非対話型セッションでも CLAUDE_CODE_FORK_SUBAGENT=1 が動作するようになりました。
英語原文を表示
SDK and claude -p: CLAUDE_CODE_FORK_SUBAGENT=1 now works in non-interactive sessions

変更後

複雑なワークフローの自動化スクリプトにおいて、コンテキストの継承を活用した高度な並列処理が可能になります。

関連ドキュメント

v2.1.117(1件)

Added
外部ビルドにおいて CLAUDE_CODE_FORK_SUBAGENT=1 を設定することで、フォークされたサブエージェントを有効化できるようになりました
英語原文を表示
Forked subagents can now be enabled on external builds by setting CLAUDE_CODE_FORK_SUBAGENT=1

変更後

重い探索やログ解析をサブエージェントに分離できるため、メイン会話のコンテキストを節約し、作業効率を向上させられます。

関連ドキュメント