Codex 现在已经不只是“帮你补几行代码”的工具，而是逐渐演变成一个可以参与项目分析、代码修改、测试生成和代码审查的 AI 编程 Agent。

对于开发者来说，如果只是偶尔在 ChatGPT 里问几个语法问题，可能感受不到 Codex 的价值；但如果你经常需要阅读旧项目、定位 Bug、批量修改文件，或者希望让 AI 更深度地参与工程开发，那么 Codex CLI 会比单纯的聊天式问答更加实用。

本文从安装开始，完整介绍 Codex CLI 的配置、基础使用方式以及几个比较实用的开发场景。

本文以 OpenAI 当前公开的 Codex 使用方式为基础。官方说明显示，Codex 已包含在多种 ChatGPT 方案中，不同套餐的使用上限会有所不同。

一、Codex 是什么？

OpenAI 将 Codex 定义为一个用于编写、审查和交付代码的 AI 编程 Agent。它可以通过多种方式使用，包括 Codex CLI、IDE 扩展、Web 端以及 ChatGPT 桌面端中的 Codex 模式。

对于程序员来说，可以简单理解成：

传统 ChatGPT
↓
你贴代码
↓
AI 给建议

Codex
↓
AI 进入项目上下文
↓
读取代码
↓
分析任务
↓
修改文件
↓
继续迭代

Codex 更强调“完成任务”，而不是单纯回答一个问题。

二、安装 Codex CLI

目前官方给出的 Codex CLI 安装方式非常直接：

npm i -g @openai/codex

OpenAI 在 Codex 正式发布时也明确给出了这一安装命令。

安装前建议确认 Node.js 和 npm 已经可用：

node -v
npm -v

如果能正常看到版本号，就可以继续安装。

安装完成后，可以检查 Codex 是否可用：

codex --version

如果终端能够正常返回版本信息，说明安装已经完成。

三、首次启动与登录

安装完成以后，直接在终端运行：

codex

首次启动时，一般会引导你完成登录。

目前 Codex 可以直接连接 ChatGPT 账号，不一定需要单独手动配置 API Key。官方说明中也明确提到，可以使用 ChatGPT 账号登录 Codex CLI、IDE 扩展、Web 端等客户端。

登录完成后，就可以进入项目目录开始使用。

例如：

cd my-project
codex

四、第一次使用 Codex，不要直接让它改整个项目

这是非常重要的一点。

很多刚接触 AI 编程 Agent 的用户会直接输入：

帮我优化整个项目。

这种 Prompt 太宽泛。

更推荐先让 Codex了解项目结构：

请先分析当前项目目录。

告诉我：
1. 使用了什么技术栈
2. 核心入口文件在哪里
3. 数据库相关代码在哪
4. 当前项目大致分成哪些模块

暂时不要修改任何文件。

这样做的好处是：

先理解
↓
再缩小范围
↓
最后修改

而不是让 AI 一上来就大规模改代码。

五、Codex 最适合的第一个场景：阅读陌生项目

假设你刚接手一个项目：

src/
├── controller/
├── service/
├── repository/
├── middleware/
├── utils/
└── tests/

可以直接让 Codex：

请分析当前项目结构。

重点回答：

1. 请求入口在哪里
2. Controller 和 Service 如何调用
3. 数据访问层在哪里
4. 用户认证逻辑可能在哪
5. 建议我先阅读哪 5 个文件

这类任务其实比“帮我写一个函数”更能体现 AI 编程工具的价值。

因为真实开发中，很多时间并不是花在写代码上，而是花在：

理解旧代码
+
找调用关系
+
确认业务逻辑

六、第二个场景：让 Codex 帮你定位 Bug

假设项目中出现一个问题：

支付成功以后，订单状态偶尔没有更新。

不要直接说：

帮我修复支付 Bug。

更推荐：

当前问题：

支付回调成功后，
订单状态偶尔没有更新。

技术栈：
Node.js + TypeScript + Prisma

请先：

1. 分析可能涉及哪些模块
2. 找出最值得检查的文件
3. 判断是否可能存在重复通知
4. 判断是否存在并发更新问题

暂时不要修改代码。

等 Codex 确认问题范围以后，再继续：

现在只检查：

payment.controller.ts
payment.service.ts
order.service.ts

分析具体问题位置。

这种方式能明显减少无效上下文。

七、第三个场景：让 Codex 只修改必要代码

当问题确认以后，可以要求：

按照刚才的方案修改。

要求：

