Claude Media
Claude Codeの「Request too large」が出たときの対処法

Claude Codeの「Request too large」が出たときの対処法

Claude Codeで「Request too large」が出る原因と対処を、3つの表示パターン別にまとめます。Prompt is too longとの違いも扱います。

Claude Codeで「Request too large」が出たら、まず疑うのはコンテキストウィンドウではなくリクエスト本体のサイズです。Claude APIには送信前のリクエストボディに32MBという上限があり、これはトークン数で管理されるコンテキストウィンドウとは別の枠です。画像や添付ファイルが会話に積み重なると、トークン数はまだ余裕があるのにボディサイズだけが先に上限へ届きます。

Request too largeとは何のエラーか

Claude Codeが組み立てたリクエストが、トークン化の前の生データの時点で32MBを超えたときに出ます。APIから見ると、HTTPステータス413のrequest_too_largeにあたります。直接のClaude APIでは、このエラーをCloudflareがAPIサーバーに届く前に返します。

原因は主に3つです。貼り付けた画像や添付ファイルの蓄積、会話のテキスト本文の肥大、そしてコマンド出力やファイル読み込みなどツール実行結果の蓄積です。

蓄積しやすい理由は、会話が続くほど1回の送信が重くなる仕組みにあります。会話履歴はターンごとに丸ごと再送されるため、base64で埋め込んだ画像のバイト列も毎ターン同じだけ乗ります。しかもbase64は3バイトを4文字に置き換える形式なので、元のファイルより約3分の1大きくなります。数MBのスクリーンショットを何枚も貼った会話は、ファイルサイズの合計より早く上限に近づきます。テキストだけで超えるのは、大きな貼り付けやツール実行結果が積み重なった場合です。

数字

リクエストサイズの上限(エンドポイント別)

  • Messages API

    32MB

    Claude Codeの会話はここに送られる

  • Batch API

    256MB

    バッチ処理用

  • Files API

    500MB

    ファイルのアップロード用

いずれも超えると413のrequest_too_large

Prompt is too longとの違い

文言のよく似た「Prompt is too long」は、トークン数がコンテキストウィンドウを超えたときのエラーです。見分けは、数えている単位がトークンかバイトかにあります。

くらべる

2つのエラーの違い

バイト数

Request too large

送信するデータそのものが32MBを超えた状態です。画像・添付・ツール実行結果が主な原因で、トークン数には余裕があることもあります。

トークン数

Prompt is too long

モデルごとのコンテキストウィンドウを超えた状態です。会話履歴の要約(/compact)でトークンを減らすのが中心の対処になります。

画面上の見え方も違います。対話セッションの「Prompt is too long」は、Context limit reached · /compact or /clear to continueという一行で出ます。-pの出力や記録(トランスクリプト)ではPrompt is too longのままです。「Request too large」の文言には、max 32MBや32MB request limitという数字が入ります。

表示される3つのパターンと見分け方

Claude Codeは、リクエストが直接Claude APIに届いたか、プロキシやゲートウェイ、クラウドプロバイダー経由かによって、メッセージの詳しさを変えます。直接届いてAPIが拒否したときは、会話を測定して回復できるかどうかまで文言に反映します。経由している場合は汎用の一文だけが出ます。

表示パターン意味Claude Codeの挙動
Request too large (max 32MB). Accumulated images and attachments...意味プロキシ / ゲートウェイ経由で詳細を測定できないClaude Codeの挙動/compactか添付削除を促すのみ
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意味会話のテキスト本文だけで32MBを超えているClaude Codeの挙動圧縮では収まらないため再送しない

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.です。v2.1.212より前の古い文言Request too large (max 32MB). Double press esc to go back and try with a smaller file.も、同じ原因の表示です。

2番目の表示の数字は、読み方が決まっています。約33.4MBがリクエスト全体の大きさで、そのうち画像と文書が20.1MBです。画像と文書を外した残りは約13.3MBで、32MBに収まります。1番目は測定できないぶん、添付の整理を促す一文が出ますが、原因は貼り付けた大きな内容、ツール実行結果、添付ファイルのいずれもありえます。文言が添付に触れていても、実際はコマンド出力の蓄積ということがあります。非対話モード(-p)では、入力を減らすか新しいセッションを始めるようメッセージが案内します。

どう対処するか

手順

表示パターン別の対処の流れ

  1. 1

    メッセージに「compacting cannot make it fit」があるか見る

    あれば3番目のパターンです。/compactは効かないので、次の手順へ進みます。

  2. 2

    3番目なら、戻るか、会話を空にする

    Escを2回押して、大きな内容を足したターンの手前まで戻ります。戻る先がなければ/clearで会話を空にします。

  3. 3

    それ以外は`/compact`で画像と添付を落とす

    会話履歴が要約され、蓄積した画像や添付ファイルが外れます。圧縮が長く止まるときの仕組みはcompactの発火条件と要約後に残る情報にあります。

  4. 4

    再発を防ぐなら、大きな内容は貼らずパスで渡す

    ログやdiffの全文を貼り付けず、ファイルのパスを示します。Claude Codeが必要な範囲を分割して読み込むので、リクエストに乗る量が増えにくくなります。

どこが重いのか見当をつけたいときは、/contextで画像や添付、ツール実行結果がどれだけ溜まっているかの目安を見られます。

/context

コマンド出力を会話に残し続けている場合も同じ考え方です。grepやheadで出力の範囲を絞ってから渡すと、ツール実行結果の蓄積を抑えられます。

