끌어다 놓기

1. 창이 열린 컴퓨터와 명령이 실행되는 컴퓨터는 다를 수 있습니다

내 컴퓨터(로컬)는 지금 앞에 앉아 쓰는 컴퓨터입니다. 원격 컴퓨터(SSH로 접속한 컴퓨터)는 네트워크로 접속한 다른 컴퓨터입니다. SSH에 접속하면 창은 내 컴퓨터에 있어도 그 안의 명령은 원격 컴퓨터에서 실행됩니다. 아래에서는 이를 로컬과 원격 컴퓨터로 줄여 씁니다.

같은 projects/lecture라는 경로 글자가 양쪽에 있더라도 같은 파일이라는 보장은 없습니다. 경로 앞에 컴퓨터 이름이 생략되어 있을 뿐, 각 컴퓨터의 파일 공간은 별개입니다.

Mac·Linux의 일반 셸에서 위치 확인: 내 Mac의 로컬 셸이나 이미 접속한 원격 컴퓨터의 셸에서 아래 명령을 한 줄씩 입력하면, 각각 그 명령이 실행된 컴퓨터의 이름·계정·현재 폴더를 보여 줍니다. AI 요청창에 입력하는 명령이 아닙니다. Windows의 로컬 PowerShell에서도 같은 세 명령을 사용할 수 있습니다.

hostname
whoami
pwd

컴퓨터 이름과 계정 이름은 서로 다를 수 있습니다. whoami 결과만으로 어느 컴퓨터인지 단정하지 말고, 접속 경로와 컴퓨터 이름도 함께 확인합니다.

2. 내 Mac 로컬 Terminal에 끌어 놓기

내 Mac Finder에 Documents/course-materials라는 연습 폴더가 있다고 가정합니다. Apple Terminal에서 Finder의 폴더를 명령 입력 영역으로 끌어 놓으면 해당 폴더의 절대 경로가 들어갑니다. 폴더를 이동하거나 복사하는 동작은 아닙니다. Apple: Terminal에 항목 끌어 놓기

1. SSH에 접속하지 않은 내 Mac의 로컬 Terminal 셸을 엽니다.
2. cd를 쓰고 공백을 하나 넣습니다.
3. Finder의 연습 폴더를 그 뒤로 끌어 놓습니다.
4. 완성된 경로가 원하는 폴더인지 확인한 뒤 Return을 누릅니다.
5. pwd를 입력하여 이동한 폴더를 확인합니다.

입력 위치: 내 Mac 로컬 Terminal 셸. 아래는 끌어 놓기 대신 직접 입력하는 예시입니다. $HOME은 이 셸을 실행 중인 내 Mac 사용자의 홈 폴더입니다.

cd "$HOME/Documents/course-materials"
pwd

cd는 폴더로 이동하라는 명령입니다. 파일이나 폴더 경로만 넣고 Return을 누르면 이동 명령이 되지 않습니다. 공백이 있는 경로는 따옴표나 역슬래시로 처리해야 합니다. 자동으로 붙은 처리를 무작정 지우지 않습니다.

3. 내 컴퓨터(로컬)에서 SSH로 원격 컴퓨터에 접속한 뒤 끌어 놓기

원격 컴퓨터에서 Claude Code를 실행하려면 먼저 원격 셸에서 원격 컴퓨터의 프로젝트 폴더로 이동합니다. 이때 필요한 경로는 /home/user/projects/lecture입니다.

입력 위치: 내 Mac의 로컬 Terminal 셸, SSH 접속 전. 아래 user는 원격 컴퓨터의 계정 이름으로, REMOTE_HOST는 원격 컴퓨터의 확인된 IP 주소·호스트 이름·SSH 별칭으로 바꿀 자리입니다. 계정 이름만으로 네트워크 주소를 알 수는 없습니다. 웹 미리보기 주소도 곧바로 SSH 주소라고 가정하지 않습니다.

ssh user@REMOTE_HOST

기존 연결에 별도 포트·키·중간 서버 옵션이 필요하면 평소 검증된 접속 방법을 그대로 사용합니다. 새 주소를 추측하거나 접속 경고를 무시하지 않습니다.

입력 위치: SSH 접속이 완료된 원격 컴퓨터의 일반 셸.

cd /home/user/projects/lecture
pwd

