導入

ClaudeCodeの真骨頂は、コードを生成するだけでなく、実際のファイルを「読んで」「書き換えて」「新規作成する」ところにあります。普通のチャットAIとの最大の違いは、提案を文字列で返すだけでなく、ファイルシステムに直接アクセスして変更を反映できる点です。しかし、この強力な機能は同時に怖さも持ち合わせています。「間違えてファイルを消してしまわないか」「意図しない場所まで書き換わらないか」と不安に感じる方も多いでしょう。実は、ClaudeCodeは安全に使えるよう、ファイル操作を3つのツール（Read、Edit、Write）に分けており、それぞれが異なる目的と確認フローを持っています。本記事では、この3つのツールの使い分け、複数ファイルにまたがる編集、差分の見方、確認プロンプトの仕組みまで、丁寧に解説します。

結論

ClaudeCodeのファイル操作は、Read（読む）、Edit（部分編集）、Write（全体書き込み）の3つのツールで構成されています。Readは安全で、いくらでも自由に使えます。EditとWriteは実際にファイルを変更するため、必ず実行前に確認プロンプトが表示され、ユーザーが承認するまでファイルは変更されません。3つの使い分けの基本ルールはシンプルです。「変更前は必ずRead」「既存ファイルの一部を変えるならEdit」「新規ファイルや全面書き換えはWrite」。これを守ればトラブルはほぼ起きません。複数ファイルにまたがる編集も得意で、「このプロジェクト全体で関数名XをYに変えて」のような依頼にも対応してくれます。差分表示は緑（+）が追加、赤（-）が削除を示し、これを読めるようになると安心して承認できます。さらに、ClaudeCodeはEditを実行する前に必ずReadでファイルを読み込むという内部ルールを持っており、これによって「中身を見ずに勝手に書き換える」というリスクが排除されています。本記事の手順を理解しておけば、数百行のコードベースを自信を持ってClaudeCodeに任せられるようになります。

ファイル操作ツールの全体像

ClaudeCodeのファイル操作は、主に次の3つのツールで行われます。

Read（読み込み）

指定したファイルの中身を読み取ります。中身を変更しない安全な操作なので、確認プロンプトは表示されません。行番号付きで内容が返されるため、ClaudeCodeはどの行に何が書かれているかを正確に把握できます。

Edit（部分編集）

既存ファイルの一部分を書き換えます。「この文字列をこの文字列に置き換える」という形で動作するため、ファイルの他の部分には影響しません。実行前に必ず確認プロンプトが出ます。

Write（書き込み・新規作成）

ファイルを新規作成、または既存ファイルを丸ごと上書きします。Editよりも大胆な操作で、確認プロンプトも当然表示されます。

この3つを使い分けることで、安全かつ効率的なファイル操作が実現されます。

Readツールの使い方

Readツールは「読み取り専用」なので、気軽に使えます。例えば次のような依頼をすると、ClaudeCodeはまずReadでファイルを読み込みます。

src/index.js を読んで、何をしているか説明してください

このとき、画面には次のような表示が出ます。

Read src/index.js (45 lines)

ClaudeCodeはファイルの内容を理解した上で、説明を返してくれます。Readは大きいファイルを読むときには行数を絞ることもできるため、巨大なログファイルやデータファイルにも対応可能です。

config.json の最初の100行だけ読んでください

Editツールの使い方

既存ファイルの一部だけを修正したいときに使うのがEditです。最も実用的なケースは「特定の関数だけ書き換える」「typo を直す」「コメントを追加する」などです。

例えば、次のような依頼をしたとします。

src/utils.js の calculateTotal という関数で、税率を 0.08 から 0.10 に変更してください

ClaudeCodeはまずReadでutils.jsを読み込み、該当箇所を特定した後、Editで以下のような差分を提示します。

src/utils.js
- const TAX_RATE = 0.08;
+ const TAX_RATE = 0.10;

Do you want to make this edit?
1. Yes
2. No

- で始まる行が削除される内容、+ で始まる行が追加される内容です。ここで「Yes」を選ぶとファイルが実際に変更され、「No」を選べば何も起きません。

Editの良いところは、変更箇所がピンポイントで分かることです。ファイル全体が書き換わるわけではないので、想定外の変更が混入しにくいのが特徴です。

Writeツールの使い方

新しいファイルを作るときや、ファイル全体を作り直すときはWriteを使います。

README.md を新規作成して、このプロジェクトの説明を書いてください

