Claude Code /teleport 与云端到本地会话接力怎么用:网页版 claude.ai/code 任务拉回本地继续改

在 claude.ai/code 网页版或手机上让云端虚拟机写好了初稿,想拉回自己电脑连本地数据库继续调?本文按官方文档讲清 claude --teleport 与 /teleport 的前置条件、四步自动切换流程、单向同步规则与常见报错。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Pro 账号

结论先说

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

云端会话通过 /teleport 拉回本地四步

图:本站根据 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 报错中断时,按下面四条逐一核对即可解决:

  1. 提示当前目录仓库不匹配:确认你当前所在的文件夹已经 git clone 了同一个 GitHub 仓库,并且 git remote -v 指向的仓库名与云端会话一致;
  2. 提示本地存在未提交改动无法切换分支:先执行 git status 查看改了哪些文件,用 git stash -u 暂存起来后再重新运行 /teleport;
  3. 列表里空空如也看不到刚才的网页会话:运行 /status 检查终端登录的邮箱和所属组织(Organization)是否与浏览器打开 claude.ai/code 时所在的组织一致;
  4. 提示账号不支持该功能:云端会话与接力功能均绑定订阅席位,并且云端与本地共享同一份套餐周期配额。还没有订阅席位或额度经常见底的开发者,可以在本站查看 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 官方文档: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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  2. 02

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 开源本地部署(Docker Compose)与提示词版本管理(Prompt Management)从零上手教程

    企业内网严禁业务日志出境,又想免费拥有大模型调用链追踪与不发版热更新提示词的能力?本文按 Langfuse 官方文档整理 Docker Compose 本地一键启动(含 ClickHouse 架构注意事项)、密钥配置与 Prompt Management 标签化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入门教程:给 LangGraph 与原生 OpenAI / Claude 接口加调用链追踪、Token 成本统计与免费层限额

    智能体多步调用总是找不到哪一轮提示词跑偏、单次请求到底烧了多少 Token?本文按 LangSmith 官方文档讲清环境变量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 与 @traceable 追踪原生接口,以及 Developer 免费层额度与留存规则。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效读英文文献:PDF 翻译插件、批注导出精读与防捏造参考文献流程

    在 Zotero 里读英文顶会论文怎么无缝联动 Claude 与 ChatGPT?本文整理 Translate for Zotero 划词翻译配置、高亮批注导出精读提示词,以及杜绝 AI 捏造假 DOI 参考文献的核验闭环。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

    想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~