Appearance
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(远程控制) 更合适。
会话是如何运行的
当你提交一个任务时:
- 克隆和准备:你的仓库被克隆到 Anthropic 托管的 VM,如果配置了安装脚本则会执行
- 配置网络:根据你环境的访问级别设置互联网访问权限
- 工作:Claude 分析代码、进行修改、运行测试并检查自己的工作。你可以全程观察和引导,或者离开等它做完再回来
- 推送分支:当 Claude 达到一个停顿点时,它会将分支推送到 GitHub。你可以审查 diff、留下行内评论、创建 PR,或者发送另一条消息让它继续
推送分支后会话不会关闭。创建 PR 和进一步的修改都在同一个对话中进行。
比较不同运行方式
Claude Code 在各处的行为是一致的,区别在于代码在哪里执行,以及是否能使用你的本地配置。Desktop 桌面版同时提供本地和云端会话。
| Web 版 | Remote Control | 终端 CLI | Desktop 桌面版 | |
|---|---|---|---|---|
| 代码运行在 | Anthropic 云端 VM | 你的机器 | 你的机器 | 你的机器 或 云端 VM |
| 聊天界面 | claude.ai 或移动 App | claude.ai 或移动 App | 你的终端 | Desktop UI |
| 使用本地配置 | 否,仅仓库 | 是 | 是 | 本地会话是,云端会话否 |
| 需要 GitHub | 是,或通过 --remote 打包本地仓库 | 否 | 否 | 仅云端会话需要 |
| 断开连接继续运行 | 是 | 仅终端保持开启时 | 否 | 取决于会话类型 |
| 权限模式 | Auto accept edits, Plan | Ask, Auto accept edits, Plan | 所有模式 | 取决于会话类型 |
| 网络访问 | 可按环境配置 | 你机器的网络 | 你机器的网络 | 取决于会话类型 |
关于其他方式的设置,请参阅终端快速开始、Desktop 桌面版 或 Remote Control 文档。
连接 GitHub 并创建环境
设置是一次性的过程。如果你已经在使用 GitHub CLI,可以从终端完成而无需打开浏览器。
在浏览器中配置:
- 访问 claude.ai/code
- 按照屏幕提示授权 GitHub 访问(允许克隆和推送代码)
- 创建一个云端环境,这决定了会话运行时的网络、环境变量等配置
从终端连接
如果你已经在使用 GitHub CLI(gh),你可以不打开浏览器就完成设置。这需要先安装 Claude Code CLI。
运行 /web-setup 会读取你本地的 gh token,将其链接到你的 Claude 账号,并在你没有云端环境时创建一个默认的。
启动任务
GitHub 连接并创建好环境后,就可以提交任务了。
- 在 claude.ai/code 选择仓库和分支
- 输入提示语(如 "Fix the alignment issue on the pricing page")
- 提交任务,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 的浏览器以获得最佳体验。需要稳定的网络连接,不支持离线使用。