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