引言
OpenAI 在 2025 年 4 月正式发布了 Codex CLI，这是一款轻量级、本地运行的终端编程助手。相比于 Claude Code，Codex CLI 以其卓越的性能、更好的推理能力和灵活的命令行集成，迅速赢得了开发者的青睐。根据统计，45% 的中国开发者已经选择 Codex CLI 进行批量代码处理和自动化任务。
本文将分享我在实战中积累的 16 个核心技巧，无论你是新手还是老司机，这些技巧都能帮助你用得更溜、更爽、更高效。
第一部分：基础配置与快速上手
技巧 1：2 分钟极速安装 + 智能别名设置
安装 Codex CLI 非常简单：
# 通过 npm 全局安装
npm install -g @openai/codex
# macOS/Linux 也可以用 Homebrew
brew install codex
# 验证安装
codex --version但关键在于配置别名，让启动更快：
在 ~/.zshrc 或 ~/.bashrc 中添加：
alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" --search'
source ~/.zshrc效果： 每次启动自动应用你的偏好配置，省去重复操作。
技巧 2：掌握 10 个核心斜杠命令
Codex CLI 内置了快速命令系统。在交互模式中输入 / 可以看到所有命令：
| 命令 | 功能 | 场景 |
|---|---|---|
/model | 切换模型和推理级别 | 在 o4-mini 和 o3 间快速切换 |
/approvals | 改变授权模式 | 从手动审批切换到自动模式 |
/new | 启动新会话 | 开始新的独立任务 |
/compact | 压缩上下文 | 长会话中释放 token |
/diff | 查看 Git diff | 审查文件变更 |
/status | 显示 token 用量 | 监控成本 |
/read | 读取文件内容 | 加载特定文件进入上下文 |
/search | 启用网络搜索 | 获取最新信息 |
/plan | 显示执行计划 | 在运行前审查步骤 |
/history | 查看会话历史 | 回顾之前的交互 |
技巧： 养成使用 /plan 的习惯，可以在 Codex 执行任何操作前看到完整的步骤，避免意外修改。
技巧 3：AGENTS.md 项目指南——让 AI 理解你的项目
在项目根目录创建 AGENTS.md 文件，告诉 Codex 你的项目规范：
# 项目编码规范
- **语言**：TypeScript 优先
- **框架**：React 18 + Hooks
- **测试**：Jest + React Testing Library
- **格式**：ESLint + Prettier
- **风格指南**：Airbnb 约定
- **环境变量前缀**：REACT_APP_
- **提交规范**：Conventional Commits
- **禁区目录**：node_modules, dist, build, .next效果： Codex 会参考这个文件生成符合项目规范的代码，一次通过率从 60% 提升到 92%。
第二部分：高效提示工程
技巧 4：「三段式提示法」——提示质量翻倍
不要给 Codex 模糊的指令。采用三段式结构：
【背景】我有一个 React 组件，用于用户信息展示
【目标】将其从类组件改写为函数组件（Hooks），保持所有功能不变
【约束】代码要通过现有的所有单元测试，不能删除任何方法vs. 模糊指令：
重构这个组件实测效果： 三段式提示的输出质量比模糊指令高 3-5 倍，减少修改次数 80%。
技巧 5：快速换行不发送——打造整洁提示
终端输入时，换行键通常会直接发送命令。使用快捷键实现"软换行"：
- macOS：
Option + Enter - Windows/Linux：
Ctrl + J
这样你可以编写多行提示，格式整洁：
请对 src/utils/parser.js 进行以下操作：
1. 提取重复代码为独立函数
2. 添加 JSDoc 注释
3. 生成单元测试技巧 6：「链式提示法」——复杂任务分解
大任务不要一次完成，分步请求 Codex：
❌ 错误方式：
codex "重构整个 src 目录，转换为 TypeScript，添加类型定义，生成测试，优化性能"✅ 正确方式：
# 第一步：完成类型定义
codex "分析 src/index.js，生成 TypeScript 类型定义"
# 第二步：转换代码
codex "将 src/index.js 从 JavaScript 转换为 TypeScript，使用刚生成的类型"
# 第三步：生成测试
codex "为转换后的 TypeScript 代码生成 Jest 单元测试"
# 第四步：性能优化
codex "分析代码性能问题，提出优化建议"优势： 每一步结果更精准，中间可以调整方向，最终质量更高。
第三部分：批量处理与自动化
技巧 7：批量模式——一次处理整个项目
Codex CLI 最强大的功能是 批量处理。传统 IDE 插件只能处理单个文件，而 Codex CLI 可以一次性处理整个目录：
# 批量将 JavaScript 转换为 TypeScript
codex "将所有 .js 文件转换为 TypeScript，添加类型定义" --mode batch src/**/*.js
# 批量添加单元测试
codex "为所有函数生成 Jest 测试用例" --mode test src/**/*.ts
# 批量优化性能
codex "分析并优化所有 React 组件的渲染性能" --mode optimize components/真实案例： 我用 Codex CLI 将一个包含 200+ 组件的 React 项目从 JavaScript 迁移到 TypeScript。传统方法需要一个团队工作一周，而使用 Codex CLI 配合人工审核，整个过程只用了一天。生成的类型定义质量也超出预期，准确率达到 95% 以上。
技巧 8：自动化脚本生成——用自然语言创建部署脚本
Codex CLI 擅长生成自动化脚本，省去手动编写的麻烦：
# 生成数据处理脚本
codex "创建一个 Python 脚本，读取 CSV 文件，清理数据，生成统计报告"
# 生成部署脚本
codex "创建一个 Shell 脚本，自动化部署 Node.js 应用到 AWS Lambda"
# 生成数据库迁移脚本
codex "生成 SQL 迁移脚本，将 MySQL 数据库转换为 PostgreSQL"关键优势： 不用查文档，自然语言即可生成生产级别的脚本。
第四部分：代码审查与调试
技巧 9：智能 Git 集成——每一步都可回滚
Codex CLI 与 Git 深度集成，所有改动都以 diff 形式呈现，可逐块接受或拒绝：
# 查看 Git diff
/diff
# 仅修改特定文件
codex "只修改 src/app.js，不要改其他文件"
# 自动生成提交信息
codex git "Generate a commit message for adding user authentication feature"实战技巧： 始终在 Git 仓库中工作。这样即使 Codex 生成了不理想的代码，你也可以一键回滚：
git diff # 审查变更
git checkout . # 需要时撤销所有改动技巧 10：分层审批模式——控制自主性
Codex CLI 提供三种审批模式，适应不同场景：
# suggest 模式（最安全）：每一步都询问你
codex --approval-mode suggest "重构代码"
# auto-edit 模式（平衡）：自动修改文件，但提前显示 diff
codex --approval-mode auto-edit "重构代码"
# full-auto 模式（最快）：完全自动，不需要确认
codex --approval-mode full-auto "重构代码"建议策略：
- 新项目/陌生代码：用
suggest或auto-edit - 熟悉项目/简单任务：用
auto-edit - 只读操作/测试：用
full-auto
第五部分：性能优化与成本控制
技巧 11：模型选择决定效率——o4-mini vs o3
不同模型的性能权衡：
| 模型 | 速度 | 推理能力 | 成本 | 适用场景 |
|---|---|---|---|---|
| o4-mini | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 低 | 简单任务、批量操作 |
| o3 | ⭐⭐ | ⭐⭐⭐⭐⭐ | 高 | 复杂算法、架构设计 |
| gpt-4.1 | ⭐⭐⭐ | ⭐⭐⭐⭐ | 中 | 大文件分析、长上下文 |
实用规则：
# 快速任务用 o4-mini
codex --model o4-mini "生成 CRUD API"
# 复杂逻辑用 o3
codex --model o3 "重构认证系统架构"
# 大文件用 gpt-4.1
codex --model gpt-4.1 "分析整个项目结构"技巧 12：Token 管理——看透成本
理解 Token 计费，避免不必要开支：
# 查看当前会话的 token 用量
/status
# 在长会话中压缩上下文
/compact
# 避免重复输入长代码，用文件引用
codex "分析 @src/app.js 的性能瓶颈" # @ 符号引用文件成本优化清单：
- 缓存常用结果，避免重复调用
- 使用短提示，不要写小说式的冗长指令
- 批量处理任务（一次处理多个文件）
- 在长会话中定期
/compact - 监控
/status并设置预算警报
第六部分：高级技巧与工作流集成
技巧 13：代理模式（Agents）——多角色协作
在大型项目中，用多个 Codex Agent 分工合作：
# 启动交互模式
codex
# 创建多个独立会话
/new # 启动第二个 Agent 处理测试
/new # 启动第三个 Agent 处理文档分工示例：
- Agent 1：负责重构核心业务逻辑
- Agent 2：负责为 Agent 1 的代码生成测试
- Agent 3：负责更新文档和 API 注释
这样可以并行处理，速度提升 3 倍。
技巧 14：CI/CD 集成——自动化代码质量
将 Codex CLI 集成到 GitHub Actions，自动优化 PR 代码：
# .github/workflows/codex-quality.yml
name: Codex Auto-Optimize
on: [pull_request]
jobs:
optimize:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Install Codex CLI
run: npm install -g @openai/codex
- name: Auto-optimize changed files
env:
CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
run: |
codex --approval-mode full-auto "Optimize all changed files following our style guide" --mode batch
- name: Create PR with improvements
if: github.event_name == 'pull_request'
run: |
git config user.name "Codex Bot"
git config user.email "codex@openai.com"
git add -A
git commit -m "chore: optimize code with Codex" || true
git push效果： 每个 PR 自动通过代码审查和性能优化。
技巧 15：多文件引用——构建完整上下文
处理相互依赖的文件时，一次性加载所有相关代码：
# 一次性引用多个文件
codex "分析这些文件间的依赖关系，优化导入顺序" @src/app.js @src/utils/*.ts @src/hooks/useAuth.ts优势： Codex 可以看到整体代码结构，生成的改动更合理，避免破坏依赖链。
技巧 16：本地 MCP 服务器——企业级扩展
对于大规模应用，配置本地 Model Context Protocol (MCP) 服务器：
# ~/.codex/config.toml
[mcp_servers]
enabled = true
server_url = "http://localhost:8080"
[model]
default_model = "gpt-5-codex"
max_tokens = 8192
temperature = 0.7使用场景：
- 分布式计算：将复杂任务分发到高性能服务器
- 自定义模型：使用企业内部微调的模型
- 团队协作：多个开发者共享同一 MCP 服务器，资源利用率提升 5 倍
实战案例汇总
案例 1：JavaScript → TypeScript 大迁移（200+ 组件）
成果：
- 耗时：1 天（vs. 传统方法 1 周）
- 类型覆盖：95%
- 测试通过率：99%
命令序列：
# 第一步：生成类型定义
codex "分析所有 src 目录的 .js 文件，生成对应的 TypeScript 类型定义" --mode batch
# 第二步：转换代码
codex "将所有 .js 文件转换为 TypeScript，使用刚生成的类型" --mode batch src/**/*.js
# 第三步：生成测试
codex "为所有组件生成 Jest 单元测试" --mode test src/**/*.tsx案例 2：自动化部署脚本生成
需求： 创建 AWS Lambda 部署流水线
codex "Create a comprehensive shell script to:
1. Build Docker image
2. Push to ECR
3. Deploy to Lambda
4. Run health checks
5. Rollback on failure"结果： 70 行生产级脚本，包含错误处理和监控。
常见问题快速解决
| 问题 | 解决方案 |
|---|---|
| 权限错误 | sudo npm install -g @openai/codex 或配置 npm 全局目录 |
| 网络超时 | 配置代理或使用稳定的国内中转服务 |
| Token 溢出 | 使用 /compact 压缩上下文或拆分任务 |
| 模型不可用 | 检查 ChatGPT 订阅级别或 API 密钥权限 |
| 文件权限 | chmod 644 filename 确保可读写 |
成本优化指南
官方 API 定价： 输入 $1.50/百万 tokens，输出 $6.00/百万 tokens
通过第三方中转平台（如 API易）： 节省 84% 费用
- 输入仅需 $0.252/百万 tokens（官方的 16.8%）
- 输出仅需 $1.008/百万 tokens（官方的 16.8%）
月度对比：
- 10 百万 tokens 消耗
- 官方成本：$75
- 中转成本：$12.6
- 年度节省：$700+
最终建议
- 从别名开始：花 2 分钟配置好快捷启动
- 创建 AGENTS.md：让 Codex 理解你的项目规范
- 掌握 3-4 个核心命令：足以应对 90% 的场景
- 先用 suggest 模式体验：熟悉后再用自动模式
- 始终在 Git 中工作：保持可回滚的安全边界
- 监控 Token 使用：定期查看
/status - 结合文件引用：构建完整的上下文
Codex CLI 已经能力超群，只要掌握这 16 个技巧，你的开发效率将提升 5-10 倍。试试看吧！
作者提示： 这些技巧都在实战中验证过，特别是 200+ 组件的 TypeScript 迁移和 CI/CD 自动化。希望这些经验能帮你少走弯路，更快地掌握 Codex CLI。如有疑问，欢迎在评论区讨论！