Claude Codeで一部だけ修正する方法｜余計な変更を防ぐ4つのコツ

Claude Codeで既存のWebサイトを修正していると、

「一部分だけ直してほしいのに、どう指示すればいいの？」
「頼んでいないファイルまで変更されるのが怖い」

と感じることはありませんか？

Claude Codeは、プロジェクト全体を確認しながら作業できる便利なツールです。一方で、修正範囲を曖昧に伝えると、意図していない箇所まで変更されることがあります。

そこで大切なのが、修正する範囲と、変更してはいけない範囲を具体的に伝えることです。

この記事では、Claude Codeで必要な部分だけを修正し、余計な変更を減らす方法を、次の4つに分けて解説します。

1. 修正範囲を具体的に指定する
2. 編集前に差分を確認する
3. 変更してはいけない範囲を伝える
4. Gitで元に戻せる状態を作る

難しい設定は必要ありません。実際に使える指示文も紹介するので、そのまま自分の案件に置き換えて試してみてください。

結論：余計な変更を防ぐ4つのコツ

① 修正範囲は「ファイル名＋対象箇所」で指定する

修正範囲を伝えるときは、ファイル名だけでなく、セレクタ名や関数名なども指定します。

曖昧な指示

ヘッダーの色をオレンジにして。

具体的な指示

assets/css/style.cssにある.site-headerのbackground-colorだけを、オレンジの#E8915Aに変更してください。ほかのプロパティやセレクタは変更しないでください。

指定するときのポイントは、次の3つです。

• 対象のファイル名
• セレクタ名や関数名
• 変更するプロパティや処理

行番号が分かる場合は補足として伝えてもよいですが、コードを追加・削除すると行番号は変わります。そのため、行番号だけに頼らず、セレクタ名や関数名も一緒に指定するのがおすすめです。

② 編集前に差分を確認する

いきなりファイルを編集させず、最初に変更案だけを出してもらうと、想定外の修正を防ぎやすくなります。

まだファイルは編集しないでください。まず、予定している変更をdiff形式で示してください。

表示される差分は、次のような形です。

- background-color: #ffffff;
+ background-color: #E8915A;

差分が想定どおりなら、編集を依頼します。関係のないファイルや多くの行が含まれている場合は、修正範囲をもう一度絞り込みます。

Claude CodeのPlan Modeを使う方法もあります。Plan Modeでは、Claude Codeがコードを調査して変更案を考える一方、ファイルの編集やコマンドの実行は行いません。Claude Code公式ドキュメント

③ 「他は変更しない」と明示する

修正対象だけでなく、変更してほしくない範囲も伝えます。

.site-headerだけを変更してください。ほかのセレクタやファイルは変更しないでください。

内容に応じて、次の指示も追加できます。

• 「HTMLの構造は変更しない」
• 「デザイン以外の動作は変更しない」
• 「既存のクラス名は変更しない」
• 「CSSやJavaScriptの読み込み順は変更しない」
• 「コードの整理やリファクタリングは行わない」

「他は触らない」だけよりも、何を変更してはいけないのか具体的に伝えるほうが効果的です。

④ 作業前にGitで元に戻せる状態を作る

Claude Codeに修正を依頼する前に、現在の状態をGitへ記録しておくと、想定外の変更があっても元に戻せます。

まず、未保存の変更を確認します。

git status

内容に問題がなければ、作業前の状態をコミットします。

git add -A
git commit -m "before: ヘッダー色変更前"

ただし、別の作業途中の変更や、コミットしてはいけないファイルが含まれていないか、git statusで必ず確認してください。

修正後は、次のコマンドで変更内容を確認できます。

git diff

対象ファイルだけを元に戻す場合は、ファイル名を指定します。

git restore -- assets/css/style.css

git restore .を実行すると、ほかのファイルにある未コミットの変更まで戻る可能性があります。初心者向けの記事では、対象ファイルを指定する方法を案内するほうが安全です。

そのまま使える指示文

まだファイルは編集しないでください。
まず、予定している変更をdiff形式で示してください。

修正対象は、assets/css/style.cssにある
.site-headerのbackground-colorだけです。

background-colorを#E8915Aに変更してください。

次の箇所は変更しないでください。

・.site-header内のほかのプロパティ
・ほかのセレクタ
・ほかのファイル
・HTMLの構造
・クラス名

コードの整理やリファクタリングも行わないでください。

差分を確認して問題がなければ、次のように伝えます。

提示した差分の内容だけを反映してください。
反映後に、実際に変更したファイル名と変更内容を報告してください。

まとめ

Claude Codeで一部だけを修正してもらうときは、次の4つを意識します。

指示を具体的にしても、意図しない変更を完全に防げるとは限りません。だからこそ、編集前に変更案を確認し、編集後にGitの差分を確認することが大切です。

そもそも Claude Code で何ができるのかは、Claude Codeとは？にまとめています。

余計な変更をそもそも起こしにくくする設定は、Claude Codeの初期設定の権限のところで触れています。