Claude Codeのサブエージェントが応答しない・固まる問題を、GitHub Issueの実例で切り分けた
Claude Codeのサブエージェント(Task tool)が応答しない・Runningのまま固まる症状を、GitHub Issueの実例から3パターンに分類。公式にタイムアウト機能がない実情と、/tasks・環境変数を使った現実的な対処法を整理した。
#サブエージェント
4 articles
Claude Codeのサブエージェント、禁止→解禁を1週間で繰り返した理由
Claude Codeはサブエージェントの同時実行を20体に制限した4日後、ネストの入れ子生成を既定で禁止し、さらに3日後には深さ3まで既定で解禁した。7月17日〜24日の3リリースを時系列で追い、暴走コストの正体とCLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS等の実務での調整方法を解説する。
Claude Code サブエージェント × Worktree Isolation 設計ガイド — 並列実行でコンフリクトを防ぐ実装パターン
Claude Codeのカスタムサブエージェントにisolation: worktreeを設定して並列ファイル編集を安全に実行する方法を解説。フロントマター設計、.worktreeinclude設定、自動クリーンアップの仕組みまで。
Claude Code Dynamic Workflows 完全ガイド — 最大1,000並列サブエージェントの仕組みと実践
2026年5月発表のClaude Code Dynamic Workflowsを徹底解説。通常のサブエージェント・Agent Teamsとの使い分け判断、/deep-researchコマンドの動作、カスタムワークフロー設計、Maxプランでのコスト感まで。