Claude Code 深度学习手册

主题

Web 版快速上手 ​

在浏览器或手机上从云端运行 Claude Code，连接 GitHub 仓库提交任务并审查 PR。

是什么 ​

Claude Code on the web 运行在 Anthropic 托管的云端基础设施上，而非你本机。你可以从浏览器的 claude.ai/code 或 Claude 手机 App 提交任务。Claude 会把你的 GitHub 仓库克隆进一台隔离的虚拟机，做出改动，再推送一个分支供你审查。

会话跨设备持久化：在笔记本上开始的任务，稍后可在手机上审查。它目前处于 research preview 阶段，面向 Pro、Max、Team 用户，以及拥有 premium seats 或 Chat + Claude Code seats 的 Enterprise 用户开放。

怎么工作 ​

  • Clone and prepare：把你的仓库克隆到 Anthropic 托管的 VM，若已配置则运行你的 setup script。
  • Configure network：根据环境的 access level 设定联网权限。
  • Work：Claude 分析代码、做出改动、运行测试并自查；你可以全程观察和引导，也可以离开后再回来。
  • Push the branch：到达停顿点时，Claude 把分支推送到 GitHub，供你审查 diff、留行内评论、创建 PR 或继续发消息。
  • 分支推送后会话不会关闭，创建 PR 和后续编辑都在同一对话内进行。
  • 每个任务有独立的 session 和独立分支，可并行运行多个任务而无需等待。

怎么配置 / 用法 ​

一次性设置，浏览器方式：

  1. 访问 claude.ai/code 并用 Anthropic 账号登录。
  2. 按提示安装 Claude GitHub App 并授权访问仓库（新项目需先在 GitHub 创建空仓库）。
  3. 创建 cloud environment（填写 Name / Network access / Environment variables / Setup script，首个项目用默认值即可，点 Create environment）。

终端方式（需已装 Claude Code CLI 和 GitHub CLI）：

bash
gh auth login

然后在 Claude Code CLI 内：

text
/login
/web-setup

/web-setup 会读取本地 gh token 关联到 Claude 账号，并在没有环境时创建一个默认 cloud environment。

什么时候用 ​

  • Parallel tasks：同时运行多个独立任务，各自独立 session 和分支，无需管理多个 worktree。
  • Repos you don't have locally：每次会话都重新克隆仓库，无需本地 checkout。
  • Tasks that don't need frequent steering：提交定义清晰的任务，去做别的事，完成后再回来审查。
  • Code questions and exploration：在没有本地 checkout 的情况下理解代码库或追踪某功能的实现。

限制 / 坑 ​

  • 需要 GitHub 仓库（或用 --remote 打包本地仓库）；纯 GitHub 登录页表示尚未连接 GitHub 账号。
  • 启用 Zero Data Retention 的组织无法使用 /web-setup 或其他云会话功能。
  • 云会话只支持 Auto accept edits 和 Plan 两种 permission mode，不支持 Ask、Auto 或 Bypass permissions。
  • setup script 大约有五分钟的时间预算，超时会导致新会话卡住或超时。
  • 需要本地配置、工具或环境的工作，更适合本机运行或用 Remote Control。

硬事实速查（12 条） ​

  • 处于 research preview，面向 Pro、Max、Team 及拥有 premium seats 或 Chat + Claude Code seats 的 Enterprise 用户。
  • 代码运行在 Anthropic cloud VM 上，从 claude.ai 或手机 App 聊天，不使用本机本地配置（仅用仓库）。
  • 入口为 claude.ai/code 或 Claude 手机 App 的 Code tab。
  • 断开连接（关闭标签页或离开）后会话仍在后台继续运行，直到 Claude 完成当前任务后转入空闲。
  • 可在 claude.ai/code URL 上加查询参数预填会话：prompt（别名 q）、prompt_url、repositories（别名 repo）、environment，各值需 URL 编码。
  • 默认网络 access level 为 Trusted，允许连接 npm、PyPI、RubyGems 等常见 package registries，同时屏蔽一般互联网访问；None 会屏蔽全部。
  • Environment variables 用 .env 格式填写，不要给值加引号（引号会被当作值的一部分）。
  • setup script 是会话启动前运行的可选 Bash 脚本（如 apt install -y gh），结果会被缓存，不会每次会话重跑。
  • 终端的 /web-setup 命令在 Claude Code CLI 内运行而非 shell；报 Unknown command 时 CLI 需 v2.1.80 以上，且需用 claude.ai 订阅登录而非 API key。
  • 可从终端用 --remote 启动云会话，用 /schedule（Routines）设置定期任务，用 /mobile 显示连接手机 App 的二维码。
  • 审查 diff 时可选行留行内评论，评论会与下一条消息打包发给 Claude；diff 满意后点 Create PR。
  • 可一次添加多个仓库以在单个会话中跨仓库工作。

官方出处：https://code.claude.com/docs/en/web-quickstart