클로드 코드 이미지 첨부 — 붙여넣기·드래그·경로와 안 될 때
클로드 코드(Claude Code)에 이미지를 첨부하는 방법은 세 가지입니다. ① 터미널 창에 이미지를 드래그해서 놓기, ② 이미지를 복사한 뒤 Ctrl+V로 붙여넣기(맥 iTerm2는 Cmd+V, 윈도우·WSL은 Alt+V), ③ 이미지 경로를 직접 알려주기(예: "이 이미지 분석해줘: /path/to/img.png"). 붙여넣기가 안 되면 대부분 터미널이 Ctrl+V를 가로챈 경우라, Alt+V나 경로 방법으로 하면 됩니다. 아래는 Claude Code 2.1.202 기준입니다.
이미지 첨부하는 세 가지 방법
| 방법 | 어떻게 |
|---|---|
| 드래그 앤 드롭 | 이미지 파일을 클로드 코드 터미널 창 위로 끌어다 놓는다 |
| 복사 후 붙여넣기 | 이미지를 복사하고 Ctrl+V. 커서 자리에 [Image #N] 칩이 삽입된다 |
| 경로 알려주기 | 프롬프트에 파일 경로를 적는다 (아래 예시) |
경로로 넣을 때는 이렇게 씁니다. 파일을 터미널로 드래그하면 경로가 자동으로 입력되기도 합니다.
이 이미지 분석해줘: /path/to/your/image.png붙여넣기가 안 될 때 (Ctrl+V 안 먹힘)
터미널마다 Ctrl+V 처리 방식이 달라서 안 되는 경우가 있습니다. 환경별로 이렇게 하세요.
| 환경 | 붙여넣기 키 |
|---|---|
| 맥 · iTerm2 | Cmd+V도 동작 (그 외 터미널은 Ctrl+V) |
| 윈도우 · WSL | 터미널이 Ctrl+V를 가로채면 Alt+V |
| 어느 환경이든 안 될 때 | 경로 알려주기 또는 드래그 앤 드롭 (항상 동작) |
정리하면, 맥은 Ctrl+V(또는 iTerm2에서 Cmd+V), 윈도우·WSL은 Ctrl+V가 안 먹으면 Alt+V입니다. 그래도 안 되면 붙여넣기에 매달리지 말고 파일을 드래그하거나 경로를 적으세요 — 이 두 방법은 터미널 설정과 무관하게 됩니다. 붙여넣기 외의 다른 키 조작은 클로드 코드 단축키 글에 정리해 두었습니다.
첨부한 이미지로 무엇을 시키나
이미지를 넣고 나면 이렇게 요청할 수 있습니다. 에러 스크린샷·UI 목업·다이어그램에 특히 유용합니다.
이 스크린샷의 에러, 원인이 뭐야?
이 디자인 목업에 맞는 CSS 만들어줘
이 화면의 UI 요소들을 설명해줘
이 컴포넌트를 재현하는 HTML 구조는?한 대화에 이미지를 여러 장 넣을 수도 있습니다. 텍스트로 설명하기 번거로운 화면·구조·오류 상태를 그대로 보여줄 때가 가장 효과적입니다.
[Image #N] 링크로 원본 열기
클로드가 답변에서 [Image #1]처럼 이미지를 가리킬 때가 있습니다. 이 링크를 Cmd+Click(맥) 또는 Ctrl+Click(윈도우·리눅스)하면 기본 뷰어로 그 이미지가 열립니다.
자주 묻는 질문 (FAQ)
Q. Ctrl+V를 눌러도 이미지가 안 들어가요.
터미널이 Ctrl+V를 가로챈 경우입니다. 윈도우·WSL이면 Alt+V, 맥 iTerm2면 Cmd+V를 써보고, 그래도 안 되면 파일을 드래그하거나 "분석해줘: /경로"로 경로를 넘기세요.
Q. 경로를 알려줬는데 못 읽어요.
경로가 실제 파일을 가리키는지, 상대경로라면 클로드 코드를 실행한 작업 디렉터리 기준인지 확인하세요. @로 파일을 참조하는 방법도 있습니다 — 이 표기는 클로드 코드 슬래시 명령어 글에서 다뤘습니다.
Q. PDF나 다른 파일도 붙일 수 있나요?
데스크톱 앱에서는 첨부 버튼이나 드래그로 이미지·PDF 등을 붙일 수 있습니다. 터미널(CLI)에서는 이미지가 위 세 방법으로 들어갑니다.
마무리
핵심은 세 가지입니다 — 드래그, Ctrl+V 붙여넣기(맥 iTerm2 Cmd+V·윈도우/WSL Alt+V), 경로 넘기기. 붙여넣기가 막히면 경로나 드래그로 우회하면 되니, 스크린샷으로 에러·디자인을 그대로 보여주며 작업해 보세요. 표기는 Claude Code 2.1.202 기준입니다.
📚 참고 출처 (2026년 7월 27일 확인 · Claude Code 2.1.202)
· Claude Code — Common workflows (Work with images)
· Claude Code — Interactive mode
COMMENTS