캡처는 화면을 이미지로 저장하는 일입니다. 캡처한 컴퓨터와 Claude Code가 실행되는 컴퓨터가 같은지에 따라 전달 방법이 달라집니다.
1. 운영체제별 캡처 방법
| 중요도 | 환경 | 캡처하기 | 파일과 클립보드 |
|---|---|---|---|
| 핵심 | macOS | Command+Shift+4로 영역 선택. Command+Shift+5로 캡처 도구를 엽니다. | 보통 설정한 위치에 파일이 저장됩니다. 영역 캡처에 Control을 더하면 클립보드로 복사합니다. |
| 핵심 | Windows 10·11 | Windows+Shift+S로 캡처 도구를 열고 영역을 선택합니다. | 이미지가 클립보드에 들어갑니다. 알림을 눌러 캡처 도구에서 저장할 수 있습니다. 자동 파일 저장은 앱 버전·설정을 확인합니다. |
| 참고 | Linux · GNOME | Print Screen으로 캡처 화면을 열고 영역·창·화면을 선택합니다. | 현재 GNOME 안내 기준으로 Pictures/Screenshots에 저장되며 클립보드로도 복사됩니다. |
| 참고 | 그 밖의 Linux 데스크톱 | 앱 메뉴에서 스크린샷 도구를 엽니다. KDE에서는 Spectacle 등을 사용합니다. | 앱의 저장·클립보드 복사 버튼을 확인합니다. 단축키는 데스크톱과 사용자 설정에 따라 다릅니다. |
클립보드는 복사한 내용을 임시로 담는 공간입니다. 이미지 파일을 저장한 것과 같지 않습니다. SSH 전송에 쓸 때는 error-01.png처럼 실제 파일로 저장합니다.
공식 안내: Mac 캡처 · Windows 캡처 도구 · GNOME 캡처.
2. 로컬: 같은 컴퓨터에서 Claude Code를 실행한 경우
- 오류나 설명할 부분을 캡처합니다. 전달할 화면에 불필요한 개인 내용이 없는지 확인합니다.
- Claude Code 요청 입력줄로 이동합니다.
- 클립보드 이미지를 붙여 넣거나, 저장한 이미지 파일을 끌어 놓거나, 이미지의 경로를 요청에 적습니다.
- 이미지 첨부 표시가 나타났는지 확인하고 무엇을 봐야 하는지 설명합니다.
| 중요도 | Claude Code 환경 | 공식 문서의 이미지 붙여넣기 키 |
|---|---|---|
| 핵심 | macOS·Linux의 지원 터미널 | Ctrl+V. 현재 문서는 iTerm2의 Command+V도 별도로 안내합니다. |
| 핵심 | Windows·WSL | Alt+V. WSL에서는 Ctrl+V도 연결되지만 터미널이 먼저 처리하면 Alt+V를 사용합니다. |
텍스트 붙여넣기 단축키와 항상 같지는 않습니다. 터미널·Claude Code 버전·클립보드 지원에 따라 실패할 수 있으므로, 첨부 표시 없이 키만 눌렀다면 전달 완료로 보지 않습니다. 파일로 저장한 뒤 경로를 알려 주는 방법을 사용할 수 있습니다.
/Users/student/workspace/lecture/error-01.png를 읽어 줘.
오른쪽 아래의 저장 버튼이 잘리는 원인을 찾아 줘.
내가 기대한 모습은 버튼 전체가 화면 안에 보이는 거야.단축키와 [Image #N] 첨부 표시는 Claude Code 공식 입력 안내 기준입니다. 확인일: 2026-11-08.
3. SSH: 다른 컴퓨터에서 Claude Code를 실행한 경우
노트북에서 캡처했는데 Claude Code는 서버에서 실행 중이라면, 일반 SSH 연결만으로 노트북의 이미지가 서버에 생기지 않습니다. 파일 저장 → 원격으로 전송 → 원격에서 확인 → 그 경로로 요청 순서로 진행합니다.
방법 A. 이미 사용하는 파일 전송·동기화 기능
SFTP 앱이나 이미 설정한 공유·동기화 폴더에 캡처를 넣고, 전송 완료 뒤 서버에서 보이는 경로를 확인합니다. 앱에 전송 기록이 있어도 원격에 해당 파일이 실제 있는지 한 번 더 확인합니다.
방법 B. SCP로 이미지 한 장 보내기
아래는 Linux 서버 예시입니다. student, your-server, 로컬 파일 경로와 원격 폴더를 실제 값으로 바꿉니다. your-server는 접속할 수 있는 실제 서버 이름이나 주소를 넣는 자리입니다.
① 원격 서버의 일반 셸에서 받을 폴더를 준비하고 경로를 확인합니다.
mkdir -p ~/capture-inbox
cd ~/capture-inbox
pwd② 내 컴퓨터의 새 터미널 탭에서 전송합니다. SSH 안에서 실행하는 단계가 아닙니다. 예시는 ①의 결과가 /home/student/capture-inbox인 경우입니다.
macOS·Linux 로컬 셸 예:
scp "$HOME/Downloads/error-01.png" student@your-server:/home/student/capture-inbox/error-01.pngWindows PowerShell에서 OpenSSH의 scp가 설치돼 있는 경우:
scp "C:\Users\student\Downloads\error-01.png" student@your-server:/home/student/capture-inbox/error-01.png받는 곳에 같은 이름이 있으면 덮어쓸 수 있으므로 매번 구별되는 이름을 사용합니다. macOS 서버라면 원격 경로가 /Users/계정명/…일 수 있습니다. ①의 실제 출력에 맞춥니다.
③ 원격 서버의 셸에서 확인합니다.
ls -l /home/student/capture-inbox/error-01.png④ 원격 서버의 Claude Code 요청줄에 전달합니다.
/home/student/capture-inbox/error-01.png를 읽고
오류 메시지를 설명해 줘. 해결 방법을 적용한 뒤 확인할 항목도 알려 줘.파일 전송 문법: OpenSSH scp 공식 매뉴얼. 이 페이지의 명령은 설명용이며 자동으로 전송을 실행하지 않습니다.
4. 전달됐는지 확인하는 기준
- 직접 붙여넣기: 이미지 첨부 표시가 나타났는지 봅니다.
- 파일 경로 전달: AI가 파일을 읽고 실제 화면의 구체적인 내용을 설명하는지 확인합니다.
- SSH: 원격 파일의 존재와 크기를 확인합니다. 노트북 경로만 입력된 상태로 끝내지 않습니다.
일부 원격 도구는 이미지 업로드나 클립보드 전달을 추가로 지원합니다. 그런 기능이 확인된 환경에서는 직접 붙여넣기가 가능할 수 있으므로 “SSH에서는 무조건 불가능”이라고 외우지는 않습니다. 기본 방법은 파일 전송 후 원격 경로 전달입니다.
문자 오류는 텍스트 전체를 복사해 보내고, 캡처는 창의 배치나 선택할 수 없는 문구를 보충할 때 함께 쓰면 좋습니다.