结论先说
/teleport(启动参数claude --teleport)专门负责把云端会话接力回本地终端:它会自动帮你核对本地 GitHub 仓库、拉取并切换到云端推送的工作分支,同时把云端聊过的完整对话历史原封不动载入本机。- 仅支持
claude.ai订阅账号:需要本地已通过/login登录同一个开通了 Pro、Max 或对应团队席位的claude.ai账号,纯 Console API Key 模式无法使用。 - 接力是「云端到本地」的单向分叉:拉回本机之后,你在终端里继续发的新消息和本地改动只保存在自己电脑上,不会反向同步回
claude.ai/code网页聊天窗口(代码层面通过git push同步到同一远程分支)。 - 拉取前务必保持本地工作区干净:如果当前目录有未提交的修改,切换云端分支时会被 Git 保护性拦截,先提交或
git stash再执行最省事。 - Claude Code 订阅与高配额开通入口:国内无境外卡可通过本站 iOS 免上号自助卡密开通 Claude Pro 会员 或 5 倍以上额度的 Claude Max 会员,完整档位选型见 Claude Code 订阅说明页。

图:本站根据 Claude Code 官方文档:Use Claude Code in the cloud 整理的示意图
本文根据 Claude Code 官方文档《Use Claude Code in the cloud》《Get started with Claude Code in the cloud》《Remote Control》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code teleport 怎么用」「网页版任务拉回本地」,在通勤路上用网页或手机派了云端改码任务,回到工位想在本地终端接着改的开发者;
- 云端沙盒里跑不通本地专属的 Docker 数据库、硬件显卡环境或内网服务,需要把改了一半的分支连同上下文一起接手回本机的人;
- 分不清
--teleport、--cloud和/remote-control三种跨端模式各干什么的人。
如果你还没用过网页端云虚拟机跑后台任务,可以先看基础入门篇 /guides/claude-code-web。
一、从云端拉回本地的三种触发方式
当你在 claude.ai/code(或手机 Claude App 的 Code 标签页,移动端用法见 /guides/claude-code-mobile-remote-control-android)里让云端虚拟机完成了初步修改,想回到电脑终端接手时,任选下面一种顺手的方式即可:
1. 系统终端直接加 --teleport 启动(最常用)
先在终端 cd 进入该 GitHub 仓库在你本机的克隆目录,然后执行:
bash
# 打开交互式列表,上下键挑选要拉回的云端会话
claude --teleport
# 或者直接粘贴网页端给出的指定会话 ID 一步到位
claude --teleport <session-id>
在网页端云会话界面点击在命令行打开的操作入口(或在云端对话框输入 /teleport),就能直接复制带准确会话 ID 的整行命令。
2. 已打开的本地会话内敲 /teleport(或简写 /tp)
如果你已经在仓库目录里启动了交互式 Claude Code,不用退出重进,直接在输入框敲:
text
/teleport
同样会弹出当前账号下的云端会话选择器。选中回车后,Claude Code 会在后台依次完成四件事:校验当前本地 origin 远程是否与云端会话对应同一个 GitHub 仓库 → 执行 git fetch 拉取云端虚拟机刚推上去的分支 → 自动 git checkout 切过去 → 把云端前几轮的上下文完整灌进当前终端。
3. 从本地先把任务发上云端,忙完再拉回来
很多老手的组合拳是「本地定方案 → 云端苦力执行 → 拉回本地验收」:
bash
# 先把本地分支推上 GitHub,再派一个云端后台会话去跑耗时重构
git push
claude --cloud "把 src/api/ 下所有旧回调接口按重构计划迁到 async/await 并补齐单测"
注意 claude --cloud 克隆的是远端 GitHub 仓库内容,不会上传你本地没推送的脏文件。等云端跑完,再用 claude --teleport 拉回本机连本地测试库做最终联调。
二、--teleport、--cloud 与 /remote-control 怎么分清
这三个名字看着像,底层执行位置和同步方向完全不同:

