Codex Cloud 使用前准备

Codex Cloud 使用前准备

Cloud 的准备工作比本地入口更多。这里不做好，后面报错会很难判断。

前置教程：Codex Cloud 适合什么场景
如果你还不知道自己是否该用 Cloud，先完成前置教程。

依据来源：OpenAI Codex 官方手册中关于 Codex cloud、GitHub 连接、MFA、cloud environments、agent internet access 和安全策略的说明。

你要准备什么

至少准备 6 件事：

1. ChatGPT 账号。
2. 可以访问的 GitHub 仓库。
3. 仓库已经推送到 GitHub。
4. Codex Cloud 访问权限。
5. Cloud environment。
6. 明确的任务描述。

如果你是团队或公司账号，还可能需要管理员开启 Cloud 权限。

第 1 步：确认代码在 GitHub 上

Cloud 不是直接读取你的本地文件夹。

你要确认：

• 项目已经是 Git 仓库。
• 代码已经推送到 GitHub。
• 你知道目标分支。
• 远程仓库里能看到你要分析的代码。

如果你的修改还只在本地，没有提交或推送，先不要用 Cloud。

你应该先用本地 CLI 或 IDE 处理。

第 2 步：确认账号安全

官方手册强调，Codex Cloud 会和代码库交互，所以账号安全比普通聊天更重要。

你应该确认：

• ChatGPT 账号能登录。
• GitHub 账号能登录。
• 如果要求 MFA，先完成 MFA。
• 团队账号权限没有被管理员关闭。

如果你用邮箱密码登录，并且 Cloud 要求 MFA，那就先设置 MFA。

第 3 步：连接 GitHub

进入 Codex Cloud 或 ChatGPT 里的 Codex 页面。

通常你需要完成：

1. 连接 GitHub。
2. 授权可访问的组织或仓库。
3. 选择仓库。
4. 确认分支。

注意：不要给 Codex 授权你完全不需要的仓库。

新手阶段优先选择：

• 自己的练习仓库。
• 不包含真实客户数据的仓库。
• 可以随时回滚的仓库。

第 4 步：准备 Cloud environment

Cloud environment 决定 Codex 在远程环境里怎么安装依赖、使用工具和运行检查。

你需要确认：

• 项目语言和框架。
• 依赖安装命令。
• 构建命令。
• 测试命令。
• 是否需要环境变量。
• 是否需要网络访问。

官方手册说明，Cloud 任务有 setup 和 agent 阶段。setup 阶段可以用网络安装依赖；agent 阶段默认没有互联网访问，除非你配置开启。

新手建议：

• 先不要开启过宽的网络访问。
• 先做只读分析任务。
• 暂时不要配置生产密钥。

第 5 步：确认不要误放密钥

Cloud 环境可能需要一些变量，但不要随便把生产密钥放进去。

你要问自己：

1. 这个任务真的需要密钥吗？
2. 能不能用测试密钥？
3. 能不能只做静态分析？
4. 这个密钥泄露会造成什么后果？
5. 是否有团队安全规范？

第一次 Cloud 任务建议不需要任何密钥。

第 6 步：准备只读任务

第一次不要让 Cloud 改代码。

先准备只读任务：

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

请用中文告诉我：
1. 这个仓库是什么类型。
2. 主要目录和入口文件在哪里。
3. 有哪些构建、测试或检查脚本。
4. 如果后续要做一个小改动，建议从哪个文件开始。
5. 当前 Cloud 环境看起来是否缺少关键依赖或配置。

这一步的目标是确认 Cloud 能读仓库、能理解项目、能识别环境。

本篇验收

完成后，你应该确认：

• 代码已经在 GitHub。
• 账号和权限可用。
• GitHub 已连接。
• Cloud environment 已准备或知道缺什么。
• 第一次任务会是只读分析，不会直接改代码。

下一篇看：第一次创建 Codex Cloud 任务。