Claude Media
Claude Code TodoツールがOpus 4.8以降で既定オフ — 影響と復活方法

Claude Code TodoツールがOpus 4.8以降で既定オフ — 影響と復活方法

Claude Code v2.1.233以降、Opus 4.8やSonnet 5などの新世代モデルではTodo/Taskツールが既定で使えなくなりました。何に影響し、どう復活させるかをまとめます。

新世代モデルではタスク一覧ツールが既定で消えた

Opus 4.8・Sonnet 5・Fable 5・Mythos 5以降のモデルでは、タスク管理ツールがデフォルトでは提供されません。対象はTodoWriteと、TaskCreate TaskGet TaskUpdate TaskListの4つです。Opus 4.7までの旧世代では今まで通りTask系4ツールが使えるので、新世代モデルだけに起きる変化です。

タスクを書き出すツール自体が渡されないため、Claudeは何段階かの作業をしていてもチェックリストへ何も追加しません。作業を追跡していないのではなく、書き出す先が無い状態になります。

2段階で入った変更の経緯

この挙動は一度に入ったものではありません。変更履歴では、次の2回に分かれています。

あゆみ

タスクツールの既定が変わった経緯

  1. v2.1.233Opus 4.8以降が既定オフに

    Opus 4.8・Sonnet 5・Fable 5・Mythos 5と、それ以降のモデルで、タスク系ツールが使えなくなりました。CLAUDE_CODE_ENABLE_TODO_TOOLS=1で戻せます(v2.1.233の解説)。

  2. v2.1.268「提供するモデル」の列挙方式へ

    Claude 3.x・Opus 4.0〜4.7・Sonnet 4.0〜4.6・Haiku 4.5だけが既定で提供される、という書き方に変わりました(v2.1.268の解説)。

後者の書き方は影響範囲が広い点が重要です。公式は「それ以外のモデルでは省かれる」とし、Claude Codeが認識できないモデルIDも同じ扱いだと説明しています。たとえばLLMゲートウェイ経由の独自モデル名がこれに当たります。Opus 4.8以降の名指しの一覧に載っていないからといって、ツールが残るわけではありません。

なぜ既定で外されたのか

新世代モデルは、書き出したチェックリストが無くても複数ステップの作業を追跡できる、というのが公式の説明です。さらにツール定義とリマインダーがコンテキストを消費するため、Claude Codeは対象外のモデルへこれらを渡しません。性能の欠落ではなく、コンテキスト予算の整理という位置づけです。

どの使い方で影響が出るか

既定オフになるのは、対象モデルをローカルで動かしたときです。対話セッションだけでなく、-pやAgent SDKも含みます。例外は次の2つです。

くらべる

ツールが出る場面と出ない場面

対象モデル+通常の対話

既定でツールなし

Opus 4.8・Sonnet 5・Fable 5・Mythos 5などを、ターミナルや拡張機能のセッションで使う場合です。Claudeはチェックリストを作りません。

バックグラウンドとクラウド

常にツールあり

バックグラウンドセッションとクラウドセッション(Claude Code on the web)では、どのモデルでも同じツールセットが提供されます。既定で提供するモデルの一覧に載っているかどうかは関係ありません。

旧世代のOpus 4.7などでは従来どおりTask系4ツールが使えます。TodoWriteだけを使いたいときはCLAUDE_CODE_ENABLE_TASKS=0を立てます。

症状から見る:何が空になるか

ツールが渡されないと、タスクに依存する機能が連鎖して中身の無い状態になります。エラーは出ないので、気づかないまま運用が続きがちです。

影響箇所新世代モデル(既定)旧世代モデル / opt-in後
セッション内のタスク一覧(Ctrl+T)新世代モデル(既定)表示する項目が無く、押しても見た目は変わらない旧世代モデル / opt-in後保留・進行中・完了の項目が見える
CLAUDE_CODE_TASK_LIST_IDによる共有新世代モデル(既定)共有する中身が作られない旧世代モデル / opt-in後セッションをまたいで同じ一覧を使える
コンテキスト圧縮後のタスク保持新世代モデル(既定)保持するタスクがそもそも無い旧世代モデル / opt-in後圧縮をまたいで保持される
TaskCreated Hook新世代モデル(既定)TaskCreateが呼ばれないので発火しない旧世代モデル / opt-in後タスク作成のたびに発火し、止める判断もできる
Agent teamsの共有タスク一覧新世代モデル(既定)使えず、メッセージで調整する旧世代モデル / opt-in後タスクの割り当てと取得で進捗を共有

