Show GN: SSH Image Drop – 스크린샷을 원격 Claude Code 세션에 넘기는 Raycast 익스텐션 — 원격 Claude Code 워크플로에 시각 자료를 자연스럽게 끼워 넣는 작은 연결고리

원격 Claude Code 세션, 스크린샷 한 장이 문제였다

원격 Mac에 SSH로 붙어 Claude Code를 돌리는 워크플로가 흔해지고 있다. 그런데 터미널과 SSH 세션은 이미지 붙여넣기를 받지 못한다. 스크린샷을 로컬 클라이언트에서 잘라 붙여 넣어도, 원격 세션에는 텍스트만 흘러 들어간다. 로컬 노트북을 클라이언트로만 쓰고 여러 원격 서버에서 에이전트를 동시에 굴리는 사람에게는 이 빈틈이 매번 발목을 잡는다.

이 문제를 직접 해결하려 만든 도구가 SSH Image Drop이다. Raycast 익스텐션 형태라 평소 쓰는 런처에서 바로 띄울 수 있고, 한 번 클릭하면 스크린샷이 원격 Claude Code 세션으로 전송된다. 제작자가 긱뉴스에 직접 소개한 Show HN 류의 도구로, 단순한 “원격 클립보드 동기화”가 아니라 “에이전트 세션에 그림을 흘려보내는” 구체적 시나리오에 초점을 맞췄다.

왜 필요했는가: 로컬 클라이언트 + 원격 에이전트의 불편함

개발 현장의 흔한 패턴이 두 가지다. (a) 노트북에서 직접 Claude Code를 돌리고, 원격 서버에는 결과만 푸시한다. (b) 반대로, 에이전트 여러 개를 원격 박스에 띄워놓고 노트북은 키보드/디스플레이 역할만 수행한다. 후자는 GPU 자원이 부족한 로컬 머신에서도 큰 모델을 굴릴 수 있어 매력적이지만, 시각 자료를 다루는 데 큰 제약을 안고 살아야 한다.

• 터미널·SSH 세션은 클립보드 이미지 수신을 거부한다. 텍스트 붙여넣기만 가능하다.
• 스크린샷은 결과적으로 로컬 파일시스템에 떨어지고, 이를 다시 원격으로 올리려면 scp/rsync 같은 추가 단계가 필요하다.
• 에이전트가 화면을 봐야 하는 작업(UI 버그 재현, 디자인 리뷰, 에러 화면 공유)에서 매번 별도 업로드 파이프라인을 구성하는 건 부담스럽다.

이러한 제약은 단순히 “귀찮음”의 영역이 아니다. 로컬에서 캡처 → 원격 컨텍스트로 전달 → 에이전트가 시각 정보로 추론이라는 흐름을 끊기 때문에, 멀티모달 추론이 점점 표준이 되는 시대일수록 워크플로 효율이 떨어진다.

동작 방식: Raycast에서 한 번 누르면 끝

SSH Image Drop은 Raycast 익스텐션이다. 평소 Spotlight처럼 ⌘ + Space로 런처를 띄우고, 미리 설정해 둔 명령을 선택하는 흐름이다. 별도 데몬 데몬을 띄울 필요도 없고, 환경설정은 익스텐션 내부에서 끝난다. 기본 인터랙션은 다음과 같다.

1. Raycast에서 익스텐션 명령을 실행한다.
2. 로컬 스크린샷(전체 화면/영역/선택 창)을 캡처한다.
3. 지정한 원격 SSH 세션의 작업 디렉터리로 이미지를 전송한다.
4. 필요하다면 프롬프트 텍스트도 함께 붙여 넣어, 에이전트가 이미지+질문을 한 번에 받게 한다.

여기서 핵심은 “이미지가 파일로 떨어진다”가 아니라 “에이전트 세션의 컨텍스트 안에 자연스럽게 합쳐진다”는 점이다. 에이전트 입장에서 이미지는 별도 파일 참조가 아니라 한 입력 묶음으로 인식되며, 사용자의 의도(“이 화면에서 이 부분 봐줘”)가 함께 전달된다.

설치와 설정 — 5분이면 충분

설치는 다른 Raycast 익스텐션과 다르지 않다. Store에서 SSH Image Drop을 검색해 설치하고, 환경설정에서 다음 두 가지만 채우면 된다. SSH_HOST_ALIAS(~/.ssh/config에 등록한 호스트 별칭)와 REMOTE_WORKDIR(이미지가 떨어질 작업 디렉터리, 보통 ~/.claude/tmp 같은 곳). 인증은 SSH 키 기반 그대로라 비밀번호 입력을 매번 요구하지 않는다.

# ~/.ssh/config 예시
Host dev-remote
  HostName 203.0.113.42
  User heejung
  IdentityFile ~/.ssh/id_ed25519

Claude Code 멀티모달 워크플로에 끼워 넣기

