Skip to main content
TILNOTEAI 노트

Claude Code에서 Windows 스크린샷을 WSL로 붙여넣기: 완벽 가이드

T
tilnote
•Views 1,321

개요

Claude Code를 WSL2 환경에서 사용할 때, Windows에서 캡처한 스크린샷을 쉽게 공유하는 방법을 알아봅니다. 이 가이드는 Windows 스크린샷을 WSL2 환경의 Claude Code에서 바로 사용할 수 있도록 하는 자동화 워크플로우를 설명합니다.

문제 상황

  • Windows에서 스크린샷 캡처 (Win+Shift+S)

  • WSL2에서 Claude Code 실행 중

  • 스크린샷을 Claude Code에 전달하려면 복잡한 과정 필요

    • 파일 저장 → 경로 찾기 → WSL 경로로 변환 → 복사/붙여넣기

해결 방법: windows-to-wsl2-screenshots

1. 설치

# WSL2 터미널에서 실행
gh repo clone jddev273/windows-to-wsl2-screenshots
cd windows-to-wsl2-screenshots
source screenshot-functions.sh

2. 자동화 시작

# 스크린샷 모니터링 시작
start-screenshot-monitor

3. 워크플로우

  1. Windows에서 스크린샷 캡처

    • Win+Shift+S: 영역 선택 캡처

    • Win+PrintScreen: 전체 화면 캡처

    • Snipping Tool 사용

  2. 자동 처리

    • 스크린샷이 자동으로 저장됨

    • WSL2 경로가 클립보드에 복사됨

  3. Claude Code에서 사용

    # Claude Code 프롬프트에서
claude "이 스크린샷을 분석해줘: [Ctrl+V]"

4. 실제 사용 예시

코드 디버깅

# 에러 스크린샷 캡처 후
claude "이 에러를 해결하는 방법을 알려줘: /mnt/c/Users/username/Pictures/Screenshots/screenshot_20250107_143022.png"

UI 분석

# UI 스크린샷 캡처 후
claude "이 UI를 React 컴포넌트로 만들어줘: /mnt/c/Users/username/Pictures/Screenshots/ui_design.png"

문서 작업

# 문서 스크린샷 캡처 후
claude "이 다이어그램을 Mermaid 코드로 변환해줘: /mnt/c/Users/username/Pictures/Screenshots/diagram.png"

5. 고급 팁

커스텀 단축키 설정

# ~/.bashrc 또는 ~/.zshrc에 추가
alias screenshot='echo "Screenshot path: $(xclip -o)"'
alias claude-screenshot='claude "분석해줘: $(xclip -o)"'

자동 시작 설정

# WSL 시작 시 자동으로 모니터링 시작
# 프로젝트 경로 확인 (보통 홈 디렉토리 하위에 있을 것)
ls ~/windows-to-wsl2-screenshots/
# ~/.bashrc에 올바른 설정 추가
echo "" >> ~/.bashrc
echo "# Windows Screenshot Monitor Auto-start" >> ~/.bashrc
echo "if [ -f ~/windows-to-wsl2-screenshots/screenshot-functions.sh ]; then" >> ~/.bashrc
echo "    (" >> ~/.bashrc
echo "        cd ~/windows-to-wsl2-screenshots" >> ~/.bashrc
echo "        source ./screenshot-functions.sh" >> ~/.bashrc
echo "        start-screenshot-monitor" >> ~/.bashrc
echo "    )" >> ~/.bashrc
echo "fi" >> ~/.bashrc

subshell 방법으로 하면 괄호 () 안에서 실행되므로 현재 셸의 작업 디렉토리가 변경되지 않고, 자동으로 원래 디렉토리로 돌아갑니다.

6. 문제 해결

Git 설치 오류

sudo apt update
sudo apt install git-all

클립보드 연동 문제

# WSL2 클립보드 도구 설치
sudo apt install xclip

경로 접근 권한

# Windows 폴더 접근 권한 확인
ls -la /mnt/c/Users/$USER/Pictures/Screenshots/

장점

  1. 즉각적인 피드백: 스크린샷 → Claude Code 분석까지 몇 초

  2. 컨텍스트 유지: 터미널을 떠나지 않고 작업 가능

  3. 자동화: 수동 파일 관리 불필요

  4. 통합 워크플로우: Windows와 WSL2 완벽 연동

활용 시나리오

  • 🐛 버그 리포트: 에러 화면 캡처 → 즉시 해결책 요청

  • 🎨 UI 개발: 디자인 스크린샷 → 코드 생성

  • 📊 데이터 분석: 차트/그래프 캡처 → 인사이트 도출

  • 📝 문서화: 애플리케이션 화면 캡처 → 문서 자동 생성

결론

Windows와 WSL2 사이의 경계를 허물어 Claude Code 사용 경험을 획기적으로 개선할 수 있습니다. 특히 시각적 정보를 다루는 개발 작업에서 생산성을 크게 향상시킬 수 있습니다.