/teleport
把一个 Web 会话接入终端。
/teleport(别名 /tp)把一个正在 Claude Code on the web(claude.ai/code)上运行的云端会话拉取到本地终端。该命令会打开一个交互式选择器,列出你自己的云端和后台会话;选定之后,Claude Code 会检查本地目录是否属于同一个仓库,检出该会话所在的分支,并加载完整的对话记录。
前提条件:干净的 Git 状态(如果有未暂存的改动,系统会先建议进行 stash)、已检出同一个仓库、该分支已经推送到远程,并且使用与云端会话相同的 claude.ai 账号登录。需要有 claude.ai 订阅。
这种切换是单向的:从传送(teleport)那一刻起,Web 端和终端端的副本会各自独立运行,本地的改动不会再同步显示在 claude.ai 或移动端应用中。如果之后还想在移动设备上访问这个本地会话,需要额外再启动 /remote-control。
✅ 什么时候用?
把在外出时启动的 Web 会话带回本地继续处理
把在手机上通过 claude.ai/code 启动的任务,用 /teleport 拉到工作电脑上,从而获得完整的文件访问权限和本地工具继续处理。
长时间运行的云端会话完成后,转到本地继续构建
把用 claude --cloud 启动的任务完成后,通过 /teleport 拉入终端,在本地测试并提交结果。
⛔ 什么时候不该用?
想把本地会话转移到另一台设备上
/teleport 只能单向工作:从云端转到终端,反过来不行。
更好的选择: 启动 /remote-control,从另一台设备远程控制本地会话,或者在桌面应用中使用“Continue in”菜单
云端会话所在的分支还没有推送
传送需要该分支已经存在于远程,否则检出会失败
更好的选择: 先在 Web 会话中完成提交/推送,再重新尝试 /teleport
来源
- Claude Code 文档(官方) ↗ code.claude.com