How to paste a screenshot into Claude Code

The three ways that work

1. Paste it with Ctrl+V, not ⌘+V

Take the shot straight to the clipboard with ⌘Ctrl⇧4, then press Ctrl+V in Claude Code. That is the one that pastes an image. ⌘+V is your terminal's own paste, which hands over a file path or nothing at all. It is the single most common reason people think image paste is broken. (More on why pastes silently vanish.)

2. Drag the file onto the terminal

Drag a .png from Finder or the Desktop onto the terminal window. The path lands in the prompt and Claude reads the image. It is the least fiddly method and it works in every terminal emulator.

3. Just type the path

look at ~/Desktop/bug.png works. It is also the only method that survives being written into a script or a task file.

Cursor and Codex differ in the keystroke and agree on the substance: the image gets in. And the image alone is rarely the thing that was missing.

Why the fix still lands in the wrong place

A screenshot answers what it looks like. It does not answer the questions the agent now has to guess at:

• Which element. A full-window shot of a settings page has forty controls in it. You meant one.
• What it should have done. The picture shows the wrong state. Nothing in it says what right looks like.
• What you did first. Bugs live in the sequence, and a still frame has none.
• What it is called in the code. You know the toggle is autoSyncEnabled. The pixels do not.

So the agent infers, usually from whatever is most visually loud in the frame. That is how you get a confident refactor of the header when you were pointing at a checkbox below the fold.

The part that actually makes the difference

Crop to the element. A tight shot of one control removes forty wrong answers before the agent starts. It is the highest-leverage habit on this page.

Then say four things in one sentence: what you pointed at, what it did, what it should do, and where it probably lives.

"The Auto-sync toggle in Settings flips back to off when I reopen the window. It should persist. Probably the preferences store, not the view."

An agent given that plus a cropped image usually gets it right first time. An agent given a full-screen PNG and "this is broken" will not, and the three turns you spend correcting it cost more than the sentence would have.

The shortcut: point and say it instead

Nobody types that sentence, because it is dull and you already know it. That gap is why Deiko exists. Double-tap Right Option, point at the toggle, say the sentence out loud. Deiko crops the screenshot to what is under your cursor, reads the element's label and window title, transcribes what you said, and writes the brief. Drop it into Claude Code, Cursor or Codex, or paste it into ChatGPT. Screenshots never leave your Mac.