Codex Quickstart：选择 App、IDE、CLI 或云端入口

适用场景

这篇手册适合第一次接触 Codex 的读者。目标不是把所有功能一次讲完，而是帮助你选对入口，并完成第一个可验证的 Codex 任务。

OpenAI 官方 Quickstart 把 Codex 分成 App、IDE extension、CLI 和 Cloud 几种入口。你可以把它们理解成同一个编码代理在不同工作位置里的表现：桌面应用更适合并行任务，IDE 更适合贴近代码编辑，CLI 更适合终端和自动化，Cloud 更适合远端执行。

步骤 1：先选入口

按你的工作方式选择：

| 入口 | 更适合谁 | 典型任务 | | --- | --- | --- | | Codex App | 想在桌面上管理多个线程、worktree、自动化任务的人 | 修 bug、跑测试、审 diff、管理并行改动 | | IDE Extension | 主要在 VS Code、Cursor、Windsurf 等编辑器里写代码的人 | 解释选区、补 TODO、把当前文件加入上下文 | | CLI | 习惯终端、脚本、CI 或 SSH 环境的人 | codex 交互、codex exec 自动化 | | Cloud | 想把任务交给远端环境执行的人 | 云端修复、GitHub review、Slack/Linear 分派 |

如果你还不确定，建议从 Codex App 或 IDE Extension 开始，因为界面反馈更直接。

步骤 2：安装或打开 Codex

Codex App 当前官方提供 macOS 和 Windows 入口。安装后打开应用，使用 ChatGPT 账号或 OpenAI API key 登录。

IDE Extension 则从你使用的编辑器扩展市场安装。安装完成后打开 Codex 面板，确认它能看到当前工作区。

CLI 用户可以在终端里安装并登录，然后进入项目目录运行：

codex

如果你只是想让 Codex 执行一次非交互任务，可以使用：

codex exec "检查这个仓库的测试命令，并说明应该先跑哪一个"

步骤 3：选择项目

第一次使用时，不要直接把 Codex 指向一个特别大的生产仓库。更稳的做法是：

1. 选择一个你熟悉的小项目。
2. 确认项目里没有未提交的敏感文件。
3. 准备好可运行的验证命令，例如 npm test、npm run lint 或 pytest。
4. 如果仓库有长期规则，把它们写进 AGENTS.md。

Codex 能读懂项目上下文，但你给它的第一批信息越清楚，它越容易做出可审查的改动。

步骤 4：发送第一条消息

第一条消息建议足够小、足够可验证。比如：

请阅读这个项目的结构，告诉我主要入口文件、测试命令和本地启动方式。先不要修改代码。

确认 Codex 对项目理解正确后，再发第二条：

请修复首页里移动端按钮换行的问题，保持现有设计风格。完成后运行 lint。

这样可以把“理解项目”和“执行修改”分开，降低误改风险。

步骤 5：检查结果

Codex 完成任务后，不要只看总结。至少检查三件事：

• diff 是否只改了相关文件。
• 是否运行了你要求的验证命令。
• 如果 Codex 请求权限，理由是否和任务匹配。

对于新手来说，最好的节奏是“小任务、短反馈、马上验证”。等你熟悉审批、沙箱和上下文管理后，再把任务扩展到多文件改造或云端自动化。

常见错误

不要一上来让 Codex “重构整个项目”。范围太大时，验证成本会迅速升高。

不要把密钥、客户数据或内部凭证直接发给 Codex。需要访问外部服务时，优先使用官方插件、MCP 或受控环境变量。

不要跳过 diff 审查。Codex 是编码代理，不是代码所有者，最终合并前仍然需要你确认。

小结

Codex Quickstart 的关键不是安装哪个客户端，而是建立一套可重复的入门流程：选入口、选项目、给清楚任务、保留审批边界、检查 diff、运行验证。只要这个循环顺了，后面的 App、IDE、CLI 和 Cloud 功能都会更容易上手。