画像は、Readツールが返す時点でClaude Codeが縮小と再圧縮をかけます。リサイズ後も500KBを超える画像は、画素数を保ったまま画質を下げたJPEGに変換されます(v2.1.196以降)。それでも細部が必要なときは、全画面のスクリーンショットではなく、見たい範囲だけを切り出した画像を渡すほうが軽く済みます。ImageMagickで先に切り抜かせる方法もあります。

手元のバージョンに修正が入っているか

次のコマンドで確認できます。

claude --version

たとえば2.1.289 (Claude Code)のように表示されます。次の表の修正はいずれもこの番号より前のものなので、含まれています。

v2.1.212とv2.1.229で何が変わったか

バージョン変更内容
v2.1.212より前変更内容画像が多く蓄積した会話が、毎ターンRequest too large (max 32MB). Double press esc to go back and try with a smaller file.で失敗していた
v2.1.212変更内容画像の多い会話が「Request too large」で失敗し続ける不具合を修正し、実際の原因を説明するメッセージにした
v2.1.229より前変更内容圧縮しても直らないケースでも、常に添付削除のアドバイスが表示されていた
v2.1.229変更内容圧縮では収まらないケースで「compacting cannot make it fit」と示し、再送しないようにした

古いバージョンのままだと、実際にはテキスト本文が原因なのに/compactを促されて空振りしやすくなります。頻繁にこのエラーへ当たる環境では、claude updateで最新版に上げておくと切り分けが早くなります。更新後は、同じclaude --versionで番号が上がったことを確かめられます。

Claude APIを自分で呼ぶアプリで起きたとき

Claude Codeを使わず、Messages APIを直接呼ぶアプリでも原因は同じです。履歴をそのまま積み続けると、base64画像のバイト列が毎ターン乗り続けます。

画像まわりの上限は、サイズの手前に枚数と寸法の制約が重なります。

項目上限
1リクエストの画像枚数上限200kトークンのコンテキストウィンドウのモデルは100枚、それ以外のモデルは600枚
画像1枚のサイズ(base64)上限Claude API直接で10MB、Amazon BedrockとGoogle Cloudで5MB
1枚の寸法上限8000×8000ピクセル
20枚を超えるリクエスト上限全画像が長辺2000ピクセル以内の制限を受ける

最後の行は見落としやすい条件です。この枚数には、前のターンから再送している画像や、tool_resultの中の画像(コンピューター操作ツールが返すスクリーンショットなど)も数えられます。1回に貼った枚数が少なくても、履歴を含めると20枚を超えることがあります。

枚数の上限より前に32MBに届く場合もあります。Amazon BedrockやGoogle Cloudでは、リクエスト全体の上限がさらに低いことがあります。

対処は、画像をFiles APIにアップロードしてfile_idで参照する方法です。リクエストに乗るのは参照だけになり、履歴に画像が何枚溜まってもボディサイズが膨らみません。ただし、大きな画像を多数載せたリクエストは、Files APIを使っても600枚に達する前に失敗しえます。アップロード前に寸法やファイルサイズを縮めておくと安全です。Files APIはClaude API直接で使え、Amazon BedrockとGoogle Cloudではbase64形式の画像だけが使えます。

Claudeのチャット画面(claude.ai)には別の上限があり、1メッセージに添付できる画像は20枚、画像1枚は10MBまでです。ここで書いた32MBや枚数は、Claude CodeやAPIで画像を扱う場合の話です。Claude CodeのCLI・Desktop・Webの違いはCLI・Desktop・Webの比較にまとまっています。

Claude appsゲートウェイ経由で出る文言

組織がClaude appsゲートウェイを使っている場合、上流がサイズ超過で413を返したとき、ゲートウェイが分類できなければrequest too large for this upstreamという文言になります。400で分類できない場合はupstream rejected the requestです。この2つは、Claude Codeが測定して出す「Request too large」とは別の表示です。Amazon Bedrockの長すぎる入力はcapability_rejected: prompt_too_longに置き換えられ、Claude Codeはこのトークンで自動的に圧縮します。

PDFエラーやレート制限との違い

サイズが絡むエラーは他にもあり、名前が似ているので取り違えやすい点に注意が要ります。PDFそのものが原因のときは「Request too large」ではなく、ページ数とファイルサイズの上限(100ページ・20MB)を示す個別のPDFエラーが出ます。対処は、ページ範囲を指定して読ませるか、pdftotextなどでテキストを抜き出してパスで渡す方法です。10ページを超えるPDFは、Readツールが一度に最大20ページずつ範囲を指定して読みます。この範囲読みにはpdftoppm(poppler-utils)が必要で、無いとpdftoppm is not installedで失敗します。原因別の切り分けはClaude Code PDFエラー一覧にあります。なお、PDFを生成したい場合はMarkdownを縦書き日本語PDFに変換する手順が別にあります。

画像側でも、サイズではなく処理そのものに失敗するときは別のエラーです。「Unable to resize image」が出る原因と対処法を見てください。画像1枚の寸法やサイズが上限を超えたときの「Image was too large」はこちらで扱っています。

429や529で止まるレート制限・混雑系のエラーは、リクエストのサイズではなく送信頻度や使用量の枠が原因です。「Request too large」が出ていないのに応答が止まる場合は、Claude rate limitエラーの対処を先に見るほうが早く解決します。エラーの種類そのものを見分けたいときはClaude Codeでよくあるエラー10選が使えます。

まとめ

「Request too large」はトークンではなくリクエストボディのバイト数が原因なので、トークンを減らす/compactだけでは直らないことがあります。画像や大きなログはFiles APIやファイルのパスで渡すと、再発しにくくなります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/errors
  2. code.claude.com/docs/en/changelog
  3. platform.claude.com/docs/en/api/errors
  4. platform.claude.com/docs/en/build-with-claude/vision
この記事を共有:XはてブLinkedIn