Claude Codeで画像を一括リサイズする方法|容量の削減とWebP変換

ブログやネットショップ、社内の資料に載せる写真は、撮ったままだと横幅が大きすぎたり、容量が重くてページの表示が遅くなったりします。1枚ずつ画像のアプリで開いて大きさを直すのは、枚数が増えるほど手間がかかる作業です。
Claude Codeに頼めば、フォルダの中の画像の大きさと容量を一覧にし、決めた横幅に一括で縮小したり、WebPの形式に変換したりできます。ただし、元の画像を上書きしてしまうと取り返しがつかないため、出力先を分けて頼むことが欠かせません。
この記事では、Macで4枚の練習用の画像を使い、Claude Codeで大きさを一覧にし、横幅の上限をそろえて縮小し、JPEGの画質を比べ、WebPに変換して結果を確かめるまでを実画面で解説します。
この記事を読めば、元の画像を残したまま、画像の大きさと容量をまとめて整えられるようになります。最初に「元の画像は書き換えない」「小さい画像は拡大しない」と伝えておくのがポイントです。
目次
- Claude Codeで画像をまとめて処理する前に決めること
- 練習用の画像を保存して元の画像と出力先を分ける手順
- 画像ごとの幅・高さ・形式・容量を一覧にしてもらう手順
- 小さい画像は拡大せずに横幅の上限をそろえる手順
- JPEGの画質を変えて容量と見た目を比べる手順
- 元の画像からWebPを書き出してもらう手順
- 出力の件数・寸法・容量と元の画像が残っていることを確かめる手順
- Claude Codeの画像のリサイズに関するよくある質問
- まとめ
- 参考リンク
Claude Codeで画像をまとめて処理する前に決めること
数枚の写真を縮小するだけなら、Macの「プレビュー」でも足ります。Claude Codeが向いているのは、大きさのばらばらな画像が何十枚もあるときや、処理の前と後の大きさと容量を表で残したいときです。画像を処理する前に決めることは、以下の4つです。
| 決めること | この記事での決め方 |
|---|---|
| 横幅の上限 | 1200ピクセル(小さい画像は拡大しない) |
| 出力の形式 | 元と同じ形式・JPEGの画質違い・WebP |
| 元の画像の扱い | originalsフォルダに置いて書き換えない |
| 出力先 | resized・compare・webpのフォルダに分ける |
元の画像の中身まで変わっていないかを確かめたいときは、処理の前に「originals の画像の md5 を記録してください」と頼んでおくと、最後に同じ値かどうかを比べられます。
「全部の横幅を1200ピクセルにそろえる」と頼むと、小さい画像まで引き伸ばされ、ぼやけることがあります。上限より大きい画像だけを縮小するように伝えましょう。
この記事では、Macに最初から入っている「sips」という画像のコマンドと、WebPに変換する「cwebp」というコマンドを使います。どちらもClaude Codeが動かすので、使い方を覚える必要はありません。Claude Codeはインストールとログインが済んでいる前提です。
練習用の画像を保存して元の画像と出力先を分ける手順
元の画像は専用のフォルダに置き、処理した画像は別のフォルダに保存させます。練習用の画像を保存して元の画像と出力先を分ける手順は、以下の3つです。
- 作業フォルダとoriginalsフォルダを作る
- originalsフォルダに画像をコピーする
- Claude Codeを起動する
作業フォルダとoriginalsフォルダを作る
ターミナルで「mkdir -p ~/touchai-demo/resize-demo/originals」と入力してEnterキーを押します。続けて「cd ~/touchai-demo/resize-demo」でresize-demoに移り「open originals」と入力してEnterキーを押すと、originalsフォルダがFinderで開きます。
ターミナルの開き方やcdの意味は、以下の記事にまとめました。
Macのターミナルの使い方!Claude Codeの前に覚える開き方と基本操作
originalsフォルダに画像をコピーする
開いたoriginalsフォルダに、縮小したい画像をFinderでコピーします。練習では、AIで作った写真風の画像3枚と、そのうち1枚を小さくした画像1枚を使いました。
上の画像の「サイズ」の列が容量です。photo-03.pngはPNGの形式のため、ほかの写真より大きい1.9MBでした。自分の画像で試すときは、元の画像を別の場所に残したまま、コピーをoriginalsに入れると安心です。
Claude Codeを起動する
resize-demoのフォルダで「claude --permission-mode manual --model sonnet」と入力してEnterキーを押します。「--permission-mode manual」は、ファイルを作る前やコマンドを動かす前に原則として許可を求めるモードの指定です。「--model sonnet」は撮影で使ったモデルの指定で、付けなくてもかまいません。
初めて開くフォルダでは、フォルダを信頼するかを確かめる画面が出ます。撮影した版では「No, exit」が最初に選ばれていたため、↓キーで「Yes, I trust this folder」(このフォルダを信頼する)に合わせてEnterキーを押しました。
英語の文は「自分で作ったか信頼できるフォルダかを確かめてください。Claude Codeはここでファイルを読み、編集し、実行できます」という意味です。黒い部分は、撮影したパソコンのユーザー名を隠したものです。撮影では、いつも使っている設定とCLAUDE.mdを読み込まない状態で起動しました。
画像ごとの幅・高さ・形式・容量を一覧にしてもらう手順
処理の前に、今の画像の大きさと容量を確かめます。この一覧が、あとで処理の結果と比べる基準になります。画像ごとの幅・高さ・形式・容量を一覧にしてもらう手順は、以下の3つです。
- ファイルを作らずに一覧を頼む
- 大きさを読むコマンドを許可する
- 一覧の数字を確かめる
ファイルを作らずに一覧を頼む
入力欄に入力した文の全文は、以下のとおりです。
「originals フォルダの画像について、ファイル名・形式・幅・高さ・容量の一覧を表で見せてください。ファイルは作らず、画像も変えないでください。」
このあとの依頼文に出てくる photo-01.jpg などは、練習に使った画像の名前です。自分の画像で試すときは、自分の画像の名前に書き換えてください。
大きさを読むコマンドを許可する
Enterキーを押すと、画像の大きさを読むコマンドの実行の許可を求められます。
画面上部のモデル名の横の黒い部分は、契約の情報を隠したものです。コマンドの「sips -g pixelWidth -g pixelHeight -g format」は、画像の幅・高さ・形式を読むだけの指定です。上の画像の英語の表示は、以下の意味を持ちます。
- Bash command・Run shell command: シェルのコマンドを実行しようとしている
- Tip: auto mode handles these prompts for you: autoモードにすると、この確認をAIが代わりに判断する
- Do you want to proceed?: 進めてよいか
- 2. Yes, and don't ask again for: 以後、同じ形のコマンドは確かめずに実行する
- 3. Yes, and switch to auto mode: 許可したうえで、autoモードに切り替える
黒い部分は、コマンドの中の作業フォルダの場所に含まれるユーザー名です。「1. Yes」のままEnterキーを押します。
Claude Codeのautoモードの切り替え方!止められたときの対処も解説
一覧の数字を確かめる
コマンドの実行が終わると、一覧が表で表示されます。
photo-01.jpgとphoto-02.jpgは横幅1536ピクセル、photo-03.pngは1254ピクセルで、上限の1200ピクセルより大きい画像です。photo-04-small.jpgは640ピクセルで、上限より小さい画像です。
入力欄の薄い文字「これらを幅800pxにリサイズして resized フォルダに保存して」は、Claude Codeが出した入力の候補で、記事の手順とは関係ありません。自分の文を入力すれば消えます。
photo-01.jpgの容量は、表では「約409KB」、Finderでは「418KB」と表示されていました。Finderは1,000バイトを1KBとして数え、Claude Codeの表は1,024バイトを1KBとして計算しているため、バイトの数(418,441バイト)は同じです。
小さい画像は拡大せずに横幅の上限をそろえる手順
上限より大きい画像だけを縮小し、resizedフォルダに保存してもらいます。小さい画像は拡大せず、そのままコピーさせます。小さい画像は拡大せずに横幅の上限をそろえる手順は、以下の3つです。
- 上限と拡大しない条件を書いて頼む
- 縮小のコマンドを許可する
- 縮小した結果と元の画像を確かめる
上限と拡大しない条件を書いて頼む
入力欄に入力した文の全文は、以下のとおりです。
「originals の画像のうち、横幅が1200ピクセルより大きいものだけを横幅1200ピクセルに縮小して、resized フォルダに同じ名前で保存してください。横幅が1200ピクセル以下の画像は拡大せず、そのままコピーしてください。縦横の比率は変えず、originals の画像は書き換えないでください。Mac に入っている sips を使ってください。」
「Mac に入っている sips を使ってください」と書いたのは、Claude Codeが別の道具を入れようとして、パソコンに部品を足す操作が増えるのを防ぐためです。
縮小のコマンドを許可する
Enterキーを押すと、縮小のコマンドの許可を求められました。
コマンドは、画像ごとに横幅を調べ、1200ピクセルより大きければ「sips --resampleWidth 1200」で縮小してresizedに保存し、そうでなければ「cp -n」でコピーする内容です。
「A variable in this command can't be checked before it runs」は「このコマンドは変数を使っているため、実行する前にどのファイルに何をするかを確かめきれない」という意味です。そのため、以後の確認を省く選択肢は表示されていません。保存先がresizedで、originalsに書き込む行がないことを確かめてから「1. Yes」のままEnterキーを押します。
縮小した結果と元の画像を確かめる
実行が終わると、処理の内容と縮小後の大きさが表で報告されます。
上の画像のとおり、横幅が上限より大きい3枚だけが1200ピクセルになり、縦横の比率も保たれました。640ピクセルのphoto-04-small.jpgは拡大されず、そのままコピーされています。
photo-01.jpgの容量は418,441バイトから183,974バイトに減りました。
一方、PNGのphoto-03.pngは1,909,519バイトから1,735,667バイトで、あまり減っていません。PNGは画質を落とさずに保存する形式のため、写真を軽くしたいときは、あとで説明するJPEGやWebPへの変換が向いています。撮影では、originalsの4枚の中身が処理の前と同じであることも別に確かめました。
JPEGの画質を変えて容量と見た目を比べる手順
JPEGは、画質の数字を下げるほど容量が小さくなる一方で、画像が粗くなります。同じ元の画像から画質違いのファイルを作り、容量と見た目を比べます。JPEGの画質を変えて容量と見た目を比べる手順は、以下の3つです。
- 画質違いのファイルを元の画像から作るよう頼む
- 変換のコマンドを許可して容量を確かめる
- 画質違いの画像をクイックルックで見比べる
画質違いのファイルを元の画像から作るよう頼む
入力欄に入力した文の全文は、以下のとおりです。
「originals/photo-01.jpg から、横幅1200ピクセルで JPEG の画質を90・75・60にした3つのファイルを compare フォルダに作り、容量の一覧を表で見せてください。ファイル名は photo-01-q90.jpg のように画質を付けてください。originals の画像は書き換えないでください。」
比べるファイルは、すべて元の画像から作らせます。縮小したJPEGをさらに変換すると、画質が二重に落ちて正しく比べられないためです。
変換のコマンドを許可して容量を確かめる
Enterキーを押すと、変換のコマンドの許可を求められます。
「-s formatOptions」のあとの数字が、JPEGの画質の指定です。保存先がcompareであることを確かめて「1. Yes」のままEnterキーを押します。
容量は、画質90が249,630バイト、75が183,974バイト、60が127,459バイトでした。報告では、画質75の容量が、先にresizedに作ったphoto-01.jpgと同じだったことにも触れています。
画質違いの画像をクイックルックで見比べる
Finderでcompareフォルダを開き、photo-01-q90.jpgを選んでスペースキーを押します。
続けて、photo-01-q60.jpgも同じように開きます。
2枚の画像は、クイックルックの窓の名前の行を切り取ったもので、上が画質90、下が画質60です。
この写真をクイックルックの大きさで見比べた限りでは、画質60でも違いはほとんど目立ちませんでした。細かい模様や文字が入った画像では差が出やすいため、実際にページに載せる大きさで確かめてから画質を決めましょう。
元の画像からWebPを書き出してもらう手順
WebPは、JPEGより小さい容量で同じくらいの見た目にしやすい画像の形式で、多くのブラウザが表示に対応しています。Macのsipsでは書き出せなかったため、Googleの「cwebp」を使います。元の画像からWebPを書き出してもらう手順は、以下の3つです。
- cwebpが入っているかを確かめる
- 上限と画質を書いて変換を頼む
- 確かめと変換のコマンドを許可する
cwebpが入っているかを確かめる
Claude Codeを起動したまま確かめるときは、ターミナルの新しい窓を開いて「cd ~/touchai-demo/resize-demo」で作業フォルダに移ってから「command -v brew cwebp」と入力し、Enterキーを押してください。続けて「brew list --versions webp」と入力してEnterキーを押します。
上の画像のように場所が2行表示されれば、HomebrewとcwebpがMacに入っています。撮影したMacには、cwebpを含む「webp」1.6.0が入っていました。この画像はClaude Codeを終えたあとに撮ったものです。
1行目の「/opt/homebrew/bin/brew」だけが表示され、cwebpの行が出ない場合は「brew install webp」と入力してEnterキーを押すと、webpの部品がインストールされます。brewの行も出ない場合は、先にHomebrewのページの手順でHomebrewを入れてください。
上限と画質を書いて変換を頼む
入力欄に入力した文の全文は、以下のとおりです。
「originals の画像から、横幅1200ピクセル以下の WebP を webp フォルダに作ってください。横幅が1200ピクセルより大きい画像は1200ピクセルに縮小し、小さい画像は拡大しないでください。変換には cwebp を使い、画質は80にしてください。cwebp が入っているかを先に確かめ、入っていなければ変換せずに教えてください。originals の画像は書き換えないでください。」
WebPも、resizedのJPEGからではなく、originalsの画像から作らせます。cwebpの画質の数字(-q)は0〜100で指定します。cwebpの説明のページに載っている既定の値は75です。
確かめと変換のコマンドを許可する
Enterキーを押すと、まずcwebpが入っているかを確かめるコマンドの許可を求められました。
「1. Yes」のままEnterキーを押すと、続けて変換のコマンドの許可を求められます。
「cwebp -q 80 -resize 1200 0」は、画質80で、横幅1200ピクセルに縮小する指定です。高さの0は、縦横の比率を保って自動で決めるという意味です。「1. Yes」のままEnterキーを押します。
WebPの容量は、photo-01が64,256バイト、photo-02が66,502バイト、photo-03が29,842バイト、photo-04-smallが22,588バイトでした。1.9MBあったPNGのphoto-03は、WebPにすると約30KBになっています。
出力の件数・寸法・容量と元の画像が残っていることを確かめる手順
最後に、出力の枚数がそろっているか、元の画像が変わっていないかを確かめます。出力の件数・寸法・容量と元の画像が残っていることを確かめる手順は、以下の3つです。
- フォルダごとの一覧と元の画像の確かめを頼む
- 確かめの結果を読む
- FinderとクイックルックでWebPを開く
フォルダごとの一覧と元の画像の確かめを頼む
入力欄に入力した文の全文は、以下のとおりです。
「originals・resized・webp の各フォルダについて、画像の枚数と、画像ごとの幅・高さ・容量を表にしてください。originals の画像が処理の前から変わっていないかも確かめてください。ファイルは作らないでください。」
Enterキーを押すと、一覧を作るコマンドの許可を求められます。
コマンドは、ファイルの数と大きさ・更新時刻を表示するだけです。「1. Yes」のままEnterキーを押します。
確かめの結果を読む
実行が終わると、フォルダごとの表と、originalsが変わっていないかの結果が報告されます。
報告の表では、3つのフォルダとも4枚ずつそろっていました(画面に写っているのは最後のwebpの表だけ)。originalsについては、容量・幅・高さ・更新時刻が最初と同じだと報告されています。
報告には「最初にハッシュ値を取っていないため、中身のバイト単位の一致までは確認できていない」とも書かれていました。ハッシュ値は、ファイルの中身から計算する値で、1バイトでも変われば違う値になります。
中身まで確かめたいときは、処理の前に「originals の画像の md5 を記録してください」と頼んでおきます。撮影では、処理の前に別に記録したmd5と比べ、4枚とも中身が変わっていないことを確かめました。
確かめが済んだら、入力欄に「/exit」と入力してEnterキーを押し、Claude Codeを終えます。
「Resume this session with」は、同じ会話の続きを始めるコマンドの案内です。黒い部分は会話のIDを隠したものです。
FinderとクイックルックでWebPを開く
ターミナルで「open webp」と入力してEnterキーを押すと、webpフォルダがFinderで開きます。
Finderの「サイズ」の列を見ると、4枚とも容量が小さくなったことが一目で分かりました。photo-03.webpを選んでスペースキーを押すと、クイックルックで中身を表示できます。
ページに載せる前に、WebPにした画像の見た目も1枚ずつ確かめておきましょう。
Claude Codeの画像のリサイズに関するよくある質問
Claude Codeで画像をまとめて処理するときによくある質問をまとめました。
元の画像は残りますか?
「originals の画像は書き換えないでください」と書いて、出力先のフォルダを分けて頼めば、元の画像は残ります。この記事の撮影でも、originalsの4枚の中身は最後まで変わりませんでした。念のため、大事な画像は処理の前に別の場所にコピーしておくと安心です。
Windowsでも同じ手順でできますか?
sipsはMacのコマンドのため、Windowsではそのまま使えません。Windowsでは、Claude Codeが別の道具を使うことになるため、使う道具を確かめてから許可してください。
何百枚の画像でも処理できますか?
この記事で試したのは4枚です。枚数が多いときは、最初に数枚で試して結果を確かめてから、全部の画像に広げる進め方が安全です。処理の前後の枚数がそろっているかも、一覧で確かめてください。
画像の中身を見て整理することもできますか?
Claude Codeは、画像の中身を読んで説明することもできます。画像を読ませる方法は、以下の記事で解説しています。
Claude Codeに画像を貼り付ける方法|できないときの対処法も解説
まとめ
Claude Codeで画像をまとめて縮小するときは、最初に横幅の上限・出力の形式・元の画像の扱い・出力先を決めます。元の画像はoriginalsのようなフォルダに置き「書き換えない」「小さい画像は拡大しない」と伝えて、出力先を分けて頼みましょう。
処理の前に大きさと容量を一覧にしておけば、縮小や変換の結果と比べられます。JPEGの画質は、容量と見た目を比べて決め、写真を軽くしたいときはWebPへの変換も選択肢になります。
最後に、出力の枚数と大きさ、元の画像が変わっていないかを確かめることが大切です。まずは数枚の画像で、一覧→縮小→画質の比較→WebP→確かめの順を試してみてください。



