Claude Code 平台集成
Claude Code 平台集成
网页版快速开始
3 分钟阅读
开始使用 Claude Code 网页版
在浏览器或手机中通过云端运行 Claude Code。连接 GitHub 仓库，提交任务，无需本地设置即可审阅 PR。
Claude Code 网页版面向 Pro、Max 和 Team 用户，以及拥有高级席位或 Chat + Claude Code 席位的 Enterprise 用户开放研究预览。
Claude Code 网页版运行在 Anthropic 托管的云基础设施上，而非您的本地机器。您可以通过浏览器访问 claude.ai/code 或使用 Claude 移动应用提交任务。
您需要一个 GitHub 仓库才能开始。Claude 会将仓库克隆到隔离的虚拟机中，进行修改，并推送一个分支供您审阅。会话跨设备持久化，因此您在笔记本上开始的任务稍后可以在手机上继续审阅。
Claude Code 网页版特别适用于：
- 并行任务：同时运行多个独立任务，每个任务在各自的会话和分支中，无需管理多个工作树
- 本地没有的仓库：Claude 每次会话都会重新克隆仓库，因此您无需提前检出
- 不需要频繁干预的任务：提交一个定义明确的任务，去做其他事情，等 Claude 完成后再审阅结果
- 代码问题与探索：无需本地检出即可理解代码库或追踪功能实现方式
对于需要使用本地配置、工具或环境的工作，在本地运行 Claude Code 或使用 Remote Control 更为合适。
会话如何运行
提交任务时：
- 克隆与准备：您的仓库被克隆到 Anthropic 托管的虚拟机中，如果配置了设置脚本，则会运行该脚本。
- 配置网络：根据环境的访问级别设置互联网访问权限。
- 工作：Claude 分析代码、进行修改、运行测试并检查工作。您可以全程观看和引导，也可以离开，等完成后再回来。
- 推送分支：当 Claude 到达停止点时，它会将分支推送到 GitHub。您审阅差异、在行内留言、创建 PR，或发送另一条消息以继续工作。
推送分支后会话不会关闭。PR 创建和进一步编辑都在同一次对话中进行。
Claude Code 运行方式对比
Claude Code 在任何地方的行为都相同。变化的是代码执行的位置以及本地配置是否可用。桌面应用同时提供本地和云端会话，因此下表中的答案取决于您选择哪种方式：
| 网页版 | Remote Control | 终端 CLI | 桌面应用 | |
|---|---|---|---|---|
| 代码运行位置 | Anthropic 云虚拟机 | 您的机器 | 您的机器 | 您的机器或云虚拟机 |
| 聊天位置 | claude.ai 或移动应用 | claude.ai 或移动应用 | 您的终端 | 桌面 UI |
| 使用本地配置 | 否，仅仓库 | 是 | 是 | 本地会话是，云端否 |
| 需要 GitHub | 是，或通过 --cloud 打包本地仓库 | 否 | 否 | 仅云端会话需要 |
| 断开连接后保持运行 | 是 | 终端保持打开时 | 否 | 取决于会话类型 |
| 权限模式 | 接受编辑、计划、自动 | 手动、接受编辑、计划 | 所有模式 | 取决于会话类型 |
| 网络访问 | 按环境配置 | 您机器的网络 | 您机器的网络 | 取决于会话类型 |
请参阅终端快速入门、桌面应用或 Remote Control 文档进行设置。
连接 GitHub 并创建环境
设置是一次性过程。如果您已使用 GitHub CLI，可以从终端完成，无需打开浏览器。
访问 claude.ai/code
前往 claude.ai/code 并使用您的 Anthropic 账户登录。
安装 Claude GitHub App
登录后，claude.ai/code 会提示您连接 GitHub。按照提示安装 Claude GitHub App 并授权其访问您的仓库。云端会话使用现有的 GitHub 仓库，因此若要开始新项目，请先在 GitHub 上创建一个空仓库。
创建环境
连接 GitHub 后，系统会提示您创建云端环境。该环境控制 Claude 在会话期间拥有的网络访问权限，以及每次创建新会话时运行的内容。有关无需任何配置即可使用的内容，请参阅已安装工具。
表单包含以下字段：
- 名称：显示标签。当您为不同项目或访问级别拥有多个环境时非常有用。
- 网络访问：控制会话可以访问的互联网内容。默认选项
Trusted允许连接到 常用包注册表，如 npm、PyPI 和 RubyGems，同时阻止一般互联网访问。 - 环境变量：每个会话中可用的可选变量，使用
.env格式。不要将值用引号包裹，因为引号会作为值的一部分存储。任何可以编辑此环境的人都能看到这些变量。 - 设置脚本：在 Claude Code 启动前运行的可选 Bash 脚本。用于安装云虚拟机未包含的系统工具，如
apt install -y gh。结果会被缓存，因此脚本不会在每个会话中重新运行。有关示例和调试技巧，请参阅设置脚本。
对于第一个项目，保持默认设置并点击创建环境。您可以稍后编辑或创建其他环境以用于不同项目。
从终端连接
如果您已使用 GitHub CLI (gh)，可以无需打开浏览器即可设置 Claude Code 网页版。这需要 Claude Code CLI。/web-setup 会读取您本地的 gh 令牌，将其关联到您的 Claude 账户，并在您没有云端环境时创建一个默认环境。
启用了零数据保留的组织无法使用 /web-setup 或其他云端会话功能。如果未安装或未认证 GitHub CLI，/web-setup 将打开浏览器引导流程。
使用 GitHub CLI 认证
在您的 shell 中，如果尚未认证，请认证 GitHub CLI：
登录 Claude
在 Claude Code CLI 中，运行 /login 使用您的 claude.ai 账户登录。如果已登录，请跳过此步骤。
开始任务
连接 GitHub 并创建环境后，您就可以提交任务了。
选择仓库和分支
从 claude.ai/code 或 Claude 移动应用的 Code 标签页，点击输入框下方的仓库选择器，选择 Claude 要处理的仓库。每个仓库都显示一个分支选择器。将其更改为您想从功能分支而非默认分支开始。您可以添加多个仓库，以在一个会话中跨仓库工作。
选择权限模式
输入框旁边的模式下拉框默认为接受编辑，Claude 会在不停止等待批准的情况下进行修改并推送分支。如果您希望 Claude 先提出方案并在编辑文件前等待您批准，请切换到计划模式。云端会话不提供手动或绕过权限。有关每个模式的详细说明，请参阅完整的权限模式列表。
描述任务并提交
输入您想要的任务描述，然后按 Enter。请尽量具体：
- 指定文件或函数："添加包含设置说明的 README" 或 "修复
tests/test_auth.py中失败的认证测试" 比 "修复测试" 更好 - 如果有错误输出，请粘贴
- 描述预期行为，而不仅仅是症状
Claude 会克隆仓库，如果配置了设置脚本则运行该脚本，然后开始工作。每个任务都有自己的会话和分支，因此您无需等待一个完成后再开始另一个。
预填充会话
您可以通过向 claude.ai/code URL 添加查询参数，为新会话预填充提示词、仓库和环境。使用此功能可以构建集成，例如在问题跟踪器中放置一个按钮，打开 Claude Code 并将问题描述作为提示词。
| 参数 | 描述 |
|---|---|
prompt | 预填充到输入框中的提示词文本。别名 q 同样可用。 |
prompt_url | 用于获取提示词文本的 URL，适用于提示词过长无法嵌入查询字符串的情况。该 URL 必须允许跨域请求。当同时设置了 prompt 时，此参数被忽略。 |
repositories | 要预选 owner/repo 的逗号分隔列表。别名 repo 同样可用。 |
environment | 要预选的环境的名称或 ID。 |
对每个值进行 URL 编码。下面的示例打开表单时已经预选了一个提示词和一个仓库：
审阅与迭代
Claude 完成后，审阅更改，对特定行留下反馈，并持续迭代直到差异看起来正确。
打开差异视图
差异指示器显示整个会话中添加和删除的行数，例如 +42 -18。点击它打开差异视图，左侧是文件列表，右侧是更改内容。
留下行内评论
在差异中选择任意一行，输入您的反馈，然后按 Enter。评论会排队，直到您发送下一条消息，然后它们会与该消息一起打包发送。Claude 会看到 "在 src/auth.ts:47，不要在这里捕获错误" 以及您的主要指令，因此您无需描述问题所在。
创建 Pull Request
当差异看起来正确时，在差异视图顶部选择创建 PR。您可以将其作为完整 PR、草稿打开，或跳转到 GitHub 的撰写页面，其中包含生成的标题和描述。
在 PR 后持续迭代
创建 PR 后会话保持活跃。将 CI 失败输出或审阅者评论粘贴到聊天中，让 Claude 处理。要让 Claude 自动监控 PR，请参阅自动修复 Pull Request。
排查设置问题
连接 GitHub 后未显示仓库
云端会话可以使用已连接 GitHub 账户可见的任何仓库，无论 Claude GitHub App 安装在哪些仓库上。如果缺少某个仓库，请确认已连接的 GitHub 账户在 GitHub 上对其有访问权限。如果您还希望某个仓库启用自动修复，请在该仓库上安装 App：在 github.com 上，打开 Settings → Applications → Claude → Configure，并确认该仓库列在 Repository access 下。私有仓库与公共仓库需要相同的授权。
页面仅显示 GitHub 登录按钮
云端会话需要已连接的 GitHub 账户。通过上述浏览器流程连接，或者如果您使用 GitHub CLI，请从终端运行 /web-setup。如果您根本不想连接 GitHub，请参阅 Remote Control，在您自己的机器上运行 Claude Code 并从网页监控。
"对所选组织不可用"
Enterprise 组织可能需要所有者启用 Claude Code 网页版。请联系您的 Anthropic 账户团队。
/web-setup 显示 "No commands match" 或 "Unknown command"
/web-setup 在 Claude Code CLI 内部运行，而非您的 shell。先启动 claude，然后在提示符处输入 /web-setup。
如果您在 Claude Code 内部输入了该命令，但命令菜单显示 No commands match "/web-setup"，或提交后返回 Unknown command: /web-setup，则该命令因未满足某个要求而被隐藏。原因通常是您的 CLI 版本低于 v2.1.80，或者您使用 API 密钥或第三方提供商而非 claude.ai 订阅进行认证。运行 claude update，然后 /login 使用您的 claude.ai 账户登录。
使用 --cloud 或 ultraplan 时显示 "Could not create a cloud environment" 或 "No cloud environment available"
远程会话功能会在您没有云端环境时自动创建一个默认环境。如果您看到 "Could not create a cloud environment"，则自动创建失败。如果您看到 "No cloud environment available"，则您的 CLI 版本早于自动创建功能。无论哪种情况，请在 Claude Code CLI 中运行 /web-setup 手动创建一个，或访问 claude.ai/code 并按照上述创建环境步骤操作。
设置脚本失败
设置脚本以非零状态退出，这会阻止会话启动。常见原因：
- 包安装失败，因为注册表不在您的网络访问级别中。
Trusted涵盖大多数包管理器；None会阻止所有访问。 - 脚本引用了在全新克隆中不存在的文件或路径。
- 一个在本地有效的命令在 Ubuntu 上需要不同的调用方式。
要调试，请在脚本顶部添加 set -x 以查看哪个命令失败。对于非关键命令，追加 || true 以免它们阻止会话启动。
新会话在设置期间卡住或超时
如果新会话在设置脚本步骤停滞，或在脚本完成前因通用容器错误而失败，则脚本可能超出了构建环境缓存的大约五分钟时间预算。拉取大型 Docker 镜像、同步完整依赖树或下载模型权重等繁重步骤通常会超出限制，尤其是当它们依次运行时。
要解决此问题，请精简脚本，使其能在五分钟内可靠完成：
- 使用
&和最后的wait并行运行独立安装，而不是串行运行。 - 将最大的下载从设置脚本移到在后台启动的 SessionStart 钩子中，以便会话在它们完成时即可使用。
- 从设置脚本中移除长时间重试睡眠，因为停滞的重试循环会计入预算。
关闭标签页后会话仍在运行
这是设计如此。关闭标签页或导航离开不会停止会话。它会在后台继续运行，直到 Claude 完成当前任务，然后进入空闲状态。在侧边栏中，您可以归档会话以将其从列表中隐藏，或删除会话以永久移除。
后续步骤
现在您可以提交和审阅任务了，以下页面涵盖了后续内容：从终端启动云端会话、安排定期工作，以及给 Claude 持久指令。
- 使用 Claude Code 网页版：完整参考，包括将会话传送到终端、设置脚本、环境变量和网络配置
- 定期任务：按时间表、通过 API 调用或响应 GitHub 事件自动化工作
- CLAUDE.md：给 Claude 持久指令和上下文，在每次会话开始时加载
- 安装 Claude 移动应用，支持 iOS 或 Android，以便从手机监控会话。在 Claude Code CLI 中，
/mobile会显示一个二维码。