Claude Code on the Web（Web 端）

是什么

Claude Code on the Web 在 Anthropic 托管的云端 VM 上运行任务，通过 claude.ai/code 访问。会话在关闭浏览器后继续运行，可从移动端监控进度。适合不需要频繁干预的长时间任务、并行多任务，以及处理本地没有克隆的仓库。

核心机制

云端环境：每个会话在独立 VM 中运行，从 GitHub 克隆仓库。预装了 Python、Node.js（20/21/22）、Ruby、PHP、Java、Go、Rust、Docker、PostgreSQL、Redis 等常用工具。

GitHub 认证：

• GitHub App（推荐）：通过 Web 界面授权，支持 PR Auto-fix
• /web-setup：在终端运行，同步本地 gh CLI token

Setup Script：在会话启动前运行的 Bash 脚本，用于安装额外依赖。结果会被缓存（约 7 天），后续会话直接使用缓存，不重新安装。

网络访问级别：

• None：无网络
• Trusted（默认）：允许常见包注册表（npm、PyPI、RubyGems 等）
• Custom：自定义域名白名单
• Full：完全访问

会话迁移：

• 终端 → Web：claude --remote "Fix the auth bug"（从 GitHub 克隆当前分支）
• Web → 终端：claude --teleport（拉取云端会话和分支到本地）

Auto-fix PR：启用后 Claude 自动监控 PR 的 CI 失败和审查意见，自动推送修复。需要安装 Claude GitHub App。

关键细节

• 云端会话只能访问仓库中提交的配置（CLAUDE.md、.mcp.json、settings.json），不使用本地 ~/.claude/ 配置
• --remote 需要先推送本地提交（VM 从 GitHub 克隆，不是从本机）
• --teleport 需要干净的工作目录（无未提交变更）
• 资源限制：4 vCPUs、16GB RAM、30GB 磁盘
• 环境变量用 .env 格式（不加引号），对能编辑环境的人可见
• CLAUDE_CODE_REMOTE=true 环境变量标识云端会话，可在 SessionStart hook 中判断

关联

• web-quickstart — Web 端快速入门（连接 GitHub、创建环境、提交任务）
• remote-control — 远程控制本地会话（代码在本机运行）
• platforms-overview — 各平台对比
• memory — 云端会话中 CLAUDE.md 的加载规则

实践要点

• 本地计划，云端执行：用 plan 模式制定方案，提交到仓库，再用 --remote 执行
• 并行任务：多个 --remote 命令创建独立会话，同时运行
• Setup Script 控制在 5 分钟内，超时会导致会话启动失败
• 不需要 GitHub 时可用 CCR_FORCE_BUNDLE=1 打包本地仓库上传（限 100MB）
• Auto-fix 会以你的 GitHub 账户名回复 PR 评论，注意触发自动化工作流的风险