Cmd. /teleport
Claude Code on the web 세션을 현재 터미널로 끌어와 이어서 작업하는 명령
핵심 요약
/teleport(별칭/tp)는 Claude Code on the web 세션을 현재 터미널로 끌어오는 웹 → 터미널 단방향 핸드오프 명령입니다.- 피커에서 세션을 고르면 그 브랜치를 fetch & checkout 하고 전체 대화 기록을 터미널로 불러옵니다.
- 반대 방향(터미널 → 웹)은
--remote플래그가, 로컬 기록 재개는--resume이 담당하며 클라우드 세션을 나열하지 않습니다. - 깨끗한 git 상태, 동일 저장소(비 fork), 원격에 push된 브랜치, 동일 claude.ai 계정 인증이 전제 조건입니다.
- API 키·Bedrock·Vertex·Foundry 인증 상태에서는 쓸 수 없고, claude.ai 구독 로그인이 필요합니다.
명령어 원본 선언
/teleport별칭(alias)으로 /tp도 동일하게 동작합니다.
공식 설명 요약
/teleport는 Claude Code on the web(클라우드) 세션을 현재 터미널로 끌어오는(pull) 명령입니다.
실행하면 세션 선택용 피커(picker)가 열리고, 선택한 세션의 브랜치를 가져와(fetch & checkout) 전체 대화 기록을 터미널로 불러옵니다.
공식 문서의 원문 설명은 다음과 같습니다.
Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as
/tp. Requires a claude.ai subscription.
이 명령은 "원격 세션을 양방향으로 넘나드는" 범용 명령이 아니라 웹 → 터미널 단방향(one-way) 핸드오프만 담당합니다. 반대 방향(터미널 → 웹)은 CLI에서 새 클라우드 세션을 만드는 --remote 플래그가 맡습니다.
CLI 외부에서는 다음 진입점으로도 동일한 텔레포트를 수행할 수 있습니다.
claude --teleport: 대화형 세션 피커 실행claude --teleport <session-id>: 특정 세션을 바로 재개/tasks에서 백그라운드 세션 목록을 본 뒤t키로 텔레포트- 웹 인터페이스의 Open in CLI로 붙여넣을 명령 복사
최소 지원 버전
- 공식 문서는 별도의 최소 CLI 버전을 명시하지 않습니다. 대신 claude.ai 구독(Pro/Max/Team, 또는 Enterprise premium·Chat + Claude Code 시트) 인증이 필요하고, Claude Code on the web 기능 자체가 아직 리서치 프리뷰 상태입니다.
사용법
# 기존 CLI 세션 안에서 실행 (재시작 없이 피커 오픈)
/teleport
/tp
# 터미널 시작 시 플래그로 텔레포트
claude --teleport
claude --teleport <session-id>텔레포트 시 Claude는 (1) 올바른 저장소에 있는지 확인하고, (2) 클라우드 세션의 브랜치를 fetch & checkout 한 뒤, (3) 전체 대화 기록을 터미널로 불러옵니다. 커밋되지 않은 변경이 있으면 먼저 stash 하도록 안내합니다.
좋은 사용 예
- 웹/모바일에서 시작한 장기 작업을 로컬 터미널에서 이어받기
/tasks로 모니터링하던 백그라운드 클라우드 세션을 직접 터미널로 가져와 마무리- 클라우드에서 진행한 브랜치를 그대로 체크아웃해 로컬 테스트·PR 작성으로 연결
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/teleport (/tp) | 웹(클라우드) 세션과 그 브랜치를 터미널로 끌어옴 | 웹에서 시작한 작업을 이어받을 때 |
/resume | 이 컴퓨터의 로컬 기록에서 대화 재개(클라우드 목록 없음) | 같은 머신의 로컬 세션 재개 |
/remote-control | 이 로컬 세션을 다른 기기에서 계속 제어 | 터미널 → 다른 기기 제어 |
/remote-env | --remote 웹 세션의 기본 원격 환경 구성 | 클라우드 실행 환경 설정 |
--teleport는 --resume과 다릅니다. --resume은 현재 머신의 로컬 기록만 다루고 클라우드 세션을 나열하지 않으며, --teleport는 클라우드 세션과 그 브랜치를 끌어옵니다.
활용 사례
- 웹에서 돌린 빌드/테스트 결과를 로컬에서 검증하고 PR로 마무리
- 모바일·웹에서 시작한 작업을 데스크톱 터미널로 옮겨 정밀 작업 지속
- 백그라운드 클라우드 세션을 필요할 때만 터미널로 가져와 리소스를 아껴 쓰기
주의사항
텔레포트는 재개 전에 다음 요건을 확인하며, 충족되지 않으면 오류나 해결 안내가 표시됩니다.
- 깨끗한 git 상태: 작업 디렉터리에 커밋되지 않은 변경이 없어야 합니다. 필요 시 stash 하도록 안내합니다.
- 올바른 저장소: fork가 아닌 동일 저장소의 체크아웃에서 실행해야 합니다.
- 브랜치 가용성: 클라우드 세션의 브랜치가 원격에 push되어 있어야 하며, 텔레포트가 자동으로 fetch & checkout 합니다.
- 동일 계정: 클라우드 세션에서 사용한 것과 같은 claude.ai 계정으로 인증되어 있어야 합니다.
또한 API 키, Bedrock, Vertex AI, Microsoft Foundry 인증 상태에서는 텔레포트를 쓸 수 없습니다. /login으로 claude.ai 계정에 로그인해야 합니다. claude.ai로 로그인했는데도 사용할 수 없다면 조직에서 클라우드 세션을 비활성화했을 수 있습니다. --teleport는 Remote Control 세션 인프라를 공유하므로 Remote Control session expired, Access denied 같은 메시지가 나타날 수 있습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Use Claude Code on the web (From web to terminal): https://code.claude.com/docs/en/claude-code-on-the-web