在网络上开始使用 Claude Code

从浏览器或手机在云中运行 Claude Code。连接 GitHub 仓库、提交任务，并在无需本地设置的情况下审查 PR。

ℹ️ Claude Code on the web 处于研究预览阶段，适用于 Pro、Max 和 Team 用户，以及拥有高级席位或 Chat + Claude Code 席位的企业用户。

Claude Code on the web 在 Anthropic 管理的云基础设施上运行，而不是在您的机器上。从浏览器中的 claude.ai/code 或 Claude 移动应用提交任务。

您需要一个 GitHub 仓库来开始使用。Claude 将其克隆到隔离的虚拟机中，进行更改，并为您推送一个分支以供审查。会话在设备间持久化，因此您在笔记本电脑上开始的任务稍后可以从手机上审查。

Claude Code on the web 适用于：

• 并行任务：同时运行多个独立任务，每个任务在自己的会话和分支中，无需管理多个 worktrees
• 您本地没有的仓库：Claude 在每个会话中新鲜克隆仓库，因此您无需检出它
• 不需要频繁指导的任务：提交一个定义明确的任务，做其他事情，当 Claude 完成时审查结果
• 代码问题和探索：理解代码库或追踪功能如何实现，无需本地检出

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

会话如何运行

当您提交任务时：

1. 克隆和准备：您的仓库被克隆到 Anthropic 管理的 VM，如果配置了，您的设置脚本会运行。
2. 配置网络：互联网访问根据您的环境的访问级别设置。
3. 工作：Claude 分析代码、进行更改、运行测试并检查其工作。您可以全程观看和指导，或者离开，当完成时返回。
4. 推送分支：当 Claude 到达停止点时，它将其分支推送到 GitHub。您审查差异、留下内联注释、创建 PR 或发送另一条消息以继续。

推送分支时会话不会关闭。PR 创建和进一步编辑都在同一对话中进行。

比较运行 Claude Code 的方式

Claude Code 在任何地方的行为都相同。改变的是代码执行的位置以及您的本地配置是否可用。Desktop 应用提供本地和云会话，因此其下面的答案取决于您选择的是哪一个：

	On the web	Remote Control	Terminal CLI	Desktop app
代码运行在	Anthropic 云 VM	您的机器	您的机器	您的机器或云 VM
您从以下位置聊天	claude.ai 或移动应用	claude.ai 或移动应用	您的终端	Desktop UI
使用您的本地配置	否，仅限仓库	是	是	本地为是，云为否
需要 GitHub	是，或通过 --remote 捆绑本地仓库	否	否	仅限云会话
断开连接时继续运行	是	当终端保持打开时	否	取决于会话类型
权限模式	自动接受编辑、Plan	询问、自动接受编辑、Plan	所有模式	取决于会话类型
网络访问	每个环境可配置	您的机器网络	您的机器网络	取决于会话类型

请参阅终端快速入门、Desktop 应用或 Remote Control 文档来设置这些。

连接 GitHub 并创建环境

设置是一次性过程。如果您已经使用 GitHub CLI，您可以从您的终端执行此操作而不是浏览器。

1. 访问 claude.ai/code：转到 claude.ai/code 并使用您的 Anthropic 账户登录。

2. 安装 Claude GitHub App：登录后，claude.ai/code 会提示您连接 GitHub。按照提示安装 Claude GitHub App 并授予其访问您的仓库的权限。云会话适用于现有的 GitHub 仓库，因此要启动新项目，请先在 GitHub 上创建一个空仓库。

3. 创建您的环境：连接 GitHub 后，系统会提示您创建云环境。环境控制 Claude 在会话期间可以访问的网络以及创建新会话时运行的内容。请参阅已安装的工具了解无需任何配置即可使用的内容。

   表单有以下字段：

   • Name：显示标签。当您为不同的项目或访问级别有多个环境时很有用。
   • Network access：控制会话可以在互联网上访问的内容。默认值 Trusted 允许连接到常见包注册表，如 npm、PyPI 和 RubyGems，同时阻止一般互联网访问。
   • Environment variables：可选变量，在每个会话中可用，采用 .env 格式。不要用引号包装值，因为引号会作为值的一部分存储。这些对任何可以编辑此环境的人都可见。
   • Setup script：可选的 Bash 脚本，在 Claude Code 启动前运行。使用它来安装云 VM 不包含的系统工具，如 apt install -y gh。结果被缓存，因此脚本不会在每个会话上重新运行。请参阅设置脚本了解示例和调试提示。

   对于第一个项目，保留默认值并单击Create environment。您可以稍后编辑它或为不同的项目创建其他环境。

