SpyBara
Go Premium

web-quickstart.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 59 additions and 34 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Sat 19 23:57 Wed 23 23:57

在网络上开始使用 Claude Code

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

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

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

Claude Code on the web 适用于：

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

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

会话如何运行

下面的步骤描述了 Anthropic 托管的会话。在自托管环境中，克隆及其之后的所有操作都在您组织自己的运行器上运行，其中网络边界、设置和推送行为由操作员配置。当您提交任务时：

  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
代码运行在 Cloud VM，默认由 Anthropic 管理 您的机器 您的机器 您的机器或 cloud VM
您从以下位置聊天 claude.ai 或移动应用 claude.ai 或移动应用 您的终端 Desktop UI
使用您的本地配置 否，仅限仓库 是 是 本地为是，云为否
需要 GitHub 是，或通过 --cloud 捆绑本地仓库 否 否 仅限云会话
断开连接时继续运行 是 当终端保持打开时 否 取决于会话类型
权限模式 接受编辑、Plan、自动 询问、自动接受编辑、Plan 所有模式 取决于会话类型
网络访问 每个环境可配置 您的机器网络 您的机器网络 取决于会话类型

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

连接 GitHub

连接 GitHub 是一次性步骤。如果您已经使用 GitHub CLI，您可以从您的终端执行此操作而不是浏览器。

1

访问 claude.ai/code

转到 claude.ai/code 并使用您的 claude.ai 账户登录。在 macOS 或 Windows 上，第一个屏幕提供 Claude Code 桌面应用和其他安装 Claude Code 的方式。要留在浏览器中，请单击页面底部的Continue on web。

2

Sign in with GitHub

登录后，claude.ai/code 会提示您连接 GitHub。按照提示操作，claude.ai/code 会将您发送到 GitHub 的授权页面。批准授权请求，GitHub 会将您返回到 claude.ai/code。云会话适用于现有的 GitHub 仓库，可以访问您的 GitHub 账户可以看到的任何仓库。要启动新项目，请先在 GitHub 上创建一个空仓库。

当 Quick web setup 关闭时（在 Team 和 Enterprise 计划上默认关闭），claude.ai/code 会要求您在仓库上安装 Claude GitHub App，除非已经安装。如果您想要Auto-fix（允许 Claude 响应 CI 失败并审查这些仓库中的拉取请求注释），请安装它；否则单击Skip。无论哪种方式，会话都可以访问相同的仓库。

3

设置您的默认环境

云环境是保存的配置，控制 Claude 在会话期间可以访问的网络以及会话启动时运行的内容。连接 GitHub 后发生的情况取决于您的计划：

  • Pro 和 Max：入门流程为您创建一个名为Default的环境。
  • Team 和 Enterprise：入门流程显示Create your first cloud environment表单。保持预填充的名称和网络访问不变，单击Create & finish以创建Default环境。如果所有者已打开Quick web setup，入门流程会为您创建Default。

Default 使用Trusted 网络访问：会话可以访问常见包注册表和其他允许列表中的域，以及通过会话网络的其他任何内容。请参阅已安装的工具了解无需任何配置即可使用的内容。

对于第一个项目，Default 环境可以按原样使用。要更改其网络访问、添加环境变量或在会话启动前运行设置脚本，请编辑它或创建其他环境。

从您的终端连接

如果您已经使用 GitHub CLI (gh)，您可以在不打开浏览器的情况下设置 Claude Code on the web。这需要 Claude Code CLI。当您运行 /web-setup 时，Claude Code 读取您的本地 gh 令牌，将其链接到您的 claude.ai 账户，如果您没有云环境，则创建Default云环境。在 Team 和 Enterprise 计划上，/web-setup 仅在所有者打开Quick web setup后才可用。

1

使用 GitHub CLI 进行身份验证

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

gh auth login
2

登录到 Claude

在 Claude Code CLI 中，运行 /login 以使用您的 claude.ai 账户登录。如果您已经登录，请跳过此步骤。使用 API 密钥进行身份验证不计数。要检查，请运行 /status 并确认Login method行显示 claude.ai 账户。

3

运行 /web-setup

在 Claude Code CLI 中，运行：

/web-setup

这会将您的 gh 令牌同步到您的 Claude 账户。成功后，Claude Code 会打印 Connected as <your-github-username> 并在您的浏览器中打开 claude.ai/code。如果您还没有云环境，/web-setup 会创建一个具有 Trusted 网络访问和无设置脚本的环境。您可以稍后编辑环境或添加变量。一旦 /web-setup 完成，您可以从您的终端使用 --cloud 启动云会话，或使用 /schedule 设置定期任务。

开始任务

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

1

选择仓库和分支

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

2

选择权限模式

输入旁边的模式下拉菜单显示会话将在其中运行的模式：

  • Auto：分类器审查 Claude 的操作，而不是询问您。当您的组织允许自动模式且所选模型支持它时出现
  • Accept edits：Claude 进行更改并推送分支而无需停止以获得批准
  • Plan：Claude 提出方法并等待您批准后再编辑文件

云会话不提供 Manual 或 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 后没有仓库出现

云会话可以使用连接的 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` 说 "Not signed in to Claude"

如果 /web-setup 响应 "Not signed in to Claude. Run /login first."，CLI 没有有效的 claude.ai 登录。当之前的登录已过期时，也会发生这种情况。运行 /login，使用您的 claude.ai 账户登录，然后再次运行 /web-setup。

`/web-setup` 警告您的令牌没有 `workflow` 作用域

如果 /web-setup 说您的 GitHub CLI 令牌没有 workflow 作用域，您可以继续，但 GitHub 可能会拒绝使用该令牌进行的某些推送，例如更改 GitHub Actions 工作流文件的推送。要添加作用域，在您的 shell 中运行 gh auth refresh -s workflow，然后再次运行 /web-setup。

`/web-setup` 显示 "No commands match" 或 "Unknown command"

/web-setup 在 Claude Code CLI 内运行，而不是在您的 shell 中。首先启动 claude，然后在提示符处输入 /web-setup。

如果您在 Claude Code 内输入它，命令菜单显示 No commands match "/web-setup"，或提交它返回 Unknown command: /web-setup，该命令被隐藏是因为未满足要求。原因通常是您使用 API 密钥或第三方提供商而不是 claude.ai 订阅进行身份验证。运行 /login 以使用您的 claude.ai 账户登录。

在 Team 和 Enterprise 计划上，该命令默认被隐藏：快速网络设置切换关闭，直到所有者打开它。当它关闭时，从浏览器连接 GitHub 代替。当管理员为您的组织禁用 Claude Code on the web 时，或当您的 Enterprise 组织启用了零数据保留（这使 Claude Code on the web 不可用）时，该命令也被隐藏。

使用 `--cloud` 时出现 "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 的环境选择器添加环境。

设置脚本失败

设置脚本以非零状态退出，这会阻止会话启动。常见原因：

  • 包安装失败，因为注册表不在您的网络访问级别中。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 码。