Can Claude Code Take Screenshots of Your Screen?
Claude Code reads screenshots you paste, and with the right setup it can capture your screen itself. Here are the four ways and when to use each.

Claude Code can work with screenshots in two directions. You can hand it a screenshot to look at, and with the right setup it can capture your screen on its own. This article covers both: how to give Claude Code an image, the four ways it can take a screenshot itself, and which one to use when you need a saved file rather than a quick look.
The Short Answer
Out of the box, Claude Code does not watch your screen. It sees an image only when you add one to the conversation or when a tool captures one for it. Those tools are:
- a shell command, such as
screencaptureon a Mac - Claude in Chrome, for pages open in your browser
- computer use, which lets Claude see and control apps on your Mac
- an MCP screenshot server, which gives Claude a capture tool it can call
Each one fits a different job, so the rest of this article walks through them in that order.
How to Give Claude Code a Screenshot
The most common search behind "Claude Code screenshot" is simpler: you took a screenshot and want Claude to read it. Claude Code's documentation lists three ways:
- Paste it. Copy the image, then press
Ctrl + Vin Claude Code. On a Mac this isCtrl, notCommand. On Windows and WSL, pressAlt + V. - Drag it. Drop the image file into the Claude Code window.
- Give a path. Type something like
Look at this screenshot: ~/Desktop/error.png.
Then ask what you need: "What is causing this error?" or "Write CSS that matches this design." Claude Code labels each image as [Image #1] and so on, and you can open the image from that label.
This works well for one screenshot you already have. It gets tedious when Claude needs a fresh capture after every change, or many captures in a row.
Four Ways Claude Code Can Take a Screenshot Itself
1. Run a shell command
Claude Code can run terminal commands, so on a Mac it can call screencapture to save an image and then read the file. Your terminal app needs Screen Recording permission first. This is quick for a one-off capture of the whole screen, but Claude has to guess window ids and file paths, and nothing organizes the results.
2. Use Claude in Chrome for web pages
With the Claude in Chrome extension connected (claude --chrome), Claude Code can open pages, click through them, and take screenshots of browser tabs. Ask "Take a screenshot of the checkout page and save it to disk" and it reports the file path. It reaches only what is open in your browser.
3. Turn on computer use
Computer use lets Claude open apps, click, type, and see your screen. In the Claude Code CLI it is a research preview on macOS for Pro, Max, and Ultra plans; you enable the built-in computer-use server from /mcp and grant Accessibility and Screen Recording. The Claude Code desktop app also offers it on Windows.
Computer use screenshots exist so Claude can see where to click. Claude Code downscales them before sending them to the model, and Anthropic describes computer use as the broadest and slowest option, used when no MCP server, shell command, or browser tool fits.
4. Connect an MCP screenshot server
An MCP server gives Claude Code a set of capture tools to call directly, with no mouse involved. Claude asks for a list of windows, picks one, and gets the image back. Because the tools are built for capturing, they can also save, repeat, and export, which the other routes leave to you.
Which Route Fits Your Task
| You want Claude to… | Best route |
|---|---|
| Read a screenshot you already took | Paste, drag, or give a path |
| Check a web page it is building | Claude in Chrome |
| Click through a native app to test it | Computer use |
| Capture a specific app window and keep the image | MCP screenshot server |
| Capture many pages or steps and export a PDF | MCP screenshot server |
Capture Windows with Claude Code and Shotomatic
Shotomatic is a desktop screenshot app for macOS and Windows that includes a local MCP server. Once Claude Code is connected, it can look at any window on your screen, not only browser tabs. Longer captures are saved to Shotomatic's Capture History, so you keep the files.
Setup takes one click: open Shotomatic, go to Settings > AI agents, and select Connect next to Claude. The Claude Code setup guide also shows the one-line claude mcp add command if you prefer the terminal.
Then ask in plain language:
"Take a screenshot of the Figma window and tell me if the spacing matches the spec."
"Capture this PDF viewer page by page, pressing the right arrow after each screenshot, and export the result as one PDF."
"Record a guide while I click through the export flow, then write a title for every step."
Behind those requests, Claude uses tools such as list_capture_sources to find the window, capture_window_snapshot to look at it, start_auto_capture to capture page after page with a key press in between, and export to save a PDF, PNG, JPG, or ZIP to your export folder. Shotomatic asks you before anything is deleted, and it never presses a key while another window is in front.
One thing to keep in mind with any of these routes: an image Claude looks at becomes part of its conversation. Close anything private before you ask for a capture.
Frequently Asked Questions
Can Claude Code see my screen?
Not by default. Claude Code sees an image when you paste or drag one in, or when a tool captures one for it: a shell command, Claude in Chrome for browser tabs, computer use on a Mac, or an MCP screenshot server such as Shotomatic.
Why does Command + V not paste a screenshot into Claude Code on a Mac?
Claude Code's paste shortcut for images is Ctrl + V, not Command + V. On Windows and WSL it is Alt + V. You can also drag the image file into the terminal or type its path.
Can Claude Code take screenshots on Windows?
Computer use in the Claude Code CLI is macOS only, but the Claude Code desktop app offers computer use on Windows too. An MCP server works on both systems; Shotomatic's MCP server runs on macOS and Windows 10 and 11.
Are screenshots Claude Code takes saved anywhere?
It depends on the tool. Computer use screenshots are for Claude to look at. A shell command or Claude in Chrome can save a file when you ask. Shotomatic saves repeated captures to Capture History and can export them as PDF, PNG, JPG, or ZIP.
Next Step
If you want Claude Code to capture app windows, repeat captures, or hand you a finished PDF, see what Claude can do with Shotomatic.
Turn repeatable screenshots into finished work
Shotomatic captures, organizes, and exports screenshot sessions on Mac and Windows.
Related posts
See more postsBest Screenshot Automation Tools for Mac (2026)
Pick a Mac tool for automated screenshots: timed intervals, one shot per click, URL-list batches, or searchable PDFs, with Shotomatic, Snagit, and CleanShot X.

How to Download Kobo Books as EPUB or PDF on a Mac
Download Kobo books as EPUB or PDF from My Books on a Mac. See what to do with an ACSM file, how to read in a browser, and how to export your notes.

How to Take a Screenshot on Windows 11 and 10: Every Shortcut
Every way to take a screenshot on Windows 11 and 10: Snipping Tool, Print Screen, Windows + Print Screen, Alt + Print Screen, and Game Bar, with what each one saves.

Greenshot for Mac: What the Mac Version Does and What to Use Instead
Greenshot's Mac App Store version is paid and hasn't been updated since 2020. See what it covers, how Greenshot features map to macOS, and what fills the gaps.
