Skip to content
← リリースに戻る · 2.1.268
改善 / v2.1.268

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

CHANGELOG 原文(英語)

Changed the task-tracking tools (TaskCreate/Get/Update/List, TodoWrite) to be offered only on Claude 3.x, Opus 4.0–4.7, Sonnet 4.0–4.6, Haiku 4.5; set CLAUDE_CODE_ENABLE_TODO_TOOLS=1 elsewhere
公式の変更履歴を開く ↗

日本語での補足

タスク管理ツール(TaskCreate/Get/Update/List、TodoWrite)を、Claude 3.x、Opus 4.0-4.7、Sonnet 4.0-4.6、Haiku 4.5でのみ提供するように変更。それ以外のモデルではCLAUDE_CODE_ENABLE_TODO_TOOLS=1を設定すると利用可能。

ドキュメント

ドキュメントの抜粋(参考訳)

Task ツールの利用可否

タスク管理ツールである TaskCreate、TaskGet、TaskUpdate、TaskList、TodoWrite は、既定では Opus 4.7、Sonnet 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 v2.1.268 以降に適用されます。

サブエージェントとエージェントチームにおけるタスク管理ツール

サブエージェントがタスク管理ツールを持つのは、サブエージェントがどのモデルで動作していても、あなたのセッションがそれらのツールを持っている場合に限られます。インプロセスのエージェントチームのチームメイトは、あなたのセッションがそれらのツールを持っていれば、タスク管理ツールを持ちます。分割ペインのチームメイトは別の Claude Code プロセスであり、--allowedTools ではなく、あなたの --tools 一覧と拒否ルールを継承します。そのため、自分が何を設定しているかを確認してください。

  • --tools 一覧も拒否ルールもなく、そのチームメイトに対して CLAUDE_CODE_ENABLE_TODO_TOOLS も未設定の場合: チームメイトは、自身のモデルが既定で持つタスク管理ツールを持ちます。
  • シェルで CLAUDE_CODE_ENABLE_TODO_TOOLS をエクスポートしている場合: Claude Code はチームメイトに、あなたがエクスポートした変数を含まない、固定された環境変数のセットを渡します。チームメイトにもこれを設定するには、シェルで claude --settings '{"env":{"CLAUDE_CODE_ENABLE_TODO_TOOLS":"1"}}' を実行してセッションを開始してください。チームメイトは、あなたの --settings の値も受け取ります。
  • --tools にタスク管理ツールの名前が含まれている場合: チームメイトは、どのモデルでもそれらのツールを持ちます。
  • タスク管理ツールが --tools に含まれていない、または拒否ルールで指定されている場合: チームメイトはそのツールを持ちません。

Task ツールがない場合、エージェントは共有タスクリストではなく、メッセージを通じてチームと連携します。

取得日 · 2026-11-20

変更の詳細