Can Claude Code read images?
Yes. Claude Code’s common workflows documentation describes image analysis for diagrams, screenshots, mockups, and more. Anthropic’s Claude Code best-practices guidance describes providing an image by pasting it, dragging and dropping it, or giving Claude its file path. This is specifically about Claude Code—not just Claude models accepting images through an API.
How to try it
-
Open Claude Code in your project.
-
For a copyable example, include the image’s file path in your message:
What error is shown in ./screenshots/error.png?Anthropic’s guidance also mentions pasting or dragging and dropping an image. The material used here doesn’t specify the exact clipboard operation or interface conditions for those options.
-
Ask a specific question, such as “Describe this diagram” or “Compare this mockup with the page and tell me what differs.”
-
Check the response against the image, particularly before acting on small text, exact measurements, or details that matter to a code change.
The source excerpts used for this guide don’t establish a complete supported-format list or Claude Code image-size limits. Don’t assume a format or limit stated for an API or another provider also applies to Claude Code.
What if an image fails?
A third-party GitHub Gist reports image-read errors in some circumstances, including with transparent PNGs, unusual encodings, and repeated image reads. These are the author’s reports—not official Claude Code limits or a guarantee that the same problems will occur in your setup.
If an image fails, try a simpler copy or export and submit it again. Treat that as a troubleshooting attempt, not a documented fix. The Gist also describes a custom hook that converts images and sends them to a separate Claude CLI process; it is a third-party workaround, not a built-in Claude Code requirement or a verified universal solution.
Claude Code or an API for image processing?
Use Claude Code when you want to show an image to an interactive coding assistant—for example, to discuss a screenshot, UI mockup, or diagram during development. Use a model API when you’re building an application that sends images to a model as part of its own request flow. These are distinct channels: the official Claude vision documentation covers API image analysis, not Claude Code’s file-handling limits.
For a production integration, consult the official documentation for the exact API channel and model you plan to use. Don’t apply a Claude Code anecdote—or limits documented for Amazon Bedrock—to a different API.
Sources
Common workflows — Claude Code Docs