이 상태에서 내 Mac Finder의 Documents/course-materials/diagram.png를 창에 끌어 놓는 경우를 생각합니다. 일반적인 터미널의 경로 입력 동작이라면 내 Mac 쪽 파일 경로 문자열이 원격 입력줄로 전달됩니다. 원격 컴퓨터로 이미지 내용이 복사된 것은 아닙니다. 원격 컴퓨터에서는 그 경로가 없거나, 우연히 같은 경로에 다른 파일이 있을 수 있습니다.

내 Mac 파일을 원격 컴퓨터에서 사용하려면 파일 전송 또는 이미 연결된 공유 폴더가 필요합니다. SSH 로그인과 파일 복사는 다른 작업입니다. OpenSSH의 scp는 SSH 연결을 이용하여 실제 파일을 복사하는 별도 명령입니다. OpenSSH: scp 설명

4. 실제 파일을 보내려면: 내 Mac 로컬 셸에서 SCP

예시는 내 Mac의 가상 연습 이미지 Documents/course-materials/diagram.png 한 장을 원격 컴퓨터 프로젝트로 복사합니다. 원본은 내 Mac에 남습니다. 전송 대상 폴더가 이미 존재하고 쓰기 권한이 있어야 하며, 같은 이름의 대상 파일이 있으면 덮어쓸 수 있으므로 겹치지 않는 이름인지 먼저 확인합니다.

1. 원격 작업 창은 그대로 두고 내 Mac에서 새 로컬 Terminal 탭이나 창을 엽니다. 새 탭도 자동 SSH로 시작하는 설정이라면 로컬 셸인지 먼저 확인합니다.
2. 연습 파일이 내 Mac에 실제 있는지 확인합니다.
3. 아래 호스트 자리표시자를 확인된 원격 컴퓨터 주소로 바꾸고, 원하는 파일·대상 이름을 확인한 뒤 전송합니다.
4. 전송 명령이 오류 없이 끝났는지 확인합니다.
5. 기존 원격 컴퓨터 SSH 창으로 돌아가 대상 파일이 있는지 확인합니다.

입력 위치: 내 Mac의 새 로컬 Terminal 셸. 원격 SSH 셸이나 AI 요청창이 아닙니다. REMOTE_HOST를 그대로 실행하지 않습니다.

scp "$HOME/Documents/course-materials/diagram.png" user@REMOTE_HOST:/home/user/projects/lecture/course-diagram-example.png

앞부분은 내 Mac 원본, user@ 뒤는 대상 컴퓨터, 콜론 뒤는 원격 컴퓨터의 저장 경로입니다. 접속에 비표준 포트를 쓴다면 SCP의 포트 옵션은 대문자 -P이며, 실제 연결 설정에 맞춰야 합니다. OpenSSH: 로컬·원격 경로와 포트 옵션

입력 위치: 이미 접속해 둔 원격 컴퓨터의 일반 SSH 셸. 아래는 전송 뒤 해당 파일의 존재와 크기를 확인하는 명령입니다. 내용까지 같아야 하는 중요한 전송은 체크섬도 비교합니다.

ls -l /home/user/projects/lecture/course-diagram-example.png

입력 위치: 원격 컴퓨터에서 실행 중인 Claude Code의 요청창. 전송을 확인한 뒤 아래처럼 원격 경로와 요청을 함께 전달합니다. 이 문장은 셸 명령이 아닙니다.

/home/user/projects/lecture/course-diagram-example.png 파일의 도식 내용을 설명해 줘.

실패하면 계속 재전송하기 전에 원본 경로·접속 주소·권한·대상 폴더를 확인합니다. 파일 하나가 필요하다면 프로젝트 전체를 복사할 필요는 없습니다.

5. 공유 폴더의 로컬 경로와 원격 경로는 다릅니다

내 Mac에 원격 컴퓨터의 공유 폴더를 이미 연결해 두었고, 공유 대상이 실제 원격 컴퓨터의 /home/user/projects에 대응한다고 확인한 경우를 생각합니다. 내 Mac에서는 그 공유 폴더 안의 프로젝트가 /Volumes/공유폴더이름/lecture로 보일 수 있습니다. 이는 내 컴퓨터(로컬)에서 공유 폴더에 접근하는 경로입니다. 원격 컴퓨터의 경로를 그대로 뜻하지는 않습니다.

위 두 경로가 같은 자료를 가리키는 것은 실제 공유 대상과 연결 상태를 확인했을 때만입니다. 볼륨 이름은 달라질 수 있고 연결이 끊길 수도 있습니다. Finder의 연결된 서버와 실제 폴더를 확인하며, /Volumes/공유폴더이름이라는 이름이 존재한다는 사실만으로 연결 대상을 확정하지 않습니다. Apple: Mac의 공유 컴퓨터·서버 연결

