「1文字だけ」のはずが、文章が丸ごと文字化けした

2026年11月9日 23:40

半年ほど前のこと。
AI（Claude Code）と一緒に作業していた文章のファイルの中に、日本語じゃない文字が1文字だけまぎれこんでいた。
韓国語の文字（ハングル）が、1文字。

直すのは1文字だけ。そう、すぐ終わると思った。

AIはその1文字を、Windowsに元から入っている「命令で一括して置き換えるツール」で直そうとした（当時はWindowsのパソコンで作業していた）。PowerShellという、ファイルの中の文字をまとめて入れ替えられるツール。

でも、直した後のファイルは、文章が全部、読めない記号の羅列になった。

えっ！なんだこれー！！

1文字のはずが、画面いっぱいの記号。
何が起きたか、すぐにはわからなくってすごくドキドキした。

原因は、ハングルそのものじゃなくて、ツールが文字の読み方を取り違えたからだって。読み方がずれると、直したい1文字だけじゃなく、全部が別の文字になってしまうらしい。

いやいやいやいや、怖ろしい…。

しかも、そのファイルは作ったばかりの一時ファイルだったこともあって、前のバージョンがどこにも残っていなかった。

助かったのは、AIとのやりとりの中に、元の文章がまだ残っていたから。
AIがその文章を丸ごと書き戻して、すぐに元どおりになったけど、もし残っていなかったら、文章は全部なくなっていたかもしれない。
初歩的なミスだけど、命拾いしたって感じ。

そのあと、失敗を書きとめている記録に、ルールを1行足した。
「文章の直しは、Claude Codeの編集機能で1か所ずつ。PowerShellでまとめて置き換えない」。

ただ、これは書いてあるだけで、機械が止めてくれる仕組みじゃない。

大きな作業のときは身構えるのに、1文字なら大丈夫って、確かめずに任せていたのがほんとのところ。小さな直しだからって油断しちゃっていた。

今、私がやっていること

作業のファイルは、履歴が残るGitという仕組みで管理している。
直すたびに前のバージョンを残しているので、もし化けても戻せる。

AIにプログラムを書いてもらう人の間では、Gitで履歴を残すのが主流。
ただ、始めるには少し準備がいるので、履歴が残らない場所のファイルをAIに直してもらうときは、直す前にコピーを1つ取っておくと安心。
直したら、一度開いて確かめる。1文字の直しでも。

ファイルを直接直せるAI（Claude Codeなど）に頼むなら、たとえばこう。

このファイルの「〇〇」を「△△」に直して。直す前にコピーを作って。
直したあと、直したところ以外が変わっていないかを比べて結果を教えて。

バックアップの話は、前にも書いた。
毎晩取っているのに戻し方を知らなかった話。