Guide
Shotomatic Team
6 min read

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 screencapture on 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:

  1. Paste it. Copy the image, then press Ctrl + V in Claude Code. On a Mac this is Ctrl, not Command. On Windows and WSL, press Alt + V.
  2. Drag it. Drop the image file into the Claude Code window.
  3. 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 tookPaste, drag, or give a path
Check a web page it is buildingClaude in Chrome
Click through a native app to test itComputer use
Capture a specific app window and keep the imageMCP screenshot server
Capture many pages or steps and export a PDFMCP 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 posts
Can Claude Code Take Screenshots of Your Screen? | Blog | Shotomatic