AREX Feed Article
@ClaudeDevs 发布 Claude Code 云会话指南:七个工作流与 GitHub 连接方法,Pro/Max 奖励额度 10 月 7 日 23:59(PT)前领取
Claude 官方开发者账号 @ClaudeDevs 在美西时间 10 月 6 日介绍了一份 Claude Code 云会话(Cloud sessions)实操指南:《》。指南收录七个适合云会话的工作流,以及第一次就成功连接 GitHub 的方法。
该账号随后在中提醒:9 月 23 日促销启动时持有 Pro 或 Max 个人订阅的用户,仍可在 Claude Code 中运行 /claim-credit 领取一次性云会话奖励额度,截止时间为太平洋时间 10 月 7 日 23:59,即北京时间 10 月 8 日 14:59。按 的说明,额度为 Pro $100、Max $250,叠加在常规计划限额之上;云会话优先消耗它,用尽或 11 月 4 日 23:59(PT)到期后,用量计入计划限额。
每个任务一台新 VM:GitHub 令牌不进 VM,空闲机器会被回收
这份指南发布在 claude.dev 的 Playbooks 栏目下,页面标注 18 分钟阅读时长,署名 Addy Osmani。它开篇列出本地会话对笔记本的三处依赖:与同一仓库上的其他会话共享工作树、用你的凭据运行、电脑睡眠或断网就停止。
帖文的描述是:每个任务在一台全新的虚拟机(VM)上运行 Claude Code,所以可以同时启动多个会话,关闭笔记本后它们继续运行。指南补充了使用方式:会话可以从 claude.ai/code、Claude 手机应用的 Code 标签、Desktop、终端(claude --cloud)和 Slack 启动,从浏览器、手机或 Desktop 跟进,结束时留下一条分支,需要时生成拉取请求。
按指南说明,云会话包含在 Pro、Max、Team、Enterprise 计划中,不单独收取云机器费用,用量与 Claude Code 其余部分共享计划限额;部分组织需要管理员先开启。指南给出的 VM 规格约为 4 vCPU、16 GB 内存、30 GB 磁盘(配图标注系统为 Ubuntu 24.04)。指南还写明几条边界:GitHub token 不进入 VM,由代理持有,会话拿到的是只能推送自己工作分支的短期凭据;仓库里的 CLAUDE.md、rules、skills 随仓库进入云端,个人目录 ~/.claude 留在本地;空闲 VM 会被回收,重新打开会话时拿到的是「对话恢复、机器全新」的环境,指南因此建议把在意的改动及时提交;前台命令默认 2 分钟超时(最长 10 分钟),之后继续在后台运行最多 30 分钟,两个数值都能用环境变量提高。
帖文回复里,@AlekVectis 了这类机制的一个冷启动代价:每个任务一台新 VM 意味着每次都是冷缓存,如果环境从零安装依赖,五个并行会话会把最初几分钟花在 npm install 上;他的建议是把依赖缓存放进环境设置。指南的常见问题部分还写明,Anthropic 会存储会话记录,保留时长取决于计划与模型改进设置;在 Team、Enterprise 和 API 上,除非组织选择加入,不会用代码或提示训练模型。
七个工作流:从并行清待办到运行不完全信任的代码
每个工作流都对应云会话的一项差异:
- 并行清空待办队列。 五个互不相干的小修复在本地要串行处理,在云端就是五个会话、五条分支。
claude --cloud从当前分支克隆 GitHub 远端,所以要先推送本地提交;每个任务要写成自包含的工单,说明问题、完成标准和验证方式。任务属于同一项大改动时,project(Pro 和 Max 公测)会用一个协调会话来创建和跟踪云会话。 - 让会话自己证明修复。 适合跑一遍证明不了的场景,比如不稳定测试:VM 的 CPU 不是你的,可以要求更彻底的验证。指南的演示把测试套件连跑 40 次,并建议必要时跑 200 次、跨 50 个提交做二分定位。
- 桌前定计划、云端构建、终端收尾。 先用 plan mode(计划模式)和 Claude 谈好方案、提交计划,再让云会话执行
docs/migration-plan.md里的迁移计划;完成后用claude --teleport把会话分支和整段对话拉回本地终端(需要干净的工作区,分支必须已推送)。 - 用手机查看和跟进。 Claude 应用的 Code 标签连接同一批会话,可以启动任务、回答 Claude 的问题、让它盯一个拉取请求。指南里的手机示例会话找到过一个真实的边界 bug:潮汐循环从不检查时间窗口的第一个和最后一个样本,窗口起点正好遇上高潮时会被漏掉。
- 把 CI 失败和审查意见交给 Claude。 仓库装上 Claude GitHub App 后,可以在会话的 CI 栏打开 Auto-fix,或在终端对 PR 分支运行
/autofix-pr。Claude 会推送针对失败检查和审查意见的修复,含糊或涉及架构的问题先来问你;对审查线程的回复以你的 GitHub 用户名发布,并标注 Claude Code。它收不到与基线分支的合并冲突通知,要主动让它 rebase。 - 不手动启动也能开工。 routine(研究预览)把提示词、仓库、连接器和环境保存为一组资源,由触发器启动:每小时最多一次的定时、HTTP 调用,或 PR 打开、发布这类 GitHub 事件。routine 不弹出审批提示,默认推送到
claude/前缀的分支。 - 运行不完全信任的代码。 第三方 PR、依赖安装脚本、刚克隆的仓库,都可以放进一次性 VM:里面没有 SSH 密钥,GitHub 凭据限定在单个会话,网络级别可以收紧到 None,或保持 Trusted(放行包注册表、GitHub 和主要云 SDK 主机)。即便设为 None,Claude Code 仍会访问 Anthropic API;所有出站流量经代理并记录主机名。
演示:三个任务、三台 VM,87 秒内全部完成
为写这份指南,作者对一个小型示例仓库跑了四个真实的云会话。仓库 tidepool 是一个预测三个虚构港口潮汐的 Node API;指南注明,截图里的仓库和用户是虚构的,但工作输出和数字来自那些真实会话。
其中三个会话在 16 秒内先后启动,分别处理三件事:修一个约每四次运行失败一次的不稳定测试,把过时的 API 文档改到与代码一致,把字符串拼接的日志改成每行一个 JSON 对象。三个会话分别运行 61、65、72 秒,自第一个启动起 87 秒内全部结束;由于 tidepool 不在 GitHub 上,每个会话要先从提示中的文件重建仓库,这一步占用了每次运行约三分之一到一半以上的时间。
修不稳定测试的会话定位到 TtlCache.get 的竞态,改成缓存进行中的 promise,然后把套件连跑 40 次、零失败;文档会话找出五处错误(列了不存在的字段、写了代码已忽略的 days 参数、把米写成了英尺、漏掉一个端点、缺错误响应),还发现 from= 参数畸形时服务端返回 200 和空列表,把它作为注意事项写进文档,而没有改动没被要求触碰的服务端代码。日志会话的提交带进了一个失败测试,它重跑缓存测试 8 次、看到 5 次失败,追到同一个竞态并给出同样的修复,但按任务边界没有动缓存代码,还在总结里说明套件不干净。指南由此给出一条并行规则:沿文件边界切分任务,按合理顺序合并分支,并预期某个会话报告的问题,另一个会话可能已经在修。
GitHub 连接:两道权限、三条路径
指南提醒:如果第一次云会话出问题,GitHub 最可能是原因,而多数故障来自两道彼此独立的权限。登录 GitHub 只告诉 Claude「你是谁」;把 Claude GitHub App 安装到账号或组织上,才决定它能看到哪些私有仓库。公开仓库只需前者;私有仓库需要后者,App 没装在拥有该仓库的账号或组织上,是「仓库在列表里不见」的常见原因。Auto-fix、GitHub 触发的 routine 和 project 也都依赖这个 App。
连接有三条路径。浏览器路径(指南推荐)先在 claude.ai/connect-github 连接账号,再把 App 安装到仓库所属的账号或组织;组织安装通常要 owner 批准,用了 SAML 单点登录的组织,还须在 GitHub 的单点登录授权步骤里对每个组织点击 Authorize。终端路径面向已经在用 gh CLI 的用户:在 Claude Code 里运行 /web-setup,把 gh token 交给 Claude 账号,会话就能触达该 token 可达的任何仓库;Team 和 Enterprise 需要管理员先开启 Quick setup。第三条是跳过 GitHub 的一次性用法:在没有 GitHub 远端的仓库里直接 claude --cloud,Claude Code 会改为上传仓库打包文件,但只有你对仓库有推送权限时,会话才能把改动推回来。
指南附的故障对照表覆盖了几类典型报错:私有仓库缺失,是 App 没装在拥有者账号上,或仓库访问范围排除了它;报错称「必须是组织 owner 才能连接」,通常因为组织拦下了成员资格检查,比如有待批准的 App 权限请求、IP 允许列表或 SAML SSO;连接后组织仓库立刻消失,多半是跳过了单点登录授权;所有云会话都报认证错误,可能是组织启用了 IP 允许列表,需要请支持团队豁免 Anthropic 托管服务。Team 和 Enterprise 的管理员另有一份清单:开启 GitHub 连接器、允许云会话、安装 App 或批准成员请求,并决定是否启用 Quick setup。
回复里的 @OdysseyStack ,「第一次就连通 GitHub」是整份指南里最有野心的说法。
奖励额度:资格条件、领取方式与不适用范围
帮助中心的促销说明写明了更细的规则:资格限定为促销启动时,也就是 2026 年 9 月 23 日 14:00(PDT)拥有有效订阅的个人 Pro 和 Max 用户,且须以 claude.ai 账号登录。Team、Enterprise、免费试用和付款逾期的账号不在范围内,该额度也不能通过 Amazon Bedrock、Google Vertex AI 或 API key 认证获得。部分账号会被自动发放,其余可以在 Desktop 应用或 IDE 的横幅、CLI 的 /claim-credit,或 claude.ai/code/claim-credit 领取。领取后不用开启按量付费的 usage credits;额度自动用于 web、Desktop、CLI 和手机端的云会话,余额在用量菜单里可见。
不适用清单同样明确:Projects 和 Routines、在本地运行的远程控制会话、Chat 和 Cowork 会话,以及云会话之外的任何 Claude 用量。额度每个账号一份、不能与其他优惠叠加,降级保留、升级不额外发放;帮助中心还注明,这次促销与每周用量限额的任何调整无关。还有一个例外是 Pro 计划下的 Fable 模型:选择它需要开启带余额的 usage credits,奖励额度会先用掉,之后 Fable 立即转向按量计费。
额度用尽之后:并行会话按并行度消耗计划限额
指南的「值得坚持的习惯」一节给出的数字是:五个并行会话的消耗速度约是单个会话的五倍;routine 另有每小时的运行上限,project 每天最多新建 200 个线程。帖文回复中,@MartinSzerment :几个会话同时占用同一份计划限额,「笔记本可以睡,限额不会睡」。
帮助中心列出的两个关键日期分别是太平洋时间 10 月 7 日 23:59 的领取截止,与 11 月 4 日 23:59(PT)的额度失效。