【要約】Claude Code の fork、既定ONのはずが使えなかった — 環境変数1つで決まっていた [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
開発者がClaude Codeのアップデートに伴い、新機能「fork」が利用できない問題に直面した。具体的には以下の事象が発生している。
- ・v2.1.232以降、forkは既定で有効とされている。
- ・しかし、VSCode拡張等の非対話セッションではエラーが出る。
- ・エラー内容は「Agent type 'fork' not found」である。
- ・「既定ON」の定義が対話セッションに限定されていることが原因である。
// Approach
筆者が、環境変数を用いた対照実験を通じて、機能の有効化条件と挙動の差異を特定した。以下の手順で検証を行っている。
- ・環境変数 CLAUDE_CODE_FORK_SUBAGENT=1 を設定し、非対話モードでの有効化を確認した。
- ・VSCodeの settings.json に環境変数を記述する方法を提示した。
- ・forkと通常のサブエージェントに対し、同一のプロンプトを投げる比較検証を行った。
- ・親セッションの秘密情報（4271、紫陽花）を回答できるかを確認した。
// Result
筆者が、fork機能が会話履歴を正確に継承し、作業効率とコストの両面で優れていることを実証した。
- ・forkは親の会話内容をツールなしで回答できた。
- ・通常のサブエージェントは会話履歴を持たず、回答不能であった。
- ・forkはプロンプトキャッシュを共有するため、低コストである。
- ・通常のサブエージェントは、回答せずとも約3.5万トークンを消費する。
Senior Engineer Insight
> AIエージェントのコンテキスト管理は、開発体験に直結する。forkによる履歴継承は、指示の重複を省き、プロンプトキャッシュ利用によるコスト最適化も期待できる。ただし、環境変数による挙動の差異は、CI/CDやIDE統合環境での自動化を阻害するリスクがある。導入時は、実行環境ごとの設定管理を徹底すべきだ。