Cmd. /teleport
Claude Code on the web 세션을 현재 터미널로 끌어와 이어서 작업하는 명령
핵심 요약
- web session을 local terminal로 가져오기 (
/tp) - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
web session을 local terminal로 가져오기 (/tp)
/teleport사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 조건부 |
| 별칭 | /tp |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
클라우드 세션 또는 루틴 접근 권한과 필요한 계정 연결을 확인합니다.
사용 예
/teleport# 기존 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는 클라우드 세션과 그 브랜치를 끌어옵니다.
실행 결과와 유지 범위
선택한 클라우드 세션의 브랜치와 대화를 현재 터미널로 가져옵니다.
/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로 붙여넣을 명령 복사
주의사항
텔레포트는 재개 전에 다음 요건을 확인하며, 충족되지 않으면 오류나 해결 안내가 표시됩니다.
- 깨끗한 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 같은 메시지가 나타날 수 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록