OpenAI Codex 是 OpenAI 在 2025 年正式推出并大规模普及的新一代 AI 软件工程智能体（Coding Agent），被定位为"AI 软件工程队友"，截至目前（2026年01月25号）被认为是与 Claude Code 并列的最强编程智能体之一。它已经远超 2021 年的那个纯代码生成模型（那个老 Codex 早已下线），现在的 Codex 是完整的自主编码 Agent 系统，能真正"像工程师一样工作"。
Codex 是由 OpenAI 推出的智能编程代理，可以理解自然语言并生成、理解、修改代码，支持调试、测试执行、代码审查等软件工程任务。Codex 可在 ChatGPT 侧边栏任务模式、终端 CLI、本地 IDE 扩展和 SDK 中运行，用于提高开发效率。
主要特点包括：
理解大型代码库并生成补丁、功能实现、错误修复等。
可自动执行测试、静态分析等环境命令。
支持本地 CLI、云端任务、IDE 扩展等多种交互方式。
一句话理解：Codex = 会"读项目、改代码、跑测试、给补丁"的 AI 程序员，而不是只会聊天的代码生成器。和普通 ChatGPT 写代码的关键区别：
一、Codex 官网相关网址
Codex 官方产品页（OpenAI）：
Codex Docs 主文档（开发者站点）：
https://developers.openai.com/codex/
Codex 官方介绍页面（中文）：
https://openai.com/zh-Hans-CN/codex 或 https://openai.com/zh-Hans-CN/index/introducing-codex
发者文档 / SDK：
https://developers.openai.com/codex 或 https://platform.openai.com/docs/codex （随模型更新）
Codex CLI 官方文档（终端使用）：
https://developers.openai.com/codex/cli/
Codex IDE 扩展（VS Code 等）文档：
https://developers.openai.com/codex/ide/
Codex Changelog（更新日志）：
https://developers.openai.com/codex/changelog/
OpenAI 官方介绍 CodeX :
https://openai.com/zh-Hans-CN/index/introducing-codex/OpenAI
OpenAI 官方出过一本如何使用它的应用手册:
https://cdn.openai.com/pdf/6a2631dc-783e-479b-b1a4-af0cfbd38630/how-openai-uses-codex.pdf
二、流行的安装或使用方式
1. 通过 ChatGPT 使用
如果你订阅了支持的套餐（Plus、Pro、Business、Enterprise、Edu），就可以在 ChatGPT 左侧栏看到 Codex 入口，点击即可开始任务（如让 Codex 写功能、修复 bug、解释代码等）。
基本交互步骤：
-
打开 ChatGPT 左侧栏 Codex。
-
输入自然语言提示描述任务。
-
Codex 自动跑测试、生成补丁，并显示 diff/日志。
-
审核、迭代或导出更改。
2. 通过终端 CLI（命令行）使用
这是 Codex 的本地使用方式：
# 安装 CLI
```bash
npm install -g @openai/codex
```首次运行将提示登录，并可使用你的 ChatGPT 账户凭证。
3. IDE 中使用
Codex 提供 IDE 扩展，可配合 VS Code、Cursor、Windsurf 等使用：
-
安装 Codex 扩展（如 VS Code Marketplace 中查找 "Codex"）。
-
扩展提供侧边 Codex 面板，可直接在 IDE 内启动任务、代码生成或审查。
-
可自定义快捷键绑定（IDE 设置中调整）。
三、快捷键速查
常用快捷键
编辑快捷键
以下是 OpenAI Codex 在主流 IDE 中的快捷键对比表（基于 2026 年 1 月的最新集成情况）：
四、权限与计费（截至2026年01月25号）
五、Codex 的指导文件 AGENTS.md
CodeX 中的 AGENTS.md 是一个简单又开放的格式，专门用来指导 CodeX 更好的干活。可以把 AGENTS.md 想象成是给 Agents 准备的 README，它提供了一个专门的、可预测的地方，用来提供上下文和指令，帮助 AI 编码 Agents 更好地完成你的项目。
详细介绍：https://agents.md/
通过 /init 命令，初始化一个项目的 AGENTS.md 指导文件。默认使用的文件是英文的，可以手动把它转换成中文，覆盖原有的英文。
五、如何正确给 Codex 下指令（核心技巧）
## Codex 指令黄金结构（新手必背）
```
【目标】
【范围】
【约束】
【验证方式】
```
### 示例 1：修 Bug
❌ 错误示范（太模糊）：
> 这个接口有 bug，帮我修一下
✅ 正确示范：
> 目标：修复订单查询接口在并发下返回重复数据的问题
> 范围：仅修改 OrderService 和相关 Repository
> 约束：不允许改数据库结构
> 验证：需要补充一个并发测试用例并通过
### 示例 2：加功能
> 目标：给录音分析接口增加"关键词命中统计"功能
> 范围：speech-analysis 模块
> 约束：接口返回结构保持不变
> 验证：新增单元测试覆盖核心逻辑
## 新手最容易犯的 3 个错误
1. ❌ 一句话扔需求
2. ❌ 不给范围，Codex 会"全项目游走"
3. ❌ 不说验证方式（测试）
## 技巧 1：先"读"，再"改"
优秀流程：
```
先分析问题 → 给出修改方案 → 我确认 → 再改代码
```
可以明确说：
> 请先给出修改方案和影响评估，不要直接改代码。
## 技巧 2：让 Codex 生成 Diff
```
请只输出 Git diff，不要解释。
```
非常适合：
* 审核
* 粘到 PR
## 技巧 3：限制修改范围（极其重要）
```
仅允许修改以下文件：
- xxx.java
- yyy.java
```
## 技巧 4：分阶段任务
不要一次性说：
> 帮我重构整个项目
而是：
1. 分析问题
2. 重构核心模块
3. 再优化边缘代码六、Codex 常见实战场景
## 场景 1：修生产 Bug（最常用）
```
线上接口在并发请求时偶发 500。
请定位问题原因，修复代码，并补充单元测试。
```
Codex 通常会：
* 找日志
* 找线程不安全代码
* 改实现
* 自动跑测试
## 场景 2：代码重构
```
请将 UserService 中超过 300 行的方法拆分，
遵循单一职责原则，不改变外部行为。
```
## 场景 3：代码审查（替代人工 Review）
```
请对当前提交的代码做一次 code review，
重点关注：
1. 并发安全
2. 性能问题
3. 可维护性
```
## 场景 4：写测试（强烈推荐）
```
请为 PaymentService 补充完整的单元测试，
覆盖成功、失败、异常三种场景。
```没有自由的秩序和没有秩序的自由，同样具有破坏性。