1. 保持现有项目结构
2. 不要大规模重构
3. 只修改必要代码
4. 不要修改无关文件

如果只是修改几行，可以继续要求：

只输出最小 diff。

例如：

- const userId = req.params.id;
+ const userId = Number(req.params.id);

+ if (Number.isNaN(userId)) {
+   throw new Error("Invalid user id");
+ }

这比一次重写整个文件更方便 Review。

八、第四个场景：让 Codex 生成测试

例如有一个函数：

def calculate_discount(price, level):
    if level == "vip":
        return price * 0.8
    return price

可以让 Codex：

请为这个函数编写 pytest 测试。

至少覆盖：

1. 普通用户
2. VIP 用户
3. price = 0
4. 负数输入
5. 非法 level
6. 非数字输入

AI 在这种结构化测试任务上通常非常适合。

程序员只需要进一步确认：

测试是否符合真实业务规则
+
边界条件是否完整
+
测试是否真的能运行

九、Codex 使用时最值得掌握的几个技巧

1. 先分析，再修改

推荐：

只分析，不修改。

确认方向没问题以后，再：

按照方案 2 修改。

这样可以减少返工。

2. 控制上下文

不要：

读取整个项目所有文件。

而应该：

先告诉我最相关的文件。

上下文越精准，Codex 通常越容易给出高质量结果。

3. 限制修改范围

可以明确要求：

不要修改数据库结构。
不要改变 API 返回格式。
不要重构无关代码。

这类约束非常重要。

4. 修改完成后再 Review 一次

例如：

请 Review 刚才的修改。

重点检查：

1. 是否引入新 Bug
2. 是否存在并发问题
3. 是否破坏原接口
4. 是否需要补测试

AI 编程不是“一次生成就结束”，而是一个迭代过程。

十、Codex 和 ChatGPT Plus / Pro 有什么关系？

目前官方说明中，Codex 已经包含在多种 ChatGPT 方案中，包括 Free、Go 以及更高等级方案，只是不同套餐的使用上限不同。

因此很多开发者在使用一段时间后，会进一步关注：

Codex 使用额度
↓
Plus 是否够用
↓
Pro 是否适合重度开发
↓
ChatGPT 订阅和续费问题

对于国内开发者来说，这几个问题经常会一起出现。如果需要同时了解 ChatGPT Plus 订阅、GPT 充值注意事项以及 Codex 使用额度，也可以例如参考 aicz123.com 中整理的相关中文资料，再结合 OpenAI 官方 Pricing 和 Usage 页面核对当前规则。

涉及账号和支付时，仍然建议优先保护好：

账号密码
验证码
Cookie
Session
API Key

不要随意交给不可信来源。

十一、Codex 不只是 CLI

虽然本文重点介绍的是 CLI，但 Codex 目前并不局限于终端。

官方当前提供的使用方式包括：

• Codex CLI

• Codex IDE 扩展

• Codex Web

• ChatGPT 桌面端 Codex 模式

这些入口都可以通过 ChatGPT 账号连接。

如果你平时主要使用 VS Code 一类 IDE，那么 IDE 扩展可能更加方便；如果习惯服务器、SSH 和命令行开发，Codex CLI 通常更顺手。

十二、推荐的 Codex 开发工作流

实际使用时，可以参考下面这个流程：

进入项目
↓
分析目录
↓
明确任务
↓
缩小相关文件
↓
让 Codex 分析
↓
确认修改方案
↓
执行最小修改
↓
运行测试
↓
再次 Review
↓
人工确认

尽量避免：

把整个项目交给 AI
↓
让 AI 随意修改
↓
发现问题
↓
重新修改
↓
不断返工

AI 编程工具的效率，很大程度上取决于开发者会不会拆解任务。

总结

Codex CLI 的安装并不复杂，核心命令就是：

npm i -g @openai/codex

安装以后使用 ChatGPT 账号完成登录，即可在项目目录中开始使用。

但真正决定 Codex 是否好用的，并不是“会不会安装”，而是能不能建立正确的使用方式：

• 先分析项目

• 明确任务范围

• 控制上下文

• 限制修改文件

• 使用最小 Diff

• 自动生成测试

• 修改后再次 Review

把 Codex 当成一个需要明确任务边界的 AI 开发协作者，而不是一个“自动写完整项目”的工具，通常更容易获得稳定的结果。

参考资料：

OpenAI Help Center：Using Codex with your ChatGPT plan。

OpenAI：Codex is now generally available。