How to Send a Screenshot to Claude Code

By CodeAgentSwarm · Updated October 31, 2026

A screenshot often explains a bug faster than a paragraph: a broken layout, an error dialog, a chart that looks wrong. Claude Code can read images, so the only question is how to get the picture into the session without saving files to the desktop and hunting for paths. This guide starts with the three ways Claude Code supports on its own, then shows how CodeAgentSwarm turns a screenshot into a message for an agent in a couple of keystrokes.

The three built-in ways

Anthropic's common workflows page lists three ways to add an image to a Claude Code session:

  • Drag and drop the image file into the Claude Code window.
  • Paste it with Ctrl+V, or Alt+V on Windows and WSL. On a Mac this is Control, not Command.
  • Give the path in your prompt, for example: Analyze this image: /path/to/your/image.png.

Then ask a concrete question about it: "the button in this screenshot overlaps the footer at 390 px, fix the CSS" works better than "look at this".

To copy a region straight to the clipboard on macOS, use Cmd+Ctrl+Shift+4. On Windows, Win+Shift+S does the same. Then paste it into Claude Code.

Screenshot to Agent in CodeAgentSwarm

CodeAgentSwarm is a desktop app for macOS, Windows and Linux that runs Claude Code, Codex and other agents side by side. It has a capture flow made for this job.

  • Press Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows and Linux. You can change the shortcut in Settings.
  • Drag over the part of the screen you want, on any monitor. The capture happens when you release the mouse.
  • A preview opens. The session you were working in is already selected, and you can pick another open session or start a new agent in one of your projects.
  • Click the image to draw on it with a pencil, arrows or text, write what is wrong, and press Send.

The agent receives your note and the path to the image in one message, so it can open the file itself. This works the same for Claude Code, Codex and the other agents.

Need to capture another app? Click the camera button at the bottom of a Chat. It waits 5 seconds so you can switch windows, then opens the same region selector. Click it again or press Esc to cancel.

Appshots: capture a whole window with two keys (macOS)

On a Mac, press both Shift keys at the same time to capture the window of the app in front, with no selection to draw. Captures collect in a small tray. In any Chat, the Add Appshots button next to the camera adds them to the message you are writing, and you can still edit the images and the text before sending.

Appshots need two macOS permissions, Input Monitoring and Screen Recording. In Settings > Capture > Appshots you can grant them, switch the key pair to both Command or both Option, or turn the gesture off.

Paste and drop also work

  • In a CodeAgentSwarm terminal, Cmd+V on a Mac pastes a copied image. The app saves it to a temporary file and hands the path to the agent.
  • Drop an image file onto a terminal or a Chat to attach it.
  • In the Chat, click a pending image before sending to draw on it.

From your phone

With the CodeAgentSwarm phone app paired to your computer, you can attach a photo from the camera or the gallery to any Chat session, draw on it, and send it. Handy for a bug you just saw on a real device. Setup is in how to control Claude Code from your phone.

FAQ

How do I paste a screenshot into Claude Code on a Mac?

Copy the image and press Ctrl+V (Control, not Command) in the Claude Code terminal. You can also drag the file into the window or type its path. In a CodeAgentSwarm terminal, Cmd+V works too.

How do I paste an image into Claude Code on Windows?

Anthropic documents Alt+V for image paste on Windows and WSL. Drag and drop and file paths work as well.

Can Claude Code read screenshots?

Yes. Claude Code can analyze images you add to the conversation, such as error screens, UI mockups or diagrams.

Does Screenshot to Agent work with Codex?

Yes. In CodeAgentSwarm the capture flow sends the image path and your note to whichever session you pick, including Codex, OpenCode and the other supported agents.