快速上手 Codex

OpenAI 官方 Quickstart 说明：每一种 ChatGPT 套餐都包含 Codex，你也可以用 OpenAI API key 登录并通过 API credits 使用 Codex。

新手真正要解决的不是“装哪个最专业”，而是先选对入口、做一个低风险任务、学会检查结果。

先理解四个入口

Codex 不是只有一个用法。官方 Quickstart 给了四类入口：

• App：桌面应用，官方推荐的新手入口，适合在本机项目里直接使用。
• IDE extension：把 Codex 放进 VS Code、Cursor、Windsurf 这类编辑器。
• CLI：在终端里使用，适合已经熟悉命令行和本地工程流程的人。
• Cloud：在浏览器里的云端环境运行任务，适合后台执行、查看日志、创建 PR。

如果你还不确定，从 App 或 IDE extension 开始。CLI 和 Cloud 更适合已经知道项目结构、权限边界和验证方式的人。

第一次不要做什么

第一次使用 Codex，不要直接让它“重构项目”“做完整产品”“全面优化”。这些任务范围太大，新手很难判断结果好坏。

第一条消息最好是只读任务：

请先阅读这个项目，告诉我它的主要结构、启动方式、关键目录，以及你建议我从哪里开始做一个小改动。不要修改文件。

这条消息的价值是让你确认三件事：Codex 是否在正确项目里、是否理解现有结构、是否能用仓库证据说话。

安全上手流程

建议按这个顺序完成第一次使用：

1. 选择一个真实但不关键的项目。
2. 确认 Git 工作区干净，或者至少知道当前有哪些改动。
3. 让 Codex 先做只读项目介绍。
4. 让它提出一个很小的修改计划。
5. 只批准一个边界明确的小任务。
6. 查看 diff，确认没有无关文件。
7. 运行测试、lint、build 或项目已有验证命令。

新手要把 Codex 当成会改代码的协作者，不是一次性外包工具。每一步都要能看见边界和证据。

各入口怎么选

App 适合：

• 你想用官方桌面应用处理本地项目。
• 你不想先理解 CLI 参数。
• 你希望从 Local 模式开始。

IDE extension 适合：

• 你主要在 VS Code、Cursor 或 Windsurf 里开发。
• 你希望一边看代码一边和 Codex 对话。
• 你想让 Codex 跟随当前编辑器上下文。

CLI 适合：

• 你熟悉终端。
• 你能看懂命令输出、Git diff、测试结果。
• 你希望在脚本化或本地工程流里使用 Codex。

Cloud 适合：

• 你想把任务放到云端环境后台执行。
• 你需要连接 GitHub 仓库并创建 PR。
• 你能审查日志、diff 和最终分支。

新手常见坑

• 在错误文件夹里启动 Codex。
• 一上来给超大任务，导致结果不可审查。
• 没看 diff 就接受改动。
• Codex 说跑了测试，但你没有核对输出。
• 不知道当前是 Local 还是 Cloud。
• 用 API key 登录后，误以为所有 ChatGPT 登录能力都完全一样。
• Cloud 环境没配好，就把问题归因给模型能力。

怎么判断第一次成功

第一次成功不等于做出一个大功能，而是完成一个可控闭环：

• Codex 能正确识别项目结构。
• 你知道它在哪个目录工作。
• 它没有修改只读任务里的文件。
• 第一个小改动只影响预期文件。
• diff 能看懂。
• 至少有一种验证方式能证明改动可用。

完成这个闭环后，再继续学习 prompt、配置、安全权限、Cloud environment 和团队流程。

官方资料

• OpenAI Codex Quickstart
• OpenAI Codex App
• OpenAI Codex IDE extension
• OpenAI Codex CLI
• OpenAI Codex Cloud
• OpenAI Codex best practices

© OpenAI

最近更新：2026年5月4日