从您的终端连接

如果您已经使用 GitHub CLI (gh)，您可以在不打开浏览器的情况下设置 Claude Code on the web。这需要 Claude Code CLI。/web-setup 读取您的本地 gh 令牌，将其链接到您的 Claude 账户，如果您没有云环境，则创建一个默认的云环境。

ℹ️ 启用了零数据保留的组织无法使用 /web-setup 或其他云会话功能。如果未安装或验证 GitHub CLI，/web-setup 会打开浏览器入门流程。

1. 使用 GitHub CLI 进行身份验证：在您的 shell 中，如果您还没有进行身份验证，请对 GitHub CLI 进行身份验证：

   gh auth login
   

2. 登录到 Claude：在 Claude Code CLI 中，运行 /login 以使用您的 claude.ai 账户登录。如果您已经登录，请跳过此步骤。

3. 运行 /web-setup：在 Claude Code CLI 中，运行：

   /web-setup
   

   这会将您的 gh 令牌同步到您的 Claude 账户。如果您还没有云环境，/web-setup 会创建一个具有 Trusted 网络访问和无设置脚本的环境。您可以稍后编辑环境或添加变量。一旦 /web-setup 完成，您可以从您的终端使用 --remote 启动云会话，或使用 /schedule 设置定期任务。

开始任务

连接了 GitHub 和创建了环境后，您已准备好提交任务。

1. 选择仓库和分支：从 claude.ai/code 或 Claude 移动应用中的 Code 选项卡，单击输入框下方的仓库选择器，并为 Claude 选择要在其中工作的仓库。每个仓库都显示一个分支选择器。更改它以从功能分支而不是默认分支启动 Claude。您可以添加多个仓库以在一个会话中跨它们工作。

2. 选择权限模式：输入旁边的模式下拉菜单默认为Auto accept edits，其中 Claude 进行更改并推送分支而无需停止以获得批准。如果您希望 Claude 提出方法并在编辑文件前等待您的同意，请切换到Plan mode。云会话不提供 Ask 权限、Auto 模式或 Bypass 权限。请参阅权限模式了解完整列表。

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 添加查询参数来预填充新会话的提示、仓库和环境。使用此功能来构建集成，例如问题跟踪器中的按钮，该按钮使用问题描述作为提示打开 Claude Code。

参数	描述
prompt	要在输入框中预填充的提示文本。也接受别名 q。
prompt_url	要从中获取提示文本的 URL，用于太长而无法嵌入查询字符串的提示。URL 必须允许跨源请求。当也设置了 prompt 时被忽略。
repositories	要预选的 owner/repo 段的逗号分隔列表。也接受别名 repo。
environment	环境的名称或 ID 以预选。

对每个值进行 URL 编码。下面的示例打开表单，其中已选择提示和仓库：

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

审查和迭代

当 Claude 完成时，审查更改，在特定行上留下反馈，并继续直到差异看起来正确。

1. 打开差异视图：差异指示器显示整个会话中添加和删除的行，例如 +42 -18。选择它以打开差异视图，左侧是文件列表，右侧是更改。

2. 留下内联注释：选择差异中的任何行，输入您的反馈，然后按 Enter。注释排队直到您发送下一条消息，然后它们与其捆绑。Claude 看到”at src/auth.ts:47, don’t catch the error here”与您的主要指令一起，因此您不必描述问题在哪里。

3. 创建拉取请求：当差异看起来正确时，选择差异视图顶部的Create PR。您可以将其作为完整 PR、草稿打开，或跳转到 GitHub 的撰写页面，其中包含生成的标题和描述。

4. 在 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 码。

---

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。