Claude CodeでTaskListが使えない理由と対処

Claude CodeでTaskListが使えない理由と対処

Claude Code で TaskCreate や TaskList、TodoWrite が呼べなくなり、Ctrl+T のタスクリストも空のまま、という報告が続いています。

2026 年 11 月 1 日の Qiita の記事 も、タスクリストを作って進めるスキルが動かなくなった事例を書いていました。

【Claude Code】TaskListが使えなくなった!? - Qiita

これは不具合ではなく、新しいモデルでは既定で外す仕様の変更で、環境変数 1 つで戻せます。

どのモデルで消えるのか、どんなときに戻すのかが分かると、スキルや hook を直すかどうかも決められます。

仕様は 2026 年 11 月 3 日時点の公式ドキュメントと CHANGELOG(最新版は 2.1.317)で確かめたもので、私の手元で全モデルを試したわけではありません。

TodoWrite と Task 系ツールの関係

どちらも、Claude が複数の手順を進めるときに使うチェックリストの道具です。

古いほうの TodoWrite は、1 つでセッションのチェックリストを管理するツールです。

新しいほうは TaskCreate・TaskGet・TaskUpdate・TaskList の 4 つに分かれていて、タスクの依存関係も持てます。

CHANGELOG によると、v2.1.16(2026 年 1 月)で新しいタスク管理の仕組みが入り、v2.1.19 で古い仕組みに留まるための環境変数が足されました。

claude-code/CHANGELOG.md at main · anthropics/claude-code

いまの既定は 4 つの Task 系ツールで、CLAUDE_CODE_ENABLE_TASKS=0 にしたときだけ、代わりに TodoWrite が出ます。

そのため TodoWrite を前提にした古いスキルや解説は、新しいモデルかどうかに関係なく、いまの既定と食い違います。

タスクリストが会話の圧縮をまたいで残り、CLAUDE_CODE_TASK_LIST_ID で ~/.claude/tasks/ の名前付きのフォルダを指せば複数のセッションで共有できるのも、いまの仕様です。

既定で使えるのは Opus 4.7・Sonnet 4.6・Haiku 4.5 以前

いまの提供範囲は、公式のツール一覧 の「Task tool availability」に書かれています。

Tools reference - Claude Code Docs
セッションの条件チェックリストのツール
Opus 4.7・Sonnet 4.6・Haiku 4.5 とそれ以前のモデル既定で出る
それ以外のモデル(Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.1 など)既定で出ない
Claude Code が知らないモデル ID(LLM ゲートウェイの独自の名前など)既定で出ない
バックグラウンドセッションとクラウドセッションモデルを問わず出る

変更は 2 段階で進みました。

まず v2.1.233(2026 年 8 月 14 日 UTC)で、Opus 4.8、Sonnet 5、Fable 5、Mythos 5 とそれより新しいモデルから外れています。

次に v2.1.268(2026 年 9 月 10 日 UTC)で、「出すモデルを挙げる」形に整理されました。

CHANGELOG に載る前の 2026 年 7 月にも、同じ症状の報告 は出ていました。

[BUG] TaskCreate and TodoWrite both disabled on Opus 4.8 / Sonnet 5 / Fable 5 by a server-side model gate — no fallback, no local override · Issue #80487 · anthropics/claude-code

最近の版にしてから気づいた場合でも、その版で初めて変わったとは限りません。

同じ別名でも結果が変わる

モデルの別名は接続先によって指す版が違うので、同じ指定でも結果が分かれます。

モデル設定のドキュメント の表では、sonnet は Anthropic API で Sonnet 5.5、Amazon Bedrock で Sonnet 4.5 です。

Model configuration - Claude Code Docs

上の条件に当てはめると、/model sonnet でも Anthropic API では出ず、Bedrock では出ることになります。

LLM ゲートウェイ経由で独自のモデル名を使っている場合も、既定で出ない側に入ります。

LLMゲートウェイとは?複数のAI APIをまとめる仕組み

サブエージェントはセッションに従う

サブエージェントがチェックリストのツールを持てるのは、親のセッションが持っているときだけです。

Haiku 4.5 で動かすサブエージェントでも、親が Opus 5.5 で有効にしていなければ、ツールはありません。

外された理由

公式の説明は 2 つあります。

  • 新しいモデルは、チェックリストを書き出さなくても複数の手順を追える
  • ツールの定義とリマインダーが、コンテキストを消費する

開発側も #86929 のコメントで、いまは意図した動作で不具合ではない、と書いています。

[Bug] TaskCreate/TaskUpdate tools missing from deferred tool list · Issue #86929 · anthropics/claude-code

ただし、見え方は壊れた状態に近いものです。

エラーは出ず、ツールが一覧に無いだけなので、#93675 の報告者は /doctor にもツール一覧にも理由が出なかったと書いています。

Task tools are off by model, with no settings key and no way to keep a session checklist by default · Issue #93675 · anthropics/claude-code

この issue は、設定キーの追加や理由の表示を求めたまま、2026 年 11 月 3 日時点で open です。

消えると止まるもの

