Flicopy
Guide

How to paste a screenshot into Claude Code on Mac

You copied a screenshot, pressed ⌘V in Claude Code, and nothing happened. That is expected: in most Mac terminals Claude Code pastes images with a different key. Here is how it works, and how to get older screenshots in too.

The short answer

In Claude Code on a Mac, paste images with Ctrl V, not ⌘ V. Claude Code inserts an [Image #1] chip at the cursor, and you can refer to it in your prompt.

The exception is iTerm2, where ⌘ V also pastes images. On Windows and WSL the key is Alt V. This comes from Claude Code’s interactive mode reference (checked November 12, 2026).

Why the difference: ⌘ V is handled by the terminal app, which pastes text. Ctrl V reaches Claude Code itself, which reads the image from the clipboard.

Step by step

  1. Copy a screenshot to the clipboard. Press Control ⇧ ⌘ 4 and drag over an area. Holding Control copies the screenshot instead of saving a file.
  2. Switch to the terminal running Claude Code and click in the prompt.
  3. Press Ctrl V. An [Image #1] chip appears. Type your question, such as “Why does this layout break on narrow screens?”, and press Return.

Repeat for more images: each one gets the next number.

If it says “No image found in clipboard”

  • Check what is on the clipboard. If you copied the screenshot file in Finder, the clipboard may hold the file reference rather than the image. Copy the image itself, or use the next tip.
  • Drag the file in. Dragging an image file into the terminal inserts its path, and Claude Code can read images from a path.
  • Type the path. You can also write the path in your prompt, for example look at ~/Desktop/error.png.

Send an older screenshot, or several

The clipboard only holds the latest screenshot. If the one you need is from an hour ago, or you want to send three, you need somewhere they were kept.

Flicopy is your working memory on the Mac: every screenshot you take and everything you copy stays in the Quick Panel, newest first, with the app and page it came from.

One image

  1. Press ⌥ ⌥ (Option twice) to open the Quick Panel.
  2. Select the screenshot and press ⌘ C to copy it.
  3. In Claude Code, press Ctrl V.

Pressing Return in the Quick Panel pastes with ⌘ V, which Claude Code treats as text in most terminals, so copy first and use Ctrl V for images.

Several images

Drag the cards out of the Quick Panel and drop them into the terminal window. Each one arrives as a file path, and Claude Code reads them as images. To select several cards before dragging, ⌘-click them.

Text works with any paste. Select the error message, the log and the link in the Quick Panel and press Return: they paste together, one per line, and Claude Code collapses a long paste into [Pasted text #1]. See how to give your AI context from your Mac for more.

Frequently asked questions

Why doesn’t ⌘V paste images in Claude Code?

In most terminals, ⌘ V is handled by the terminal app, which only pastes text. Claude Code reads images from the clipboard when you press Ctrl V. iTerm2 is an exception where ⌘ V also works.

How do I take a screenshot straight to the clipboard on Mac?

Press Control ⇧ ⌘ 4 for an area or Control ⇧ ⌘ 3 for the whole screen. See where screenshots go on Mac for more options.

Does this work with the Claude desktop app?

The desktop and web apps accept ⌘ V for images like any other Mac app, and you can paste several items from Flicopy at once with Return.