是什么
Claude Code Web 端的快速入门指南,介绍如何在浏览器中无需本地安装即可运行 Claude Code。适合并行多任务、处理本地没有克隆的仓库,以及不需要频繁干预的长时间任务。
核心机制
首次设置(一次性):
- 访问 claude.ai/code 并登录
- 安装 Claude GitHub App,授权访问仓库
- 创建云端环境(配置网络访问级别、环境变量、Setup Script)
或者通过终端设置(已有 gh CLI 的用户):
gh auth login # 先认证 GitHub CLI
# 在 Claude Code CLI 中:
/web-setup # 同步 gh token 到 Claude 账户提交任务流程:
- 选择仓库和分支
- 选择权限模式(Auto accept edits 或 Plan mode)
- 描述任务并提交
审查和迭代:
- 点击
+42 -18差异指示器打开 Diff 视图 - 点击任意行添加行级注释
- 注释会在下次发送消息时一起提交给 Claude
- 点击「Create PR」创建拉取请求(支持正式 PR、草稿 PR 或跳转到 GitHub 编辑页)
会话管理:
- 关闭标签页不会停止会话,任务继续在后台运行
- 归档会话:悬停在侧边栏会话上,点击归档图标
- 删除会话:永久删除,不可恢复
关键细节
- Web 端只支持 Auto accept edits 和 Plan mode,不支持 Ask permissions、Auto mode 和 Bypass permissions
- 云端会话只能访问仓库中提交的配置,不使用本地
~/.claude/配置 - 可通过 URL 参数预填充任务:
https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp - 会话共享:Team/Enterprise 可设为团队可见,Pro/Max 可设为公开(注意检查敏感内容)
关联
- claude-code-on-the-web — Web 端完整参考(环境配置、网络访问、会话迁移)
- remote-control — 远程控制本地会话(代码在本机运行)
- platforms-overview — 各平台对比
实践要点
- 任务描述要具体:「Fix the failing auth test in tests/test_auth.py」优于「fix tests」
- 提交任务后可以做其他事,Claude 完成后在移动端查看结果
- 每个任务创建独立会话和分支,可以同时运行多个任务
- PR 创建后会话仍保持活跃,可继续处理 CI 失败或审查意见
- Setup Script 超时(5分钟)会导致会话启动失败,用
set -x调试