Appearance
Codex 是什么？从工作原理到第一次使用
如果你搜索“Codex 是什么”“Codex 怎么用”，通常想知道的不是一句产品介绍，而是三个实际问题：它能不能理解我的仓库、能不能直接改代码、我怎样判断它没有改错。可以把 Codex 理解成面向软件开发的 AI 工作代理：它读取项目上下文，根据任务调用开发工具，修改工作区中的文件，再通过测试、构建和 diff 让结果可检查。
官方产品信息可以查看 OpenAI Codex 官方页面，具体功能、登录方式和版本支持以 OpenAI Codex 开发者文档 为准。本文补充的是面向中文开发者的工程使用方法。
Codex 和普通聊天有什么区别
普通聊天主要依赖你粘贴到对话中的文字。Codex 更接近一个在项目目录中工作的开发工具，它可以在授权范围内：
- 阅读源码、测试、配置和依赖文件
- 根据任务搜索相关实现和调用方
- 修改一个或多个文件
- 执行测试、类型检查、构建或其他命令
- 汇报修改内容、命令结果和仍然存在的风险
关键不只是“它会自动写代码”，而是它能够把理解、编辑和验证连接起来。上下文越接近真实仓库，任务描述越具体，结果越容易复现。
一次 Codex 任务发生了什么
text
任务目标 → 读取项目上下文 → 制定修改计划 → 编辑文件
→ 运行验证命令 → 检查 diff → 汇报结果第一步是明确目标和边界。第二步是让 Codex 找到真正的入口、调用方和测试，而不是凭文件名猜测。第三步先拆出计划，尤其适用于跨模块任务。最后必须看 diff 和验证结果，因为模型的“已完成”不等于项目已经通过测试。
Codex 能做什么
阅读和解释代码
你可以让 Codex 解释一个模块的调用链、数据流和错误处理路径：
阅读
src/orders和相关测试，只总结创建订单的调用链、数据校验位置和失败处理，不修改文件。
只读任务适合第一次建立信任，也适合排查陌生仓库。要求它给出文件路径和证据，能减少泛泛解释。
实现范围明确的功能
把功能拆成可验证的小任务，例如新增接口校验、补一个边界测试或修复一个错误状态。提示词中写明允许修改的目录、不能改变的接口和完成标准。
代码审查和重构
让 Codex 审查 diff 时，应要求它按严重程度报告行为回归、边界条件、安全风险和测试缺口。不要只问“代码有没有问题”，那样很容易得到没有优先级的建议。可以参考用 Codex 做代码审查。
整理文档和工程规则
Codex 适合把已有代码事实整理成 README、迁移说明和 AGENTS.md。规则文件应记录长期有效的命令、目录边界和验证方式，具体写法见 AGENTS.md 项目规则。
Codex 不是什么
不是无需审查的自动提交器
它可能提出错误假设、遗漏边界条件或误解旧代码。生产配置、数据库迁移、权限变更和大范围重构都应该先分析，再小步实现，并由人检查 diff。
不是项目需求的替代品
“把登录做好”不是完整需求。你仍需要说明成功和失败行为、兼容性、性能限制、允许修改的范围和验证命令。任务越清楚，返工越少。
不是任何 API 的通用适配层
如果你把 Codex 能力接入自己的产品，要确认 API 的认证方式、Base URL、模型 ID、工具调用和流式响应是否匹配。API 场景可以从 Codex API 接入概览 开始。
本地 CLI 和 API 怎么选
| 场景 | 更适合的方式 | 原因 |
|---|---|---|
| 在自己的仓库中修改代码 | Codex CLI 或官方 Codex 工作流 | 能直接读取项目并运行本地命令 |
| 在后台服务中生成结果 | API | 可以接入队列、权限、日志和业务数据库 |
| Pull Request 自动审查 | API 或受控自动化任务 | 需要固定输入、超时、重试和审计 |
| 一次性理解陌生项目 | 本地只读任务 | 上下文完整，验证成本低 |
CLI 安装步骤见 Codex CLI 安装与使用。如果是服务端调用，还要阅读 API Key 配置 和 生产环境接入清单。
第一次使用的推荐任务
进入一个 Git 工作区后，先发只读任务：
text
请先读取 package.json、README、项目入口和测试配置。
只告诉我：如何启动、如何测试、主要模块在哪里。
不要修改任何文件，也不要执行有副作用的命令。确认它理解仓库后，再做一个小改动：指定目标文件、行为变化和验证命令。完成后运行 git diff、受影响测试和构建，确认结果再扩大任务。
FAQ
Codex 和 ChatGPT 是一回事吗？
它们都可以使用 AI 模型，但产品形态和工作方式不同。Codex 面向软件开发任务，重点是项目上下文、工具调用、代码修改和验证。具体产品边界请以官方 Codex 文档为准。
Codex 会读取整个仓库吗？
它会根据任务、工作目录和工具权限读取相关上下文，不应假设它已经理解所有文件。大仓库应指定目录和入口，必要时先做只读分析。
Codex 生成的代码可以直接上线吗？
不建议直接上线。至少检查 diff、运行测试和构建，确认权限、错误处理、日志和敏感数据边界。生产变更应保留人工审查和回滚方案。
使用 Codex 需要 API Key 吗？
取决于你使用的产品形态和认证方式。CLI 登录、官方服务和第三方 API Provider 的配置方式可能不同，不要把一种方式的 Key 写进另一种配置。可从 API Key 配置教程 开始。