Free AI Opportunity Audit

How to Paste Images in Claude Code

Shyam Verma•
How to Paste Images in Claude Code

Ever tried pasting a screenshot into Claude Code while running in a devcontainer? It doesn't work. The containerized environment can't access your clipboard. I tried many clipboard tools and scripts on both host and guest machines, even SSH wrappers, but the clipboard never worked. The fix skips the clipboard entirely: paste the image's file path as text instead.

Quick Answer: Three Ways to Add an Image

The Claude Code docs list three ways to get an image into a session:

  1. Paste from the clipboard. Press Ctrl+V, even on a Mac. The docs list Cmd+V only for iTerm2. On Windows, press Alt+V. On WSL both Ctrl+V and Alt+V work, and Alt+V is the one to use if your terminal grabs Ctrl+V first (shortcut reference). The image shows up in your prompt as an [Image #1] chip.
  2. Drag and drop the image file into the Claude Code window.
  3. Type or paste the image's path, for example Analyze this image: /path/to/screenshot.png.

In my devcontainer, Ctrl+V only ever gave me "no image found in clipboard", so I use option 3. The rest of this post sets that up so it takes one click.

We build production AI systems for clients too, not just devcontainer workarounds. Three examples: a bilingual loan-intake chatbot that cut loan processing from days to minutes, a semantic internal-linking engine built on OpenAI embeddings and vector search, and a workflow-automation integration connecting an AI platform to 2,000+ apps. If you're weighing an AI build of your own, tell us what you're building.

Pasting a File Path Works

When you paste a full file path to an image in Claude Code, it automatically recognizes and attaches the image!

Step 1: Mount Your Screenshots Folder

In .devcontainer/devcontainer.json, add a mount for your screenshots folder:

{
  "mounts": [
    "source=${localEnv:HOME}/Screenshots,target=/clipboard,type=bind,readonly"
  ]
}

${localEnv:HOME} reads the HOME variable on the host machine, so the path isn't tied to one person's machine (devcontainer.json reference). That works on macOS and Linux. On Windows the user folder is ${localEnv:USERPROFILE}. Change Screenshots to whichever folder your screenshot tool saves into.

Step 2: Create a Quick List Task

In .vscode/tasks.json, add a task to list recent images:

{
  "tasks": [{
    "label": "List Images in /clipboard",
    "type": "shell",
    "command": "find /clipboard -type f \\( -iname \"*.jpg\" -o -iname \"*.png\" -o -iname \"*.gif\" -o -iname \"*.jpeg\" \\) -printf '%T@ %p\\n' | sort -nr | head -n 10 | cut -d' ' -f2-"
  }]
}

Step 3: One-Click with Task Runner

Install the Task Runner extension. It lists your project's tasks in the Explorer pane so each one runs with a click. Add it to devcontainer.json so it installs inside the container (where extensions go):

{
  "customizations": {
    "vscode": {
      "extensions": ["SanaAjani.taskrunnercode"]
    }
  }
}

Task Runner button in VS Code

The Workflow

1. Take and Save Screenshot

Capture screenshot and save to mounted folder

2. Click Task Runner

Click task in Task Runner

3. Copy the Latest Image Path

Copy latest image path from output

4. Paste Path - Claude Handles It!

Paste the path and Claude will handle it as image

Example in Action

# Task output shows:
/clipboard/error_2025-01-19.png
/clipboard/ui_mockup.png

# Just paste in Claude Code:
"Check this error: /clipboard/error_2025-01-19.png"
# → Image automatically appears as attachment!

Why This Works

  • Docker mount makes host files visible in container
  • Task lists paths sorted by newest first
  • Claude Code's built-in feature recognizes image paths and auto-attaches them
  • No manual file transfers or complex workarounds needed

Pro Tips

  1. Use a specific folder for screenshots, not your main Downloads
  2. Configure your screenshot tool to save there automatically
  3. The mount is read-only, so you can't accidentally modify anything from inside the container
  4. Periodically clear out old screenshots to keep the list manageable

Conclusion

The key was discovering that Claude Code automatically attaches images when you provide their full path. Combined with a Docker mount and a one-click task, you can copy a screenshot's path and paste it straight into Claude Code, no clipboard access required.

Shyam Verma

Shyam Verma

Full Stack Developer & Founder

Shyam Verma is a seasoned full stack developer and the founder of Ready Bytes Software Labs. With over 13 years of experience in software development, he specializes in building scalable web applications using modern technologies like React, Next.js, Node.js, and cloud platforms. His passion for technology extends beyond coding—he's committed to sharing knowledge through blog posts, mentoring junior developers, and contributing to open-source projects.

Comments