TaskCreated Hookで「大きすぎるタスクを止める」「特定の名前を禁止する」といった制御を組んでいたなら、対象モデルへ切り替えた瞬間に効かなくなります。このHookは終了コード2(またはdecision: "block")でタスクの作成を取り消し、その理由をClaudeへ返せる仕組みです。取り消されたタスクは削除され、メッセージはツールのエラーとしてClaudeに届きます。continue: falseはこのイベントでは無視され、Claudeは作業を続けます。matcherには対応せず、タスクが作られるたびに発火します。入力にはtask_idとtask_subjectが入り、task_description、teammate_name、team_nameは付くことがあります。Task系ツールが無いセッションでは、このイベント自体が発火しません。Hookそのものを疑う前に、モデルとバージョンの組み合わせを見るのが早道です。イベントの種類と設定はClaude Code Hooks完全ガイドにあります。

ツールが渡されているかを確かめる

自分のセッションにタスクツールがあるかは、公式がセッション内で聞く方法を示しています。Claudeに「What tools do you have access to?」と尋ねると、利用できるツールを会話形式で答えます。TaskCreateの名前が挙がらなければ、そのセッションには渡されていません。

手元のv2.1.287では、claude --helpが--allowedToolsと--toolsの両方を表示しました。実際の記述は次のとおりです。

claude --version
# 2.1.287 (Claude Code)
claude --help
#   --allowedTools, --allowed-tools <tools...>
#       Comma or space-separated list of tool names to allow (e.g. "Bash(git *) Edit")
#   --tools <tools...>  Specify the list of available tools from the built-in set.
#       Use "" to disable all tools, "default" to use all tools, or specify tool names

--helpの一行説明には、タスクツールを名指しすると復活する、という記述はありません。この条件はCLIリファレンスのオプション表に書かれている仕様です。helpだけを頼りにすると見落とします。

元に戻す3つの方法

手順

タスクツールを戻す手順(選べるのは1つで足ります)

  1. 1

    環境変数で全体に戻す

    CLAUDE_CODE_ENABLE_TODO_TOOLS=1を立てて起動します。モデルとプロバイダーを問わず、同じツールセットが提供されます。v2.1.233以降で使えます。

  2. 2

    そのセッションだけ戻す

    --allowedToolsか--toolsに、タスクツールを1つ名指しします。名前を挙げただけで、Claude Codeはそのセッションをタスクツールありに切り替えます。--allowedToolsは本来「確認なしで実行してよいツール」を指定するフラグなので、TaskCreateの呼び出しも確認なしで通る点を頭に置いてください。

  3. 3

    Agent SDKでは同名のオプション

    allowedTools(Pythonではallowed_tools)かtoolsオプション、またはenvにCLAUDE_CODE_ENABLE_TODO_TOOLSを指定します。

# 恒常的に戻す
export CLAUDE_CODE_ENABLE_TODO_TOOLS=1
claude
 
# そのセッションだけ戻す
claude --allowedTools TaskCreate

注意が要るのは--toolsです。これは組み込みツールを絞り込むフラグなので、タスクツールだけを書くと他のツールが使えなくなります。普段使うツールと並べて列挙してください。

似た名前のCLAUDE_CODE_ENABLE_TASKSは役割が違います。環境変数の全体像にもあるとおり、こちらは「Task系4ツールにするか、TodoWrite1本にするか」を選ぶ変数で、対象モデルでツールを渡すかどうかとは関係しません。CLAUDE_CODE_ENABLE_TODO_TOOLS=1だけで既定のTask系4ツールが戻ります。CLAUDE_CODE_ENABLE_TASKS=0を重ねると、対象モデルでもTodoWriteだけが戻ります。

Todoが作られていた場面と、影響の大きさ

公式のAgent SDK資料によると、ツールがあるセッションでClaudeがTodoを作るのは次のような場合です。

  • 3つ以上の個別の操作が要る複雑なタスク
  • 利用者が複数の項目を挙げたとき
  • 進捗の追跡が役立つ長めの作業
  • Todoでの整理を明示的に頼まれたとき

ごく短い依頼や1ステップの作業では作らないこともあります。Todoが無くても作業は進むので、既定オフで困るのは進捗を外から読み取りたい場合だけです。したがって影響が出やすいのは、複数ファイルにまたがる実装や長時間の自走です。単発の質問や小さな修正が中心なら、既定オフには気づきにくいでしょう。

