Claude Code に雑に丸投げして、「なんか遠回りしたな」で終わらせるのはもったいない。そこで止めると、次回も同じ場所で迷う。作業ログを見返す、迷った地点を次回に生かす。ここまでやって初めて、CLI のエージェントはただの便利ツールから、だんだん手癖の合う相棒になる。
狙いは単純だ。Claude Code がどこで止まり、何を確かめ、どこで手戻りしたかを拾って、次の指示を最初から少しだけ鋭くする。これだけで、無駄な探索、でかい diff、あいまいな修正の往復が減る。特に、ファイル整理や文書作成みたいに「正解はあるが、そこへ行く道筋がいくつもある」作業で効く。
筆者は最初、ログをほとんど見返していなかった。すると何が起きるか。前回と同じように「とりあえず全体を見てから判断します」と動き、不要な範囲まで触り、最後に「やっぱりここは触らないで」で戻る。差分は膨らむし、どこで判断が鈍ったのかも残らない。地味だが、これがいちばん痛い。
まず、作業ログは「終わったあとに読む資料」ではなく、「次回の依頼文を作る材料」だと考えると扱いやすい。Claude Code には、実行中の会話やコマンドの流れが残る。そこから見るべきなのは、派手な成功例ではなく、むしろ迷った瞬間だ。たとえば、同じファイルを何度も開いた、似た候補を比較していた、途中で方針転換した、対象範囲を広げすぎた、そんな箇所である。
見る順番は、雑でいいが筋は通したほうがいい。筆者は次の順で拾うことが多い。
これを毎回きっちり表にする必要はない。だが、最低でも「迷った地点」と「その原因」だけは抜く。原因はたいてい、次のどれかに落ちる。
このうち、いちばん効くのは「境界を先に渡す」ことだ。たとえば、フォルダ整理なら「このディレクトリ配下だけ」「古い添付ファイルだけ」「重複候補は削除せず一覧化だけ」と先に言う。文書作成なら「事実関係は触らず、表現だけ整える」「見出し構成は維持する」と書く。Claude Code は雑に賢いので、範囲をぼかすと勝手に広げやすい。広げた先で迷う。そこを防ぐ。
実際の見返し方は、あまり構えなくていい。作業が終わったら、会話ログを上から眺めて、次の三つをメモするだけでも十分だ。
この三点が見えたら、次回の依頼文には「先回りの一行」を足す。たとえば、こんな具合だ。
この作業では、まず対象外を明確にしてから進めてください。
迷ったら広げず、いったん候補だけ出して確認してください。
変更は最小限にし、不要な置換や削除はしないでください。
もう少し具体的に、ファイル整理で使うならこうなる。
Downloads フォルダの整理を手伝ってください。
対象は .zip と .pdf と重複しそうな画像だけに絞ってください。
削除はまだせず、まず候補一覧を作ってください。
迷ったら、ファイル名と更新日時だけで判断せず、内容も確認してください。
文書作成ならこうだ。
この議事録を整えてください。
事実関係は変えず、重複表現と長すぎる文だけを直してください。
見出し構成は維持してください。
意味が取れない箇所は推測で埋めず、疑問点として残してください。
こういう一文は、ただの丁寧さではない。Claude Code が勝手に探索を広げるのを抑える、実務的な柵だ。作業ログを見返したからこそ、どこに柵を置くべきかが見える。
注意したいのは、ログを見返して「前回の迷い」をそのまま再現しないことだ。たとえば、前回が「対象を広げすぎた」なら、次回は境界を狭くする。だが狭くしすぎると、今度は必要な修正まで漏れる。ここを極端に振ると、別の手戻りが起きる。筆者も一度、迷った痕跡を嫌がって条件を絞り込みすぎ、肝心の関連ファイルを見落とした。ログを改善に使うはずが、視野狭窄の記録になったわけだ。嫌な話だが、ありがちである。
なので、見返すときは「何を減らすか」だけでなく「何は残すか」も決める。たとえば、次回に引き継ぐのはこんな情報だ。
この情報がたまると、作業ごとの指示テンプレが自然に育つ。だが、テンプレを増やしすぎると逆効果だ。毎回の依頼文が長文になって、読む側も実行側もだるい。だから、テンプレは「固定の長文」ではなく、「引き継ぐ一文の束」にしておくのがちょうどいい。
たとえば、よく迷う作業があるなら、毎回の冒頭に一段だけ足す。
前回迷った点は、対象範囲の広げすぎでした。
今回は、最初に対象外を列挙してから進めてください。
必要なら確認して止まってください。勝手に広げないでください。
これだけで十分効くことが多い。豪華な仕組みはいらない。重要なのは、迷った地点を「反省」で終わらせず、次回の指示に変換することだ。
少し進んだやり方としては、作業ログから「迷いの型」を自分用に分類しておくといい。たとえば、次のようなラベルでざっくり分ける。
この分類があると、次回の依頼文を作るときに、足すべき一文がすぐ出る。毎回ゼロから考えなくて済むので、地味に効く。Claude Code を使う頻度が増えるほど、この差は大きくなる。
最後にひとつ。作業ログは、完璧に残そうとしなくていい。長い会話を全部整形して保存する必要はない。むしろ、迷った地点だけを抜くほうが続く。続かない整理は、だいたい誰にも読まれない。読まれない記録は、次回に効かない。だから、作業が終わったら「どこで止まったか」「次はどう言えば防げるか」だけ拾って、その場で依頼文に一行足す。これで十分だ。
Claude Code をうまく育てるコツは、賢い指示を一発で当てることではない。迷った痕跡を毎回少しずつ回収して、次の依頼を少しだけマシにすることだ。作業ログを見返して、迷った地点を次回に生かす。この地味な一手が、いちばん効く。