Skip to content

Web 版快速开始(Claude Code on the web)

Claude Code on the web 让你的开发任务运行在 Anthropic 托管的云端基础设施上,而非本地机器。通过浏览器(claude.ai/code)或移动 App 提交任务,Claude 在隔离的 VM 中克隆 GitHub 仓库、修改代码并推送分支供你审查。适合多任务并行、免本地环境配置的探索,以及用手机碎片时间进行 Code Review。

Claude Code on the web 在 Anthropic 托管的云端基础设施上运行,而不是你的本地机器。你可以从浏览器(claude.ai/code)或 Claude 移动 App 提交任务。

你需要一个 GitHub 仓库才能开始使用。Claude 会将其克隆到隔离的虚拟机中,进行修改,并推送一个分支供你审查。会话跨设备持久化,所以你在笔记本上开始的任务,晚点可以在手机上审查。

Claude Code on the web 适合这些场景

  • 并行任务:同时运行多个独立任务,每个任务有自己的会话和分支,无需管理多个本地 worktree
  • 本地没有的仓库:Claude 每次会话都会全新克隆仓库,你无需在本地检出
  • 无需频繁干预的任务:提交一个定义明确的任务,去做别的事,等 Claude 完成后再来审查结果
  • 代码探索和答疑:无需本地检出即可理解代码库或追踪特性实现

如果任务需要你本地的配置、工具或环境,在本地运行 Claude Code 或使用 Remote Control(远程控制) 更合适。


会话是如何运行的

当你提交一个任务时:

  1. 克隆和准备:你的仓库被克隆到 Anthropic 托管的 VM,如果配置了安装脚本则会执行
  2. 配置网络:根据你环境的访问级别设置互联网访问权限
  3. 工作:Claude 分析代码、进行修改、运行测试并检查自己的工作。你可以全程观察和引导,或者离开等它做完再回来
  4. 推送分支:当 Claude 达到一个停顿点时,它会将分支推送到 GitHub。你可以审查 diff、留下行内评论、创建 PR,或者发送另一条消息让它继续

推送分支后会话不会关闭。创建 PR 和进一步的修改都在同一个对话中进行。


比较不同运行方式

Claude Code 在各处的行为是一致的,区别在于代码在哪里执行,以及是否能使用你的本地配置。Desktop 桌面版同时提供本地和云端会话。

Web 版Remote Control终端 CLIDesktop 桌面版
代码运行在Anthropic 云端 VM你的机器你的机器你的机器 或 云端 VM
聊天界面claude.ai 或移动 Appclaude.ai 或移动 App你的终端Desktop UI
使用本地配置否,仅仓库本地会话是,云端会话否
需要 GitHub是,或通过 --remote 打包本地仓库仅云端会话需要
断开连接继续运行仅终端保持开启时取决于会话类型
权限模式Auto accept edits, PlanAsk, Auto accept edits, Plan所有模式取决于会话类型
网络访问可按环境配置你机器的网络你机器的网络取决于会话类型

关于其他方式的设置,请参阅终端快速开始Desktop 桌面版Remote Control 文档。


连接 GitHub 并创建环境

设置是一次性的过程。如果你已经在使用 GitHub CLI,可以从终端完成而无需打开浏览器。

在浏览器中配置

  1. 访问 claude.ai/code
  2. 按照屏幕提示授权 GitHub 访问(允许克隆和推送代码)
  3. 创建一个云端环境,这决定了会话运行时的网络、环境变量等配置

从终端连接

如果你已经在使用 GitHub CLI(gh),你可以不打开浏览器就完成设置。这需要先安装 Claude Code CLI

运行 /web-setup 会读取你本地的 gh token,将其链接到你的 Claude 账号,并在你没有云端环境时创建一个默认的。


启动任务

GitHub 连接并创建好环境后,就可以提交任务了。

  1. 在 claude.ai/code 选择仓库和分支
  2. 输入提示语(如 "Fix the alignment issue on the pricing page")
  3. 提交任务,Claude 开始分配 VM 和克隆代码

预填充会话 URL

你可以通过向 claude.ai/code URL 添加查询参数来预填充新会话的提示语、仓库和环境。这可用于构建集成,例如在工单系统中加一个按钮,点击后直接用工单描述作为提示语打开 Claude Code。

参数说明
prompt预填充到输入框的提示语文本。也接受别名 q
prompt_url提示语过长无法放入查询字符串时,从该 URL 获取。URL 必须允许跨域请求。当 prompt 也设置时被忽略。
repositories逗号分隔的 owner/repo 列表以预选仓库。也接受别名 repo
environment要预选的环境名称或 ID。

请对每个值进行 URL 编码。下面的示例打开一个表单,其中预填了提示语并预选了仓库:

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

审查与迭代

当 Claude 完成时,审查变更,对特定代码行留下反馈,并继续迭代直到 diff 看起来符合预期。

  • 可以在变更视图直接点击代码行添加评论
  • 要求 Claude 根据评论修改,或者如果你觉得 OK,直接创建 Pull Request
  • 创建 PR 后,后续沟通和提交仍在同一个会话流中处理

常见问题

Q: Web 版 Claude Code 和命令行版本有什么区别?

A: Web 版在浏览器中运行,无需安装,适合快速上手或在没有终端环境的机器上使用。命令行版本功能更完整,支持本地文件访问、Hooks、本地 MCP 服务器等。两者的核心 AI 能力相同。

Q: 在 claude.ai/code 上创建的项目可以和本地 Claude Code 共享吗?

A: 可以通过 GitHub 仓库连接实现共享——在 Web 版中连接同一个 GitHub 仓库,本地和 Web 都能访问相同的代码。但本地配置文件(如 settings.json、Hooks)不会自动同步到 Web 版。

Q: Web 版 Claude Code 需要什么浏览器?

A: 支持 Chrome、Firefox、Safari、Edge 等主流现代浏览器。推荐使用 Chrome 或基于 Chromium 的浏览器以获得最佳体验。需要稳定的网络连接,不支持离线使用。