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 后没有仓库出现
Claude GitHub App 需要对您想要使用的每个仓库的显式访问。在 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 以便它们不会阻止会话启动。
关闭选项卡后会话继续运行
这是设计使然。关闭选项卡或导航离开不会停止会话。它在后台继续运行，直到 Claude 完成当前任务，然后空闲。从侧边栏，您可以存档会话以将其从列表中隐藏，或删除它以永久删除它。后续步骤
现在您可以提交和审查任务，这些页面涵盖接下来的内容：从您的终端启动云会话、安排定期工作以及给 Claude 常设指令。- 使用 Claude Code on the web：完整参考，包括将会话传送到您的终端、设置脚本、环境变量和网络配置
- Routines：按计划、通过 API 调用或响应 GitHub 事件自动化工作
- CLAUDE.md：给 Claude 持久指令和上下文，在每个会话开始时加载
- 为 iOS 或 Android 安装 Claude 移动应用以从您的手机监控会话。从 Claude Code CLI，
/mobile显示 QR 码。