Claude Agent SDK、委任されないのは allowedTools のせいです
Claude Agent SDK で自作エージェントを定義したのに、一度も呼ばれない。でもエラーは出ないし、成果物はちゃんと返ってくる。
これ、allowedTools に Agent が入っていないだけかもしれません。
公式のトラブルシューティング「Claude not delegating to subagents」で、筆頭に挙がっているのがこれです。
include `Agent` in `allowedTools` to auto-approve subagent calls. Without it,
Agent invocations fall through to your `canUseTool` callback or, in `dontAsk` mode, are deniedつまり、入れ忘れると**エラーではなく「委任されないだけ」**になります。親が全部自分でやってしまう。動いてはいるので、気づきにくい。dontAsk モードだとそのまま拒否されます。
同じ節に挙がっている残り2つは、プロンプトでエージェント名を明示すること("Use the code-reviewer agent to...")と、description を具体的に書くこと。ここは想像がつく話です。
で、驚いたのはツール名のほう。
このツール、v2.1.63 で Task から Agent に改名されました。ところが移行が中途半端なままで、公式が自分でこう書いています。現行 SDK は tool_use ブロックでは "Agent" を出すけれど、system:init のツール一覧と result.permission_denials[].tool_name では今も "Task" のまま。
なので委任が拒否されたことを検知するコードを書くなら、両方を見る必要があります。古い記事が Task で書かれている理由も、たぶんここ。
ついでにもう一つ、静かに起きるやつを。AgentDefinition の tools を省略すると使えるツールを全部継承しますが、書いて外したツールについて公式はこう言っています。
A tool you leave out isn't in the subagent's session at all: Claude works without it,
with no permission prompt or error.外したツールはセッションに存在しない。権限プロンプトもエラーも出ません。
「委任されない」も「ツールが無い」も、どちらも黙って起きます。SDK でエージェントを組むときにいちばん時間を溶かすのは、たぶんこの静かさのほうです。
出典: Claude Code Docs / Subagents in the SDK(2026年8月時点)