Claude Code 画像添付ガイド — 3つの方法と使い分け¶

対象 / ポイント

対象: Claude Codeで画像を使ったやり取りをしたいが、添付方法や制限がわからないエンジニア

ポイント:

ドラッグ＆ドロップ・クリップボード・ファイルパスの3方式があり、場面に応じて使い分けると効率が上がる
形式はJPEG/PNG/GIF/WebP対応、1画像5MB・最大解像度8000×8000pxの制限がある
画像プレビュー機能（v2.0.73〜）でターミナル上から直接確認できる

3つの添付方法¶

ドラッグ＆ドロップ¶

最も直感的な方法です。

# ターミナルでClaude Codeを起動
claude

# 画像ファイルをターミナルウィンドウにドラッグ＆ドロップ
# → 自動的に画像が添付され、プロンプト入力待ちになる

おすすめの用途

UIモックアップ、エラー画面のスクリーンショット、デザインファイルの共有に最適です。

クリップボード貼り付け¶

画面キャプチャを直接貼り付けられます。

macOSWindows/Linux

1. Cmd + Shift + 4 でスクリーンショット撮影
2. Claude Codeのプロンプト入力中に Ctrl + V で貼り付け

重要

macOSでは Cmd + V ではなく Ctrl + V を使用してください。

1. 通常の方法でスクリーンショット撮影（Win + Shift + S 等）
2. Claude Codeのプロンプト入力中に Ctrl + V で貼り付け

ファイルパス指定¶

作業ディレクトリ内の画像をパスで参照できます。

claude
> /path/to/screenshot.png を分析してこのUIの問題点を教えてください

相対パスも使用可能です：

> ./images/mockup.png をReactコンポーネントに実装してください

方法別の使い分けガイド¶

どの方法を使うかは「画像の出どころ」で判断すると迷わない。

状況	推奨方法	理由
ブラウザやアプリのエラー画面をすぐ共有したい	クリップボード	スクリーンショット → 即貼り付けで最速
Figma等からエクスポートした画像ファイルがある	ドラッグ＆ドロップ	ファイルを探してそのまま投入できる
CIログの画像やリポジトリ内の画像を参照したい	ファイルパス指定	パスをコピーするだけで添付できる
複数の画像をまとめて分析したい	ファイルパス指定	複数パスを1プロンプトに列挙できる

実践例¶

ドラッグ＆ドロップ: デザインモックからの実装¶

claude
> [Figmaエクスポート画像をドラッグ＆ドロップ]
> このデザインをReact + Tailwind CSSで実装してください

クリップボード: エラー画面の即座の共有¶

# 1. ブラウザでエラー画面を Cmd+Shift+4 (macOS) でキャプチャ
# 2. Claude Codeに切り替えて Ctrl+V で貼り付け
claude
> このエラー画面の原因を特定してください。該当コードの修正もお願いします

ファイルパス指定: 複数画像のバッチ分析¶

claude
> ./screenshots/before.png と ./screenshots/after.png を比較して
> UIリグレッションがないか確認してください

対応形式と制限事項¶

サポート形式¶

形式	特徴	推奨用途
JPEG	高圧縮・写真向き	UI写真、実機キャプチャ
PNG	透明度対応・可逆圧縮	スクリーンショット、テキスト入り画像
GIF	アニメーション対応	操作手順の共有（初フレームのみ分析）
WebP	高効率・小ファイル	最適化済み画像

サイズ・解像度制限¶

項目	制限値
1画像あたりの最大サイズ	5MB
最大解像度	8000 × 8000 px
推奨解像度	1000 × 1000 px 以上
1リクエストあたりの最大画像数	100枚
複数画像の合計サイズ	32MB

20枚超の場合

20枚を超える画像を添付すると、最大解像度が 2000 × 2000 px に制限されます。

画像プレビュー機能¶

添付した画像をターミナル上でそのまま確認できます（v2.0.73で追加）。

クリック可能な画像リンク¶

添付した画像に [Image #N] というクリック可能なリンクが表示されます。

[Image #1] screenshot.png (1.2MB)

リンクをクリックすると、デフォルトの画像ビューアで開けます。

対応ターミナル¶

ターミナル	クリック対応
iTerm2
ghostty
WezTerm
VS Code内蔵ターミナル
macOS標準ターミナル

トラブルシューティング¶

クリップボード貼り付けが動作しない¶

症状	原因	解決策
何も貼り付けられない	ショートカットキーの誤り	macOSでは Ctrl+V を使用
文字化けする	ターミナルの互換性	iTerm2やWezTermに変更
大きな画像が失敗	サイズ制限超過	5MB以下にリサイズ

画像が認識されない¶

# 画像形式を確認
file /path/to/image.png

# サイズを確認
ls -lh /path/to/image.png

# 必要に応じてリサイズ（ImageMagick使用）
convert input.png -resize 2000x2000\> output.png

画像リサイズのワンライナー

# 5MB超の画像を自動圧縮
find . -name "*.png" -size +5M -exec convert {} -resize 2000x2000\> {} \;