タスク管理ツールの対応モデル限定

Task ツールの利用可否

タスク管理ツールである TaskCreate、TaskGet、TaskUpdate、TaskList、TodoWrite は、既定では Claude 3.x モデル、Opus 4〜4.7、Sonnet 4〜4.6、Haiku 4.5 でのみ利用できます。これらのツールが利用できる場合、Task ツール 4 種が使えます。ただし CLAUDE_CODE_ENABLE_TASKS=0 を設定すると、代わりに TodoWrite になります。

それ以外のすべてのモデルでは、オプトインしない限り、Claude Code はこれらのツールを提供しません。これは、LLM ゲートウェイ経由で提供されるカスタムモデル名など、Claude Code が認識しないモデル ID でも同様です。新しいモデルでは、Claude は書き出したチェックリストがなくても複数ステップの作業を把握でき、ツールの定義やリマインダーはコンテキストを消費します。これらのツールがない場合、作業中に Claude がタスクリストに何かを追加することはありません。

既定でこれらのツールを備えていないモデルで使いたい場合は、次のいずれかを行ってください。

• Claude Code を起動する前に CLAUDE_CODE_ENABLE_TODO_TOOLS=1 を設定する。たとえば CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude のようにします。これにより、Claude Code はすべてのモデル・すべてのプロバイダーで同じツールを提供するようになります
• --allowedTools にいずれかのツール名を指定する。たとえば claude --allowedTools TaskCreate のようにします
• --tools にツールを列挙する。これにより、そのセッションの組み込みツールが、列挙したツールだけに制限されます。使いたいツールを、他に使う組み込みツールと合わせて含めてください
• Agent SDK では、allowedTools と tools の各オプションが、この 2 つのフラグと同じように機能します

バックグラウンドセッションとクラウドセッションでは、一覧に含まれているかどうかにかかわらず、Claude Code はすべてのモデルで同じツールを提供します。

Claude Code がサブエージェントにこれらのツールを与えるのは、サブエージェントが別のモデルを使う場合でも、あなたのセッションがそれらのツールを持っている場合に限られます。インプロセスのエージェントチームのチームメイトは、同様にあなたのセッションに従いますが、独自の分割ペインで動くチームメイトは、別の Claude Code プロセスとして動作するため、そのモデル自身が判断します。Task ツールがない場合、エージェントは共有タスクリストではなく、メッセージを通じてチームと連携します。

ここで説明した既定のセットは、Claude Code v2.1.268 以降に適用されます。