Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Per-image 2000px limit is undocumented and fails mid-session with no recovery [3 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#50890•Fetched 2026-04-20 12:10:14
View on GitHub
Comments
3
Participants
3
Timeline
8
Reactions
0
Author
RonB-LandingAIRonB-LandingAI
Participants
0xbrainkid0xbrainkidgithub-actions[bot]github-actions[bot]RonB-LandingAIRonB-LandingAI
Timeline (top)
labeled ×4commented ×3unlabeled ×1

Error Message

API Error: "An image in the conversation exceeds the dimension limit for many-image requests (2000px). Start a new session with fewer images."

Code Example

API Error:  "An image in the conversation exceeds the dimension limit for many-image requests (2000px). Start a new session with fewer images."
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Hitting this error at 40% context window usage: "An image in the conversation exceeds the dimension limit for many-image requests (2000px). Start a new session with fewer images."

Three problems:

  • The 2000px per-image cap is not surfaced anywhere in the UI before it fails. Users discover it by losing a session.
  • The only remediation offered is "start a new session" — there is no option to drop, downscale, or replace the offending image in place.
  • It's triggered by image dimensions, not context size, so the context meter gives zero warning.

Net-net: either auto-downscale images to the cap on upload, warn at paste time, or expose the per-image limit in the context indicator. Forcing a full session restart for a screenshot that's a few hundred pixels too wide is a bad default and a horrible user experience!!!!!

What Should Happen?

Net-net: either auto-downscale images to the cap on upload, warn at paste time, or expose the per-image limit in the context indicator. Forcing a full session restart for a screenshot that's a few hundred pixels too wide is a bad default and a horrible user experience!!!!!

Error Messages/Logs

API Error:  "An image in the conversation exceeds the dimension limit for many-image requests (2000px). Start a new session with fewer images."

Steps to Reproduce

pasted a f-ing screen shot.

this bug reporting is laborious and also a bad customer experience!!!!

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

Version 1.3109.0 (35cbf6)

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

This bug reporting process is horrible! Make someone REALLY work at providing you information...yeah that's a great customer experience.

extent analysis

TL;DR

To resolve the issue, consider implementing one of the suggested solutions: auto-downscale images to the cap on upload, warn at paste time, or expose the per-image limit in the context indicator.

Guidance

  • The error message indicates that an image exceeds the dimension limit for many-image requests (2000px), suggesting that the issue is related to image size.
  • To mitigate this, the application could automatically downscale images to the cap on upload, or provide a warning at paste time if an image exceeds the limit.
  • Exposing the per-image limit in the context indicator could also help users avoid this issue by providing a clear indication of the image size limit.
  • Consider modifying the error handling to provide more user-friendly options, such as allowing users to drop, downscale, or replace the offending image in place, rather than forcing a full session restart.

Example

No code snippet is provided as the issue does not include specific code details.

Notes

The issue highlights a poor user experience due to the lack of clear indication of the image size limit and the restrictive error handling. Resolving this issue will require modifications to the application's image handling and error handling mechanisms.

Recommendation

Apply a workaround, such as auto-downscaling images or providing warnings at paste time, as this will improve the user experience and provide a more robust solution to the issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#batch processing#GPU compatibility#latency issue#model loading

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [BUG] Per-image 2000px limit is undocumented and fails mid-session with no recovery [3 comments, 3 participants]