图:本站根据 Claude Code 官方文档:Cloud 与 Remote Control 整理的示意图
- 想出门前合上笔记本电脑让任务继续跑:用
claude.ai/code或claude --cloud,代码在 Anthropic 的隔离云虚拟机里跑,关机断网都不耽误; - 云端改得差不多了,需要用本机
~/.claude私有规则、本地 MCP 或内网数据库收尾:用claude --teleport把接力棒彻底拿回本地(如果是恢复以前本来就在本机跑的历史会话,则用--resume,区别见 /guides/claude-code-resume-history); - 电脑一直开着不关机,只是离开工位去会议室想用手机盯一眼本机进度、点个权限批准:不要用云端会话,直接在本地终端敲
/remote-control(简写/rc),代码全程不离开你的电脑。
另外要注意命令行与桌面端的一个边界:在纯 CLI 终端里,你可以把云端会话「拉」回本地,但不能把已经聊了一半的本地终端对话历史直接「推」上云端(如果你装了官方桌面客户端,则可以在桌面版 Code 标签页通过 Open in 菜单把任务转交云端,详见 /guides/claude-code-desktop)。
三、拉取报错或找不到会话的常见排查
遇到 /teleport 报错中断时,按下面四条逐一核对即可解决:
- 提示当前目录仓库不匹配:确认你当前所在的文件夹已经
git clone了同一个 GitHub 仓库,并且git remote -v指向的仓库名与云端会话一致; - 提示本地存在未提交改动无法切换分支:先执行
git status查看改了哪些文件,用git stash -u暂存起来后再重新运行/teleport; - 列表里空空如也看不到刚才的网页会话:运行
/status检查终端登录的邮箱和所属组织(Organization)是否与浏览器打开claude.ai/code时所在的组织一致; - 提示账号不支持该功能:云端会话与接力功能均绑定订阅席位,并且云端与本地共享同一份套餐周期配额。还没有订阅席位或额度经常见底的开发者,可以在本站查看 Claude Pro 充值页 或更高配额的 Claude Max 充值页 了解官方档位差异。
常见问题
问:拉回本地修改完之后,网页上原来建好的 Pull Request 怎么更新?
答:/teleport 已经自动帮你切到了云端会话对应的同一条远程工作分支上。你在本地改好代码并 git commit && git push 后,GitHub 上对应的分支和 PR 就会直接更新,无需重新建新 PR。
问:云端虚拟机里临时装过的 npm 或 pip 依赖,拉回本地还在吗?
答:只有写进 package.json、requirements.txt 等代码文件并提交到分支里的声明会跟过来;node_modules 或虚拟环境二进制目录不在 Git 里,切回本机后需先跑一次 npm install 或同步本地依赖环境。
问:拉回本地一次之后,原来的云端会话会被自动删掉吗?
答:不会。云端那份会话记录仍然留在网页侧边栏供你查阅或归档,只是两边从拉取那一刻起各自独立,不再双向同步后续聊天文字。
问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅?
答:可在 Claude Code 订阅页 选择走 iOS 订阅链路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付宝、微信支付与 AlipayHK,无需交出账号密码;若账号弹出身份核验也可查看 Claude KYC 认证人工协助(失败不收费,封号不在质保范围)。
相关教程
- Claude Code 网页版(claude.ai/code)怎么用:在云端跑任务
- Claude Code 手机端、安卓版怎么用:接云端会话或 Remote Control
- Claude Code 桌面版使用教程:Code 标签页、并行会话与定时任务
- Claude Code 怎么看历史对话、恢复之前的会话:--continue、--resume 与 /resume
参考资料
- Claude Code 官方文档:Use Claude Code in the cloud — https://code.claude.com/docs/en/claude-code-on-the-web
- Claude Code 官方文档:Get started with Claude Code in the cloud — https://code.claude.com/docs/en/web-quickstart
- Claude Code 官方文档:Remote Control — https://code.claude.com/docs/en/remote-control
- Claude Code 官方文档:Commands — https://code.claude.com/docs/en/commands
0 条评论
还没有评论,来抢沙发~