基礎
TodoWrite(タスク追跡)とは?
読み方: トゥドゥライト
定義
Claude Code が複数ステップのタスクを ToDo リストとして可視化・追跡するビルトインツール。長期タスクの進捗管理に使う。
詳しい解説
TodoWrite は Claude Code が現在のタスクを ToDo リストとして整理し、進捗を可視化するためのビルトインツールです。複数ステップにわたる作業(マイグレーション、リファクタリング、機能実装など)では、Claude が自動的に TodoWrite を呼び出してタスクを細分化し、in_progress / completed のステータスを更新しながら進めます。ユーザーは画面上で残りタスクをひと目で確認でき、Claude も次に何をすべきかを毎ターン明示するため、長期タスクで脱線しにくくなります。TodoWrite が威力を発揮するのは、(1) 3 ステップ以上の作業を含む実装、(2) 並列に複数の独立作業を進めるシナリオ、(3) リファクタリングのように影響範囲が広いタスク、です。Claude Code は in_progress を常に 1 つだけ保つ運用が推奨されており、現在の集中ポイントが明確になります。ユーザーは ToDo の完了を待たずに方向転換の指示を出すこともでき、その場合 Claude は ToDo を更新してから新しいタスクに切り替えます。シンプルなタスク(1〜2 ステップ)には使わない方針が推奨されており、過剰な ToDo 化を避けて自然な対話の流れを維持できます。TodoWrite と /compact を組み合わせると、長時間のセッションでも進捗を見失わずにコンテキストを効率的に管理できます。