claude-code - 💡(How to fix) Fix 2000px multi-image limit blocks ALL interaction, not just image reads [1 comments, 2 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#46132Fetched 2026-04-11 06:28:14
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
labeled ×4commented ×1

When a conversation accumulates multiple PNG images via the Read tool (e.g., visual inspection of code-generated figures), eventually the error appears:

"An image in the conversation exceeds the dimension limit for many-image requests (2000px). Run /compact to remove old images from context, or start a new session."

This error then blocks ALL further interaction -- not just image reads, but text responses, tool calls, and even processing of user messages. The session becomes completely unresponsive to any input. The only recovery is /compact or /clear.

Error Message

When a conversation accumulates multiple PNG images via the Read tool (e.g., visual inspection of code-generated figures), eventually the error appears: This error then blocks ALL further interaction -- not just image reads, but text responses, tool calls, and even processing of user messages. The session becomes completely unresponsive to any input. The only recovery is /compact or /clear. The error should only prevent reading additional images. Text responses, non-image tool calls (Edit, Bash, Grep, etc.), and subagent launches should continue to work. The session should not become completely blocked. 4. The 2000px error blocks everything

Root Cause

When a conversation accumulates multiple PNG images via the Read tool (e.g., visual inspection of code-generated figures), eventually the error appears:

"An image in the conversation exceeds the dimension limit for many-image requests (2000px). Run /compact to remove old images from context, or start a new session."

This error then blocks ALL further interaction -- not just image reads, but text responses, tool calls, and even processing of user messages. The session becomes completely unresponsive to any input. The only recovery is /compact or /clear.

Fix Action

Workaround

  • /compact sometimes clears the images
  • /clear always works but loses all context
  • Launching visual inspection in a fresh subagent (Agent tool) avoids accumulating images in the main session
RAW_BUFFERClick to expand / collapse

Description

When a conversation accumulates multiple PNG images via the Read tool (e.g., visual inspection of code-generated figures), eventually the error appears:

"An image in the conversation exceeds the dimension limit for many-image requests (2000px). Run /compact to remove old images from context, or start a new session."

This error then blocks ALL further interaction -- not just image reads, but text responses, tool calls, and even processing of user messages. The session becomes completely unresponsive to any input. The only recovery is /compact or /clear.

Expected behavior

The error should only prevent reading additional images. Text responses, non-image tool calls (Edit, Bash, Grep, etc.), and subagent launches should continue to work. The session should not become completely blocked.

Steps to reproduce

  1. Open a Claude Code session (Max subscription, Opus 4.6)
  2. Use the Read tool to read 10-15 PNG files (code-generated plots, typically 2000-4000px wide)
  3. After accumulating enough images, attempt any action (even a text response)
  4. The 2000px error blocks everything

Environment

  • Claude Code v2.1.98
  • Claude Max subscription
  • Opus 4.6 (1M context)
  • macOS
  • Context usage was ~30% (not a context limit issue)

Workaround

  • /compact sometimes clears the images
  • /clear always works but loses all context
  • Launching visual inspection in a fresh subagent (Agent tool) avoids accumulating images in the main session

Impact

For workflows that require visual inspection of generated output (e.g., verifying code-generated figures by reading PNG files), this forces either frequent /compact cycles or delegating all image reads to subagents. The blocking of ALL interaction (not just image reads) is the critical issue -- it makes the session appear frozen with no way to recover except /compact or /clear.

extent analysis

TL;DR

The most likely fix is to implement a mechanism to prevent the accumulation of images in the conversation context, such as automatically removing old images when the dimension limit is reached.

Guidance

  • Investigate the /compact command to understand how it clears old images from the context and consider integrating this functionality into the main session to prevent image accumulation.
  • Modify the error handling to only prevent image reads when the dimension limit is exceeded, rather than blocking all interaction.
  • Consider implementing a threshold for the number of images that can be accumulated before triggering the error, to prevent the session from becoming unresponsive.
  • Review the Opus 4.6 context usage limits to ensure that the issue is not related to the 1M context limit.

Example

No code snippet is provided as the issue does not contain sufficient technical details to create a specific example.

Notes

The issue may be related to the specific implementation of the Read tool and the conversation context management in Claude Code v2.1.98. Further investigation is needed to determine the root cause of the issue.

Recommendation

Apply a workaround, such as using the /compact command or launching visual inspection in a fresh subagent, until a permanent fix can be implemented. This will allow users to continue working with the tool while preventing the session from becoming unresponsive.

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…

FAQ

Expected behavior

The error should only prevent reading additional images. Text responses, non-image tool calls (Edit, Bash, Grep, etc.), and subagent launches should continue to work. The session should not become completely blocked.

Still need to ship something?

×6

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

Back to top recommendations

TRENDING