Codex: Codex CLI 模型选择
最后更新：2026-08-31
CLI 环境下的模型选择更灵活，支持更多自定义选项。本节聚焦 CLI 的模型相关配置。
📋 前置知识：了解 Codex 模型选择基本知识（见第 19 课）
1. 你将学到
- CLI 模型参数
- 多模型切换
- 成本优化实战
- 模型性能对比
2. CLI 模型参数
BASH
# 指定模型
codex --model o3
# 指定模型 + 温度
codex --model gpt-5-codex --temperature 0.2
# 指定模型 + 最大 token
codex --model o3 --max-tokens 8192
# 查看可用模型
codex --list-models
参数说明
| 参数 | 说明 | 推荐值 |
|---|---|---|
--model |
模型名称 | 按任务选择 |
--temperature |
创造性（0-1） | 0.1-0.3（代码） |
--max-tokens |
最大输出 | 4096-8192 |
--top-p |
采样范围 | 0.9（默认） |
3. 多模型切换
(1) 配置文件切换
TOML
# ~/.codex/config.toml
model = "gpt-5-codex" # 默认模型
# .codex/config.toml（项目级）
model = "deepseek-coder" # 项目覆盖
(2) 环境变量切换
BASH
# 临时切换
CODEX_MODEL=o3 codex "设计微服务架构"
# DeepSeek
export OPENAI_API_KEY="sk-deepseek-xxx"
export OPENAI_BASE_URL="https://api.deepseek.com"
codex --model deepseek-coder
(3) Alias 快捷切换
BASH
# ~/.zshrc 或 ~/.bashrc
alias codex-o3='codex --model o3'
alias codex-fast='codex --model o4-mini'
alias codex-deep='export OPENAI_API_KEY="sk-deepseek-xxx"; export OPENAI_BASE_URL="https://api.deepseek.com"; codex --model deepseek-coder'
# 使用
codex-o3 "设计系统架构"
codex-fast "修复 lint 错误"
codex-deep "写单元测试"
▶ 示例 1: Alice 的多模型工作流
BASH
# Alice 的 alias 配置
alias codex-draft='codex --model o4-mini --temperature 0.5' # 草稿
alias codex-code='codex --model gpt-5-codex --temperature 0.2' # 编码
alias codex-think='codex --model o3 --temperature 0.1' # 深度思考
# 使用
codex-draft "快速生成 API 骨架"
codex-code "实现用户注册功能"
codex-think "设计分布式缓存方案"
4. 成本优化实战
(1) 分级策略
| 任务级别 | 模型 | 成本/任务 | 场景 |
|---|---|---|---|
| L0 | o4-mini | $0.001 | 格式化、加注释 |
| L1 | deepseek-coder | ¥0.01 | Bug 修复、添加功能 |
| L2 | gpt-5-codex | $0.05 | 重构、API 开发 |
| L3 | o3 | $0.30 | 架构设计、复杂算法 |
(2) 自动降级
BASH
#!/bin/bash
# smart-codex.sh - 智能模型选择
TASK="$1"
# 简单任务用便宜模型
if echo "$TASK" | grep -qiE "lint|format|comment|typo"; then
codex --model o4-mini "$TASK"
elif echo "$TASK" | grep -qiE "fix|bug|add feature"; then
codex --model gpt-5-codex "$TASK"
elif echo "$TASK" | grep -qiE "architect|design|migrate|refactor"; then
codex --model o3 "$TASK"
else
codex --model gpt-5-codex "$TASK"
fi
▶ 示例 2: Bob 的月度成本
TEXT
📖 仅展示
# Bob 的任务分布（每月 200 个任务）
L0 (30%): o4-mini → 60 × $0.001 = $0.06
L1 (40%): deepseek-coder → 80 × ¥0.01 = ¥0.80 ≈ $0.11
L2 (25%): gpt-5-codex → 50 × $0.05 = $2.50
L3 (5%): o3 → 10 × $0.30 = $3.00
总计：约 $5.67/月
如果全用 o3：约 $60/月
节省：90%
5. 模型性能实测
(1) 测试方法
| 测试项 | 说明 |
|---|---|
| 代码生成 | 生成 REST API 端点 |
| Bug 修复 | 修复空指针异常 |
| 重构 | 将 Class 组件转 Hooks |
| 审查 | 安全漏洞扫描 |
(2) 结果对比
| 模型 | 代码生成 | Bug 修复 | 重构 | 审查 | 速度 |
|---|---|---|---|---|---|
| o3 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 🐢 |
| gpt-5-codex | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 🏃 |
| gpt-4o | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 🏃 |
| o4-mini | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⚡ |
| deepseek-coder | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 🏃 |
❓ 常见问题
Q CLI 如何查看当前使用的模型？
A 运行
codex --show-config 或在会话中使用 /config 命令。Q temperature 设多少合适？
A 代码生成建议 0.1-0.3（更确定），文档和创意建议 0.5-0.7（更灵活）。
Q max-tokens 设多大？
A 简单修改 2048 足够，复杂重构 4096-8192，超长文档可能需要更大。设太小会截断输出。
Q 可以用模型的 API 名而不是别名吗？
A 可以。
--model gpt-5-codex-2026-08-28 等完整名称也支持。Q CLI 和 App 用同一模型效果一样吗？
A 底层模型一样，效果相同。但 App 有额外的 UI 优化和上下文管理。
📖 小节
- CLI 模型参数：
--model/--temperature/--max-tokens - 多模型切换：配置文件 / 环境变量 / Alias
- 成本优化：分级策略 + 自动降级 + DeepSeek 替代
- 实测：o3 最强最慢，o4-mini 最快最便宜
📝 作业
- 基础题（难度⭐）：配置 Alias 实现快速模型切换。
- 进阶题（难度⭐⭐）：实现自动降级脚本——根据任务描述选择模型。
- 挑战题（难度⭐⭐⭐）：对你常用的任务进行模型性能实测，建立自己的模型选择矩阵。
