If you use iTerm2, pasting images into Claude Code follows standard macOS conventions — Cmd+V works exactly as expected. The only trick is making sure your screenshot goes to the clipboard rather than to a file on disk.
The default Mac screenshot shortcut saves a file. Add Ctrl to send it to the clipboard instead:
# Standard Mac screenshot shortcuts:
Cmd+Shift+4 # drag to select region — saves to desktop as a file
Ctrl+Shift+Cmd+4 # drag to select region — copies to CLIPBOARD, no file saved
Then paste into Claude Code inside iTerm2 with the normal paste shortcut:
Cmd+V # paste image from clipboard — works as expected in iTerm2
Claude Code sees the image directly in the conversation. Paste screenshots of broken UIs, error dialogs, failing test output, design mockups, or anything visual you want Claude to reason about without needing to describe it in words.
You can also copy images from Slack, a browser, or Preview — Cmd+C from the source, switch to your iTerm2 terminal, then Cmd+V.
If pasting appears to do nothing, open Preview → File → New from Clipboard to confirm the image is actually on your clipboard rather than saved as a file.
Note: If you use Ghostty, the paste shortcut is Ctrl+V, not Cmd+V — Ghostty uses Linux terminal conventions. Every other major terminal (iTerm2, Warp, Kitty) follows the standard macOS Cmd+V behaviour.
Ctrl+Shift+Cmd+4 to capture, Cmd+V to paste — two keystrokes from visual bug to diagnosis in iTerm2.
Log in to leave a comment.
The /btw command lets you ask quick side questions that are answered immediately but never added to the conversation history.
The --continue flag loads your most recent conversation instantly, no session ID required.
Claude Code accepts images from any clipboard source — screenshots, Slack messages, browser windows, and design mockups all paste directly into your prompt.