このとき、ファイルがまだ存在しない場合はWriteで新規作成されます。すでに存在する場合は、丸ごと上書きされるため、注意が必要です。Writeも実行前に内容と確認プロンプトが表示されます。

Write README.md
+ # My Project
+ 
+ このプロジェクトは...
+ (全文)

Do you want to make this edit?
1. Yes
2. No

新規作成時はすべての行が + で表示されます。既存ファイルを上書きする場合は、元の内容との差分が表示されます。

確認プロンプトの仕組み

ClaudeCodeの安全性の核は「確認プロンプト」にあります。EditとWriteは必ず、実行前にユーザーに承認を求めます。

承認には主に次のオプションがあります。

• Yes: 今回のこの変更だけを許可
• No: 変更をキャンセル
• Yes, allow all edits for this session: このセッションでは以降の編集を自動承認

セッション中ずっと毎回承認するのが面倒なときは、自動承認モードを選ぶこともできます。ただし、重要なプロジェクトでは毎回確認することを強くおすすめします。一括承認モードでも、明らかに危険な操作（ファイル削除など）には別途確認が入ります。

複数ファイルの一括編集

ClaudeCodeは複数のファイルにまたがる編集も得意です。例えば次のような依頼が典型例です。

このプロジェクト全体で、変数名 userId を accountId に変更してください

ClaudeCodeは関連ファイルを順番にReadし、それぞれの変更内容をEditで提示します。複数の確認プロンプトが連続して出るので、1つずつ承認していくか、まとめて承認するかを選びます。

別パターンとして、新しい機能追加で複数ファイルを作る場合もあります。

ユーザー管理機能を追加してください。
- models/user.js (Userモデル)
- routes/users.js (APIエンドポイント)
- tests/users.test.js (テスト)
を作成してください。

このとき、ClaudeCodeは順番に各ファイルをWriteで作成します。それぞれ確認プロンプトが出るので、必要に応じて承認していきます。

差分の読み方

Edit実行時に表示される差分は、慣れると一目で理解できます。基本的な記号は次の通りです。

• -（マイナス、赤）: 削除される行
• +（プラス、緑）: 追加される行
• 何もない行: 変更されない（周辺コンテキスト）

複雑な変更の場合、複数の差分ブロックが表示されることもあります。

src/app.js
@@ -10,7 +10,9 @@
   const user = getUser(id);
-  if (user) {
-    return user.name;
-  }
+  if (!user) {
+    return null;
+  }
+  return user.name;

@@ -10,7 +10,9 @@ という行は「元のファイルの10行目から7行分が、新しいファイルでは10行目から9行分に変わる」という意味です。最初は難しく感じるかもしれませんが、慣れると変更の概要を素早く把握できるようになります。

EditとWriteの使い分け

どちらを使うべきか迷ったときの目安は次の通りです。

Editを選ぶケース

• 既存ファイルの一部を修正する
• 変更箇所がはっきりしている
• 既存の他の部分を壊したくない

Writeを選ぶケース

• 新規ファイルを作成する
• ファイル全体を作り直す
• ボイラープレートを一から書く

実際のところ、ClaudeCodeが自動で適切なツールを選んでくれることが多いので、ユーザーが意識する場面は少ないです。ただ、Writeが選ばれたときは「ファイル全体が書き換わる」ことを認識しておくと、想定外の変更を防げます。

ファイル操作で失敗しないための工夫

gitでコミットしてから依頼する

大きな変更を頼む前には、現状をgitでコミットしておきましょう。万が一変更内容が気に入らなくても、git resetやgit checkoutで元に戻せます。

git add .
git commit -m "before claude refactor"

バックアップを取る

gitを使わないプロジェクトでも、重要なファイルはコピーを取っておくと安心です。

Plan modeを活用する

複雑な変更を頼むときは、Plan modeを使うとClaudeCodeがまず計画だけを示してくれます。実行前に全体像が見えるので、安心して承認できます。

確認プロンプトで「内容」を必ず読む

承認するときは、差分の内容を必ず目で見て確認しましょう。慣れてくると流れ作業になりがちですが、ここを丁寧にやることが結果的に作業時間を短縮します。

大きなファイルや巨大プロジェクトでの注意点

ClaudeCodeは大きなファイルも扱えますが、無制限ではありません。1ファイル数千行に及ぶような場合は、次の工夫が役立ちます。

