它解决的场景
本地 CLI 的天然限制是「电脑开着、你在场」。云端会话把执行环境挪到 Anthropic 管理的容器里,于是三件事变得顺理成章: 通勤路上手机派个修 bug 任务、睡前丢三个重构并行跑、笔记本合盖任务不断。每个会话独立容器、独立分支, 产出以 PR 形式回到仓库——评审关卡还在你手里。
可用性:研究预览,Pro / Max / Team 可用(Enterprise 需 premium 或 Chat + Claude Code 席位), 跑在订阅额度上。组织侧有两个闸门:allow_remote_sessions 策略要开着;Zero Data Retention 组织整体不可用。
接入:GitHub App 或 /web-setup
| 方式 | 做法 | 适合 |
|---|---|---|
| GitHub App | 网页 onboarding 时授权 Claude GitHub App | 浏览器起步;要用 Auto-fix 的团队 |
| /web-setup | 终端里运行,同步本地 gh CLI 的 token 到 Claude 账号 | 已经在用 gh 的个人开发者 |
一个容易误解的安全边界:两种方式下云端会话都能访问所连 GitHub 账号可见的任何仓库, App 装没装在某仓库只影响 Auto-fix 的 webhook,不是访问控制。要限制团队能碰哪些仓库,得在 GitHub 侧限制账号本身的仓库成员关系。
终端上云:--cloud
# 新起一个云端会话(从当前仓库)
claude --cloud "Fix the authentication bug in src/auth/login.ts"
# 并行派活:每条各起一个独立会话
claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"关键语义:云端 VM 克隆的是当前目录 GitHub 远端的当前分支,不是你的本地检出——本地有提交先 push。容器启动期间 CLI 显示克隆、setup 脚本等步骤清单,期间输入的消息会排队待发。旧写法 --remote 已是弃用别名。进度用 /tasks 看,或直接开 claude.ai/code / 手机 App 介入对话。
没连 GitHub?自动打包直传
从未连接 GitHub 的仓库运行 --cloud 时,Claude Code 会把本地仓库打包上传:包含全分支完整历史和已跟踪文件的未提交改动。 安全细节做得到位:.env、*.tfvars、id_rsa、*.pem 等凭证样式文件的未提交改动被自动排除并逐个列名, 会话里只见已提交版本。限制:必须是有至少一次提交的 git 仓库、打包上限 100MB(超限逐级降级到单分支、再到工作树快照)、 未跟踪文件不带(要带先 git add)、纯打包会话推不了远端。已连 GitHub 但想强制直传:CCR_FORCE_BUNDLE=1。
给跑着的会话追加指令
claude -p "别忘了同步更新 CHANGELOG" --cloud session_01DiUkqY2kzbUbDmW1w96rfi
# 发一条就退出,不等回复;session ID 也可用 claude.ai/code URL 代替这条在任何登录了同一账号的机器上都能发,也适合塞进 CI 脚本里驱动云会话。
云回终端:--teleport
claude --teleport # 交互式会话选择器
claude --teleport <session-id> # 直接拉指定会话
# 会话内等价命令:/teleport 或 /tp;/tasks 列表里按 t 也行teleport 会校验四件事:工作区干净(有未提交改动会提示先 stash)、在同一个仓库的检出里(fork 不行)、 云端分支已推到远端、登录的是同一个 claude.ai 账号。通过后自动 fetch + checkout 云端分支,完整对话历史进终端。
两个区分:--teleport ≠ --resume(后者只翻本机历史,列不出云端会话);teleport 拿到的是会话副本——本地新进展不回流网页和手机,想继续用手机盯就在本地会话里开 /remote-control。另外 teleport 需要 claude.ai 订阅登录,API key 认证下不可用(/login 切换)。
云端会话里的命令差异
| 命令 | 云端行为 |
|---|---|
| /compact、/context | 照常可用;上下文接近容量还会自动压缩 |
| /clear | 不可用——侧边栏新开会话代替 |
| /model、/effort、/rename | 可用但要带参数(如 /model sonnet),没有终端那种选择器 |
| /plugin、/resume | 终端专属,云端没有;插件改用 settings 里 enabledPlugins 声明 |
| /config | 打开网页设置页;改会话行为用环境变量或仓库里的 settings 文件 |
Subagents 与本地行为一致,仓库 .claude/agents/ 自动生效;权限模式在建任务和会话运行中都可从下拉切换。
分享前必读的安全边界
- Team / Enterprise:可见性 Private / Team 两档,默认开启「按接收者 GitHub 账号校验仓库访问权」。
- Pro / Max 个人版:可见性是 Private / Public——公开链接任何登录 claude.ai 的人都能看,且仓库访问校验默认不开。会话里往往带着私有仓库代码,分享前过一遍内容;要强制校验或匿名显示,去 Settings → Claude Code → Sharing settings。
- 删除会话不可逆;归档只是从默认列表隐藏。
Auto-fix:让 PR 自己好起来
装了 Claude GitHub App 后可以让 Claude 盯 PR:CI 挂了或评审留了意见,Claude 自动调查,改法明确就直接推修复。 配合「云端跑任务 → 网页建 PR → Auto-fix 收尾」,一条改动从派单到绿灯可以基本无人值守——评审批准仍然是你的。
上手清单
- 确认套餐(Pro/Max/Team)与组织策略 allow_remote_sessions 已开。
- 连 GitHub:个人用 /web-setup 最快,团队装 App 顺便解锁 Auto-fix。
- 第一周用「本地 plan、云端执行」:方案文件提交推送后 --cloud 指着它跑。
- 把 --cloud 当并行器用:互不相干的小任务一次派三五个,/tasks 收割。
- 个人版分享一律先自查内容;含私有代码的会话宁可 teleport 回本地演示。
云端会话补齐了 Claude Code 的最后一块拼图:本地 CLI 管交互深耕,无头模式管脚本化,云端管「人不在场时的吞吐」。 重度使用会明显吃订阅额度——限流频繁时,参考我们的套餐对比选档或升到 Max。