Claude Code on the web 处于研究预览阶段，适用于 Pro、Max 和 Team 用户，以及拥有高级席位或 Chat + Claude Code 席位的企业用户。
- 并行任务：同时运行多个独立任务，每个任务在自己的会话和分支中，无需管理多个 worktrees
- 您本地没有的仓库：Claude 在每个会话中新鲜克隆仓库，因此您无需检出它
- 不需要频繁指导的任务：提交一个定义明确的任务，做其他事情，当 Claude 完成时审查结果
- 代码问题和探索：理解代码库或追踪功能如何实现，无需本地检出
会话如何运行
当您提交任务时：- 克隆和准备：您的仓库被克隆到 Anthropic 管理的 VM，如果配置了，您的设置脚本会运行。
- 配置网络：互联网访问根据您的环境的访问级别设置。
- 工作：Claude 分析代码、进行更改、运行测试并检查其工作。您可以全程观看和指导，或者离开，当完成时返回。
- 推送分支：当 Claude 到达停止点时，它将其分支推送到 GitHub。您审查差异、留下内联注释、创建 PR 或发送另一条消息以继续。
比较运行 Claude Code 的方式
Claude Code 在任何地方的行为都相同。改变的是代码执行的位置以及您的本地配置是否可用。Desktop 应用提供本地和云会话，因此其下面的答案取决于您选择的是哪一个：
请参阅终端快速入门、Desktop 应用或 Remote Control 文档来设置这些。
连接 GitHub 并创建环境
设置是一次性过程。如果您已经使用 GitHub CLI，您可以从您的终端执行此操作而不是浏览器。访问 claude.ai/code
转到 claude.ai/code 并使用您的 Anthropic 账户登录。
安装 Claude GitHub App
登录后，claude.ai/code 会提示您连接 GitHub。按照提示安装 Claude GitHub App 并授予其访问您的仓库的权限。云会话适用于现有的 GitHub 仓库，因此要启动新项目，请先在 GitHub 上创建一个空仓库。
创建您的环境
连接 GitHub 后，系统会提示您创建云环境。环境控制 Claude 在会话期间可以访问的网络以及创建新会话时运行的内容。请参阅已安装的工具了解无需任何配置即可使用的内容。表单有以下字段：
- Name：显示标签。当您为不同的项目或访问级别有多个环境时很有用。
- Network access：控制会话可以在互联网上访问的内容。默认值
Trusted允许连接到常见包注册表，如 npm、PyPI 和 RubyGems，同时阻止一般互联网访问。 - Environment variables：可选变量，在每个会话中可用，采用
.env格式。不要用引号包装值，因为引号会作为值的一部分存储。这些对任何可以编辑此环境的人都可见。 - Setup script：可选的 Bash 脚本，在 Claude Code 启动前运行。使用它来安装云 VM 不包含的系统工具，如
apt install -y gh。结果被缓存，因此脚本不会在每个会话上重新运行。请参阅设置脚本了解示例和调试提示。
从您的终端连接
如果您已经使用 GitHub CLI (gh)，您可以在不打开浏览器的情况下设置 Claude Code on the web。这需要 Claude Code CLI。/web-setup 读取您的本地 gh 令牌，将其链接到您的 Claude 账户，如果您没有云环境，则创建一个默认的云环境。
启用了零数据保留的组织无法使用
/web-setup 或其他云会话功能。如果未安装或验证 GitHub CLI，/web-setup 会打开浏览器入门流程。运行 /web-setup
在 Claude Code CLI 中，运行：这会将您的
gh 令牌同步到您的 Claude 账户。如果您还没有云环境，/web-setup 会创建一个具有 Trusted 网络访问和无设置脚本的环境。您可以稍后编辑环境或添加变量。一旦 /web-setup 完成，您可以从您的终端使用 --remote 启动云会话，或使用 /schedule 设置定期任务。开始任务
连接了 GitHub 和创建了环境后，您已准备好提交任务。选择仓库和分支
从 claude.ai/code 或 Claude 移动应用中的 Code 选项卡，单击输入框下方的仓库选择器，并为 Claude 选择要在其中工作的仓库。每个仓库都显示一个分支选择器。更改它以从功能分支而不是默认分支启动 Claude。您可以添加多个仓库以在一个会话中跨它们工作。
选择权限模式
输入旁边的模式下拉菜单默认为Auto accept edits，其中 Claude 进行更改并推送分支而无需停止以获得批准。如果您希望 Claude 提出方法并在编辑文件前等待您的同意，请切换到Plan mode。云会话不提供 Ask 权限、Auto 模式或 Bypass 权限。请参阅权限模式了解完整列表。
预填充会话
您可以通过向 claude.ai/code URL 添加查询参数来预填充新会话的提示、仓库和环境。使用此功能来构建集成，例如问题跟踪器中的按钮，该按钮使用问题描述作为提示打开 Claude Code。| 参数 | 描述 |
|---|---|
prompt | 要在输入框中预填充的提示文本。也接受别名 q。 |
prompt_url | 要从中获取提示文本的 URL，用于太长而无法嵌入查询字符串的提示。URL 必须允许跨源请求。当也设置了 prompt 时被忽略。 |
repositories | 要预选的 owner/repo 段的逗号分隔列表。也接受别名 repo。 |
environment | 环境的名称或 ID 以预选。 |
审查和迭代
当 Claude 完成时，审查更改，在特定行上留下反馈，并继续直到差异看起来正确。留下内联注释
选择差异中的任何行，输入您的反馈，然后按 Enter。注释排队直到您发送下一条消息，然后它们与其捆绑。Claude 看到”at
src/auth.ts:47, don’t catch the error here”与您的主要指令一起，因此您不必描述问题在哪里。在 PR 后继续迭代
创建 PR 后会话保持活跃。将 CI 失败输出或审查者注释粘贴到聊天中，并要求 Claude 解决它们。要让 Claude 自动监控 PR，请参阅自动修复拉取请求。
故障排除设置
连接 GitHub 后没有仓库出现
云会话可以使用连接的 GitHub 账户可以看到的任何仓库，无论 Claude GitHub App 安装在哪些仓库上。如果仓库丢失，请验证连接的 GitHub 账户在 GitHub 上有权访问它。如果您还想为仓库启用自动修复，请在其上安装应用：在 github.com 上，打开Settings → Applications → Claude → Configure 并验证仓库是否列在Repository access 下。私有仓库需要与公共仓库相同的授权。页面仅显示 GitHub 登录按钮
云会话需要连接的 GitHub 账户。通过上面的浏览器流程连接，或如果您使用 GitHub CLI，从您的终端运行/web-setup。如果您根本不想连接 GitHub，请参阅 Remote Control 以在您自己的机器上运行 Claude Code 并从网络监控它。
“Not available for the selected organization”
企业组织可能需要管理员启用 Claude Code on the web。联系您的 Anthropic 账户团队。/web-setup 返回 “Unknown command”
/web-setup 在 Claude Code CLI 内运行，而不是在您的 shell 中。首先启动 claude，然后在提示符处输入 /web-setup。
如果您在 Claude Code 内输入它仍然看到错误，您的 CLI 版本早于 v2.1.80，或者您使用 API 密钥或第三方提供商而不是 claude.ai 订阅进行身份验证。运行 claude update，然后 /login 以使用您的 claude.ai 账户登录。
使用 --remote 或 ultraplan 时出现 “Could not create a cloud environment” 或 “No cloud environment available”
远程会话功能如果您没有云环境，会自动创建一个默认的云环境。如果您看到 “Could not create a cloud environment”，自动创建失败。如果您看到 “No cloud environment available”，您的 CLI 早于自动创建。在任何一种情况下，在 Claude Code CLI 中运行 /web-setup 以手动创建一个，或访问 claude.ai/code 并按照上面的Create your environment 步骤。
设置脚本失败
设置脚本以非零状态退出，这会阻止会话启动。常见原因：- 包安装失败，因为注册表不在您的网络访问级别中。
Trusted涵盖大多数包管理器；None阻止它们全部。 - 脚本引用在新鲜克隆中不存在的文件或路径。
- 在本地工作的命令在 Ubuntu 上需要不同的调用。
set -x 以查看哪个命令失败。对于非关键命令，附加 || true 以便它们不会阻止会话启动。
新会话在设置期间挂起或超时
如果新会话在设置脚本步骤上停滞或在脚本完成前因通用容器错误而失败，脚本可能超过了构建环境缓存的大约五分钟时间预算。拉取大型 Docker 镜像、同步完整依赖树或下载模型权重等繁重步骤经常会将总数推过限制，特别是当它们一个接一个运行时。 要解决此问题，修剪脚本使其可靠地在五分钟内完成：- 使用
&和最后的wait并行运行独立安装，而不是按顺序运行它们。 - 将最大的下载移出设置脚本，进入SessionStart hook，在后台启动它们，以便会话在它们完成时变得可用。
- 从设置脚本中删除长重试睡眠，因为停滞的重试循环会计入预算。
关闭选项卡后会话继续运行
这是设计使然。关闭选项卡或导航离开不会停止会话。它在后台继续运行，直到 Claude 完成当前任务，然后空闲。从侧边栏，您可以存档会话以将其从列表中隐藏，或删除它以永久删除它。后续步骤
现在您可以提交和审查任务，这些页面涵盖接下来的内容：从您的终端启动云会话、安排定期工作以及给 Claude 常设指令。- 使用 Claude Code on the web：完整参考，包括将会话传送到您的终端、设置脚本、环境变量和网络配置
- Routines：按计划、通过 API 调用或响应 GitHub 事件自动化工作
- CLAUDE.md：给 Claude 持久指令和上下文，在每个会话开始时加载
- 为 iOS 或 Android 安装 Claude 移动应用以从您的手机监控会话。从 Claude Code CLI，
/mobile显示 QR 码。