网页版与云端会话

云端会话在云基础设施（默认由 Anthropic 托管）而不是你的机器上运行 Claude Code。本页从浏览器里的 claude.ai/code 开始一个，你也可以从 Claude 手机 App、桌面应用，或终端里用 claude --cloud 开始。云端会话适用于 Pro、Max 和 Team 套餐，以及拥有高级席位或 Chat + Claude Code 席位的 Enterprise 用户。

你需要一个 GitHub 仓库来开始。Claude 把它克隆到一台隔离的虚拟机里，做改动，并推送一个分支供你评审。会话可以跨设备保持，你在笔记本上开始的任务，稍后在手机上就能评审。

云端会话适合：

• 并行任务：同时运行多个独立任务，每个在自己的会话和分支里，无需管理多个 worktree
• 你本地没有的仓库：Claude 每个会话都重新克隆仓库，所以你不需要把它检出
• 不需要频繁引导的任务：提交一个定义清楚的任务，去做别的事，等 Claude 完成后评审结果
• 代码问题与探索：不用本地检出就能理解代码库或追踪某个功能是怎么实现的

需要你本地配置、工具或环境的工作，在本地运行 Claude Code 或使用 Remote Control 更合适。

会话如何运行

下面描述 Anthropic 托管的会话。提交任务时：

1. 克隆并准备：你的仓库被克隆到一台 Anthropic 管理的虚拟机，如果配置了设置脚本就运行它
2. 配置网络：根据你环境的访问级别设置互联网访问
3. 工作：Claude 分析代码、做改动、运行测试并检查自己的工作；你可以全程观看和引导，也可以走开等它完成
4. 推送分支：Claude 到达停止点时把分支推送到 GitHub；你评审 diff、留行内评论、创建 PR，或再发一条消息让它继续

分支推送后会话并不关闭，创建 PR 和后续编辑都在同一个对话里进行。

比较运行 Claude Code 的方式

Claude Code 在各处行为相同，变化的是会话在哪里运行，以及你的本地配置是否可用：

连接 GitHub

连接 GitHub 是一次性步骤。如果你已经在用 GitHub CLI，也可以改在终端里完成。

1. 访问 claude.ai/code，用你的 claude.ai 账号登录
2. 登录后，claude.ai/code 提示你连接 GitHub。按提示操作，它会把你带到 GitHub 的授权页；批准授权请求后，GitHub 把你送回 claude.ai/code。云端会话适用于已有的 GitHub 仓库
3. 有了这个连接，会话可以克隆任何公开仓库，但只有在私有仓库上安装了 Claude GitHub App 时才能在其中工作。在你想使用其私有仓库的每个 GitHub 账号或组织上安装 Claude GitHub App
4. 云端环境是保存的配置，控制会话期间 Claude 的网络访问权限以及会话开始时运行什么。连接 GitHub 之后：Pro 和 Max 套餐会为你创建一个名为 Default 的环境；Team 和 Enterprise 套餐会显示 Create your first cloud environment 表单，保持预填的名称和网络访问不变，点 Create & finish 创建 Default 环境

Default 使用 Trusted 网络访问：会话可以访问常见的包注册表和其他在允许列表里的域名，通过会话的网络不能访问其他任何东西。对第一个项目，Default 环境开箱即可用；要更改网络访问、添加环境变量或在会话开始前运行设置脚本，可以编辑它或创建额外的环境。

从终端连接

如果你已经用 GitHub CLI（gh），可以从终端连接 GitHub 用于云端会话（需要 Claude Code CLI）：

1. 在 shell 里，如果还没认证，运行 gh auth login
2. 在 Claude Code CLI 里运行 /login，用你的 claude.ai 账号登录（用 API Key 认证不算）
3. 在 Claude Code CLI 里运行 /web-setup，确认把你的 gh 令牌发送到你的 Claude 账号的提示

成功时，Claude Code 会打印 Connected as <your-github-username> 并在浏览器里打开 claude.ai/code。要移除令牌，在 claude.ai/customize/connectors 断开 GitHub；要让令牌本身失效，在 GitHub 上撤销它。启用了零数据保留（ZDR）的组织不能使用 /web-setup 或其他云端会话功能。

