Claudeのedit_fileができない原因と解決策｜exact matchエラーの正体と回避法

# Claudeのedit_fileができない原因と解決策｜exact matchエラーの正体と回避法

結論：edit_file失敗の原因は「一致条件が厳密すぎること」

ClaudeのMCPツール edit_file を使っていて、こんなエラーに出くわしたことはありませんか？

特にWSL環境では、このエラーが起きやすいです。 改行コードの混在（CRLF vs LF）がexact matchの不一致を引き起こすためです。

Could not find exact match for oldText in file

このエラーが出る原因はシンプルです。`edit_file` は、`oldText` に指定した文字列がファイル内に「完全一致」で存在しないと動かないからです。スペース1つ、改行コード1文字、JSONのエスケープの有無——そのどれかが少しでも違うと、ファイルを変更する前に処理が止まります。

設定ミスでも、Claudeのバグでもありません。仕様として「厳密な一致」を要求しているツールなので、一致しない理由を1つずつ潰していくことが解決への近道です。この記事では、私が実際に詰まったケースをもとに、よくある原因5つと即効の対処法をまとめます。

WSL環境でedit_fileが失敗しやすい理由

WSLを使っている方には、このエラーが特に起きやすいです。なぜWSL環境が鬼門になるのかを、まとめて整理しておきます。

改行コードの混在（CRLF vs LF）

WSL環境では、ファイルがWindowsとLinuxの両方から触られることがあります。Windowsのエクスプローラーでファイルを開いてメモ帳で保存すると、改行コードが CRLF（\r\n）に変換されます。Linux側では LF（\n）が標準です。

Claudeが oldText を LF ベースで生成していても、ファイルが CRLF になっていると1バイト単位の完全一致が取れず、即座にエラーになります。

確認と対処：VSCodeの右下に「CRLF」と表示されていたら、クリックして「LF」に変換してから再試行してください。

/mnt/c上のファイル操作が絡む場合

/mnt/c/ 上のファイルを edit_file で修正しようとすると、ファイルシステム間のI/O変換が加わり、文字コードやメタデータの扱いがさらに複雑になります。WSL環境でのファイル操作全般の遅さ・トラブルについては「WSLで/mnt/cが遅い理由と解決策」で詳しく解説しています。

/mnt/c/ 上のファイルを edit_file で修正する必要がある場合は、まず ~/ に移動してから作業することをおすすめします。

Claude edit_fileができない原因

「edit_fileって、単純にテキストを置き換えるだけじゃないの？」と最初は思っていました。ところが実際に使ってみると、思いのほか繊細なツールだということがわかります。

exact matchとは何か

edit_file は内部で、指定した oldText をファイルの内容から1バイト単位で探します。ファイル内に該当する文字列が見つかった場合のみ、その箇所を newText で置き換えます。

つまり「だいたい似ている」では動きません。Claudeがコンテキストから oldText を生成するとき、元のファイルと完全に一致していない文字列を渡すと、即座にエラーになります。

なぜ失敗するのか

問題は、Claudeがコンテキストウィンドウにロードしたファイルの内容と、ディスク上の実際のファイルの内容がずれていることがあるからです。具体的な原因は後述しますが、このズレが「見た目は同じなのにマッチしない」という状況を生み出します。

ファイルを更新したのに再読込していない、エディタが自動フォーマットした、改行コードが変換された——こうした「変化」が、Claudeの持っているテキストと実ファイルの間に差異を作ります。

よくある原因5つ

実際に詰まったケースと、私が調べて把握した原因を5つにまとめます。どれか1つでも心当たりがあれば、そこから確認してみてください。

原因① 改行コードの違い（CRLF vs LF）

Windowsで作成・編集したファイルは改行コードが CRLF（\r\n）になっていることがあります。LinuxやMacでは LF（\n）が標準です。

WSLを使っている場合、Windowsのエクスプローラーでファイルを開いてメモ帳で保存すると、改行コードが CRLF に変換されることがあります。Claudeが oldText を LF ベースで生成していると、ファイル内の CRLF と一致せず、エラーになります。

確認方法：VSCodeの右下に「CRLF」と表示されていたら要注意です。

原因② JSONエスケープの有無

body.md のような素のMarkdownファイルではなく、JSONファイルを直接 edit_file で編集しようとした場合に起きやすいパターンです。

たとえばJSON内にダブルクォートを含む文字列がある場合、ファイル上は \" とエスケープされています。しかしClaudeがコンテキストとして読み込んだとき、" として解釈して oldText に渡すことがあります。この場合、ファイル上の \" と一致せずエラーになります。

対策：JSONファイルはなるべく edit_file で直接触らない。変更が必要なら write_file で全文書き換えるか、JSONの中身を別ファイル（Markdownなど）に分離する設計にする方が安全です。

原因③ ファイル更新後の再読込漏れ

Claudeがファイルを読み込んだ後、そのファイルが別の操作で更新されたとき、Claudeのコンテキストには古い内容が残ったままになります。

write_file でファイルを上書きした直後に edit_file を呼ぼうとすると、Claudeが持っている内容と実ファイルの内容がずれていてエラーになることがあります。`edit_file` の前には必ず最新の状態を読み込み直すことが基本です。

原因④ 複数箇所への一致

oldText に指定した文字列が、ファイル内に2か所以上存在する場合もエラーになります。edit_file はどちらを書き換えるべきか判断できないため、処理を止めます。

よくあるのは、テンプレートを使い回した記事ファイルに同じ表現が複数登場しているケースです。この場合は oldText の範囲を広げて、前後の文脈を含めた一意な文字列に変更する必要があります。

原因⑤ エディタのformat on saveによる自動変換

VSCodeの「Format On Save」が有効になっていると、ファイルを保存するたびにフォーマッターが走ります。インデントの変換、末尾スペースの削除、空行の追加・削除——こういった変更がClaudeの持っているテキストとのズレを引き起こします。

特に Prettier が有効な場合、Markdownファイルの改行やリストの形式も自動で整形されることがあります。Claudeが読み込んだ内容とフォーマット後の内容が違えば、そのまま edit_file に渡してもエラーになります。

実際に詰まったログ

私が実際にこのエラーで詰まったのは、body.md の一部を修正しようとしたときでした。

エラー内容

Could not find exact match for oldText in file
The file content may have changed since it was last read.
Please re-read the file and try again.

このエラーメッセージ自体は「ファイル内容が変わっているかもしれないので再読込してください」という意味で、ある意味正直なエラーです。しかしそのときの私は、ファイルを変更した覚えがなかったので最初は意味がわかりませんでした。