画像・PDFでエラー「Request too large」の直し方
Claude Codeで画像やPDFを貼ると出る「Request too large」「Image was too large」「PDF too large」の意味と直し方を、公式のエラー一覧に沿って整理します。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
画像・PDFでエラーが出るとは
Claude Code に画像やPDFを貼り付けたり、添付したりすると、その内容は会話に残ります。公式のエラー文にも「会話に溜まった画像と添付ファイルがリクエストを上限より大きくした」という趣旨の文面があり、画像を貼り続けるとリクエスト全体が大きくなることが分かります。
公式のエラー一覧によると、「Request too large」は、トークンに分解する前のリクエスト本文が API の上限32MBを超えた時のエラーで、原因は大きな貼り付け、ツールの結果、添付ファイルなどです。会話の長さの上限（コンテキストウィンドウ）とは別だと明記されています。会話が長すぎるときの「Prompt is too long」は別の話なので、そちらは Prompt is too long の記事 をご覧ください。
画像とPDFには、リクエスト全体とは別に、1つごとの上限もあります。画像にはサイズや寸法（ピクセル数）の上限があり、PDFにはページ数と容量の上限があります。全体、1つの画像、1つのPDFのどれが大きすぎるのかを、文面で見分けます。
基本（エラーの種類と上限）
公式のエラー一覧（Request errors）の内容を整理します（2026年10月に確認。上限の数字は変わることがあります）。
| 画面の文言 | 意味 | 対処 |
|---|---|---|
| Request too large (max 32MB). … | リクエスト全体が32MBを超えた | /compact、または Esc を2回押して戻る |
| Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents). | 画像や文書が原因でリクエストが上限を超えた（数字は例） | Claude Code が画像などを外して再試行する |
| Request too large for the API’s 32MB request limit | 文章だけで上限を超えている。compacting cannot make it fit と書かれる | Esc 2回で戻る、または /clear |
| Image was too large. | 画像のサイズか寸法が上限を超えた | 画像を縮小する |
| Unable to resize image … | 画像の自動縮小に失敗した | 形式を変換する、縮小して添付し直す |
| PDF too large (max 100 pages, 20MB). | PDFが100ページまたは20MBを超えた | ページ範囲を指定して読ませる、テキストに変換する |
| PDF is password protected. | PDFにパスワードがかかっている | パスワードを外す、元のアプリで書き出し直す |
| The PDF file was not valid. | PDFが正しい形式ではない | テキストに変換する、書き出し直す |
API に直接つないでいて API 自体が拒否した場合、Claude Code は会話の大きさを測り、回復できるかどうかで文面を変えます。プロキシ、ゲートウェイ、クラウドプロバイダー経由では、一般的な文面（最初の行）になります。
画像の上限については、公式に次のように書かれています。API が受け付けるのは、1枚だけなら長辺8000ピクセルまで、コンテキストに20枚を超える画像がある場合は3000ピクセルまでです。
具体例（場面別の見え方と直し方）
場面1: 画像を何枚も貼ったあとに止まる
スクリーンショットを何枚も貼りながら作業していると、次のような文面が出ます。
Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
溜まった画像と添付ファイルで上限を超えた、という意味です。公式の対処は /compact の実行で、溜まった画像や添付を落とすと説明されています。Esc を2回押して、添付を足した場面より前に戻る方法もあります。
数字つきの文面が出る場合もあります。
Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).
画像や文書が原因だと測れた場合で、Claude Code がそれらを外して再試行します。
場面2: 文章だけで上限を超えている
Request too large for the API's 32MB request limit
メッセージだけで上限を超えているときの文面です。compacting cannot make it fit（圧縮しても収まらない）と書かれ、Claude Code は再試行しません。/compact では直りません。Esc を2回押して、大きな内容を足したターンより前に戻るか、/clear で新しく始めます。非対話モード（-p）では、入力を減らすか新しいセッションを始めるよう案内されます。
場面3: 1枚の画像が大きすぎる
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
画像のサイズか寸法が上限を超えています。画像を縮小してから貼るか、必要な部分だけを撮りなおします。Claude Code は処理できない画像を文字の目印に置き換えて再試行するので、次のメッセージからは通ると公式にあります。ただし、v2.1.142 より前のバージョンでは、貼った画像が会話に残り、以降のメッセージでも同じエラーが続くことがあります。その場合は Esc を2回押して、画像を足したターンより前に戻ります。
場面4: 画像を縮小できなかった
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Claude Code は通常、大きな画像を自動で縮小しますが、デコードや縮小に失敗するとこの系統のエラーになります。公式の一覧には、CMYK 形式の JPEG、アニメーション WebP、壊れている可能性のあるファイルなど、原因を名指しする文面もあります。対処は文面によって分かれます。変換を求める文面なら PNG、JPEG、GIF、WebP のいずれかに変換して添付し直します。寸法や容量の上限を示す文面なら、その上限より小さく縮小または再圧縮します。原因を名指しする文面なら、文面が示す形式（RGB の PNG や JPEG など）で保存し直します。
場面5: PDFでエラーになる
PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
公式では、上の文面は非対話モードでの表示で、対話中のセッションでは代わりに Esc を2回押してやり直すよう促す文面になる、と説明されています。公式の対処は、次のとおりです。
- 大きすぎるPDFは、Claude にページ範囲を指定して Read ツールで読ませるか、pdftotext などでテキストを取り出し、そのファイルをパスで指定する。
- パスワード付きや形式が正しくないPDFは、パスワードを外す、または元のアプリで書き出し直してから試す。
ページ範囲の読み取りで、次の文面が出ることもあります。
pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.
ページ範囲の読み取りは pdftoppm でページを描画して行うため、poppler-utils が必要です。文面に出ているコマンドで入れるか、ほかの環境では pdftoppm が PATH に入る poppler を入れます。
画像・PDFエラーが出たときにやるべきこと
- 画面の文面を読み、Request too large、Image was too large、Unable to resize image、PDF の文面のどれかを決める。
- Request too large で compacting cannot make it fit を含まなければ、/compact を実行する。
- 含む場合は、Esc を2回押して大きな内容を足したターンより前に戻るか、/clear で新しく始める。
- 画像のエラーなら、上限（長辺8000ピクセル、20枚を超える場合は3000ピクセル）以内に縮小するか、必要な部分だけを撮りなおす。
- Unable to resize image の場合は文面に従う。変換を求められたら PNG、JPEG、GIF、WebP のいずれかに変換し、原因（CMYK や アニメーションWebPなど）が示されていれば、その指示どおりに保存し直す。
- PDFのエラーなら、100ページ・20MBを超えていないか確認し、超えているときはページ範囲を指定するか、テキストに変換する。
- 大きなファイルは、中身を貼らずにパスで指定する（Claude が少しずつ読めると公式にあります）。
- 古いバージョンでは挙動が違う（注意点を参照）ため、Claude Code の更新も検討する。更新は Claude Codeの更新方法 を参照してください。
画像・PDFエラーの注意点
- Request too large の32MBは、1回のリクエスト全体の上限です。1枚ごとの画像の上限ではありません。小さな画像でも、何枚も溜まれば超えます。
- /compact は、会話をそれまでの要約に置き換えて容量を空ける操作です。やり取りの細部が要約に残るとは限らないため、必要な情報は先に別の場所に控えておくと安心です（後半は筆者の考えです）。
- バージョンで挙動が違います。公式には、v2.1.212 より前は画像が溜まった会話が毎ターン失敗した、v2.1.229 より前は圧縮で直らない場合にも添付の案内が出た、とあります。
- 数字つきの文面は、API に直接つないでいる場合のものです。プロキシやゲートウェイ、クラウドプロバイダー経由では一般的な文面になります。
画像・PDFエラーが出たときによくあるミス
- Request too large を、会話が長いときの Prompt is too long と混同する。上限の種類も対処も違います。
- compacting cannot make it fit と出ているのに、/compact を繰り返す。
- 100ページを超えるPDFを、まるごと添付する。ページ範囲を指定するか、テキストに変換します。
画像・PDFエラーのチェックリスト
- 文面が、Request too large、Image was too large、Unable to resize image、PDF の文面のどれかを確認したか。
- compacting cannot make it fit の有無を確認したか。
- /compact、または Esc 2回で戻る操作を試したか。
- 画像の寸法を、上限（8000 または 3000 ピクセル）以内にしたか。
- PDFが100ページ・20MB以内で、パスワードがないか。
画像・PDFエラーのFAQ（よくある質問）
Q. /compact しても直りません。
A. 文面に compacting cannot make it fit があれば、メッセージだけで上限を超えているため、/compact では直りません。Esc を2回押して戻るか、/clear で新しく始めてください。
Q. 画像は何MBまで貼れますか。
A. 1枚ごとの容量の上限は、公式には記載が確認できませんでした。確認できたのは、リクエスト全体の32MBと、画像の寸法の上限（1枚なら長辺8000ピクセル、20枚を超えると3000ピクセル）です。
Q. 大きなPDFを読ませたいです。
A. 公式の案内は、Claude にページ範囲を指定して Read ツールで読ませること、または pdftotext でテキストを取り出し、そのファイルをパスで指定することです。
筆者の見解（画像・PDFエラー）
私見では、このエラーで初心者が一番損をするのは、文面を最後まで読まずに「とりあえず /compact」を繰り返すことだと考えます。Request too large、Image was too large、Unable to resize image、PDF の文面は、どれも「大きすぎる」と言っているように見えますが、全体の容量の話なのか、1枚の画像の寸法の話なのか、1つのPDFの話なのかで、効く手がまったく違います。特に compacting cannot make it fit が付いているときは、要約しても収まらないと画面がはっきり告げているので、粘らずに Esc の2回押しで戻るか /clear に切り替えるのが近道だと思います。確認の順番は、文面の種類、compacting cannot make it fit の有無、貼った物の大きさ、で十分だと考えます。
また、同じ画像やPDFを形式も大きさも変えずに貼り直すのは避けるべきだと考えます。原因が変わらない以上、結果も変わらないからです。普段の使い方としては、画面全体のスクリーンショットではなく必要な範囲だけを切り取り、大きな文書は中身を貼らずにパスで渡す習慣をつけておくのが、このエラーを遠ざける一番の予防策だと私は考えます。
画像・PDFエラーの関連項目
出典（一次情報）
本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。