環境変数
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS
1 に設定すると、Explore や Plan などのすべての組み込みサブエージェントタイプを無効にする。非インタラクティブモード(-p フラグ)でのみ適用される。真っさらな状態を望む SDK ユーザーに有用である。これにより、Agent ツール呼び出しが subagent_type を省略した場合に Claude Code が実行するサブエージェントである general-purpose も削除される。そのような呼び出しはその後、subagent_type is required というエラーで失敗する。
使い方・用途
- 非インタラクティブモード(-p フラグ)で動作させる SDK 利用者が、Explore や Plan などの組み込みサブエージェントをすべて無効化してクリーンな状態から使い始めたいとき
- 組み込みサブエージェントや general-purpose を使わない構成にして、Agent ツール呼び出し時に subagent_type の指定が必須になる挙動へ統一したいとき
英語原文(公式ドキュメントより)
Set to 1 to disable all built-in subagent types such as Explore and Plan. Only applies in non-interactive mode (the -p flag). Useful for SDK users who want a blank slate. This also removes general-purpose, the subagent Claude Code runs when an Agent tool call omits subagent_type. Such a call then fails with subagent_type is required