How to Send a Screenshot to Claude Code
By CodeAgentSwarm · Updated October 31, 2026
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, orAlt+Von 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+Pon macOS orCtrl+Shift+Pon 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+Von 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.