Claude Desktop을 샌드박스에 연결

Claude Desktop을 샌드박스에 연결 (Connect Claude Desktop to a sandbox)

Claude Desktop이 SSH로 원격 머신에서 Claude Code를 실행하도록 샌드박스를 가리키는 방법을 알아볼게요.

출처: 문서

본문

이 연결 지침은 로컬 샌드박스를 사용해요. 클라우드 SSH 설정은 SSH로 연결을 참고하세요.

Claude Desktop은 SSH로 원격 머신에서 Claude Code를 실행할 수 있어요. 샌드박스를 가리키면 에이전트가 호스트가 아니라 격리된 환경 안에서 동작해요.

[!NOTE] 이 페이지는 Claude Desktop이 SSH로 샌드박스에 연결하는 내용을 다뤄요. Claude Code CLI를 샌드박스 안에서 직접 실행하려면 Claude Code를 참고하세요.

사전 요구 사항 (Prerequisites)

  • SSH 접근이 설정되어 있어야 해요. 에디터 및 앱 통합을 참고하세요.
  • Claude Desktop이 설치되어 있어야 해요.

Claude 에이전트 타입으로 생성한 샌드박스를 사용하세요. Claude 샌드박스 템플릿은 원격 Claude Code 세션에 Anthropic 자격 증명과 네트워크 접근을 구성해요.

연결 (Connect)

[!WARNING] Claude Desktop을 SSH로 샌드박스에 연결하면 Anthropic 자격 증명이 샌드박스 안의 Claude Code 프로세스로 전송되어 격리 보장이 약화돼요.

아직 없다면 현재 디렉터리용 이름 있는 Claude 샌드박스를 만드세요:

$ sbx create --name demo claude .

터미널에서 샌드박스에 연결할 수 있는지 확인하세요:

$ ssh demo.sbx

Claude Desktop에서 세션을 시작하기 전에 환경 드롭다운을 열고 + Add SSH connection을 선택하세요. 연결 이름을 입력하고 SSH Host에 demo.sbx 같은 샌드박스 호스트네임을 입력하세요. 관리 SSH 구성이 제공하므로 SSH Port와 Identity File은 비워 두세요.

환경 드롭다운에서 해당 연결을 선택한 다음, 원격 폴더 선택기로 마운트된 워크스페이스를 선택하세요. 선택기는 처음에 /home/agent에서 열릴 수 있어요.

더 많은 연결 옵션은 Claude Desktop의 SSH 세션 지침을 참고하세요.

토큰 갱신 후 끊긴 SSH 연결 문제 해결

Anthropic 토큰이 만료되고 갱신되어야 할 때 SSH 연결이 끊겨요. 이 문제를 우회하려면 호스트에서 샌드박스를 수동으로 실행하세요:

$ sbx run --name <sandbox-name>

Windows에서 SSH 연결 시간 초과 문제 해결

Claude Desktop은 Windows에서 Git이 필요해요. SSH 연결이 시간 초과되고 Claude Desktop 로그에 ProxyCommand error: spawn sh ENOENT가 포함되면 Windows용 Git을 설치하세요.

Git이 이미 설치되어 있다면 sh.exe가 PATH에 있는지 확인하세요:

PS> where.exe sh

명령이 sh.exe를 찾지 못하면 Git bin 디렉터리를 사용자 Path에 추가하세요. 기본 디렉터리는 C:\Program Files\Git\bin이에요. Path를 업데이트한 후 Claude Desktop을 종료하고 다시 시작하세요.

더 알아보기 (Learn more)