Pick your year
Home by Dark
×

Your first build: a screenshot shortcut

⏱ 15 min7 steps

You already take screenshots. This piece is about getting one in front of Claude with no mess left behind.

It's a ladder: three ways to do the same thing. Start on the first rung, and climb when it starts to bug you. That's how this whole course works. Start with what's already there, and build when you outgrow it.

Plan on about 15 minutes. Getting stuck is normal, especially at the pop-ups.

permission Your Mac asking "is this OK?" before an app can do something private, like see your screen or press keys for you. All words

Before this, you'll want:

×

Steps

Step 1 of 70 done · about 15 min left

Steps for
  1. Step 1 of 7, not done yet
  2. Step 2 of 7, not done yet
  3. Step 3 of 7, not done yet
  4. Step 4 of 7, not done yet
  5. Step 5 of 7, not done yet
  6. Step 6 of 7, not done yet
  7. Step 7 of 7, not done yet

  1. Rung 1: paste a screenshot into the Claude app or claude.ai

    Nothing to build. Your MacYour PC already has a for this.

    1. Hold down Cmd, Ctrl and Shiftthe Windows key and Shift together, then press 4S. Your pointer turns into a small crosshair. The screen dims, with a small bar at the top.
    2. Drag a box around what you want Claude to see, then let go.
    3. Click in the chat box in the or at claude.ai, and press Cmd+VCtrl+V. That's : putting whatever you last copied right where you're typing.

    The picture went to your , the invisible spot where copied things wait. It never touched your Desktop, so there's nothing to clean up. On Windows, Snipping Tool also keeps a copy in Screenshots, inside Pictures. You can leave it there.

    keyboard shortcut A few keys you press together to make something happen, like Cmd+V to paste. All wordsClaude app Claude on your phone or computer, where you chat with it by typing. claude.ai is the same thing in a web browser. All wordspasting Putting whatever you last copied right where you're typing. On a Mac, that's Cmd+V. All wordsclipboard The invisible spot on your computer where copied things wait until you paste them. All words

    You should see:

    Your screenshot shows up in the chat box, ready to send with a question.

    That's not what I see
    A screenshot landed on my Desktop when I didn't want it there.
    The Ctrl key got missed, so your Mac saved a instead of putting it on the clipboard. Nothing broke. Drag the file to the Trash, then try again holding Cmd, Ctrl and Shift before you press 4.file One document on your computer, like a letter or a photo. Files live inside folders. All words
    My pointer didn't turn into a crosshair.
    Hold down all three keys first (Cmd, Ctrl and Shift) and keep holding them. Then tap 4 and let go of everything.

  2. Start Claude Code in your hello folder

    Rung 2 happens inside , so start it in the hello you made when you installed it.

    1. Open (Cmd+SpaceWindows key, type Terminal, press Enter).

    2. Go to your hello folder. Type this and press Enter:

      cd ~/Backyard/hello

      cd ~\Backyard\hello

    3. Start Claude Code. Type this and press Enter:

      claude
    Claude Code Claude, working inside Terminal. It can make files and run things on your Mac, with a safety checker watching what it does. All wordsfolder A place on your computer that holds files and other folders, like a drawer in a filing cabinet. All wordsTerminal An app on your Mac where you type instructions instead of clicking on things. Claude Code works inside it. All words

    You should see:

    Claude Code's name and version at the top, and a line starting with ❯ where you type.

    That's not what I see
    It says "zsh: command not found: claudeThe term 'claude' is not recognized".
    Claude Code isn't installed yet, or this Terminal window doesn't know about it. Close the window with Cmd+WCtrl+Shift+W, open a new one and try again. If it still says that, go back to Claude Code and .install Put a new program on your computer so you can use it. All wordssign in Tell Claude Code which Claude account is yours, so it knows you've paid for it. All words
    It says "cd: no such file or directoryCannot find path … because it does not exist".
    The hello folder isn't there yet. Type ~/Backyard/hello and press Enter, then try the line again.mkdir The command that makes a new folder. Type mkdir, a space and the new folder's name. It's short for make directory. All wordscd The command that moves Terminal into a folder. Type cd, a space and the folder's name. It's short for change directory, an old word for folder. All words

  3. Rung 2: paste a screenshot into Claude Code

    Same shortcut, one change.

    1. Take the screenshot the same way.
    2. Click in the Terminal window where Claude Code is running.
    3. Press Ctrl+VAlt+V, not Cmd+VCtrl+V.
    4. Type your question after it and press Enter.

    Everyone tries Cmd+V first. When I tested this on October 16, 2026, Cmd+V did nothing and Ctrl+V pasted the picture.Everyone tries Ctrl+V first. On Windows, Alt+V pastes the picture.

    You should see:

    [Image #1] shows up where you type.

    That's not what I see
    I pressed Cmd+VCtrl+V in Terminal and nothing happened.
    That's the one everybody hits, me included. In Terminal, paste a picture with Ctrl+VAlt+V. Ctrl is the key that says control, next to fn in the bottom-left corner. Cmd is the one with the ⌘ on it, right next to the space bar.Alt is the key right next to the space bar.
    [Image #1] never showed up in Terminal.
    Take the screenshot with Cmd+Shift+4 instead (no Ctrl). That saves a picture on your Desktop.Hold the Windows key and press E, then open Pictures, then Screenshots. Windows saved a copy of your snip there. Drag it from the Desktopfrom there into the Terminal window and let go. Delete it from the Desktop afterward. That's exactly the chore rung 3 gets rid of.You can delete it afterward.

  4. Paste the starter prompt into Claude Code

    From here on, the build uses tools only Macs have, so on Windows this lesson ends after rung 2.

    This is based on a tool I built for myself, part of a small set of shortcuts I call VibeTools. You won't copy my version. You'll build your own with Claude Code, one step at a time. That's the real lesson: you say what you want in plain words, and Claude does the building with you.

    The below asks Claude to build rung 3 with you. You press Shift+Cmd+8 and drag a box. That's your whole job. Your Mac does the rest:

    • It saves the screenshot to a , out of the way, never on your Desktop.
    • It pastes the file's location (its address on your Mac) into Terminal and presses Enter, so Claude sees it right away.
    • It deletes the screenshot once Claude has read it, or after 10 minutes.
    1. Click the Copy button below.
    I'm on a Mac and I use Claude Code in Terminal. Build me a keyboard shortcut: when I press Shift+Cmd+8, I drag a box around part of my screen. Save that screenshot to a temporary folder, not my Desktop. Paste its location into my Terminal window and press Enter so Claude can see it. Delete the screenshot once Claude has read it, or after 10 minutes. Walk me through it one step at a time, including any Mac settings or permissions I need to turn on, and wait for me to say "done" before the next step.
    1. Click in the Terminal window where Claude Code is running.
    2. Press Cmd+V to paste it. For words, Cmd+V works fine in Terminal. Ctrl+V is only for pictures.
    3. Press Enter.
    prompt What you type to Claude. A good one says what you want, how to work and what never to do. All wordstemporary folder A folder for files you only need for a few minutes. It's out of the way, so nothing piles up on your Desktop. All words

    You should see:

    Claude replies with the first step and waits for you to say done.

    That's not what I see
    Terminal says "command not found".
    The prompt went to Terminal itself, not to Claude Code. Type claude and press Enter to start Claude Code. When it's ready for you, paste the prompt again and press Enter.
    I pasted it and nothing happened.
    The prompt is sitting there waiting for you. Press Enter to send it.
    Claude did a bunch of steps at once instead of waiting for me.
    Type this and press Enter: Please slow down. Give me one step at a time and wait for me to say done. It will.

  5. Let Claude make the script and the Quick Action

    What Claude builds has two parts. A is a list of instructions your Mac follows in order: take the picture, paste its location, press Enter, clean up. A is a small helper your Mac can run from any app. The keyboard shortcut starts the Quick Action, and the Quick Action runs the script.

    Claude Code works on its own in : it makes files and runs commands without stopping to ask, and a safety checker blocks anything risky.

    1. Do each step Claude gives you, then type done and press Enter.
    2. Watch what Claude does as it goes. If it stops to ask you something, read it, and if you're not sure, ask it what that does first.

    Claude might make the Quick Action for you, or it might walk you through , an app that comes with your Mac. If it uses Automator, it will look something like this:

    1. Press Cmd+Space, type Automator and press Enter.
    2. Click New Document, choose Quick Action, then click Choose.
    3. At the top, set "Workflow receives" to no input in any application.
    4. Find Run Shell Script in the list on the left and drag it into the big space on the right.
    5. Paste in what Claude gives you, then save with Cmd+S and give it a name you'll recognize.

    If Claude suggests a different way, that's fine. Follow what it says, and ask it to explain anything that doesn't make sense.

    script A list of instructions your Mac follows in order, written down so it can do them again whenever you ask. All wordsQuick Action A small helper you add to your Mac. It can run from any app, and you can give it a keyboard shortcut. All wordsauto mode Claude works without asking, and a separate safety checker blocks anything risky. All wordsAutomator An app that comes with your Mac for making Quick Actions and other small helpers. All words

    You should see:

    Claude tells you the script and the Quick Action are ready, or walks you through Automator one step at a time.

    That's not what I see
    Claude Code is asking me to approve something and I'm not sure what it is.
    Choose No for now and ask it: What does that do, in plain words? Once the answer makes sense, ask it to try again and choose Yes. Asking is never a waste of time.
    Claude told me to open Automator and I can't find it.
    Press Cmd+Space, type Automator and press Enter. If nothing comes up, tell Claude. It can make the Quick Action another way.
    In Automator, I can't find Run Shell Script.
    Click in the search box at the top of the list of actions on the left and type shell. Run Shell Script shows up. Drag it into the big empty space on the right.
    I got an error message and I don't know what it means.
    Use rung 2 from this page. Press Cmd+Ctrl+Shift+4, drag a box around the error, click in Terminal and press Ctrl+V. Then ask Claude: What went wrong, and what do I do now?

  6. Give it a key in System Settings

    Now you'll tell your Mac that Shift+Cmd+8 starts your Quick Action.

    1. Click the Apple menu (the apple in the top-left corner of your screen), then click System Settings.
    2. Click Keyboard in the list on the left.
    3. Click the Keyboard Shortcuts… button.
    4. Click Services on the left, then open General by clicking the small arrow next to it.
    5. Find your Quick Action by its name. Make sure the box next to it is checked.
    6. Double-click at the right end of its line (it may say "none"). Then press Shift+Cmd+8 together.
    7. Click Done.

    You should see:

    Your Quick Action in the list, checked, with ⇧⌘8 at the right end of its line.

    That's not what I see
    I can't find a Keyboard Shortcuts button.
    On an older Mac (macOS Monterey or earlier), the app is called System Preferences. Open it from the Apple menu, click Keyboard, then click the Shortcuts tab at the top. Services is in the list on the left.
    My Quick Action isn't in the list.
    Quit System Settings (press Cmd+Q) and open it again, since the list may not show something new until then. Still missing? Look under the other headings in Services, not only General. If it isn't anywhere, ask Claude: Can you check that the Quick Action is saved in my Services folder?
    My Mac didn't keep Shift+Cmd+8, or something else already uses it.
    Pick a combination nothing else uses, such as Ctrl+Option+Cmd+8. Then tell Claude which keys you picked, so you're both talking about the same thing.

  7. Press Shift+Cmd+8 and say yes to the pop-ups

    1. Click once on the Terminal window where Claude Code is running.
    2. Press Shift+Cmd+8 and drag a box around something on your screen.

    The first time, your Mac asks for permission before the tool can work. A permission is your Mac checking "is this OK?" before an app sees your screen or presses keys for you. Expect up to three pop-ups:

    • Accessibility, so the tool can paste and press Enter for you.
    • Screen Recording (on newer Macs, Screen & System Audio Recording), so it can take the picture.
    • One asking to control System Events. That's the part of your Mac that presses keys for the tool. Click OK.

    When a pop-up offers Open System Settings, click it and turn on the switch next to the app it names. If your Mac asks you to quit and reopen that app, do it. Then press Shift+Cmd+8 again. It's normal to need two or three tries the first time while the permissions get sorted out.

    When it works, you didn't paste anything, and you didn't press Enter. The tool did both. It pastes with Cmd+V, not Ctrl+V, because what it puts on your clipboard is the location as plain words, not the picture.

    Take a look at your Desktop. Nothing new on it. That's the whole point.

    You should see:

    A line of text shows up in Terminal by itself (that's the file's location), and Claude starts telling you about your screenshot.

    That's not what I see
    I pressed Shift+Cmd+8 and nothing happened.
    There are three usual reasons. One, a permission isn't on yet: see "I closed the permission pop-up" below. Two, the app you were in already uses those keys for something of its own, and the app wins. Click on your Desktop and try again; if it works there, go back to Step 6 and pick a different combination. Three, the box next to your Quick Action in the Services list isn't checked. Check it.
    The location pasted into the wrong window.
    The tool pastes into whichever Terminal window is in front. Before you press the keys, click once on the Terminal window where Claude Code is running. If you have more than one Terminal window open, close the ones you aren't using. If you use a different app than Terminal, tell Claude; the tool needs to know which app to paste into.
    I closed the permission pop-up by mistake.
    You survived a 35-minute ride in a station wagon with the windows up while the grown-ups smoked. A closed pop-up won't stop you. Your Mac usually won't ask again, so go and turn it on yourself. Click the Apple menu (the apple, top left of your screen), then System Settings, then Privacy & Security on the left. Click Accessibility and turn on the switch next to the app the pop-up named. Go back, click Screen Recording (on newer Macs it's called Screen & System Audio Recording) and do the same. If the app isn't in the list, click the + button under it and pick the app. If a pop-up asked about controlling System Events, click Automation and turn on System Events for that app. Then try Shift+Cmd+8 again.
    The screenshot only shows my wallpaper, not my windows.
    The Screen Recording permission is off. Turn it on the way the snag above shows, then quit the app it named (Cmd+Q) and open it again.
    The pop-up named an app I wasn't expecting.
    The pop-up names the app your Mac thinks is asking. That can be the app you were in when you pressed the keys. Allow it. If the shortcut works in one app and not another, the other app may need the same permission.
    Something I'd copied earlier is gone.
    To paste the file's location, the tool puts it on your clipboard, which replaces whatever was there. Copy the other thing again when you need it.
    Claude says it can't find the file.
    The screenshot deletes itself after 10 minutes, or once Claude has read it. Press Shift+Cmd+8 and take a new one.
×

Your challenge

For one week, use Shift+Cmd+8 every time you want to show Claude Code something on your screen. At the end of the week, look at your Desktop. Count the screenshots you didn't have to clean up.

Helpful extras

Last checked 2026-10-16

Start