第一次创建 Codex Cloud 任务

第一次创建 Codex Cloud 任务

第一次 Cloud 任务只做一件事：让 Codex 只读分析仓库。

前置教程：Codex Cloud 使用前准备
如果 GitHub、权限和 Cloud environment 还没准备好，先完成前置教程。

依据来源：OpenAI Codex 官方手册中关于 Codex cloud tasks、cloud environments、GitHub 仓库和远程任务的说明。

任务目标

本篇只完成：

创建一个 Cloud 只读分析任务。

不做：

• 不修改代码。
• 不创建 PR。
• 不配置生产密钥。
• 不让 Codex 大范围重构。
• 不把本地未提交修改当成 Cloud 已知内容。

第 1 步：打开 Codex Cloud

打开 Codex Cloud 入口。

常见入口可能是：

https://chatgpt.com/codex

或者 ChatGPT 左侧导航里的 Codex。

如果你看不到入口，可能是：

• 账号没有权限。
• 工作区管理员未开启。
• GitHub 尚未连接。
• 当前套餐或组织策略不支持。

不要在这一步猜，先回到前一篇检查权限。

第 2 步：选择仓库和环境

选择你准备好的练习仓库。

确认 4 件事：

1. 仓库名称正确。
2. 分支正确。
3. Cloud environment 正确。
4. 不是正式生产仓库。

如果你有多个仓库，不要凭记忆点。

认真看仓库名和组织名。

第 3 步：粘贴只读任务提示词

复制下面这段：

请只读分析当前仓库，不要修改任何文件，不要创建分支，不要创建 PR。

请用中文回答：
1. 这个仓库看起来是什么类型。
2. 主要目录结构是什么。
3. 入口文件可能在哪里。
4. package.json、pom.xml、requirements.txt 或类似配置文件里有哪些可用脚本。
5. 当前 Cloud environment 是否看起来缺少关键依赖、脚本或环境变量。
6. 如果后续要做一个最小安全改动，你建议从哪里开始。
7. 本次你没有修改任何文件。

这个提示词有 3 个重点：

• 明确只读。
• 明确不创建 PR。
• 明确检查 Cloud 环境是否缺东西。

第 4 步：提交任务

提交任务后，等待 Codex 执行。

你要观察：

• 任务是否成功创建。
• 是否开始读取仓库。
• 是否出现权限错误。
• 是否出现环境错误。
• 是否要求你补充信息。

第 5 步：看 Cloud 返回结果

结果出来后，先检查它有没有遵守边界。

应该看到：

• 它分析了仓库类型。
• 它列出了主要目录。
• 它找到了配置文件或脚本。
• 它指出 Cloud 环境可能缺什么。
• 它明确没有修改文件。

如果它开始提修改方案，也没问题。

但如果它真的创建了修改或 PR，就说明你的任务边界没有控制好，下一次要写得更严格。

第 6 步：如果失败，先分类

常见失败类型：

现象	可能原因
看不到仓库	GitHub 没连接、权限不足、组织授权问题
环境启动失败	Cloud environment 缺依赖或脚本
安装依赖失败	setup 脚本、网络、包管理器、私有源问题
不能访问外部服务	agent 阶段网络默认关闭或访问策略限制
找不到本地修改	本地修改没有提交或推送
要求登录或 MFA	账号安全要求未完成

如果失败，不要直接重建一堆配置。

把错误信息打码后问 Codex：

这是 Cloud 只读任务失败信息，我已经隐藏敏感内容：

【粘贴错误】

请帮我判断更可能是仓库权限、Cloud environment、依赖安装、网络访问、账号 MFA，还是本地未推送代码导致。
请按可能性排序，并告诉我下一步应该检查哪里。

第 7 步：保存第一次成功结果

第一次成功后，建议保存这 3 类信息：

1. 任务输入内容。
2. 任务运行状态。
3. 只读分析结果。

这些信息后面可以用来排查：

• Cloud 是否能访问仓库。
• Cloud environment 是否可用。
• Codex 是否能理解项目结构。

本篇验收

完成后，你应该得到：

• 一个 Cloud 只读任务。
• 一份仓库分析结果。
• 没有创建 PR。
• 没有修改文件。
• 知道 Cloud 是否能正常访问仓库和环境。

下一篇看：Cloud 结果怎么带回本地。