Claude が手順を追えなくなるわけではないものの、チェックリストにつないでいた仕組みは止まります。

  • Ctrl+T のタスクリスト: 項目が入らず、空のままになる
  • TaskCreated の hook: 発火しない
  • エージェントチーム: 共有のタスクリストの代わりに、メッセージで連携する
  • Agent SDK のアプリ: tool_use のブロックが流れないので、進捗を描く画面に何も届かない
  • タスクリストを手順に書いたスキル: 書いたとおりには動かない(Qiita の例では、Claude がマークダウンで管理するようになった)

TaskCreated が発火しないことは、hooks のリファレンス に書かれています。

Hooks reference - Claude Code Docs

利用者の報告には、タスクリストの有無を見て作業を止める自作の hook が、黙って効かなくなった例もありました。

手元で確かめる方法

いちばん簡単なのは、公式が案内しているとおり、セッションの中で「What tools do you have access to?」と聞くことです。

開発側が #86929 に残した再現手順は、モデルを変えて同じ質問を投げる形でした。

# 既定のモデルで聞く
claude -p "Do you have a TaskCreate or TaskUpdate tool? List every tool name containing Task or Todo."

# Opus 4.7 を指定して同じことを聞く
claude -p "Do you have a TaskCreate or TaskUpdate tool? List every tool name containing Task or Todo." --model claude-opus-4-7

v2.1.233 での記録によると、既定の Opus 5 で見えたのは TaskOutput と TaskStop だけで、Opus 4.7 では Task 系がすべて見えています。

戻し方

いちばん広く効くのは、環境変数 の CLAUDE_CODE_ENABLE_TODO_TOOLS=1 で、v2.1.233 以降で使えます。

Environment variables - Claude Code Docs

全モデルと全プロバイダーで同じツールが出るようになります。

その場だけ戻す

Claude Code を起動する前に設定します。

CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude

PowerShell では次のように書きます。

$env:CLAUDE_CODE_ENABLE_TODO_TOOLS = "1"
claude

毎回戻す

設定ファイルの env に書くと、claude を起動するたびに効きます。

{
  "env": {
    "CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"
  }
}

個人なら ~/.claude/settings.json、チームで揃えるならプロジェクトの .claude/settings.json に置きます。

プロジェクトの env の多くの値は、各メンバーがフォルダを信頼したあとで効きます。

フラグと Agent SDK で戻す

環境変数を使わず、起動のフラグでツールの名前を挙げる方法もあります。

# どれか 1 つを挙げれば、チェックリストのツールが提供される
claude --allowedTools TaskCreate

--tools でも指定できますが、挙げたものだけにツールが絞られるので、使う組み込みツールも一緒に並べます。

Agent SDK では allowedTools・tools・env のどれかを使います。

Track todos - Claude Code Docs
// env は子プロセスの環境を置き換えるので process.env を展開する
const options = {
  env: { ...process.env, CLAUDE_CODE_ENABLE_TODO_TOOLS: "1" },
};

間違えやすい 2 つ

似た名前の CLAUDE_CODE_ENABLE_TASKS は、ツールがあるセッションで Task 系か TodoWrite かを選ぶものなので、これを設定しても新しいモデルでは戻りません。

エージェントチームの分割ペインのメンバーには、シェルで export した値が渡りません。

メンバーにも効かせるなら、公式の案内どおり --settings で渡します。

claude --settings '{"env":{"CLAUDE_CODE_ENABLE_TODO_TOOLS":"1"}}'

戻すかどうかの決め方

Agent SDK のドキュメントは、有効にするのはアプリがそのツールの呼び出しを読むときだけでよい、と案内しています。

Claude Code の対話でも、同じ考え方で分けられます。

いまの使い方判断
Ctrl+T で進み具合を人が見ている戻す
TaskCreated の hook や共有のタスクリストを使っている戻す
アプリで進捗を描いたり記録したりしている戻す
スキルの手順に TaskCreate と書いてあるだけ前提を外すか、戻すかを決める
どれにも当てはまらない戻さない

戻さなければ、ツールの定義とリマインダーの分のコンテキストを使わずに済みます。

どれだけ減るかの公式の数字は、確かめた範囲では見つかりませんでした。

似た名前の別物

Task が付く名前は他にもあり、混ぜると調べる先を間違えます。

名前何をするものか
Agent(旧 Task)サブエージェントを起動する。v2.1.63 で改名され、Task(...) の書き方は別名として残っている
TaskStop実行中のバックグラウンド処理を止める
TaskOutputバックグラウンド処理の出力を読むツールだった。v2.1.277 で削除
/tasks実行中のシェルとサブエージェントの一覧を見る。チェックリストは Ctrl+T
MCP tasksMCP サーバー側で動く長い処理を、後で受け取る仕組み

ツール一覧に TaskStop はあるのに TaskCreate が無いのは、新しいモデルでは仕様どおりの状態です。

MCPのTasksとは?時間のかかる処理を後で受け取る仕組み

最後に

TaskList や TodoWrite が消えたら、最初にセッションのモデルと Claude Code の版を確かめると、原因を早く絞れます。

新しいモデルなら仕様どおりで、必要なときだけ CLAUDE_CODE_ENABLE_TODO_TOOLS=1 を足せば戻ります。

戻す基準は、人やプログラムがそのリストを読んでいるかどうかです。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA