CX-11 Codex Web / Cloud 辅助指南

CX 11 Codex Web / Cloud 辅助指南 CX 11 Codex Web / Cloud 辅助指南 Cloud 不是“更强的本地 App”。它缺少你的本机文件、GUI 状态和本地服务，必须靠远程仓库和 environment 复现。 ⠀ 4.1 App 转 Cloud 前的最小交接包 ⠀ 不要只写“帮我继续修”。给 Cloud 的任务要包含： ⠀ Code block Plain Text 仓库/分支：owner/repo 的 feature/login mobile 分支。 目标：修复登录页移动端按钮溢出。 范围：只改 src/pages/login.tsx、src/styles/login.css 和相关测试。 环境：使用 pnpm install frozen lockfile；验证 pnpm test login 和 pnpm lint。 限制：不要改认证逻辑，不要新增依赖，不要接触 secrets。 交付：打开 PR 或更新现有 PR，PR 描述包含 Summary / Verification / Risk。 ⠀ 这份交接包能减少 Cloud 因上下文不足而扩大改动。 ⠀ 5. Setup Script ⠀ Setup script 用来准备云端环境，例如： ⠀ Code block Plain Text npm ci npm run build ⠀ 原则： ⠀ • 短而稳定。 • 不写交互式命令。 • 不输出密钥。 • 失败时错误清晰。 • 与项目 README / AGENTS.md 保持一致。 ⠀ 6. Internet Access 与 Secrets ⠀ Cloud 任务可能需要联网或 secret。规则： ⠀ • 默认最小权限。 • 只给任务需要的 secret。 • 不把 secret 打印到日志。 • 不把生产写权限给调试任务。 • 定期轮换密钥。 ⠀ 7. App 到 Cloud 的接力 ⠀ 常见流程： ⠀ Code block Plain Text App 中发现问题 本地确认范围 创建 GitHub issue / PR Cloud 接手长时间修复或 CI 修复 回到 App 拉取分支 App Review 最终检查 ⠀ Cloud 是辅助执行，不是绕过 Review。 ⠀ 8. Cloud 回到 App 怎么验收 ⠀ Cloud 完成后，回到 App 做： ⠀ 1. 拉取远端分支或打开对应 PR。 2. 在 App Review 里看 diff。 3. 本地运行关键验证命令。 4. 检查 Cloud 是否改了范围外文件。 5. 检查 PR 描述和测试记录。 6. 决定是否继续让 App 修，还是回 Cloud 处理远程 CI。 ⠀ 不要因为 Cloud 任务“通过”就跳过本地 Review。 ⠀ 8.1 Cloud 回流的四个常见风险 ⠀ 风险 检查方式 云端环境和本机不同 本地重新跑关键命令 Cloud 改了范围外文件 App Review 查看文件列表 PR 描述过度乐观 对照 diff 和测试日志重写 Verification Secrets / 网络权限过宽 检查 environment 和 GitHub connector 权限 ⠀ Cloud 适合长任务，但最终合并仍然要回到 Review、测试和人工判断。 ⠀ 9. Web / Cloud 与 Automations ⠀ 需求 优先 本地项目周期检查 App Automation 远程仓库长任务 Cloud PR / CI 触发 GitHub / CI / Cloud 内部系统调度 SDK / 外部队列 ⠀ 不要用桌面 App 伪装 webhook server。 ⠀ 常见问题 ⠀ Q1：Cloud 能访问互联网吗？ ⠀ 取决于当前 environment 和官方能力。需要联网时显式配置并审查风险。 ⠀ Q2：Cloud 能用我的本机文件吗？ ⠀ 不能默认假设。Cloud 主要使用远程仓库和配置的环境。 ⠀ Q3：Cloud 任务完成后还要本地 Review 吗？ ⠀ 要。最终合并前仍要看 diff、测试和 PR。 📝 总结与检查清单 ⠀ 完成本课后，请确认以下所有项： ⠀ 理解Cloud是远程执行路径，不是本地App的替代品 知道什么任务适合Cloud（远程仓库、长任务、PR修复） 知道什么任务不适合Cloud（本机私有文件、GUI任务） 了解Environment、setup script、secrets的基本概念 Cloud完成后会回到App做本地Review 不因为Cloud"通过"就跳过本地Review ⠀ 如果以上全部勾选，恭喜你掌握Codex Web/Cloud辅助！ 附录 ⠀ A. App vs Cloud 对比 ⠀ 维度 App Web / Cloud 执行位置 本机 云端环境 主要对象 本地线程、worktree 远程仓库、PR 适合 本地开发、桌面多线程 长任务、远程PR ⠀ B. 推荐学习资源 ⠀ • Codex Cloud 官方文档：https://developers.openai.com/codex/cloud • 本系列上一篇：CX 10 Review / GitHub / PR • 本系列下一篇：CX 12 CLI 辅助 课程制作：老金 最后更新：2026年5月30日 许可：本课程采用CC BY NC SA 4.0许可 下一步 ⠀ 下一篇：CX 12 CLI 辅助指南。 Cloud 不是“更强的本地 App”。它缺少你的本机文件、GUI 状态和本地服务，必须靠远程仓库和 environment 复现。 ⠀ 4.1 App 转 Cloud 前的最小交接包 ⠀ 不要只写“帮我继续修”。给 Cloud 的任务要包含： ⠀ ⠀ 这份交接包能减少 Cloud 因上下文不足而扩大改动。 ⠀ 5. Setup Script ⠀ Setup script 用来准备云端环境，例如： ⠀ ⠀ 原则： ⠀ • 短而稳定。 • 不写交互式命令。 • 不输出密钥。 • 失败时错误清晰。 • 与项目 README / AGENTS.md 保持一致。 ⠀ 6. Internet Access 与 Secrets ⠀ Cloud 任务可能需要联网或 secret。规则： ⠀ • 默认最小权限。 • 只给任务需要的 secret。 • 不把 secret 打印到日志。 • 不把生产写权限给调试任务。 • 定期轮换密钥。 ⠀ 7. App 到 Cloud 的接力 ⠀ 常见流程： ⠀ ⠀ Cloud 是辅助执行，不是绕过 Review。 ⠀ 8. Cloud 回到 App 怎么验收 ⠀ Cloud 完成后，回到 App 做： ⠀ 1. 拉取远端分支或打开对应 PR。 2. 在 App Review 里看 diff。 3. 本地运行关键验证命令。 4. 检查 Cloud 是否改了范围外文件。 5. 检查 PR 描述和测试记录。 6. 决定是否继续让 App 修，还是回 Cloud 处理远程 CI。 ⠀ 不要因为 Cloud 任务“通过”就跳过本地 Review。 ⠀ 8.1 Cloud 回流的四个常见风险 ⠀ 风险 检查方式 云端环境和本机不同 本地重新跑关键命令 Cloud 改了范围外文件 App Review 查看文件列表 PR 描述过度乐观 对照 diff 和测试日志重写 Verification Secrets / 网络权限过宽 检查 environment 和 GitHub connector 权限 风险 风险 检查方式 检查方式 云端环境和本机不同 云端环境和本机不同 本地重新跑关键命令 本地重新跑关键命令 Cloud 改了范围外文件 Cloud 改了范围外文件 App Review 查看文件列表 App Review 查看文件列表 PR 描述过度乐观 PR 描述过度乐观 对照 diff 和测试日志重写 Verification 对照 diff 和测试日志重写 Verification Secrets / 网络权限过宽 Secrets / 网络权限过宽 检查 environment 和 GitHub connector 权限 检查 environment 和 GitHub connector 权限 ⠀ Cloud 适合长任务，但最终合并仍然要回到 Review、测试和人工判断。 ⠀ 9. Web / Cloud 与 Automations ⠀ 需求 优先 本地项目周期检查 App Automation 远程仓库长任务 Cloud PR / CI 触发 GitHub / CI / Cloud 内部系统调度 SDK / 外部队列 需求 需求 优先 优先 本地项目周期检查 本地项目周期检查 App Automation App Automation 远程仓库长任务 远程仓库长任务 Cloud Cloud PR / CI 触发 PR / CI 触发 GitHub / CI / Cloud GitHub / CI / Cloud 内部系统调度 内部系统调度 SDK / 外部队列 SDK / 外部队列 ⠀ 不要用桌面 App 伪装 webhook server。 ⠀ 常见问题 ⠀ Q1：Cloud 能访问互联网吗？ ⠀ 取决于当前 environment 和官方能力。需要联网时显式配置并审查风险。 ⠀ Q2：Cloud 能用我的本机文件吗？ ⠀ 不能默认假设。Cloud 主要使用远程仓库和配置的环境。 ⠀ Q3：Cloud 任务完成后还要本地 Review 吗？ ⠀ 要。最终合并前仍要看 diff、测试和 PR。 📝 总结与检查清单 ⠀ 完成本课后，请确认以下所有项： ⠀ 理解Cloud是远程执行路径，不是本地App的替代品 知道什么任务适合Cloud（远程仓库、长任务、PR修复） 知道什么任务不适合Cloud（本机私有文件、GUI任务） 了解Environment、setup script、secrets的基本概念 Cloud完成后会回到App做本地Review 不因为Cloud"通过"就跳过本地Review ⠀ 如果以上全部勾选，恭喜你掌握Codex Web/Cloud辅助！ 附录 ⠀ A. App vs Cloud 对比 ⠀ 维度 App Web / Cloud 执行位置 本机 云端环境 主要对象 本地线程、worktree 远程仓库、PR 适合 本地开发、桌面多线程 长任务、远程PR 维度 维度 App App Web / Cloud Web / Cloud 执行位置 执行位置 本机 本机 云端环境 云端环境 主要对象 主要对象 本地线程、worktree 本地线程、worktree 远程仓库、PR 远程仓库、PR 适合 适合 本地开发、桌面多线程 本地开发、桌面多线程 长任务、远程PR 长任务、远程PR ⠀ B. 推荐学习资源 ⠀ • Codex Cloud 官方文档：https://developers.openai.com/codex/cloud • 本系列上一篇：CX 10 Review / GitHub / PR • 本系列下一篇：CX 12 CLI 辅助 课程制作：老金 最后更新：2026年5月30日 许可：本课程采用CC BY NC SA 4.0许可 下一步 ⠀ 下一篇：CX 12 CLI 辅助指南。 本篇是 App 主线的云端辅助篇。 ⠀ 主要来源：OpenAI Codex Web / Cloud、GitHub integration、Environments、Internet Access、Secrets 官方文档。 课程信息 ⠀ • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 预计学时：1 2小时 • 难度等级：⭐⭐ 入门级 • 更新日期：2026年5月30日 • 信息来源：OpenAI Codex Web/Cloud、GitHub integration、Environments、Secrets 官方文档 • 前置要求：已完成 CX 01 安装、CX 02 桌面工作流、CX 10 Review/PR 📚 本课学习目标 ⠀ 完成本课学习后，你将能够： ⠀ 1. 理解Cloud的定位：掌握Cloud是远程执行路径，不是"更强的本地App" 2. 判断何时用Cloud：远程仓库任务、长任务、PR修复、不依赖本机文件的改动 3. 理解Environment：知道如何定义云端任务的仓库、依赖、setup script、secrets 4. 编写安全的setup script：短而稳定、不写交互式命令、不输出密钥 5. 掌握App到Cloud的接力流程：本地确认范围→创建issue/PR→Cloud接手→回到App Review 6. 管理Cloud安全：最小权限secrets、不打印到日志、不把生产写权限给调试任务 7. 验收Cloud结果：回到App看diff、本地跑验证、检查范围外改动 8. 区分App/Cloud/Automation场景：知道各自适合什么类型的任务 🗺️ 学习路径导航（先看这里！） ⠀ 💡 根据你的情况选择学习路径：不用全看！ 💡 根据你的情况选择学习路径：不用全看！ ⠀ 路径A：快速上手（⏱️ 10分钟） ⠀ 适合人群：想知道什么时候该把任务交给Cloud ⠀ 只看这些章节： ⠀ 路径B：完整学习（⏱️ 1 2小时） ⠀ 适合人群：想系统掌握Cloud配置和使用 ⠀ 学习顺序：从头到尾所有章节 1. Web / Cloud 是什么 ⠀ Codex Web / Cloud 是远程执行路径。它通常围绕远程仓库、PR 和云端环境工作。 ⠀ 与 App 的区别： ⠀ 维度 App Web / Cloud 执行位置 本机 / 本地项目 云端环境 主要对象 本地线程、worktree、Review 远程仓库、任务、PR 环境依赖 本机工具和文件 Cloud environment 适合 本地开发、桌面多线程 长任务、远程 PR、云端 CI 风格任务 维度 维度 App App Web / Cloud Web / Cloud 执行位置 执行位置 本机 / 本地项目 本机 / 本地项目 云端环境 云端环境 主要对象 主要对象 本地线程、worktree、Review 本地线程、worktree、Review 远程仓库、任务、PR 远程仓库、任务、PR 环境依赖 环境依赖 本机工具和文件 本机工具和文件 Cloud environment Cloud environment 适合 适合 本地开发、桌面多线程 本地开发、桌面多线程 长任务、远程 PR、云端 CI 风格任务 长任务、远程 PR、云端 CI 风格任务 ⠀ 2. 什么时候用 Cloud ⠀ 适合： ⠀ • 远程仓库上直接修 issue。 • PR 评论修复。 • CI 失败后云端排查。 • 长时间后台任务。 • 不依赖本机私有文件的改动。 ⠀ 不适合： ⠀ • 需要本机数据库或本地 GUI。 • 需要访问未同步的本机文件。 • 需要你频繁看 UI 的任务。 • 密钥和生产数据边界不清的任务。 ⠀ 3. Environment 是什么 ⠀ Cloud environment 定义云端任务怎么跑： ⠀ • 选择仓库。 • 安装依赖。 • 设置 setup script。 • 配置 secrets。 • 控制网络访问。 • 设定运行验证方式。 ⠀ 好的 environment 应该能让 Codex 在云端稳定复现项目。 ⠀ 4. 创建 Cloud 任务前先准备什么 ⠀ 从 App 接力到 Cloud 前，先准备： ⠀ 项 要写清 仓库 Cloud 要操作哪个 GitHub repo / branch 任务范围 改哪些目录，不改哪些目录 依赖安装 用 npm ci、pnpm install frozen lockfile 还是其他命令 验证命令 build、test、lint 具体怎么跑 Secrets 需要哪些，是否只读，是否会进日志 网络 是否需要 Internet access 回流方式 生成 PR、推分支，还是只输出报告 项 项 要写清 要写清 仓库 仓库 Cloud 要操作哪个 GitHub repo / branch Cloud 要操作哪个 GitHub repo / branch 任务范围 任务范围 改哪些目录，不改哪些目录 改哪些目录，不改哪些目录 依赖安装 依赖安装 用 npm ci、pnpm install frozen lockfile 还是其他命令 用 npm ci、pnpm install frozen lockfile 还是其他命令 验证命令 验证命令 build、test、lint 具体怎么跑 build、test、lint 具体怎么跑 Secrets Secrets 需要哪些，是否只读，是否会进日志 需要哪些，是否只读，是否会进日志 网络 网络 是否需要 Internet access 是否需要 Internet access 回流方式 回流方式 生成 PR、推分支，还是只输出报告 生成 PR、推分支，还是只输出报告 ⠀