• ファイル全体ではなく、特定の関数や範囲を指定して読ませる
• 巨大ファイルは事前に分割しておく
• バイナリファイルは扱えないので、テキスト形式に変換する

また、何百ファイルもあるプロジェクトでは、CLAUDE.mdに「主要なディレクトリ構成」を書いておくと、ClaudeCodeが効率的にファイルを見つけられます。

ファイル削除はどうやるか

EditやWriteと違い、ファイル削除は明示的にBashツールを通じて行われます。

不要な test_old.js を削除してください

ClaudeCodeは確認した上で、rm test_old.js のようなコマンドを実行します。これも確認プロンプトが必ず出ます。削除は元に戻せないことが多いので、特に慎重に確認してください。Bashコマンドの実行についてはClaudeCodeのbash統合も参考になります。

トラブル対応

変更後に動かなくなった

差分を確認した上で「さっきの変更を元に戻してください」と頼めば、ClaudeCodeが逆向きの変更を行ってくれます。gitを使っていれば、git checkoutが確実です。

ファイルを間違って上書きしてしまった

承認直後なら、すぐに「元の内容に戻してください」と依頼します。ClaudeCodeは履歴から元の内容を覚えていることが多いです。バックアップやgitがあれば、それを使うのが確実です。

Editがうまくいかない（該当箇所が見つからない）

EditはRead時の内容と完全一致する文字列を探します。タブやスペースの違いで失敗することがあるため、その場合は範囲を明示して再依頼するか、Writeで書き換えてもらいます。

詳しいトラブル対応はClaudeCodeのよくあるエラーと対処法を参照してください。

FAQ

Q1. ファイルを編集するたびに確認するのは面倒ではありませんか?

最初は面倒に感じますが、安全のためには有用です。慣れてきて信頼できる範囲なら「allow all edits」を使うとセッション中の手間が減ります。

Q2. ClaudeCodeはどんなファイル形式でも編集できますか?

テキストベースのファイル（.js, .py, .md, .json, .css, .html, .txtなど）はすべて編集できます。画像や音声などのバイナリは編集できません。

Q3. ファイルの一部だけ読むことはできますか?

はい、行範囲を指定して読み込めます。「50行目から100行目だけ読んで」のように依頼すれば、その範囲のみ取得されます。

Q4. 編集前に差分のプレビューを見たいです

EditやWriteを実行する前に必ず差分が表示されるので、自動的にプレビューが見られます。さらに詳しく見たい場合は「変更内容を説明してから実行して」と頼めば、説明が先に出ます。

Q5. 複数ファイルを一度に編集すると、途中で失敗したらどうなりますか?

途中で失敗したり、ユーザーが「No」と答えたりした場合、それまでに承認したファイルの変更は残り、未承認のものは適用されません。半端な状態を避けるには、gitで事前にコミットしておくのが安全です。

Q6. ClaudeCodeに編集してほしくないファイルを指定できますか?

.gitignore に近い形で、ClaudeCodeの設定ファイル（settings.json など）で読み取り・編集対象から除外できます。詳しくはClaudeCodeの設定ガイドを参照してください。

Q7. 編集履歴はどこかに残りますか?

ClaudeCode自体には永続的な編集履歴はありません。履歴を残したい場合はgitなどのバージョン管理ツールを使うのが鉄則です。

まとめ

ClaudeCodeのファイル編集は、Read、Edit、Writeという3つのツールで構成され、それぞれが明確な役割を持っています。Readで読み、Editで部分変更し、Writeで新規作成・上書きする。この基本ルールを押さえれば、ファイル操作で失敗することはほとんどありません。確認プロンプトと差分表示の仕組みを理解しておけば、AIにファイルを任せる不安も大きく減ります。複数ファイルにまたがる編集や、巨大なプロジェクトでも、ClaudeCodeは強力な相棒として機能します。最初は1ファイル単位の小さな編集から始め、徐々に複雑な依頼に挑戦していけば、いつの間にか手放せないツールになっているはずです。gitでのバックアップを習慣にしながら、ClaudeCodeのファイル編集機能を存分に活用してください。

関連記事

• ClaudeCodeとは？基本機能と特徴を徹底解説
• ClaudeCodeの初回利用ガイド
• ClaudeCodeのプロンプト作成のコツ
• ClaudeCodeの設定ガイド
• ClaudeCodeのよくあるエラーと対処法
• ClaudeCodeのbash統合
• ClaudeCodeのスラッシュコマンド一覧