Entropic Echo

主题

Codex CLI 手动配置与排错 ​

日常安装、CC Switch 配置、Codex App 和启动流程见 Codex 使用指南。本页只说明手动配置、参数与排错。

第三方模型请使用 Codex++

本页的 config.toml 示例适用于 Codex CLI 使用 GPT 官方模型（gpt-*）的手动排障。若要在 Codex 桌面 App 使用 DeepSeek、Claude、Gemini 等第三方模型，或任何非 GPT 官方模型，请使用 Codex++ 配置第三方模型，不要在 CC Switch 中配置 Codex。

手动编辑配置文件 ​

文件位置 ​

系统config.tomlauth.json
WindowsC:\\Users\\<USERNAME>\\.codex\\config.tomlC:\\Users\\<USERNAME>\\.codex\\auth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json

config.toml ​

toml
model_provider = "entropicecho"
model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
disable_response_storage = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

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

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

1M 上下文配置 ​

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

toml
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 ​

json
{
"OPENAI_API_KEY": "sk-xxx"
}

配置参数说明 ​

参数说明可选值
model_provider模型提供商标识自定义名称
model使用的模型从模型广场复制
model_reasoning_effort推理深度low / medium / high
disable_response_storage禁用响应存储true（推荐）
wire_apiAPI 协议responses

常见问题 ​

Base URL 格式问题 ​

工具Base URL 格式
Claude Codehttps://站点地址（不带 /v1）
Codexhttps://站点地址/v1（带 /v1）

外接调用返回 403 block？ ​

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

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

示例：

json
{
"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 说明。