How to Show Claude Code a Screenshot or Screen Recording of a Bug

Sometimes a bug is easier to show than to describe. A button looks wrong. A layout breaks. A text is cut off. Claude Code can look at images, so you can show it what you see. This guide covers the basic ways to do that. Then it covers what to do when you have many things to point out in one pass.

We make Quibble, a Mac screen recorder. It is one option in the last method, not the only way.

What Claude Code can look at

Anthropic's Claude Code docs have a section called "Work with images". It lists three ways to add an image to the conversation:

1. Drag and drop an image into the Claude Code window.
2. Copy an image and paste it into the CLI with Ctrl+V (the docs list Ctrl+V; in iTerm2, Cmd+V also works).
3. Give Claude an image path, for example "Analyze this image: /path/to/your/image.png".

The docs say you can use more than one image in a conversation. They also give examples such as "Here's a screenshot of the error. What's causing it?"

The docs describe images: screenshots, mockups and diagrams. We did not find a statement about video files in that section, so this guide does not promise that Claude Code can watch a screen recording. If your tool needs it, take screenshots from the recording instead.

Method 1: Paste one screenshot

Use this for one clear problem.

1. Press Shift-Command-4 to select an area, or Shift-Command-3 for the whole screen. (To copy the shot instead of saving a file, hold Control as well.)
2. In the Claude Code window, press Ctrl+V.
3. Write what is wrong and what you want. For example: "The Submit button label is misspelled. Fix it."

Tell Claude what you want in words. A screenshot shows the problem, but it does not say which change you expect.

Method 2: Give a file path

Use this when the screenshot is already a file, or when you have several.

1. Save the screenshot to a folder. Note the full path.
2. In your message, write the path: "Look at /Users/me/Desktop/bug-1.png. The button is cut off on the right. Find the code and fix it."
3. For more than one image, list each path on its own line and say what each one shows.

Claude Code can also pick files with the @ key in a message. The docs describe @ for files and directories. We did not confirm in the docs that @ works the same way for images, so use a plain path to be safe.

Method 3: A recording with several notes

One screenshot is fine for one bug. A design or product review usually has ten small things. Taking ten screenshots, naming them and writing ten sentences is slow.

Another way is to record once, point at each thing and say what is wrong. Then copy the notes with their screenshots and paste them into Claude Code in one message. Here is how that works in Quibble:

1. Open Quibble and press Option-Command-R to start recording. Your microphone is recorded by default.
2. Use your app. When you see a problem, hold Command and move the mouse over it to draw a yellow highlight, and say what is wrong. The highlight is what records the spot.
3. Press Option-Command-R again to stop. The editor opens, and each thing you said is a note with a time and a thumbnail. Notes made while you drew a Command highlight also keep the spot.
4. Click Copy for AI agent (Shift-Command-C). Quibble copies text to your clipboard. It does not send it anywhere.
5. Open Claude Code in your project. Paste the text with Command-V in the terminal and press Enter.

What the copied text contains:

• A short instruction asking the agent to fix each item in the codebase.
• Each note, with its time and the words you said.
• If you drew a Command highlight, the spot as x and y numbers and a box size, from the top-left of the recorded screen.
• The file path of a screenshot for each note, so the agent can open it.
• The path of the notes table and, if it exists, the video.

The text also asks the agent to say which note was unclear and what it assumed, and to list each note number with what changed when it is done.

Here is a real example. We recorded a small login page with two notes: "This button label is misspelled, it should say Submit" and "Cancel looks exactly like the main button. Make it a light gray secondary button." We pasted the copied text into Claude Code, and in a separate test into OpenAI Codex. In both runs the agent changed the misspelled label and gave the Cancel button a gray background. The colors differed: Claude Code chose #e4e4e7 and Codex chose #e5e7eb. This was one small page. It does not show how an agent will handle a large app, and an agent can still get a note wrong. Check the result.

Quibble has no link to Claude Code. It does not run the fix. You copy, you paste, and the agent reads the files from the paths in the text. Recording and editing are free, and Copy for AI agent works without a license. Saving the finished video as MP4 needs a license ($7.99 per month, $79 per year or $129 once). Quibble needs a Mac with Apple silicon and macOS 15 or later.

Which method should you use?

Tips for any method

• Say what you want changed, not only what is wrong.
• Highlight one thing per note with Command.
• Remove private data from the screen before you capture it: emails, tokens, other tabs.
• Review what the agent changed before you commit.

If you also want to send a video to a person, see Quibble vs Loom and Loom for Claude Code.

Frequently asked questions

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

Copy the image, then press Ctrl+V in the Claude Code window. Anthropic's docs list Ctrl+V for pasting. You can also drag the image into the window or give its file path.

Can Claude Code watch a screen recording?

The Claude Code docs we read describe images, not video. We did not find a statement that it can watch a video file. To be safe, give it screenshots and text.

Can I give Claude Code more than one screenshot?

Yes. The docs say you can work with multiple images in a conversation. Name each one and say what it shows.

Does Quibble send my notes to Claude Code?

No. Copy for AI agent only copies text to your clipboard. You paste it into Claude Code or Codex yourself. Nothing is uploaded, and Quibble has no cloud or share links.

Will the agent always fix every note?

No. It can fix them, but it can misread a note or change the wrong thing. In our short test with two notes, both agents made the change. Always review the result.

Sources

• Anthropic: Claude Code common workflows, "Work with images" (docs.claude.com redirects here)
• OpenAI: Codex CLI
• Quibble: getquibble.app

---