Codex CLI 配置参考

本页用于手动配置、模型参数说明和排障。日常使用默认推荐先看 CC Switch 统一配置。

---

配置方式一：CC Switch（默认推荐）

CC Switch 是最简单的配置方式，自动写入 config.toml 和 auth.json，无需手动编辑文件。完整步骤见 CC Switch 统一配置。

配置步骤 ：

1. 打开 CC Switch ，框架选 Codex ，点击"添加配置"
2. 选 自定义配置，Base URL 填 https://api.amadeus.mom/v1
3. 填写 API Key （sk-xxx）
4. 点击添加 ，应用后重启终端

---

配置方式二：手动编辑配置文件

文件位置

系统	config.toml	auth.json
Windows	C:\\Users\\<USERNAME>\\.codex\\config.toml	C:\\Users\\<USERNAME>\\.codex\\auth.json
macOS / Linux	~/.codex/config.toml	~/.codex/auth.json

---

config.toml

model_provider = "entropicecho"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.entropicecho]
name = "entropicecho"
base_url = "https://api.amadeus.mom/v1"
wire_api = "responses"
requires_openai_auth = true

Codex 的 Base URL 需要 /v1 后缀，与 Claude Code 不同。

1M 上下文配置

如果你当前使用的是支持长上下文的 Codex 接入方案，建议同时确认以下两项。注意：这两个参数必须写在顶层，不能写在 [model_providers.entropicecho] 供应商配置下：

model_context_window = 1000000
model_auto_compact_token_limit = 900000

含义分别是：

参数	作用
model_context_window	将可用上下文窗口设为 1,000,000
model_auto_compact_token_limit	接近上限前提前触发压缩，避免对话直接撞满

如果你通过 CC Switch 一键写入配置，优先以 CC Switch 生成结果为准；只有在手动排障时才建议自己改 config.toml。

---

auth.json

{
"OPENAI_API_KEY": "sk-xxx"
}

---

配置参数说明

参数	说明	可选值
model_provider	模型提供商标识	自定义名称
model	使用的模型	见下方模型列表
model_reasoning_effort	推理深度	low / medium / high
disable_response_storage	禁用响应存储	true（推荐）
wire_api	API 协议	responses

---

支持的模型

模型	说明
gpt-5.5	最新版本（推荐）
gpt-5.4	稳定版本
gpt-5.4-mini	轻量版，响应更快、成本更低
gpt-5.3-codex-spark	Codex 代码优化版
codex-auto-review	自动代码评审

---

常见问题

Base URL 格式问题

工具	Base URL 格式
Claude Code	https://站点地址（不带 /v1）
Codex	https://站点地址/v1（带 /v1）

外接调用返回 403 block？

如果你不是直接使用官方默认链路，而是把 Codex 接到第三方平台、网关、自定义客户端或其他外接场景，除了 Base URL 和 API Key 之外，还要同时满足：

1. 使用正确的模型名称，以 控制台 可用模型为准
2. 请求头中携带 Codex 对应的 User-Agent

示例：

{
"Authorization": "Bearer sk-xxx",
"User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
}

缺少对应 UA 时，常见报错就是 403 block 或 403 Forbidden。

如果外接的是其他类型模型，也同样需要按对应类型补 User-Agent。

API Key 无效？

1. 检查 ~/.codex/auth.json 中的 Key 是否正确
2. 确认中转站余额充足
3. 确认 Token 未过期

推理速度慢？

将 model_reasoning_effort 从 high 改为 medium 或 low，响应速度可显著提升。

同时使用 Claude Code 和 Codex？

两者配置文件独立，互不冲突。使用 CC Switch 可统一管理：

• Claude Code → ~/.claude/settings.json
• Codex → ~/.codex/config.toml + ~/.codex/auth.json

外接 UA 的统一说明见 外接调用 User-Agent 说明。