내 Mac Finder에서 파일을 연결된 공유 폴더 안으로 복사하는 것은 파일 내용의 전송을 수반합니다. 반면 그 파일을 SSH 터미널 입력줄로 끌어 놓기는 경로 입력일 수 있습니다. 놓는 위치가 다릅니다. 원격 컴퓨터의 Claude Code에는 확인된 /home/user/projects/lecture/... 경로를 전달합니다.

이 설명은 새 공유 연결이나 설정 변경을 요구하지 않습니다. 기존 연결이 없다면 앞의 SCP 방식처럼 별도 전송 방법을 사용합니다. Windows에서는 공유 폴더가 네트워크 드라이브 Z:\lecture 또는 \\서버이름\공유폴더이름\lecture처럼 보일 수 있습니다. 실제 연결된 공유 대상을 확인하며, Mac의 /Volumes 경로를 그대로 적용하지 않습니다.

6. Windows에서는 로컬 PowerShell과 SSH 뒤 원격 셸을 나눕니다

Windows Terminal은 PowerShell·명령 프롬프트·WSL 등을 담는 터미널 앱입니다. 이 예시는 Windows의 로컬 PowerShell을 기준으로 하며 WSL 명령과 섞지 않습니다. 파일 탐색기에서 끌어 놓은 결과는 터미널·드롭 위치에 따라 다르므로, 아래 예시처럼 경로를 직접 입력해도 됩니다. 특히 새 탭 버튼 위 드롭은 새 탭을 여는 별도 동작입니다. Microsoft: Windows Terminal의 프로필·끌어 놓기

로컬 파일 경로는 C:\Users\사용자\Documents\course-materials\diagram.png처럼 Windows 형식입니다. 그러나 Linux 서버에 SSH 접속한 뒤에는 /home/user/projects/lecture 같은 원격 컴퓨터의 경로를 사용합니다. SSH가 Windows 파일 경로를 원격 컴퓨터의 파일로 자동 변환하거나 복사하지는 않습니다.

입력 위치: Windows PC의 로컬 PowerShell, SSH 접속 전. OpenSSH 클라이언트가 사용 가능한 환경에서, 호스트 자리표시자를 확인된 주소로 교체하여 사용합니다. Microsoft: Windows Terminal에서 SSH 사용

ssh user@REMOTE_HOST

입력 위치: SSH 접속 완료 뒤 원격 컴퓨터의 일반 셸. 화면을 열어 둔 PC가 Windows여도 이 예시의 원격 컴퓨터는 Linux 서버이므로 Linux 명령과 경로를 사용합니다.

cd /home/user/projects/lecture
pwd

입력 위치: 별도로 연 Windows 로컬 PowerShell. 원격 컴퓨터 SSH 셸이 아닙니다. 가상 연습 파일을 보내는 예시이며 $HOME은 Windows 사용자의 홈 폴더입니다. 실제 Documents 위치가 다르면 원본 경로를 바꿉니다. 대상 파일 이름의 중복도 먼저 확인합니다.

scp "$HOME\Documents\course-materials\diagram.png" user@REMOTE_HOST:/home/user/projects/lecture/course-diagram-example.png

전송 뒤에는 원격 컴퓨터 SSH 셸에서 앞 절의 ls -l 확인을 진행합니다. Windows에서 경로를 끌어 넣었다고 해도, 원격 셸이 Windows의 C: 드라이브를 볼 수 있게 되는 것은 아닙니다.

7. 셸 입력과 Claude의 이미지 첨부는 구별합니다

Claude 웹의 파일 업로드와 터미널의 경로 삽입은 서로 다른 기능입니다. Claude Code의 이미지 입력 방식도 운영체제·터미널에 따라 다릅니다. 경로 글자만 들어갔는지, 이미지 첨부 표시가 생겼는지 확인하고 설명을 덧붙입니다. Claude 웹에 올린 파일이 자동으로 원격 컴퓨터 프로젝트 폴더에 생기는 것도 아닙니다. Claude: 파일 업로드 · Claude Code: 이미지 입력과 운영체제별 입력 방식

더 자세한 이미지 전달 절차는 캡처 파일을 SSH 환경에 전달하는 방법에서 이어집니다.