Claude Code に任せると、気づいたら最後まで走り切っていて、途中の判断材料が消えることがある。これが地味に痛い。途中報告を入れさせる、中間報告を入れさせる、進捗の粒度を決める。この3つをちゃんと使うだけで、勝手に突き進んで戻れなくなる事故をかなり減らせる。
特に、ファイル整理や文書作成みたいな「正解はあるが、途中で見たい」作業では効く。全部終わってから見せられても、そこまでの流れが雑だと手戻りがだるい。最初に報告の頻度を決めておけば、Claude Code は勝手に走る道具ではなく、区切って確認しながら進む相棒になる。
まず押さえるべきなのは、指示は「こまめに見せて」だけでは弱いという点だ。Claude Code は、曖昧な指示だと節目の定義を自分で決めがちだし、その節目があなたの感覚とズレる。だから、何回ごとに、どの単位で、何を報告するのかまで決める。
たとえば、文書のたたき台を作らせるなら、こう書く。
まず作業計画を短く出してから、3段階ごとに途中報告してください。
各途中報告では、今やったこと、次にやること、迷っている点を3行で示してください。
勝手に最後まで進めず、各段階の終わりで止まって確認を待ってください。
この書き方のいいところは、頻度と粒度が両方入ることだ。単に「途中で報告して」だと、Claude Code はたまに大きめの節目でしか止まらない。逆に「細かく報告して」だけでは、何をどの程度まとめるのかが曖昧で、報告が長くなるか、逆に薄くなる。報告の中身まで固定しておくとぶれにくい。
ファイル整理でも同じだ。たとえば大量の資料から不要ファイル候補を洗い出すとき、いきなり全件処理させると、誤削除の不安が残る。そこで、次のように区切る。
1フォルダ処理するごとに途中報告してください。
報告には、見つけた重複候補、削除候補、保留したものの理由を入れてください。
こちらが承認するまで削除は実行しないでください。
ここで大事なのは、「実行」と「提案」を分けることだ。Claude Code は提案をうまくやるが、提案のまま進めると、あとで見たときにどこまでが候補でどこからが実作業か分かりにくい。とくに削除系は、報告を挟まずに一気に進めると事故が起きやすい。筆者も最初、この切り分けを甘くして、あとで差分を見返すのが面倒になった。人間側が「まあ大丈夫だろ」と流すと、確認ポイントが消えるからだ。
もう少し実務的にやるなら、報告頻度を「回数」ではなく「意味のある単位」で決めるほうがいい。たとえば、作業が大きく3つに分かれるなら「各フェーズの終わりで報告」、ファイルが多いなら「10件ごとに報告」、文章なら「見出し1本ごとに報告」といった具合だ。回数だけ指定すると、内容が薄いのに報告だけ増える。逆に単位だけだと、どこで止まるかがぶれる。両方あると安定する。
文章作成なら、こんな頼み方が使いやすい。
この文章を、導入・本文・締めの3段階で進めてください。
各段階の終わりで中間報告を入れ、そこで必ず止まってください。
中間報告では、追加した要素と、まだ決めていない点を明示してください。
これで何がいいかというと、途中で方向修正しやすいことだ。最後まで書き切ってから「やっぱりトーンが違う」「この例は要らない」と言うのは、だいぶだるい。中間報告があれば、いらない枝を早めに切れる。diff も小さくなるし、読み返す側の負担も減る。
ただし、途中報告を細かくしすぎると、逆に作業が細切れになって遅く感じる。ここは勘違いしやすい。報告は監視ではなく、確認ポイントだ。1ファイルごとに止めるべき場面もあれば、まとまりのある1章を一気に進めたほうがいい場面もある。たとえば、Markdown の見出し構成を整えるだけなら、章ごとに止めさせるほうが自然だが、単純な名前変更や置換なら、数件まとめてから報告させたほうが効率がいい。
要するに、こう考えるといい。
「どこで人間の判断が要るか」を先に決め、その地点で止まらせる。
「どこまで進めたか」を短く報告させる。
「止まる条件」を曖昧にしない。
もし作業の途中で何度も確認したいなら、依頼文にこの一文を足すと扱いやすい。
判断が必要な箇所では、続行せずに止まって質問してください。
質問がない段階では、次の報告単位まで進めてください。
これで「全部聞いてくる」か「勝手に進む」かの極端さを抑えられる。Claude Code には、考えるべきところでは止まり、止まらなくていいところは進んでもらうのがちょうどいい。雑に任せると、あとで見返したときに流れが見えない。そこだけは最初に縛っておいたほうがいい。
最後に、報告の粒度を決めるときの実用的な目安を書いておく。
大きな方針が変わる作業では、各フェーズごとに報告。
安全性が気になる作業では、少量ごとに報告。
単純な整形作業では、まとまりごとに報告。
この線引きを最初に言語化しておくと、Claude Code はかなり扱いやすくなる。黙って進みすぎるのを防ぐ一番のコツは、頑張って見張ることではない。どこで息継ぎさせるかを先に決めることだ。