开始一个任务

GitHub 已连接、环境已创建后，就可以提交任务了：

1. 在 claude.ai/code 或 Claude 手机 App 的 Code 标签页，点输入框下方的仓库选择器，选择 Claude 要在其中工作的仓库；每个仓库都显示分支选择器，可以更改它让 Claude 从功能分支开始
2. 输入框旁的模式下拉菜单显示会话将以什么模式运行：Auto（分类器审查 Claude 的动作而不是问你）、Accept edits（Claude 做改动并推送分支，不停下来等批准）、Plan（Claude 提出方案，等你批准后才编辑文件）。云端会话不提供 Manual 或 Bypass permissions
3. 输入你想要什么并按 Enter。要具体：点名文件或函数（「Add a README with setup instructions」或「Fix the failing auth test in tests/test_auth.py」好过「fix tests」）；如果有就粘贴错误输出；描述期望行为，而不仅仅是症状

Claude 会克隆仓库，如果配置了设置脚本就运行它，然后开始工作。每个任务有自己的会话和自己的分支，所以你不必等一个完成才开始另一个。

预填会话

可以给 claude.ai/code 的 URL 添加查询参数，预填新会话的提示、仓库和环境，用来构建集成，比如在你的工单系统里放一个按钮，用 issue 描述作为提示打开 Claude Code：

每个值都要做 URL 编码：

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

评审并迭代

Claude 完成后，评审改动，对特定行留反馈，继续直到 diff 看起来正确：

• 一个 diff 指示（如 +42 -18）显示整个会话新增和删除的行数，选择它打开 diff 视图：左边是文件列表，右边是改动。默认 diff 与会话的基础分支比较，可以选 Compare against 另选一个分支
• 选择 diff 里任意一行，输入你的反馈并按 Enter。评论会排队直到你发送下一条消息，然后与它打包一起发送，Claude 会连同你的主要指令一起看到「在 src/auth.ts:47，这里不要捕获错误」，所以你不必描述问题在哪里
• diff 看起来正确时，选 diff 视图顶部的 Create PR，可以作为完整 PR、草稿打开，或跳转到 GitHub 带生成标题和描述的创建页面
• PR 创建后会话仍然保持活跃。把 CI 失败输出或评审者评论粘贴进聊天，让 Claude 处理；想让 Claude 自动监控 PR，见官方的「自动修复 PR」

设置排障

• 连接 GitHub 后没有仓库出现：如果在浏览器里连接，私有仓库只有在拥有它的账号或组织上装了 Claude GitHub App 且安装的仓库访问包含它时才会出现；如果用 /web-setup 连接，会话可以访问你的 gh 令牌能访问的每个仓库，运行 gh repo view OWNER/REPO 检查你的 GitHub CLI 登录能否看到该仓库
• 页面只显示 GitHub 登录按钮：云端会话需要连接 GitHub 账号；通过上面的浏览器流程连接，或用 GitHub CLI 在终端运行 /web-setup。如果完全不想连接 GitHub，可以用 Remote Control 在自己的机器上运行 Claude Code，再从浏览器或手机监控
• 「Claude Code isn't available on your account」：你在所选组织里的席位不包含 Claude Code；如果你属于另一个组织，点该页面上的 Switch organization，否则请组织 Owner 给你分配包含 Claude Code 的席位
• 设置脚本失败：设置脚本以非零状态退出会阻止会话启动。常见原因：包安装失败是因为注册表不在你的网络访问级别里（Trusted 覆盖大多数包管理器，None 全部阻止）；脚本引用了新克隆里不存在的文件或路径；本地能用的命令在 Ubuntu 上需要不同的调用方式。调试时在脚本顶部加 set -x 看是哪条命令失败；对非关键命令，在末尾加 || true 免得它们阻止会话启动
• 新会话在设置期间挂起或超时：脚本很可能超出了构建环境缓存的大约五分钟时间预算（例如拉取大型 Docker 镜像等重步骤），要精简脚本让它可靠地在五分钟内完成