Codex Cloud：使用云端模式

Codex Cloud 是一种不依赖本地环境的使用方式。你不需要在自己电脑上打开 App 或 CLI，直接在浏览器里连接 GitHub 仓库，让 Codex 在云端完成任务。

提示

CLI 的使用方式见 CLI 安装与登录，IDE 插件见 在 VS Code 中使用 Codex，桌面 App 的使用见 Codex 桌面 App 下载与安装。

这节解决什么

Cloud 模式解决的是“任务需要跑一段时间、依赖 GitHub 仓库、我不想占用本机环境”的问题。它不是桌面 App 的替代品，而是另一种执行位置。

你可以把它理解成：你在浏览器里分派任务，Codex 在云端环境里读仓库、执行步骤、整理结果，必要时生成 PR 或说明修改建议。

适合谁

这一节适合：

• 已经把代码或文档放在 GitHub 仓库里的人。
• 想让 Codex 分析远程仓库、整理 issue、生成 PR 草案的人。
• 本地电脑不方便长时间跑任务，但希望任务继续推进的人。
• 团队需要把 AI 协作接入 GitHub 工作流的人。

如果任务依赖本机私有文件、桌面软件、局域网服务或本地密钥，优先使用桌面 App 或 CLI。

适合场景

• 较长的任务，不想占用本地资源
• 多个任务并行推进
• 让 Codex 在独立环境里分析仓库、提出 PR
• 不在电脑旁、只有浏览器时临时使用

先做什么

连接仓库前先确认：

1. 仓库里没有不该暴露的密钥、客户资料或私有文件。
2. 你知道要授权全部仓库，还是只授权特定仓库。
3. 任务可以通过云端仓库完成，不依赖本机 GUI 或本地服务。
4. 你知道完成后要看 diff、日志、测试结果或 PR 内容。

如何使用

第 1 步：打开 Codex Cloud

访问：https://chatgpt.com/codex/cloud

连接成功后会跳转到任务页面：

第 2 步：授权并选择仓库

Cloud 模式直接在 GitHub 仓库中运行，需要先完成授权。你可以授权全部仓库，也可以只选择特定仓库：

第 3 步：下达指令，查看任务进度

下达指令后，Codex 会在云端执行任务，进度显示在页面下方的任务列表里：

点击任务可以查看每一步的执行过程和中间状态。任务完成后也可以查看最终回答和产出内容：

---

与桌面 App 模式的区别

	Codex 桌面 App	Codex Cloud
运行环境	本地电脑	云端（GitHub 环境）
是否需要安装	需要下载电脑端客户端	不需要，浏览器直接访问
适合任务	本地代码、插件、自动化	远程仓库分析、PR 生成
并行任务	支持	支持

常见失败

现象	先检查什么	建议处理
找不到仓库	GitHub 授权范围	只授权需要的组织或仓库，再刷新
任务跑不起来	云端环境缺依赖或命令不明确	在仓库文档或 AGENTS.md 写清安装、测试、构建命令
结果和本地不一致	本地有未提交文件或私有配置	先提交必要上下文，或改用桌面 App / CLI
PR 改动太大	任务范围太宽	让 Codex 先只读分析，再拆小任务
无法判断是否完成	没有验收标准	要求输出命令、日志、diff、风险和后续人工检查

本节验收标准

完成这一节后，你应该能做到：

• 能说清 Cloud、桌面 App、CLI、IDE 的执行位置差异。
• 能安全地选择 GitHub 授权范围。
• 能给 Cloud 任务写清目标、仓库、范围和验收方式。
• 能查看云端任务过程、最终输出、diff 或 PR。
• 知道依赖本机文件、私有服务或桌面软件的任务不适合直接交给 Cloud。

下一步：排障手册