この内容は、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. 定義を読む
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)にした。
{
"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"
まとめ
今回は、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"として設定することでタスクリストを再有効化できる。