传统 Claude Code 运行在你本地:关掉终端,任务就停了。Claude Code 网页版不同——任务运行在 Anthropic 管理的云端,关掉浏览器、合上笔记本,任务继续跑,手机 App 还能实时监控进度。
网页版 vs 本地版核心区别
| 本地 CLI | 网页版 | |
|---|---|---|
| 运行位置 | 你的机器 | Anthropic 云端 VM |
| 关掉终端 | 任务停止 | 任务继续 |
| 手机监控 | 需要 Remote Control | 直接用 Claude App |
| 工具环境 | 你自己的环境 | 预装开发工具的标准 VM |
| 凭证/密钥 | 本地 .env | 需要在环境设置里配置 |
适合网页版的场景:
- 长时间跑的任务(几十分钟以上)
- 需要在不同设备之间切换监控
- CI/CD 风格的自动化任务
- 不想污染本地环境的实验性任务
快速开始
访问 claude.ai/code,登录,连接 GitHub,选择仓库,提交第一个任务。
云端环境里有什么?
每个会话在一个全新的 Anthropic VM 里运行,克隆你的代码仓库后开始工作:
| 类别 | 预装内容 |
|---|---|
| Python | Python 3.x、pip、poetry、uv、pytest、mypy、ruff |
| Node.js | 20/21/22(via nvm)、npm、yarn、pnpm、eslint、prettier |
| Ruby | 3.1/3.2/3.3、gem、bundler |
| Java | OpenJDK 21、Maven、Gradle |
| Go | 最新稳定版 |
| Rust | rustc、cargo |
| 数据库 | PostgreSQL 16、Redis 7.0(已安装,默认未启动) |
| 容器 | Docker、docker compose |
| 工具 | git、jq、ripgrep、tmux、vim |
资源限制:4 vCPU、16 GB RAM、30 GB 磁盘。
哪些配置会同步到云端?
云端会话从仓库克隆开始,只有提交到 git 里的配置才有效:
| 配置 | 在云端可用? | 原因 |
|---|---|---|
| 仓库里的 CLAUDE.md | ✅ | 随仓库克隆 |
| .claude/settings.json(Hooks 等) | ✅ | 随仓库克隆 |
| .mcp.json MCP 服务器 | ✅ | 随仓库克隆 |
| .claude/skills/ 技能 | ✅ | 随仓库克隆 |
| 你本机的 ~/.claude/CLAUDE.md | ❌ | 只在本机 |
用 claude mcp add 添加的 MCP | ❌ | 写在本机 user config |
| .env 里的密钥 | ❌ | 不在仓库里 |
经验:团队共用的配置(CLAUDE.md、hooks、MCP 服务器)都应该提交到仓库,这样云端会话和本地会话行为一致。
Setup Scripts:安装云端需要但本地已有的工具
本地已经装好了的工具(如特定 CLI),云端 VM 可能没有。用 Setup Script 在会话启动时安装:
在环境设置里的 Setup script 字段填入:
#!/bin/bash
# 安装 gh CLI(云端默认没有)
apt update && apt install -y gh
# 安装项目特定工具
curl -fsSL https://get.example.com/tool | bashSetup Script vs SessionStart Hook 的区别:
| Setup Script | SessionStart Hook | |
|---|---|---|
| 在哪配置 | 云端环境 UI | 仓库 .claude/settings.json |
| 什么时候跑 | 会话创建前 | 会话启动后 |
| 在哪跑 | 只在云端 | 云端 + 本地都跑 |
只需要在云端跑的逻辑(如安装工具),放 Setup Script;本地和云端都需要的逻辑(如 npm install),放 SessionStart Hook,并在脚本里检查是否在云端:
#!/bin/bash
# 只在云端环境里运行
if [ "${CLAUDE_CODE_REMOTE}" != "true" ]; then
exit 0
fi
npm install
pip install -r requirements.txt网络访问控制
每个环境可以设置网络访问级别:
| 级别 | 允许的出站连接 |
|---|---|
| None | 无网络访问 |
| Trusted | 预设白名单:npm、PyPI、RubyGems、GitHub、常用云 SDK |
| Full | 任意域名 |
| Custom | 自定义域名白名单 |
大多数项目用 Trusted 就够了。需要访问内部服务时选 Custom 并添加域名。
Auto-fix:PR 收到评论自动修复
这是网页版的杀手级功能——在 GitHub PR 上收到 review 评论或 CI 失败,Claude 自动启动会话修复,完成后推送新 commit。
开启条件:需要安装 GitHub App(不是用 /web-setup 授权的方式,因为 Auto-fix 需要接收 PR webhook)。
适合场景:
- CI 失败时自动修复(如 lint 错误、测试失败)
- 收到「请修一下这里的 typo」类型的 review 评论
- 规范性修改(如统一代码风格)
本地和网页版之间切换
任务在云端跑,但你想在本地继续?两个命令:
# 从终端启动云端会话(不需要打开浏览器)
claude --remote
# 把正在云端跑的会话拉到本地继续
claude --teleport <session-id>同一个任务可以无缝在云端和本地之间切换。
手机 App 监控
任务在云端跑时,Claude App(iOS/Android)可以:
- 实时查看任务进度
- 在任务需要确认时收到通知并响应
- 查看完成结果
- 用 Dispatch 从手机启动新任务发到桌面端
常见注意事项
密钥和凭证:目前没有专用的 Secrets Store。如果任务需要 API Key,在环境设置里加环境变量,注意所有有环境编辑权限的人都能看到。
交互式认证:不支持需要浏览器弹窗的认证(如 AWS SSO),因为云端 VM 没有浏览器。用 API Token 替代。
会话不持久化:每个新会话从全新 VM 开始。用 Setup Script 或 SessionStart Hook 安装依赖,不要手动在会话里安装后期望下次还在。
来源:Claude Code 网页版官方文档 | 整理:ClaudeEagle