Codex 现在已经包含在所有 ChatGPT 计划里。也就是说，只要你有 ChatGPT 账号，就可以开始用 Codex。
如果你想走 API 计费，也可以用 OpenAI API key 登录，用 API credits 来使用。不过要注意：用 API key 登录时，某些功能可能不可用，比如 cloud threads。
Codex 的定位不是“代码补全插件”。更准确地说，它是一个可以接任务的编程 Agent。你可以让它读项目、解释代码、找 bug、改文件、跑命令、提交改动，甚至在云端处理 GitHub 仓库里的任务。
一句话理解 Codex
Codex 是一个能进入你代码项目里干活的 AI 工程助手。
你可以对它说：
Tell me about this project
它会先读项目结构，告诉你这个项目是做什么的。
你也可以说：
Find and fix bugs in my codebase with minimal, high-confidence changes.
它会尝试复现问题、定位原因、修改代码，再给你说明改了什么。
如果你想让它做功能，也可以这样说：
Build a classic Snake game in this repo.
但最好给清楚范围，不要只丢一句“做个游戏”。Codex 越清楚边界，结果越靠谱。
Codex 有四种入口
Codex 主要有四种使用方式：
- App：桌面应用，官方推荐入口
- IDE extension：在 VS Code、Cursor、Windsurf 等编辑器里用
- CLI：在终端里用
- Cloud：在浏览器里用，适合云端跑任务和 GitHub 工作流
这四种方式不是互斥的。你可以本地用 App 或 CLI，写代码时用 IDE 插件，复杂任务交给 Cloud。
方式一：Codex App，最适合大多数人
Codex App 是官方推荐入口，支持 macOS 和 Windows。
如果你刚开始用 Codex，建议先从 App 开始。它比 CLI 更直观，也比 IDE 插件更完整，适合处理本地项目。
适合谁？
适合：
- 想让 Codex 直接处理本地项目的人
- 不想先折腾命令行的人
- 想用一个独立桌面 App 管理多个项目的人
- 需要 Codex 读取、修改、运行本地代码的人
第一步：下载并安装 Codex App
Codex App 支持：
- macOS Apple Silicon
- macOS Intel
- Windows
如果你用的是 Intel 芯片的 Mac，要选择 Intel build。Apple Silicon Mac，比如 M1、M2、M3、M4，则选择 Apple Silicon 版本。
Linux 目前不是正式 App 平台，可以留下邮箱等待通知。
第二步：打开 Codex 并登录
安装完成后，打开 Codex。
你可以用两种方式登录：
- ChatGPT 账号
- OpenAI API key
推荐普通用户用 ChatGPT 账号登录。如果用 API key 登录，有些功能可能受限，比如 cloud threads。
第三步：选择项目文件夹
Codex 需要知道你要它在哪个项目里工作。
选择一个项目目录，比如：
my-next-app/ my-python-service/ company-dashboard/
如果你之前用过 Codex App、CLI 或 IDE Extension，它会显示你过去操作过的项目。
第四步：确认选择 Local
选好项目后，要确认 Codex 当前运行模式是 Local。
Local 的意思是：Codex 在你的机器上处理这个项目。它可以读取项目文件、修改代码、运行本地命令。
这一步很关键。你如果想让 Codex 处理本地项目，就应该选 Local。
第五步：发送第一条消息
刚开始不要急着让它改代码。建议先让它了解项目。
可以这样问：
Tell me about this project
它会查看项目结构，告诉你：
- 这个项目大概是什么
- 用了什么技术栈
- 入口文件在哪里
- 主要目录有什么用
- 可能有哪些运行命令
这个步骤很适合新项目，也适合你接手别人的项目。
方式二：IDE Extension，在编辑器里直接用 Codex
如果你平时主要在 VS Code、Cursor、Windsurf 里写代码，可以安装 Codex IDE 插件。
支持的编辑器包括：
- Visual Studio Code
- Cursor
- Windsurf
- Visual Studio Code Insiders
适合谁？
适合：
- 想边写代码边让 Codex 帮忙的人
- 希望 AI 直接理解当前打开文件的人
- 习惯在 IDE 里完成开发流程的人
- 想让 Codex 读文件、跑命令、改项目的人
第一步：安装 Codex extension
在对应编辑器里安装 OpenAI 的 Codex 插件。
安装后，Codex 会出现在侧边栏里。如果没看到，可能被折叠到扩展区里了。
你也可以把 Codex 面板移动到编辑器右侧，这样一边看代码，一边看 Codex 的操作过程。
第二步：打开 Codex 面板
打开侧边栏里的 Codex 面板。
它类似一个 Agent 工作区，不只是聊天框。
你可以让它：
- 解释当前项目
- 修改当前文件
- 搜索代码
- 跑测试
- 找 bug
- 写功能
- 做小范围重构
第三步：登录并开始任务
可以用 ChatGPT 账号或 API key 登录。
Codex 在 IDE 里默认是 Agent mode。这意味着它可以：
- 读取文件
- 运行命令
- 修改项目目录里的代码
这比普通代码补全强很多。普通补全是在你写代码时给建议；Agent mode 是你给任务，它自己去查、改、验证。
第四步：使用 Git checkpoints
这是非常重要的一点。
Codex 可以改你的代码，所以在开始任务前，最好先做一个 Git checkpoint。
简单说，就是先确认当前代码状态是干净的：
git status
如果有需要，可以先提交一次：
git add . git commit -m "checkpoint before codex task"
或者至少记住当前 diff。
任务完成后，再检查 Codex 改了什么：
git diff
这样如果结果不满意，你可以很容易回退。
方式三：CLI，在终端里用 Codex
Codex CLI 支持 macOS、Windows 和 Linux。
如果你习惯终端工作，CLI 是很自然的入口。
适合谁？
适合：
- 喜欢命令行的开发者
- 经常在服务器或 Linux 环境里开发的人
- 想把 Codex 接入脚本或自动化流程的人
- 不想打开桌面 App 或 IDE 的人
第一步：安装 Codex CLI
可以用 npm 安装：
npm install -g @openai/codex
也可以用 Homebrew 安装：
brew install codex
如果你是 Node.js 用户，用 npm 很方便。如果你是 macOS 用户，Homebrew 也很顺手。
第二步：运行 codex 并登录
进入项目目录，然后运行：
codex
首次运行时，它会提示你登录。
你可以选择：
- ChatGPT 账号
- OpenAI API key
登录完成后，Codex 就能在当前目录工作。
第三步：让 Codex 处理当前目录
CLI 的逻辑很直接：你在哪个目录运行 codex，它就默认在哪个项目里工作。
比如：
cd my-project codex
然后你可以输入：
Tell me about this project
或者：
Find and fix bugs in my codebase with minimal, high-confidence changes.
CLI 特别适合那种“我知道我要干什么，不想点界面”的场景。
第四步：同样要用 Git checkpoints
CLI 下更应该注意 Git 状态。
建议每次让 Codex 做比较大的任务之前，先检查：
git status
任务完成后看 diff：
git diff
如果它改得不对，不要硬着头皮继续。先回退，再重新给更清楚的指令。
方式四：Cloud，在浏览器里用 Codex
Codex Cloud 可以在浏览器里使用：
chatgpt.com/codex
它适合把任务交给云端跑，尤其适合 GitHub 仓库。
适合谁？
适合：
- 想让 Codex 在云端处理代码的人
- 想把任务直接交给 Codex 后后台运行的人
- 想让 Codex 创建 Pull Request 的团队
- 想在 GitHub PR 评论里通过 @codex 分配任务的人
第一步：打开 Codex Cloud
进入：
chatgpt.com/codex
你也可以在 GitHub Pull Request 评论里 tag：
@codex
让 Codex 接任务。这个需要你已经登录 ChatGPT，并完成相关连接。
第二步：设置环境
在启动第一个任务前，需要先配置环境。
进入：
chatgpt.com/codex/settings/environments
然后连接你的 GitHub 仓库。
这个环境告诉 Codex：
- 要处理哪个 repo
- 使用什么运行环境
- 如何安装依赖
- 如何运行测试
- 如何提交改动
没有环境，Codex 就不知道怎么在云端跑你的项目。
第三步：启动任务并查看进度
环境准备好后，就可以在 Codex Cloud 界面发任务。
Codex 会在云端运行，你可以：
- 实时看日志
- 让任务在后台跑
- 等它完成后再回来检查结果
这和本地 App/CLI 的体验不一样。Cloud 更像是你把任务派给一个远程工程师，让它自己开分支、改代码、跑验证。
第四步：审查改动并创建 PR
任务完成后，Codex 会展示 diff。
你可以：
- 查看它改了哪些文件
- 继续追问或要求修改
- 直接创建 Pull Request
- 把分支拉到本地测试
如果要本地测试，可以：
git fetch git checkout <branch-name>
这一步很适合团队协作。Codex 不是直接把代码合进主分支，而是给你一个可审查的改动。
四种入口怎么选？
想最快上手：选 App
如果你只是想试试 Codex，或者想让它处理本地项目，直接用 App。适合大多数人。
天天写代码：选 IDE Extension
如果你主要在 VS Code、Cursor、Windsurf 里工作，装 IDE 插件。它更贴近你的日常开发环境。
喜欢命令行：选 CLI
如果你经常在终端里操作项目，CLI 最自然。尤其适合后端、基础设施、Linux 用户。
想把任务丢给云端：选 Cloud
如果你想让 Codex 在后台跑任务、创建 PR、处理 GitHub 仓库，用 Cloud。适合团队和稍复杂的工程流。
第一次该让 Codex 做什么？
新手不要一上来就让它“大改架构”。推荐从这几类任务开始。
任务 1：让它读项目
Tell me about this project
这是最安全的第一步。
你可以接着问：
Where is the main entry point?
How do I run this project locally?
What are the most important directories?
这能快速建立你和 Codex 对项目的共同理解。
任务 2：让它找 bug，但要求最小改动
可以这样写：
Find and fix bugs in my codebase with minimal, high-confidence changes. Method: 1. Reproduce: run tests/lint/build, or follow the existing repo scripts. 2. Localize: identify the smallest set of files involved. 3. Fix: implement the minimal change that resolves the issue. 4. Prove: add or update a focused test if the repo has a test runner. Constraints: - No refactors. - No unrelated cleanup. - Do not invent errors. - If something cannot be confirmed, say so. Output: - What was broken. - Why it broke. - What changed. - What evidence proves the fix.
这类提示很关键。你不是简单说“修 bug”，而是告诉它怎么修、修到什么程度、不要做什么。
任务 3：让它做一个小功能
比如：
Build a classic Snake game in this repo.
但最好加上限制：
Scope: - Only implement classic Snake: movement, food, score, game over, restart. - Reuse existing project tooling. - Do not add new dependencies unless required. - Keep UI minimal and consistent with existing styles. Deliverables: - Small set of files. - Run instructions. - Manual verification checklist.
这能防止 Codex 自由发挥过头。
写给 Codex 的提示词怎么写？
很多人用不好 Codex，不是因为模型不行，而是任务说得太糊。
不要这样写：
帮我优化一下项目
这个范围太大。Codex 可能不知道你要优化性能、结构、UI、依赖还是构建速度。
也不要这样写：
重构整个项目
这很容易失控。
更好的写法是：
Find the slowest part of the dashboard loading path. Do not change code yet. First explain what files and functions are involved. Then propose the smallest safe fix.
或者：
Fix the login button bug where clicking it does nothing. Reproduce the issue first. Only modify the smallest necessary code path. After fixing, run the relevant test or explain why no test exists.
好提示词一般包含五件事：
- 目标是什么
- 范围到哪里为止
- 不能做什么
- 如何验证
- 输出什么结果
使用 Codex 的几个实用原则
1. 先让它理解，再让它修改
新项目不要直接改。先问：
Tell me about this project
再问：
Where would you implement X?
确认方向没问题，再让它动手。
2. 每次只给一个清楚任务
不要一次说：
修 bug、优化 UI、升级依赖、顺便加个登录页。
这会让任务变乱。
拆开做：
- 修 bug
- 跑测试
- 再做 UI
- 最后升级依赖
Codex 更适合连续执行小任务，而不是一次吃掉一个大混沌。
3. 明确要求“最小改动”
尤其是修 bug 时，一定要说：
Make the smallest change necessary. No refactors or unrelated cleanup.
否则它可能顺手改掉一堆你没要求的东西。
4. 让它证明结果
不要只听它说“已修复”。
要求它：
- 跑测试
- 跑 lint
- 跑 build
- 给出失败前后对比
- 说明没有测试时的原因
可以这样写：
After the change, run the relevant tests and summarize the result. If you cannot run tests, explain why.
5. 用 Git 管住风险
Codex 能改代码，所以 Git 是保险带。
任务前：
git status
任务后：
git diff
满意再提交。不满意就回退。
App、IDE、CLI、Cloud 的核心区别
| 入口 | 使用场景 | 优点 | 注意点 |
|---|---|---|---|
| App | 本地项目 | 官方推荐，界面完整 | 需要安装桌面应用 |
| IDE Extension | 日常写代码 | 离代码最近 | 注意审查自动改动 |
| CLI | 终端工作流 | 快，适合开发者 | 对命令行更熟悉才舒服 |
| Cloud | 云端任务/GitHub | 可后台跑、可建 PR | 需要配置环境和仓库 |
最推荐的新手路径
如果你是第一次用 Codex，我建议按这个顺序来：
- 安装 Codex App
- 用 ChatGPT 账号登录
- 选择一个不太重要的测试项目
- 发送：Tell me about this project
- 再让它做一个小任务，比如修一个明确 bug
- 查看 diff
- 跑测试
- 满意后提交
等你熟悉后，再用 IDE 插件或 CLI。如果你开始做团队协作，再配置 Cloud。
Codex 真正改变的是什么？
它改变的不是“写代码更快”这么简单。
更大的变化是：开发工作开始从“你逐行写代码”，变成“你描述任务，Agent 进入项目执行”。
以前你问 AI：
帮我写一个函数
现在你可以说：
这个页面提交表单后没有刷新状态。请复现问题，找到原因，用最小改动修复，并跑相关测试。
这完全不是一个层级的工具。
Codex quickstart 看起来只是安装教程，但背后的意思很明确：OpenAI 想让 Codex 成为开发工作流入口。它可以在 App 里、本地 IDE 里、终端里、云端仓库里工作。
这就是编程 Agent 的形态：不是只回答问题，而是进入你的项目，完成一段工程任务。
最后一句话
Codex 上手其实很简单：选入口、登录、选项目、发任务。
真正难的是你怎么分配任务。任务越清楚，边界越明确，验证方式越具体，Codex 的结果就越可靠。