从基础到实战
先理解 Codex 如何工作，再逐步进入配置、提示词、测试和代码审查。
Codex 中文指南从安装到自主 AI Agent
覆盖安装配置、提示词、项目规范、权限安全与国内 API 接入的完整 Codex 中文指南。
Codex 是 OpenAI 面向软件开发工作的编码代理。它可以理解项目结构、读取和修改多个文件、运行命令与测试，并根据执行结果继续完成任务。与只补全一段代码的工具不同，Codex 更适合处理具有明确目标和验收条件的完整工程工作。
你可以在 Codex 桌面应用中管理本地项目和开发任务，也可以根据工作环境选择 CLI、IDE 扩展或云端任务。不同入口的界面有所区别，但核心工作方式相同：让 Codex 获取必要的项目上下文，在受控权限内操作，并用测试、构建或差异审查验证结果。
| 使用场景 | Codex 可以完成的工作 | 建议的验证方式 |
|---|---|---|
| 理解代码库 | 梳理目录、调用链、数据流和启动方式 | 对照 README、配置文件和实际命令 |
| 实现功能 | 复用现有模式修改多个文件并补充测试 | 运行相关测试、类型检查和构建 |
| 修复缺陷 | 定位根因、建立复现、完成最小修复 | 确认测试在修复前失败、修复后通过 |
| 代码审查 | 检查行为回归、权限风险和缺失测试 | 查看具体文件、行号和触发条件 |
| 工程维护 | 更新依赖、整理文档、处理重复任务 | 检查差异并记录未验证的风险 |
Codex 并不会自动保证代码正确。对于数据库迁移、生产部署、密钥、付款和删除操作，仍应保留人工审批，并检查它实际执行过的命令与测试。
第一次任务可以这样写：
阅读 README 和项目配置，说明这个项目如何启动、测试和构建。
先不要修改文件；结果中列出你实际读取的文件和仍不确定的部分。任务明确之后，再逐步增加写入、测试或代码审查范围。更完整的写法见 Codex 高质量提示词。
第一次接触 Codex，建议依次阅读 Codex 是什么、Codex 应用下载安装 和 高质量提示词。准备把它用于真实项目时，再配置 AGENTS.md、沙箱权限 与 代码审查。
AGENTS.md 保存项目规则。 把目录结构、构建命令、验证要求和禁止修改的文件变成仓库中的长期指令。相关指南：使用 AGENTS.md、沙箱与权限、代码审查与测试、连接 MCP 工具。
本站是独立中文社区指南，不是 OpenAI 官方网站。使用第三方 API 前，请自行确认服务条款、数据处理方式、模型能力和计费规则。详见隐私协议。