Claude Code にまとめて置換を頼むと、たしかに早いです。けれど、ひとたび思った通りでない変更が混ざると、どこから直せばいいか分からなくなります。そこで効くのが、小さく直して、小さく確かめて、問題があればすぐ戻せる形に分けるやり方です。
これは開発だけの話ではありません。大量の文書名を揃える、案件フォルダの中身を整理する、重複した表記を統一する、といった作業でも同じです。
Claude Code は、ファイルを直接書き換える前に「どう分けて進めるか」を人間が決めておくと、とても扱いやすくなります。いきなり全件置換を指示するより、まず対象を絞り、次に一部だけ反映し、最後に確認して広げる。この順番にすると、途中で止めても作業が崩れません。
たとえば、社内文書の表記を「メールアドレス」から「連絡先」に寄せたい、あるいは案件資料のファイル名から日付の表記ゆれをなくしたい。そんなときは、最初から「全ファイルを一斉に置換して」と頼むのではなく、次のように進めます。
1. まず対象ファイルを一覧にして
2. 変更候補を確認できる差分を出して
3. 1つのフォルダだけ先に反映して
4. 問題なければ範囲を広げて
5. 途中で困ったら、どの段階まで戻せばよいか分かるようにして
Claude Code への依頼文も、最初から完成形を求めないほうが安定します。たとえば文章の言い換えなら、こんなふうに区切るとよいです。
このリポジトリ内の Markdown ファイルについて、
「メールアドレス」という表現を「連絡先」に置き換えたいです。
いきなり全件変更せず、次の順で進めてください。
1. 置換対象になりそうな箇所を一覧化する
2. まず 1 ファイルだけ、最小限の変更で反映する
3. 差分を見て、意味が変わっていないか確認する
4. 問題がなければ同じ方針で広げる
変更前に、どの段階で止められるかも説明してください。
コード修正でも考え方は同じです。たとえば API 名を変える、関数名を揃える、設定キーを整理する。こういう作業は、関連箇所が多いほど一気にやりたくなりますが、むしろ危ないです。まず参照箇所だけ洗い出し、次に一部だけ変え、最後にテストや動作確認を挟む。Claude Code に任せるなら、「全部やって」ではなく「段階ごとに止まれる形で進めて」と言ったほうが、修正の意図も残ります。
関数名 foo を bar に変えたいです。
ただし一度に全体へ反映しないでください。
- 参照箇所を先に挙げる
- 影響の少ない箇所から 1 つずつ変更する
- 変更ごとに差分を要約する
- 途中で戻せるよう、どこまで済んだか明示する
破壊的な変更や大きなリファクタリングは、私が確認してから進めてください。
ここで大事なのは、「置換」より「段階を分けた変更」を依頼することです。Claude Code は作業を進められますが、どこで区切るかを決めるのは人間です。区切りがないと、ひとつの小さな誤りが広い範囲に広がります。逆に、1 箇所ずつなら、差分を見ただけで違和感に気づけます。
段階コミットに近い進め方をすると、巻き戻しも簡単になります。Git を使っているなら、各段階でコミットしておけば、問題が出たときにその時点へ戻せます。ここでいうコミットは、作業の区切りを記録することです。大きく一括で保存するのではなく、「ここまでなら安全」と思える単位で切るのがコツです。
git status
git add path/to/file
git commit -m "Normalize terminology in guide draft"
非エンジニアの作業でも考え方は同じです。たとえば、案件ごとのフォルダを整理して、ファイル名の表記を統一する場面を想像してください。「すべてのファイルを一度に直す」と、途中で別案件の資料まで巻き込むことがあります。そこで、まず 1 案件だけを対象にし、命名規則を決め、数本だけ先に整え、問題がなければ同じルールを広げます。Claude Code には、いきなり実行ではなく、候補の一覧と変更案を出させるほうが向いています。
このフォルダ内のファイル名を整理したいです。
いきなり全件変更せず、まず次をお願いします。
- 変更候補の一覧
- 変更ルールの案
- 1 フォルダだけ試した場合の例
- 途中でやめたときに元の名前へ戻せるかの確認
私が確認するまで、実際の変更は最小限にしてください。
気をつけたいのは、段階を分けても「確認を省く」と結局危ない、という点です。小さく分けた変更は、目で見て違和感を探せるのが利点です。差分を飛ばして先へ進むと、段階にした意味が薄れます。もうひとつ、名前だけ似ている箇所をまとめて置換するのも要注意です。文脈が違えば、同じ単語でも意味が変わります。文章、コード、設定ファイルでは、同じ「置換」でも安全な範囲が違います。
もし作業量が多いなら、Claude Code には「次の一手だけ」を頼むと扱いやすくなります。たとえば、対象の洗い出し、1 ファイルへの反映、差分確認、次の範囲への展開、という順に分けるやり方です。これなら途中で止めても、どこまで終わったかが分かりますし、やり直しも局所で済みます。
最後に、これは置換作業に限りません。大量の文書修正、重複データの整理、古い資料名の統一、設定の切り替え。どれも「一気に片づける」より、「小さく区切って確かめる」ほうが強いです。Claude Code を使うときは、速さよりも、戻せる単位で進めることを優先してください。そうすると、作業はむしろ速く終わります。途中で迷う時間が減るからです。