Claude Code でありがちな失敗は、こちらが「ちょっと整えて」と言っただけなのに、気づいたら深いところまで掘り進んでいて、最後にまとめて見せられることだ。これ、気持ちはわかるが、後から戻すのがだるい。ファイル整理でも文書作成でも同じで、途中で一回止めてくれないと、方向がずれていても気づけない。
そこで効くのが、途中報告を指定する、つまり進捗報告の粒度を決めるやり方だ。Claude Code に「何分ごとに報告してくれ」と機械的に命令するより、「どの単位で止まり、何を見せるか」を先に決めておくほうがずっと実用的である。黙って進みすぎるのを防ぐだけで、手戻りはかなり減る。
たとえば、最初の依頼にこう添える。
まず、作業を小さく区切って進めてください。
各ステップの終わりで、やったこと・見つけた問題・次にやることを短く報告してください。
勝手に大きく先へ進まず、一区切りごとに私の確認を待ってください。
この「一区切り」が肝だ。時間ではなく、作業単位で切る。
ファイル整理なら「重複候補の洗い出しまで」「不要そうな一時ファイルの候補抽出まで」「削除前の一覧提示まで」と分ける。文書作成なら「骨子作成まで」「見出しの並べ替えまで」「本文の追記案まで」と切る。コード修正なら「影響範囲の確認」「修正案の提示」「実装」「テスト結果の報告」と分ける。こうしておくと、黙って長々と進まない。
実際、筆者は最初、「最後に完成品を見せればいいだろう」と雑に頼んで、あとで手戻りしたことがある。Claude Code が悪いというより、こちらの指示が粗かった。途中の見せ場がないと、こちらは判断材料を失う。結果、不要な変更まで含んだ差分をまとめて飲まされる。あれは痛い。
途中報告を安定させたいなら、依頼文に見える形で期待値を書いておくといい。たとえば次のようにする。
作業は次の粒度で進めてください。
1. 現状の確認
2. 変更方針の提示
3. 小さな単位で実施
4. 各単位の完了ごとに報告
5. 私の確認後に次へ進む
報告には、完了したこと、未完了のこと、気になる点を含めてください。
この書き方のいいところは、Claude Code が「どこで止まればいいか」を誤解しにくいことだ。
単に「こまめに報告して」とだけ書くと、何をもってこまめとするのか曖昧だ。1ファイルごとか、1手順ごとか、1ディレクトリごとか。そこを決めるのが先である。
非エンジニア用途でも同じだ。たとえば、散らかった資料フォルダを整理したいなら、いきなり全削除まで進ませない。まずは候補を出させ、次に分類案を出させ、その次に移動案を出させる。削除は最後だ。途中報告がないと、似た名前のファイルをまとめて消すところまで走られて困る。
PDFと画像の整理を手伝ってください。
いきなり移動や削除はしないでください。
まず重複候補と不要候補を一覧にし、次に分類ルールを提案し、私が確認してから作業してください。
各段階の終わりで短く報告してください。
ここで大事なのは、報告の「量」ではなく「中身」だ。長文でだらだら進捗を吐かせても意味がない。見たいのは、何を変えたか、何が未確定か、次に何をするか、の3点で十分である。報告が長すぎると、読む側が疲れて結局見なくなる。短く、しかし要点は外さない。これがちょうどいい。
一方で、やりすぎると邪魔にもなる。小さな変更のたびに確認待ちにすると、作業が細切れになりすぎて逆に遅い。だから、最初に止めどころを決めるべきだ。たとえば「ひとまとまりの変更が終わるごとに報告」「危険な操作の前だけ止まる」「見出しの再編が終わったら報告」といった具合である。全部の行動で止める必要はない。
筆者はここで一度、報告を細かくしすぎて失敗した。1つ直すたびに止めるようにしてしまい、会話が断続的になって、逆に全体の流れが見えなくなったのだ。作業者も依頼者も、どこまで進んだかを追いにくくなる。途中報告は多ければいいものではない。意味のある区切りに絞るのが正解だ。
実務では、こんなルールが使いやすい。
- 取り返しのつかない操作の前では必ず止まる
- 1つの論点や1つのフォルダ単位で報告する
- 報告には「完了」「保留」「次の一手」を入れる
- 私の確認なしに次の大きな段階へ進まない
これでかなり安定する。
特に、削除・上書き・大量移動の前は必ず止めておくべきだ。Claude Code は速い。だからこそ、止める指示がないと、その速さがそのまま事故になる。
もう一つ、途中報告を機能させるコツがある。最初の時点で「最終成果物だけでなく、中間成果も欲しい」と明言することだ。たとえば、文書作成なら「完成版だけでなく、章立て案も見たい」。整理作業なら「移動後の一覧だけでなく、移動前の候補一覧も見たい」。こう書くだけで、報告の質が上がる。Claude Code は指示したものを見せようとするので、欲しいものを先に言わないと外す。
要するに、途中報告は「小まめに連絡してね」という気分論では足りない。どの単位で、何を含めて、どこで止まるかを決める。そこまで書いて、ようやく黙って進みすぎない状態になる。Claude Code を使うときは、速さより見通しを優先したほうがいい。速く走るより、途中でちゃんと顔を上げるほうが、結局は早い。