멀티모달 컨텍스트를 한 번에 넘기는 패턴은 다양한 작업에 그대로 응용된다. 화면을 공유해 UI 디버깅을 부탁하거나, 데이터 시각화 결과를 즉시 모델에 검토받거나, 디자인 시안의 미세한 차이를 추론시키거나 하는 흐름이 대표적이다. SSH Image Drop은 이때의 “전달막” 한 겹을 없애준다.

실제 사용 사례를 정리하면 다음 세 가지로 수렴한다.

• UI 회귀 재현: 운영 중인 화면 스크린샷 + 재현 단계 텍스트를 한 묶음으로 보내 “이 화면에서 X 동작 시 Y가 깨짐” 같은 보고를 자동화한다.
• 차트/대시보드 리뷰: 분석 결과를 시각화한 이미지를 컨텍스트로 함께 던져, 모델이 수치 해석과 그래프 모양을 동시에 보게 한다.
• 디자인 비교: 두 시안을 한 프롬프트에 묶어 “어디가 어색한가”를 추론시키는 등 사람과 모델 사이의 검토 비용을 크게 줄인다.

이 패턴들이 힘을 발휘하려면 이미지가 “파일이 아니라 입력”으로 다뤄져야 한다. SSH Image Drop이 해결한 것은 사실 별것 아닌 연결고리 한 줄이지만, 그 줄이 빠지면 멀티모달 워크플로는 매번 수동 업로드 단계에서 멈춘다.

보안과 운영 — SSH 키 기반일 때의 안전성

“스크린샷이 자동으로 원격으로 간다”는 표현이 부담스러울 수 있다. 다만 전송 경로 자체는 기존 SSH 세션과 다르지 않다. 키 인증을 쓰는 환경이라면 (a) 데이터는 사용자 계정 권한으로만 전송되고, (b) 채널 자체는 SSH 암호화 안에 머문다. 별도 데몬이 0.0.0.0에 바인딩하거나 평문 HTTP를 열지 않는다는 점이 중요하다.

운영 측면에서 짚어둘 만한 지점은 두 가지다. 첫째, 전송되는 이미지는 원격 작업 디렉터리에 흔적이 남는다. 민감 정보가 담긴 캡처를 자주 보내는 환경이라면 ~/.claude/tmp에 주기적 정리 정책(예: 일 1회 만료)을 두는 편이 깔끔하다. 둘째, 에이전트 프롬프트와 이미지를 함께 보낼 때는 의도치 않은 정보 노출을 피하도록 사전에 “캡처 전 마스킹” 습관을 들이는 게 좋다.

Raycast 생태계 안에서의 위치

Raycast는 macOS의 생산성 런처로 자리 잡았고, 단순 앱 실행을 넘어 “작업을 빠르게 묶는” 도구로 진화 중이다. SSH Image Drop은 그 진화의 연장선에 있다. “스크린샷 + 원격 세션 + 에이전트 입력”이라는 결합을 단축키 한 번에 묶고, 다른 Raycast 익스텐션과 이어 붙일 수 있게 만들었기 때문이다.

예를 들어 “스크린샷 → 캡션 자동 생성 → Slack 공유” 같은 두 단계 익스텐션을 체이닝하면, 로컬에서 화면 한 장을 떼는 순간 그것이 팀 안에서도 공유 가능한 자산이 된다. SSH Image Drop 자체는 단일 도구이지만, 이런 작은 연결고리들이 모여 멀티모달 워크플로 전체를 묶기 시작한다.

마무리 — 원격 환경에서 에이전트를 굴릴 때의 작은 연결고리

SSH Image Drop은 거창한 프레임워크가 아니다. 다만 스크린샷 한 장이 로컬에 갇혀 있다는 사실 하나가 멀티모달 워크플로의 마찰을 키운다면, 그 마찰을 없애는 작은 도구 한 개가 실제 시간을 많이 벌어준다. 원격 Claude Code를 본격적으로 굴린다면 한 번쯤 깔아볼 만하다.

더 본질적인 시사점은 따로 있다. 로컬 머신의 자원이 부족해 원격 GPU 박스에서 에이전트를 굴리는 시대에, “시각 정보를 자연스럽게 흘려보내는” 도구의 가치는 점점 커진다. SSH Image Drop 같은 작은 연결고리들이 모여, 로컬/원격을 가로지르는 멀티모달 워크플로의 표준이 만들어질 가능성이 높다.

---

📰 원본: 긱뉴스 — Show GN: SSH Image Drop – 스크린샷을 원격 Claude Code 세션에 넘기는 Raycast 익스텐션

---

📰 원본 출처 · https://news.hada.io/topic?id=32462 (#N=32462)

이 글은 GeekNews(긱뉴스)에 게제된 글을 기반으로 작성되었습니다. 원본의 라이선스와 저작권은 원작자에게 있습니다.