什么是 Codex CLI
OpenAI 在 2025 年推出了 Codex CLI，一个在终端中运行的 AI 编程代理。它可以直接读取你的代码库，理解项目结构，并执行文件编辑、运行命令等操作。
安装与配置
Codex CLI 通过 npm 安装：
npm install -g @openai/codex安装后需要配置 OpenAI API Key：
export OPENAI_API_KEY=your-key-here三种运行模式
Suggest 模式（默认）
AI 提出建议但不自动执行，你需要逐步确认每个操作。适合学习和谨慎的修改。
Auto Edit 模式
AI 可以自动编辑文件但不能执行命令。适合批量代码修改场景。
Full Auto 模式
AI 完全自主工作，自动编辑文件和执行命令。适合有信心的重复性任务。
实战示例
示例1：给项目添加 TypeScript 支持
codex "给这个 JavaScript 项目添加 TypeScript 支持，配置 tsconfig，把 src 目录下的 .js 文件转换为 .ts"示例2：编写测试
codex "为 src/utils/ 目录下的所有函数编写 Jest 单元测试"示例3：修复 CI 问题
codex "CI 报错 eslint error，请修复所有 lint 错误"最佳实践
- 始终在 Git 仓库中使用，方便回滚
- 先用 Suggest 模式熟悉行为，再切换 Auto
- 复杂任务拆分为小步骤，逐个执行
- 定期 commit，避免大范围修改后难以追踪
与 GitHub Copilot 的区别
Copilot 是编辑器内的实时补全工具；Codex CLI 是终端中的任务执行代理，能理解整个项目并完成多步骤任务。两者互补使用效果最佳。