DEV Community

Little Pan
Little Pan

Posted on Originally published at ponymux.com

Why can't I see the image Claude Code reads?

When Claude Code reads a screenshot, or its browser tool takes one, your terminal prints a line like Read 1 file. The picture goes to the model. You never see it. Codex draws a thumbnail too small to read, and Grok prints one line with a file path. To check what the agent actually looked at:

  • Open the file. If the image is on disk, run open <path> on macOS, or Cmd+Click the path in Codex and Grok.
  • Ask for a file. Browser screenshots are not files until you ask. Tell Claude Code to save the screenshot to a path, then open that.
  • Let the terminal draw it. Codex does this on Kitty or Sixel terminals. Claude Code can through a mod, in Ghostty, kitty, or iTerm2.
  • Keep it beside the agent. PonyMux shows the pictures the agent receives in a floating Agent View over its Terminal. Select one to enlarge it, and use the arrow keys to go back through the last 20.

Why can't I see the image Claude Code reads?

Because the terminal only gets text. When Claude Code reads an image file with its Read tool, the picture is handed to the model as visual content, and the terminal shows Read 1 file and nothing else. In our test, that line carried no link and drew no picture.

Anthropic's docs describe what Claude receives and are silent on what you see. There is no built-in setting that draws the image in the transcript. Browser screenshots behave the same way.

So when an agent says "the page looks fine" or describes a window you can't find, you have no way to check it from the terminal alone. That is the gap the rest of this post is about.

What do Codex and Grok show instead?

Each shows something different. This is what we saw when each agent read the same 1280×720 PNG in Ghostty, with Claude Code 2.1.326, Codex 0.167.2, and Grok 1.0.88.

What you see Open it larger
Claude Code One line, Read 1 file. No picture. Cmd+Click (Mac) or Ctrl+Click on an [Image #N] link when Claude refers to one. Otherwise open the file yourself.
Codex A thumbnail in the fullscreen transcript, with the path as a link. Needs a Kitty or Sixel terminal. Click the path to open the image.
Grok One line, Read <file> (image), with the path. No picture. Cmd+Click or Ctrl+Click the path. A plain click shows a card with an Open button.

The Codex thumbnail was about 22 columns by 6 rows in a 160-column window, which is too small to read text in a screenshot. A GitHub request asks for larger previews and a fullscreen view, and it was still open when we checked. Codex's release notes (0.164 to 0.168) cover the preview, the clickable path, and tmux support.

How do I open the image the agent just looked at?

Start with the path. When the agent reads an image file, the path is in the transcript.

On macOS, open <path> opens it in your default app, from any shell. In Codex, click the path in the transcript. In Grok, Cmd+Click it. In Claude Code, Cmd+Click or Ctrl+Click works on an [Image #N] link when Claude refers to one in a reply.

Screenshots from a browser or from screen control are usually not files at all. Claude Code's Chrome integration can save them. Anthropic's example is "Take a screenshot of the checkout page and save it to disk", and Claude then reports the file path. Put that in your prompt, or in CLAUDE.md, and open the file it names.

Screen control is different. The docs don't say you can save its screenshots to a path.

Can my terminal draw the image itself?

Sometimes, and only in some terminals.

Codex does it by default on terminals that support the Kitty or Sixel graphics protocol, such as Ghostty and kitty. Since 0.168 it also works inside tmux on Ghostty and kitty, with allow-passthrough all set.

Claude Code has no built-in image display, but it has mods, and a mod can draw an Image element. That draws in kitty 0.28 or later, Ghostty, and iTerm2 3.5 or later (which needs Claude Code 2.1.305 or later). Other terminals show the alt text. Inside tmux you need Claude Code 2.1.310 or later, tmux 3.3 or later, and focus-events and allow-passthrough turned on. The element draws a picture the mod gives it. Anthropic's docs don't say a mod can show what Claude read.

Grok drew nothing in our Ghostty test.

What you get depends on your terminal, and on whether you use tmux or SSH.

Is this the same as pasting an image into Claude Code?

No. Pasting is the other direction: you give the agent a picture. This post is about the picture the agent gets from a tool.

To paste, press Ctrl+V on macOS and Linux (Cmd+V in iTerm2), or Alt+V on Windows and WSL. Claude Code inserts an [Image #N] chip. Codex takes a paste into the composer, or codex --image with the first prompt. Grok takes Ctrl+V, Alt+V on Windows, or a file dragged in from Finder.

If your problem is that a paste doesn't work, that's a different set of fixes, usually about your terminal intercepting the key.

How does PonyMux show them?

PonyMux runs Claude Code, Codex, and Grok in one window on macOS and Windows. Its Agent View shows the pictures an agent receives while it works, so you don't need a terminal that draws images.

The enlarged Agent View window in PonyMux, showing the browser screenshot of Google's home page that the agent took, with a left-arrow key to step back through earlier pictures

  • When the agent takes a screenshot of a browser or your screen, a small window opens over the corner of its Terminal.
  • Select the picture to open it larger. The arrow keys step through the last 20.
  • Images the agent reads from a file wait in the Agent View section of the Inspector as a strip of thumbnails. They don't open the window by themselves.
  • Tall screenshots show their top and fade out, so the window doesn't grow.
  • Remote Control shows the same pictures on your phone.

Nothing is saved to disk. PonyMux keeps the last 20 pictures of each Terminal's agent in memory and reads recent ones back from the transcript when you open a conversation. Agent View doesn't show while several Terminals are selected.

To turn the floating window off, switch off Show Agent View automatically in Settings → General. For the full reference, see Agent View. For the story behind it, read See what your agent sees.

PonyMux is free for macOS and Windows: download it here.

Top comments (0)