一気に全部やろうとすると、だいたい雑になる。Claude Code でも同じで、でかい変更をひと塊で投げると、途中で文脈があふれて、直したい箇所まで巻き込んで壊しやすい。差分を小さく保つコツは、気合いではなく区切り方だ。
Claude Code は、ローカルのファイルを読んで、変更案を返して、そのまま編集まで進められる。だからこそ、最初の依頼文で「何を1回分の仕事にするか」をはっきり切るだけで、手戻りがかなり減る。開発でも文書整理でもファイル整理でも効く。むしろ非エンジニアほど、この区切りが効く。
たとえば、フォルダ整理で「重複っぽい書類を見つけて、年別に分けて、ファイル名も整えて、不要キャッシュも消して」と全部まとめて頼むと、途中で迷う。先にやるべきなのは、検出だけなのか、移動までなのか、削除までなのかを分けることだ。Claude Code に任せる単位を小さくすると、確認もしやすいし、戻すのも楽になる。
まずは、頼み方を「調べる」「提案する」「実行する」に分ける。これだけで事故率が下がる。
# 例: 変更前に候補だけ出させる
Claude Code に以下を依頼する:
「このフォルダ内で重複していそうなPDFを洗い出して。
削除はしないで、候補を一覧にして。
判断材料として、ファイル名・サイズ・更新日時も出して。」
# 例: 次に整理方針を作る
Claude Code に以下を依頼する:
「上の一覧をもとに、残すものと移すものの方針を提案して。
まだファイルは変更しないで、手順だけを短くまとめて。」
# 例: 最後に実行する
Claude Code に以下を依頼する:
「この方針に従って、ファイル名の変更と移動だけを実行して。
削除はまだしないで。変更後に差分を確認できるようにして。」
この三段階が地味に効く。いきなり実行まで入れると、Claude Code は親切にまとめて動こうとする。だが、親切さがそのまま危険になる場面がある。特に、ファイル名変更、複数ファイルの内容置換、ディレクトリ再構成みたいな作業は、1回の差分が大きくなりがちだ。差分が大きいと、どこで何が変わったのか追いにくい。レビューもつらい。手直しもつらい。つらさの三重奏になる。
筆者も最初、これをやって痛い目を見た。README の整理、設定ファイルの見直し、古いメモの移動をまとめて頼んだら、結果は見た目きれいでも中身が雑だった。説明文の修正とファイル移動と構成変更が同じ塊になり、どれが効いてどれが余計か分からない。あとから1箇所だけ直したいのに、前提が崩れていてやり直しになる。あれは本当にだるい。以後は、1回の依頼で変える対象を絞るようにしている。
区切り方の目安は、内容ではなく「戻せるかどうか」で決めるといい。次のどれかに当てはまるなら、そこで切る。
たとえば文書作成なら、まず章立てだけを整える。次に各章の要点だけを書く。最後に表現を磨く。これを一度にやると、構成の良し悪しと文章の良し悪しが混ざる。混ざると判断できない。文章はうまく見えても、構成が崩れていることがある。逆もある。だから、構成、内容、表現の順に分ける。仕事が雑に見えて、実は一番事故りにくい。
Claude Code への指示も、最初から「完成させて」ではなく、途中の成果物を明示したほうがいい。たとえばこうだ。
この資料を次の順で進めてください。
1. いまの構成のまま、重複している見出しを洗い出す
2. 見出しだけを整理した案を出す
3. 合意したら本文を少しずつ直す
一度に本文全体は書き換えないでください。
この書き方だと、Claude Code も暴走しにくい。何を終わりとするかが見えるからだ。逆に、「いい感じに整えて」は危ない。いい感じ、は人間同士でもズレる。Claude Code はなおさらだ。作業のゴールが曖昧だと、差分がふくらむだけで終わる。
実務では、変更の種類ごとに回を分けるのがいちばん安定する。コードなら、リファクタリングと機能追加を分ける。文書なら、内容追加と文体修正を分ける。ファイル整理なら、分類と削除を分ける。順番を混ぜない。混ぜると、どの判断が危なかったのか追えないからだ。
特に注意したいのは、削除と移動を同じ回にしないことだ。削除は取り返しがつきにくい。移動はまだ戻せるが、削除は戻せないことがある。だから、まず移動だけ、次に確認、最後に削除、の三段階が安全だ。これは地味だが、あとで助かる。
もう1つ、変更を小さく保ちたいなら、Claude Code に「途中で止まる」余地を与えるといい。以下のように書くと、勝手に大工事されにくい。
まずは方針だけ出してください。
実行はしないでください。
私が「次へ」と言ったら、その1段階だけ進めてください。
変更は1カテゴリずつにしてください。
たとえば「ファイル名の整形」だけを終えたら止めてください。
次のカテゴリには進まないでください。
このやり方は、コンテキストの節約にもなる。いちどに全部やると、会話の流れも長くなり、途中で前提がぼやける。小分けにすれば、直前の判断だけ見ればよくなる。Claude Code は長い相談もできるが、だからといって長くまとめるほど得というわけではない。むしろ逆だ。
最後に、区切ったあとに必ず確認する癖をつける。差分は毎回見る。ここを飛ばすと、小さな変更にした意味が消える。Git を使うなら、コミットも小さく切る。文書やファイル整理なら、各段階で結果を保存する。戻せる単位にしておけば、失敗しても傷が浅い。
大きな変更を安全に進めるコツは、賢く一発で当てることではない。見える単位に刻んで、1回ごとに確認することだ。Claude Code は、その刻み方をちゃんと指示したときにいちばん扱いやすい。雑に大きく頼むと雑に大きく返ってくる。そこを外さなければ、作業はかなり安定する。