複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名や社名が変わると、マニュアルやWebの原稿など、いくつものファイルの文字を直す必要があります。1つずつ開いて置き換えると見落としが出やすく、まとめて置き換えると、変えてはいけない語まで変わってしまうのが心配です。
MacのClaude Codeなら、フォルダの中のファイルから置き換える候補を一覧にしてもらい、残す語やファイルを決めてから一括置換できます。置き換えたあとは、コマンドで数え直し、置換前のコピーと比べれば、余計な変更がないかを人が確かめられます。
この記事で使うのは、架空のサービスのマニュアル6ファイルです。製品名を置き換え、帳票の名前と更新履歴は残す一括置換を、Claude Codeで行う手順を実画面で解説します。
この記事を読めば、残す所を守ったまま複数のファイルを置き換え、1つのファイルだけ元に戻す方法まで分かります。置き換える前にフォルダのコピーを残しておくのがポイントです。
目次
- 置換する前に練習のファイルとコピーを用意する手順
- 置換の候補をファイルと行ごとに一覧にしてもらう手順
- 置き換える語と残す語を決めて置換してもらう手順
- 古い語の残りと余計な変更がないか確かめる手順
- 1つのファイルだけ元に戻す手順
- Claude Codeの一括置換に関するよくある質問
- まとめ
- 参考リンク
置換する前に練習のファイルとコピーを用意する手順
Claude Codeは、起動したフォルダの中のファイルを読んで作業します。この記事では、.mdや.txtのようなテキストのファイルを扱います。練習のファイルは、すべて.mdのファイルです。この記事はMacで操作し、Claude Codeのインストールとログインが済んでいる前提で進めます。置換する前に練習のファイルとコピーを用意する手順は、以下の5つです。
- 作業フォルダを作って移る
- 確認してから進めるモードでClaude Codeを起動する
- 練習のファイルを6つ作ってもらう
- 確認してから進めるモードに戻す
- フォルダのコピーを残す
Claude Codeのインストールとログインの手順は、以下の記事で解説しています。
Claude CodeのインストールをWindows・Mac別に徹底解説!日本語対応も紹介
作業フォルダを作って移る
ターミナルを開き「mkdir -p ~/touchai-demo/replace-demo」と入力してEnterキーを押します。続けて「cd ~/touchai-demo/replace-demo」と入力してEnterキーを押してください。
行の頭が「replace-demo」に変われば、作業フォルダに移れています。
確認してから進めるモードでClaude Codeを起動する
作業フォルダで「claude --permission-mode manual --model sonnet」と入力してEnterキーを押します。「--permission-mode manual」は、ファイルを変える前などに原則として許可を求めるモードの指定です。「--model sonnet」は撮影で使ったモデルの指定で、付けなくてもかまいません。
初めて開くフォルダでは、上の画像の画面が出ます。英語の文は「自分で作ったか信頼できるフォルダかを確かめてください。Claude Codeはここでファイルを読み、編集し、実行できます」という意味です。黒い部分は撮影したパソコンのユーザー名を隠したものです。
最初に選ばれている「No, exit」は終了するという意味なので、↓キーで「Yes, I trust this folder」(このフォルダを信頼する)に合わせます。
Enterキーを押すと、Claude Codeの入力の画面に変わります。
2行目のSonnet 5.5がモデルで、その右の黒い部分は契約の情報を隠したものです。入力欄の薄い文字は入力の例で、自分で入力したものではありません。入力欄の下の「manual mode on」が、確認してから進めるモードになっている印です。撮影では、いつも使っている設定とCLAUDE.mdを読み込まない状態で起動しました。
Claude Codeの権限設定を徹底解説!自動承認を安全に使う方法も紹介
練習のファイルを6つ作ってもらう
練習に使うのは、架空のサービス「ラクラク受付」のマニュアルです。6つのファイルの中身を「=== ファイル名 ===」の行で区切って、以下の折りたたみにまとめています。開いて、中の文をすべてコピーしてください。
練習用のマニュアル6ファイルの全文を見る
練習のファイルには、置き換えで間違えやすい所をわざと入れています。帳票の名前の「ラクラク受付表」、半角カナの「ラクラク受付」、1行に2回出てくる行、変えてはいけない更新履歴のファイルです。
入力欄に「以下の6つのファイルを、manual フォルダの中に、一字も変えずに作ってください。「=== ファイル名 ===」の行がファイルの区切りで、この行はファイルに入れないでください。」と入力し、続けてコピーした文を貼り付けてEnterキーを押します。
最初のファイルを作る許可を求めてきました。
6つのファイルを作るたびに許可を求められるため、撮影では↓キーで2つ目の「Yes, and switch to accept edits」を選びました。
2つ目の選択肢は、この会話の間、ファイルの編集とよく使うファイル操作のコマンドを確かめずに進めるモード(accept edits)に切り替えるという意味です。Enterキーを押すと、残りのファイルは許可を求めずに作られました。
撮影では、作られた6つのファイルが、記事の折りたたみの文と一字一句同じであることを確かめました。
確認してから進めるモードに戻す
置き換えの前には、確認してから進めるモードに戻します。Shiftキーを押しながらTabキーを押すたびに、モードが変わります。撮影した版では、accept edits→plan→auto→manualの順に変わり、3回押すと「manual mode on」に戻りました。途中の表示は「plan mode on」と「auto mode on」です。
途中のautoモードは、AIが確認を自動で判断するモードです。押しすぎないよう、入力欄の下の表示を見ながら押してください。
フォルダのコピーを残す
Claude Codeの入力欄で「!」を入力すると、ターミナルのコマンドをそのまま実行するシェルのモードに変わります。続けて「cp -R manual manual-backup && ls」と入力してEnterキーを押します。
manualフォルダの中身が、manual-backupフォルダにコピーされました。置き換えで困ったときは、このコピーから元に戻します。シェルのモードの結果は会話に加わるため、Claude Codeが内容について返事をすることがあります。
置換の候補をファイルと行ごとに一覧にしてもらう手順
置き換える前に、どのファイルのどの行に置き換える語があるかを一覧にしてもらいます。置換の候補をファイルと行ごとに一覧にしてもらう手順は、以下の3つです。
- ファイルを変えずに一覧を作ってもらう
- 今いる場所を確かめる
- コマンドで出てくる回数を数え直す
ファイルを変えずに一覧を作ってもらう
入力欄に、以下の文を入力してEnterキーを押します。
「manual フォルダの中で、「ラクラク受付」と、半角の「ラクラク受付」のような表記の違いが出てくる場所を、ファイル名・行番号・その行の文ですべて一覧にしてください。1行に2回出るときは2回と数えてください。ファイルはまだ変えないでください。」
ファイルを読むだけの作業のため、許可は求められずに一覧が表示されました。
一覧には13か所が並び、半角の「ラクラク受付」は04-よくある質問.mdの1か所でした。
ただし、まとめの文に「ラクラク受付表は4回(No.7、8、13)」とあり、番号は3つしかありません。AIの数え方には誤りが混じることがあるため、次の手順でコマンドを使って数え直します。返事が長いため、この画面は窓を縦に広げて撮っています。それでも1〜5番は画面の上に切れてしまいました。
今いる場所を確かめる
シェルのモードで「pwd」と入力してEnterキーを押すと、今いるフォルダの場所が表示されます。
撮影では、Claude Codeが一覧を作る途中でmanualフォルダの中に移っていました。シェルのモードのコマンドは、Claude Codeが移った場所で動くことがあります。
撮影では、この状態で「manual/」から始まるファイルを指定したコマンドを打ち、ファイルが見つからないと表示されました(その画面は載せていません)。このあとのコマンドも、Claude Codeが別のフォルダに移っているときは、先頭に「cd ~/touchai-demo/replace-demo && 」を付けてください。
コマンドで出てくる回数を数え直す
シェルのモードで、以下のコマンドを入力してEnterキーを押します。最初の「cd ~/touchai-demo/replace-demo &&」で作業フォルダに戻ってから数えるため、Claude Codeがどこに移っていても同じ結果になります。
「cd ~/touchai-demo/replace-demo && grep -o -E 'ラクラク受付表|ラクラク受付|ラクラク受付' manual/*.md | sort | uniq -c」
左の数字が、そのファイルにその語が出てくる回数です。「grep -o」は見つけた語を1つずつ出すため、1行に2回出る語も2回と数えられます。
撮影では、ラクラク受付が9回、ラクラク受付表が3回、半角のラクラク受付が1回でした。一覧の「4回」は誤りで、ラクラク受付表は3回です。返事の「今度は」は、撮影でcdを付けずに打った1回目が失敗していたことを指しています。
置き換える語と残す語を決めて置換してもらう手順
一覧を見て、置き換える語と、残す語やファイルを人が決めます。この記事では、サービス名の「ラクラク受付」と半角の「ラクラク受付」を「ラクラク予約」に置き換えます。帳票の名前の「ラクラク受付表」と更新履歴のファイルは残すことにしました。置き換える語と残す語を決めて置換してもらう手順は、以下の3つです。
- 残す所を伝えて置換を依頼する
- 置換のコマンドの許可を出す
- 置換の報告を読む
残す所を伝えて置換を依頼する
入力欄に、以下の文を入力してEnterキーを押します。
「manual フォルダの「ラクラク受付」と半角の「ラクラク受付」を、全角の「ラクラク予約」に置き換えてください。ただし、帳票の名前の「ラクラク受付表」と、99-更新履歴.md の中は変えないでください。manual-backup は変えないでください。」
過去の出来事を書いた更新履歴は、当時の名前のまま残すことがあります。どこを残すかは、自分の会社の決まりに合わせて書き換えてください。
置換のコマンドの許可を出す
Enterキーを押すと、置換のコマンドの許可を求めてきました。
コマンドの中の「ラクラク受付(?!表)」は、後ろに「表」が続かないラクラク受付だけを選ぶ指定です。「0[1-5]-*.md」は01〜05で始まるファイルを指し、99-更新履歴.mdを対象から外しています。「Multiple directory changes in one command require approval for clarity」は、1つのコマンドの中でフォルダを何度も移るため確認を求めている、という意味です。
選択肢の「Yes, and switch to auto mode」は、AIが確認を自動で判断するautoモードに切り替えて進めるという意味で、上の「Tip: auto mode handles these prompts for you」はその案内です。残す所が守られているかをコマンドで確かめてから「1. Yes」で進めます。撮影では、1回目のコマンドは文字コードの指定の誤りで何も置き換わらず、Claude Codeが直したコマンドの許可をもう一度求めてきました。
この画面も「1. Yes」で進めます。
置換の報告を読む
置き換えが終わると、ファイルごとの置き換えた数が報告されました。
報告の表は、01が3、02が3、04が2、05が1で、合計は9です。ところが、文では「あわせて10か所」と書かれていました。報告の数はそのまま信じず、次の見出しの手順で数え直して確かめます。
古い語の残りと余計な変更がないか確かめる手順
置き換えのあとは、置き換えるはずの語が残っていないか、残すはずの語が変わっていないか、ほかの所が変わっていないかを確かめます。古い語の残りと余計な変更がないか確かめる手順は、以下の2つです。
- 置き換えのあとの回数を数え直す
- コピーと比べて変わった行を確かめる
置き換えのあとの回数を数え直す
シェルのモードで、以下のコマンドを入力してEnterキーを押します。
「cd ~/touchai-demo/replace-demo && grep -o -E 'ラクラク受付表|ラクラク受付|ラクラク受付|ラクラク予約' manual/*.md | sort | uniq -c」
結果を、置き換える前の数と比べます。.txtのファイルも対象にするときは、コマンドの「manual/*.md」を「manual/*」に変えてください。ラクラク予約は01が3回、02が3回、04が2回、05が1回で、合計9回です。
置き換える前のラクラク受付と半角のラクラク受付のうち、99-更新履歴.mdの1回を除いた数と一致します。残すと決めた03のラクラク受付表2回と、99-更新履歴.mdの2つの語も、そのまま残っていました。
コピーと比べて変わった行を確かめる
シェルのモードで「diff -r manual-backup manual」と入力してEnterキーを押します。「diff -r」は、2つのフォルダの中のファイルを比べて、違う行を表示するコマンドです。
結果が長いため、入力したコマンドと最初のファイル名の行は、画面の上に切れています。
コピー(置き換える前)の行は頭に「<」が、置き換えた後の行は頭に「>」が付きます。変わった行は01が3行、02が2行、04が2行、05が1行の計8行で、どの行もラクラク受付がラクラク予約に変わっただけでした。02の7行目は1行に2回出てくる行のため、行の数(8)と置き換えた数(9)が違います。
03-予約の登録.mdと99-更新履歴.mdは結果に出てこないため、コピーと同じ中身のままです。置換の報告の「10か所」ではなく、数え直した9か所が正しい数です。
1つのファイルだけ元に戻す手順
置き換えたあとで、一部のファイルだけ元に戻したくなることがあります。撮影では、問い合わせのページだけは来月まで古い名前で案内する、という想定で戻しました。1つのファイルだけ元に戻す手順は、以下の2つです。
- コピーからファイルを戻して確かめる
- Claude Codeを終える
コピーからファイルを戻して確かめる
シェルのモードで、以下のコマンドを入力してEnterキーを押します。
「cp manual-backup/05-お問い合わせ.md manual/ && diff manual-backup/05-お問い合わせ.md manual/05-お問い合わせ.md && echo 同じです」
コマンドの前半の「cp」で、コピーのファイルで上書きして戻します。後半の「diff」で違いがなければ「同じです」と表示されます。「同じです」が出れば、05-お問い合わせ.mdは置き換える前の中身に戻ったということです。フォルダ全体を戻す場合も、同じようにコピーから戻せます。
Claude Codeを終える
入力欄に「/exit」と入力してEnterキーを押すと、Claude Codeが終わり、ターミナルの入力に戻ります。
「Resume this session with」は、同じ会話の続きを始めるコマンドの案内です。黒い部分は会話のIDを隠したものです。
Claude Codeの一括置換に関するよくある質問
Claude Codeで複数のファイルを一括置換するときによくある質問をまとめました。
WordやExcelのファイルも置き換えられますか?
この記事で扱ったのは、.mdや.txtのようなテキストのファイルです。WordやExcelのファイルは中身の形式が違うため、この記事の手順はそのまま使えません。
置き換えのルールを自分で書く必要はありますか?
撮影では「ラクラク受付表は残す」と日本語で伝えると、Claude Codeが「(?!表)」という指定を含むコマンドを作りました。自分で書く必要はありませんが、許可の画面でどのファイルと語が対象になっているかは確かめてください。
/rewindで置き換えを元に戻せますか?
Claude Codeには、会話とファイルを巻き戻す/rewindの機能があります。ただし、この記事の置き換えはperlのコマンドで行われました。コマンドだけで変えたファイルは/rewindで戻らないことがあるため、置き換える前にフォルダのコピーを残しておくのが安心です。
Claude Codeの/rewindで元に戻す方法!ファイルと会話の巻き戻し
まとめ
Claude Codeで複数のファイルを一括置換するときは、最初にフォルダのコピーを残し、置き換える候補を一覧にしてもらいます。一覧の数はコマンドで数え直し、置き換える語と残す語やファイルを人が決めてから依頼するのがポイントです。
置き換えたあとは、grepで回数を数え直し、diff -rでコピーと比べて、残す所が変わっていないか、余計な変更がないかを確かめます。AIの報告の数が実際と違うこともあるため、数え直した結果で判断することが大切です。
まずは練習のマニュアルで、コピー→一覧→置換→数え直し、の順を試してみてください。