再有効化するかどうかの判断

状況対応の目安
TaskCreated Hookやタスク一覧を前提にした自動化がある対応の目安CLAUDE_CODE_ENABLE_TODO_TOOLS=1を既定にする
CLAUDE_CODE_TASK_LIST_IDで複数セッションの一覧を共有している対応の目安同上。復活させないと共有の中身が作られない
進捗をたまにCtrl+Tで覗く程度対応の目安復活は任意で、無くても実害は小さい
コンテキストを節約したい、長時間セッションが多い対応の目安既定のオフのままで、ツール定義とリマインダーの分が浮く

復活させたあとのタスク一覧は、Ctrl+Tで表示を切り替えます。一度に見えるのは最大5件で、一覧を開いたままにすると、--resumeや--continueで戻ったときも展開された状態で再開します。全件を見たい、消したいときは、Claudeに「show me all tasks」「clear all tasks」と頼みます。

自動化を組んでいるなら、モデルを新世代へ切り替える前に設定へ足しておくと、気づかないうちに機能が止まる事態を避けられます。

ツール呼び出しを監視するときの注意

HookやAgent SDKでTaskCreateの呼び出しを追う場合、割り当てられたタスクIDは入力には入っていません。IDは対応するtool_result側のtool_use_resultにtask.idとして返ります。入力だけを見ていると、IDが常に空に見えます。

もう一点、ストリームに流れるTaskUpdateの入力は、モデルが出力した生の形のままです。Claude Codeはidやtask_idをtaskIdに直してから実行しますが、その補正はストリームには反映されません。読む側はtaskIdだけを前提にせず、3つの名前を順に見るコードにするのが安全です。公式のサンプルもこの形で書かれています。

まとめ

ローカルでOpus 4.8以降や未知のモデルIDを使うと、タスクツールは既定で渡されません。Hook・一覧・共有のどれにも頼っていなければ、既定のままで困ることはほとんどありません。

よくある質問

Agent SDKでも同じですか

同じです。TypeScript SDKでは、v0.3.233でOpus 4.8・Sonnet 5・Fable 5・Mythos 5以降の既定のツール一覧からタスクツールが外れました。toolsに名前を挙げるかallowedToolsで参照するか、CLAUDE_CODE_ENABLE_TODO_TOOLS=1を立てれば残せます。v0.3.268からは、バンドルするClaude Codeが列挙方式の既定を持ちます。自前のClaude CodeをpathToClaudeCodeExecutable(TypeScript)やcli_path(Python)で指定すると、その実行ファイルの既定が使われます。復活させるにはallowedTools、tools、envのいずれかです。TypeScriptのenvは環境変数を丸ごと置き換えるので、...process.envを展開します。Pythonのenvは継承した環境に上書きで足されるため、その配慮は要りません。

TodoWriteからTask系への置き換えは、既定オフより前に始まっています。TypeScript SDK v0.3.142では、ヘッドレスとSDKのセッションがTodoWriteの代わりにTask系ツールを使うようになり、破壊的変更として記録されました。ツールの出力を読む側は、一覧の全件を置き換える形ではなく、タスクIDで積み上げる形にする必要があります。

サブエージェントやAgent teamsのメンバーはどうなりますか

サブエージェントは、親のセッションにツールがあるときだけ渡されます。別のモデルで動かしても同じです。Agent teamsで同じプロセス内のメンバーも親に従いますが、別の分割ペインで動くメンバーは独立したClaude Codeプロセスなので、そのメンバー自身のモデルで決まります。ツールが無いと、共有タスク一覧の代わりにメッセージで調整します。

opt-inしていても、v2.1.285以前ではフォアグラウンドのサブエージェントでタスクツールが欠けることがありました。v2.1.286(2026年9月30日)で修正されています。TypeScript SDKはv0.3.286で、toolsやallowedToolsに挙げたツールがフォアグラウンドのサブエージェントへ渡らない不具合が直りました。サブエージェントの設計はClaude Code Sub-agents完全ガイドで扱っています。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/tools-reference
  2. code.claude.com/docs/en/interactive-mode
  3. code.claude.com/docs/en/env-vars
  4. code.claude.com/docs/en/agent-teams
  5. code.claude.com/docs/en/agent-sdk/todo-tracking
  6. code.claude.com/docs/en/cli-reference
  7. code.claude.com/docs/en/changelog
この記事を共有:XはてブLinkedIn