メインコンテンツへスキップ

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月時点)

    あなたへのおすすめ