맥에서 Claude Code에 스크린샷 붙여 넣는 법
스크린샷을 복사하고 Claude Code에서 ⌘V를 눌렀는데 아무 일도 없다면, 정상입니다. 맥의 대부분 터미널에서 Claude Code는 다른 키로 이미지를 붙여 넣습니다. 원리와, 조금 전 스크린샷까지 넣는 방법을 알려 드립니다.
결론부터
맥의 Claude Code에서는 이미지를 Ctrl V로 붙여 넣습니다. ⌘ V가 아닙니다. 커서 위치에 [Image #1]이 들어가고, 프롬프트에서 그것을 가리킬 수 있습니다.
예외는 iTerm2로, ⌘ V로도 이미지가 들어갑니다. Windows와 WSL에서는 Alt V입니다. 출처는 Claude Code의 인터랙티브 모드 문서입니다(2026년 11월 12일 확인).
차이가 나는 이유: ⌘ V는 터미널 앱이 처리해 텍스트를 붙여 넣고, Ctrl V는 Claude Code에 그대로 전달되어 클립보드에서 이미지를 읽습니다.
단계별로
- 스크린샷을 클립보드에 복사합니다. Control ⇧ ⌘ 4를 누르고 영역을 드래그하세요. Control을 누르고 있으면 파일로 저장하지 않고 복사합니다.
- Claude Code가 실행 중인 터미널로 전환하고 프롬프트를 클릭합니다.
- Ctrl V를 누릅니다.
[Image #1]이 나타나면 “좁은 화면에서 이 레이아웃이 왜 깨질까?“처럼 질문을 쓰고 Return을 누릅니다.
이미지가 더 있으면 반복하세요. 번호가 차례로 늘어납니다.
’No image found in clipboard’라고 나오면
- 클립보드에 뭐가 있는지 확인하세요. Finder에서 스크린샷 ’파일’을 복사했다면 클립보드에는 이미지 대신 파일 참조가 들어 있을 수 있습니다. 이미지 자체를 복사하거나 다음 방법을 쓰세요.
- 파일을 드래그하세요. 이미지 파일을 터미널로 끌어다 놓으면 경로가 들어가고, Claude Code는 경로로 이미지를 읽을 수 있습니다.
- 경로를 적으세요.
~/Desktop/error.png 봐 줘처럼 프롬프트에 경로를 써도 됩니다.
조금 전 스크린샷이나 여러 장 보내기
클립보드에는 가장 최근 스크린샷만 들어 있습니다. 한 시간 전 것이 필요하거나 세 장을 보내고 싶다면, 남겨 둔 곳이 있어야 합니다.
Flicopy는 Mac의 작업 기억입니다. 찍은 스크린샷과 복사한 모든 것이 출처 앱과 페이지와 함께 최신순으로 빠른 패널에 남습니다.
이미지 한 장
- ⌥ ⌥(Option 키 두 번)로 빠른 패널을 엽니다.
- 스크린샷을 고르고 ⌘ C로 복사합니다.
- Claude Code에서 Ctrl V를 누릅니다.
빠른 패널에서 Return을 누르면 ⌘ V로 붙여 넣는데, 대부분의 터미널에서 Claude Code는 이를 텍스트로 받습니다. 이미지는 먼저 복사하고 Ctrl V로 붙여 넣으세요.
이미지 여러 장
빠른 패널의 카드를 터미널 윈도우로 끌어다 놓으세요. 각각 파일 경로로 들어가고, Claude Code가 이미지로 읽습니다. 드래그하기 전에 여러 카드를 고르려면 ⌘-클릭하세요.
글, 로그, 링크
글은 어떤 방식으로 붙여 넣어도 됩니다. 빠른 패널에서 오류 메시지, 로그, 링크를 고르고 Return을 누르면 한 줄씩 함께 들어가고, 긴 내용은 Claude Code가 [Pasted text #1]로 접습니다. 더 알아보려면 맥에서 AI에 맥락 넘기는 법을 참고하세요.
자주 묻는 질문
Claude Code에서 ⌘V로 이미지가 안 붙는 이유는?
대부분의 터미널에서 ⌘ V는 터미널 앱이 처리하고, 터미널 앱은 텍스트만 붙여 넣습니다. Claude Code는 Ctrl V를 누를 때 클립보드에서 이미지를 읽습니다. iTerm2는 예외로 ⌘ V도 됩니다.
맥에서 스크린샷을 바로 클립보드로 찍으려면?
영역은 Control ⇧ ⌘ 4, 전체 화면은 Control ⇧ ⌘ 3입니다. 다른 방법은 맥 스크린샷 저장 위치를 참고하세요.
Claude 데스크탑 앱에서도 똑같나요?
데스크탑 앱과 웹 버전은 다른 맥 앱처럼 ⌘ V로 이미지를 받습니다. Flicopy에서 Return으로 여러 항목을 한꺼번에 붙여 넣을 수도 있습니다.