1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

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

1
Last updated at Posted at 2026-11-01

この内容は、claude codeのバージョンおよび仕様の変更によって最新でなくなるかもしれないので、自身の環境を確認の上、使ってください。

TL;DR

claude codeでTaskListが使えなくなる事象が発生したので、環境変数CLAUDE_CODE_ENABLE_TODO_TOOLS=1で設定することで回復した。

解決法は2種類あり、セッションごとにCLAUDE_CODE_ENABLE_TODO_TOOLS=1 claudeと起動するか、settings.jsonに"CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"として設定することでタスクリストを再有効化できる。

きっかけ

最近、claude codeでタスクリストを作成して作業を進めるskillsが機能しなくなっていたことがわかった。claude codeは代わりにマークダウンでのタスク管理をするようになっていたのだ。

環境

mac・windows・linuxで、claude codeのバージョン2.1.316において発生

原因

主な原因としては、TaskCreate / TaskUpdate などのタスクリスト管理に関するツール群がclaude code側から呼び出せなくなっていたことが原因だった。

解決法

1. まず、環境変数の候補を洗い出す

Claude Code は単一バイナリとして ~/.local/share/claude/versions/ に置かれている。この中には JS がそのまま埋め込まれているので、strings で環境変数名を拾える。

B=~/.local/share/claude/versions/2.1.316
strings -n 6 "$B" \
  | grep -oE '\b[A-Z][A-Z0-9_]{3,}(TODO|TASK)[A-Z0-9_]*\b' \
  | sort -u
タスクリストを有効にする環境変数の候補一覧
- CLAUDE_CODE_ENABLE_TASKS
- CLAUDE_CODE_ENABLE_TODO_TOOLS
- CLAUDE_CODE_TASK_LIST_ID
- CLAUDE_CODE_TODO_REMINDER_MODE
- CLAUDE_CODE_DISABLE_BACKGROUND_TASKS

候補一覧から名前的に、ENABLE_TASKS と ENABLE_TODO_TOOLSが有力そうである。

2. 定義を読む

minify済みの該当定義

function r0() {
  if (i.CLAUDE_CODE_ENABLE_TASKS === false) return false;
  return true;
}

function p5() {
  if (Ac() || bEs()) return true;
  let e = s8t();
  if (e === undefined || QCr(e) || XCr(e)) return true;
  return i.CLAUDE_CODE_ENABLE_TODO_TOOLS === true;
}

function Jue() { return r0() && p5(); }
各ツールの定義
userFacingName() { return "TaskCreate" }, isEnabled() { return Jue() },
userFacingName() { return "TaskGet"    }, isEnabled() { return Jue() },
userFacingName() { return "TaskUpdate" }, isEnabled() { return Jue() },

つまり、CLAUDE_CODE_ENABLE_TODO_TOOLSが本命の環境変数

3. 環境の変数の設定

以下の設定を行わなくてもCLAUDE_CODE_ENABLE_TODO_TOOLS=1 claudeとして起動すればセッションごとにタスクリストが有効化される

共通設定を行う場合は先に進むべし

settings.json の env ブロックに書くと、セッションの環境変数として入る。機能トグルは個人設定なのでユーザースコープ(~/.claude/settings.json)にした。

settings.json
{
  "model": "claude-opus-5",
  "env": {
    "CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"
  }
}

4. 検証

"1"が返ってくれば、jsonは壊れておらず設定も正しくできている。

jq -e '.env.CLAUDE_CODE_ENABLE_TODO_TOOLS' ~/.claude/settings.json
# => "1"

ClaudeCodeのよる自己回復

claude codeには、update-configというSkillsがデフォルトで入っており、これを使うことで安全に設定を編集・検証してくれる。

まとめ

今回は、claude codeでTaskListが使えなくなる事象が発生したので、環境変数CLAUDE_CODE_ENABLE_TODO_TOOLS=1で設定することで回復した。

解決法は2種類あり、セッションごとにCLAUDE_CODE_ENABLE_TODO_TOOLS=1 claudeと起動するか、settings.jsonに"CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"として設定することでタスクリストを再有効化できる。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?