博客 · Codex 使用指南 ·
Codex 使用教程：选对入口，完成第一个项目任务
区分桌面、网页云端、命令行与编辑器入口，按官方路径登录、提供项目上下文，用范围明确的小任务开始，再核对结果。
第一次使用 Codex（OpenAI 的编程助手），可以按工作位置选择入口：本地项目从桌面应用开始，远程编程任务使用云端环境。登录后，提供任务所需的文件或上下文，先完成一个范围明确、能够核对结果的小任务。
网页、命令行和编辑器入口怎么选？
OpenAI 官方快速入门列出了不同入口，可按工作方式选择：
- 桌面应用：适合处理本地项目，可以读取、修改你选择的文件夹中的文件。
- 网页云端：适合远程编程工作，可选择或创建 Codex Cloud（云端运行环境）。
- Codex CLI（命令行工具）：适合习惯在终端中工作的开发者。
- Codex IDE extension（代码编辑器扩展）：适合希望留在编辑器内工作的开发者。
先选一个入口完成任务即可。下面以桌面应用为主；命令行和编辑器扩展的安装，可从官方快速入门进入对应专页。
登录后，怎样开始处理本地项目？
按官方桌面流程操作：
- 从快速入门页的下载入口选择适合操作系统的应用，安装后打开。
- 使用自己的 ChatGPT 账号登录。
- 从 ChatGPT 下拉菜单选择 Codex，进入编程工作入口。
- 打开要处理的项目文件夹，再描述任务。
处理本地项目时，先确认打开的是目标文件夹，再要求 Codex 依据其中的文件回答，并列出引用路径。也可以按任务需要补充相关文件或上下文，不必把完整项目都作为首次任务的范围。
想在网页做任务，云端环境怎么准备？
在新任务中选择 Work in > Cloud（工作位置 > 云端），打开 Select environment（选择环境），再选择 Create environment（创建环境）。
Codex 会检查代码仓库，协助准备和测试环境设置。确认设置符合预期后，由你发布环境；发布后，可在网页、移动端或桌面应用中开始和继续云端任务。
建议先核对目标仓库和环境检查结果。若准备阶段出现问题，先处理环境设置，再提交编程任务。
第一个任务应该怎么写？
官方建议说明目标，并补充所需文件或上下文。实际提问时，可以整理成“目标、范围、交付结果”三部分。
假设你刚接手一个已有项目，可以这样开始：
阅读项目说明和相关配置，解释项目如何启动。列出启动入口、依据的文件路径，以及需要我确认的前置条件。先只阅读，不修改文件；无法确认的地方请明确标出。
这个任务的验收目标是拿到有文件依据的启动说明。若回答笼统，继续追问对应路径或配置内容，补齐依据后再安排修改。
收到回答后，怎样判断任务完成？
打开回答引用的文件，核对启动命令、入口和前置条件是否一致。发现矛盾时，将具体文件与矛盾点反馈给它，请它重新检查。
后续需要改代码，再说明要改变的行为、允许修改的范围和验证要求，并要求它区分已经执行的检查与尚未验证的部分。这样可以判断结果是否达到要求，以及还需补充哪些验证。
如果卡住的是套餐支持或使用额度，可查看Codex 收费与订阅关系说明。