Writeツールが賢くなった:未読ファイルの上書き緩和

これは何が変わった話?

Claude Codeには、ファイルを新規に作ったり中身を丸ごと書き換えたりする「Write(書き込み)」ツールと、ファイルの一部分だけを差し替える「Edit(編集)」ツールという2つの機能があります。今回のアップデート(v2.1.228)は、この2つのツールの間にあった「動作のルールの違い」をなくして揃えた、という内容です。

具体的には、これまでWriteツールには「そのセッション中にまだ一度も読んでいない既存ファイルは、上書きできない」という決まりがありました。一方でEditツールは、モデルによってはこの制限が緩められていました。今回の変更で、新しめのモデルを使っている場合は、Writeツールも同じルールで動くようになり、未読の既存ファイルでもそのまま上書きできるようになりました。

そもそもなぜ「読んでから書く」ルールがあったのか

これは安全のための仕組みです。Claude Codeがファイルの中身を見ずにいきなり上書きしてしまうと、そこに書かれていた大事なコードやメモが、確認もされないまま消えてしまう危険があります。一度読ませてから書かせることで、「今そこに何が書いてあるか」をAIが把握した上で変更するようにしていたわけです。

いわば、他人の書類を勝手に上から書き換える前に、まず中身をきちんと目を通しておく、というマナーのようなものです。

何が変わったのか

今回の変更で、新しいモデルを使っている場合に限り、Writeツールでもこの「事前に読む」手順を省いて、既存ファイルをそのまま上書きできるようになりました。これはEditツールがすでに持っていた挙動に合わせたもので、2つのツールの間で「あるモデルではWriteは厳しいのにEditは緩い」といったちぐはぐな状態を解消する目的があります。

一方で、古いモデルを使っている場合は、これまで通り「先に読む」手順が必須のままです。つまり、モデルの世代によって挙動が変わる点には注意が必要です。

状況	これまで	今回以降(新しいモデル)
Writeで未読ファイルを上書き	不可(先に読む必要あり)	可能
Editで未読ファイルを編集	モデルによっては可能	変更なし(そのまま)
古いモデルでのWrite	先読み必須	先読み必須(変更なし)

使う上でのポイント

普段Claude Codeにファイル操作をお願いしている分には、この変更で急に危なくなるということはありません。むしろ、これまで「先にファイルを読んでください」という一手間が省ける場面が増えるので、作業がテンポよく進みやすくなります。

ただし、「読まずに書ける」ということは、AIがそのファイルの現状を確認しないまま上書きする可能性があるということでもあります。大事なファイルを扱うときは、変更内容をきちんとレビューする習慣は変わらず大切です。