黙って最後まで走らせて、あとで「あれ、思っていたのと違う」が出る。Claude Code でもこれをやると、地味に痛い。
進捗報告、報告間隔を先に決めておくだけで、その手戻りはかなり減る。
Claude Code は、こちらが待っている間も延々と考えたり、ファイルを見たり、差分を積んだりできる。だからこそ、途中報告の頻度を先に決めておくのが効く。短い作業なら最後まで黙っていてもいいが、少しでも長引くなら、どのくらいの間隔で止まって報告するかを最初に渡しておくべきだ。これを怠ると、手元では静かでも、裏では見当違いの方向に寄っていき、最後にまとめて修正する羽目になる。
たとえば、最初の依頼文にこう書く。
この作業は途中報告を入れながら進めてください。
ひと区切りごとに、今やったこと・次にやること・迷っている点を短く報告してください。
報告間隔は、作業の節目ごと、または10分ごとを目安にしてください。
大きく方針が割れそうなら、その場で止まって確認してください。
ここで大事なのは、「途中で報告して」で終わらせないことだ。
それだと、Claude Code 側はどこで止まればいいか判断しづらい。節目ごと、時間ごと、どちらでもいいから、報告間隔を具体化しておく。人間の会話でも同じで、「適宜共有して」はだいたい機能しない。機能しないまま進むと、双方の認識がズレたまま最後まで行く。
ファイル整理や文書作成で使うなら、もっと単純でいい。たとえば大量の資料の重複チェックや、案件ごとのフォルダ整理、文章の下書き整形なら、次のように頼むと扱いやすい。
作業を始める前に、進め方を3段階で示してください。
1. 調査
2. 整理
3. 確認
各段階の終わりで途中報告を入れてください。
報告では、見つかったもの、未確定なもの、次に確認したいものを分けて書いてください。
筆者は最初、ここを甘く見ていた。
「必要なら聞いてくるだろう」と思って、長めの整理をまとめて投げたことがある。結果、途中で方針がずれたまま進み、最後の差分がでかくなって、どこで話を止めるべきだったのか分からなくなった。Claude Code が悪いわけではない。こちらが止めどころを渡していないのが悪い。道筋を渡さない長距離走は、だいたい事故る。
途中報告は、単なる安心材料ではない。実は、指示のズレを早く見つけるための道具だ。
たとえば「古いファイルを削除したい」と頼んだつもりが、実際には「似た名前のファイルを要約してほしい」になっていた、みたいなズレはよくある。早い段階で報告を挟めば、その時点で止められる。差分が小さいうちに直せるので、コンテキストの浪費も少ない。
逆に、報告を細かくしすぎると、今度は会話が細切れになってだるい。
数分おきに止めるような指定は、小さい作業ならともかく、少しまとまった仕事では邪魔になる。そこで使いやすいのが、「節目ごと」という考え方だ。Claude Code に任せる作業を、最初からいくつかの山に分ける。
たとえばこんな感じだ。
この作業は、次の節目で途中報告してください。
- 対象の把握が終わったとき
- 方針を決めたとき
- 実際の変更に入る前
- 変更後の確認が終わったとき
各報告は短くていいので、判断に必要な情報だけ出してください。
この書き方のいいところは、時間に依存しない点だ。
時間で切ると、軽い作業では報告が多すぎるし、重い作業では長時間黙り込む。節目で切れば、作業の重さに合わせて自然に報告が入る。
もうひとつ、最初に言っておくと効くのが「止まる条件」だ。
途中報告の頻度と同じくらい、どんなときに止まるかを決めておくと、勝手に進みすぎない。
以下の条件では一度止まって確認してください。
- 変更が複数の候補に分かれるとき
- 既存ファイルを削除する可能性があるとき
- 依頼の解釈が2通り以上あるとき
- 影響範囲が大きいと判断したとき
これを入れておくと、Claude Code が「とりあえずこうした」で押し切るのを防ぎやすい。とくに非エンジニアの用途では、ここが効く。書類をまとめる、不要なファイルを整理する、似た文書を比較する、といった作業は、見た目より判断が多い。勝手に深掘りされると、余計な修正が増えるだけだ。
注意したいのは、途中報告を入れても、依頼文自体が曖昧だとズレは残ることだ。
「いい感じに整理して」だけでは、報告があっても中身がぼんやりしたままだ。途中報告は万能ではない。あくまで、ズレを早く炙り出す仕組みだ。最初の目的、触っていい範囲、触ってほしくない範囲は別で書いておくべきである。
たとえば、こんな頼み方のほうがずっといい。
このフォルダ内の重複しそうなファイルを洗い出してください。
削除はまだしないで、候補だけを一覧にしてください。
途中報告は、候補を5件見つけるごとに入れてください。
判断が割れそうなものは保留にして、なぜ保留にしたかも書いてください。
この「削除はまだしないで」は地味だが大事だ。
報告間隔を決めるのと同じくらい、実行の段階を区切るのが効く。調べる、提案する、実行する。この3つが混ざると、途中報告があっても事故る。
Claude Code を長めの作業に使うなら、最初の一言で「何分おきに報告して」と決めるより、「どの節目で止まり、何を報告するか」を決めるほうが実用的だ。短い仕事なら節目は少なくていい。長い仕事なら、判断が割れたところで止める。これだけで、黙って進みすぎる問題はかなり減る。
要するに、途中報告は礼儀ではなく制御だ。
報告間隔を先に決めておくと、こちらが見ていないところで勝手に深みに入るのを防げる。次に長い指示を出すときは、「途中で報告して」ではなく、「どこで止まり、何を出すか」まで書いておくといい。これで作業はかなり扱いやすくなる。