# Codex CLI 接入最新模型全攻略：GPT-5.6 / Claude Fable 5 这样配才不踩坑

> Codex CLI 一直支持接入第三方模型——只要你的接口是 OpenAI 兼容的，改个 `base_url` 就能把 DeepSeek、Claude、GLM、Gemini 都接进来。但真上手配，坑比想象多：模型名白名单、超时、Key 读取顺序，还有 2026 年 2 月起强制的 `wire_api = "responses"`……我把几篇实测教程里的高频坑整合了一遍，照着配一遍就能跑。

## 一、配置文件在哪

Codex CLI 的配置在 `~/.codex/config.toml`（Windows 是 `%USERPROFILE%\.codex\config.toml`）。没有就新建：

```
mkdir -p ~/.codex
touch ~/.codex/config.toml
```

API Key 也可以单独放 `~/.codex/auth.json`，或者走环境变量——顺序后面会说。

## 二、两种方式：改 base_url 最简单，自定义 Provider 最灵活

官方给了两条路。

**方式一：只改 base_url（最省事）**

如果你的接口是 OpenAI 兼容格式，直接把地址换掉，其他不动：

```
openai_base_url = "https://genvis.xyz/v1"
model = "gpt-5.6-sol"
```

**方式二：自定义 Provider（多模型 / 多 Key 灵活）**

想在 GPT-5.6、Claude Fable 5 之间切，或不同模型用不同 Key，用这个：

```
model = "claude-fable-5"
model_provider = "genvis"

[model_providers.genvis]
name = "Genvís AI"
base_url = "https://genvis.xyz/v1"
env_key = "GENVIS_API_KEY"
wire_api = "responses"
```

`env_key` 指向环境变量 `GENVIS_API_KEY`，Key 放那儿就行。注意 Provider 名字自己取，但**不能叫 `openai`、`ollama`、`lmstudio`** 这三个保留名。

## 三、能在 Codex 里用 Claude Fable 5 吗？能，改一行 model

这是最多人问的。实测下来：把 `model` 直接写成 Claude 的型号就行。

```
model = "claude-fable-5"
```

只要你的 base_url 指向的网关同时聚合了 Claude（目前主流的 OpenAI 兼容聚合网关都接了全系），Codex 会用 OpenAI Responses API 的形状把请求发出去，网关负责翻译成 Claude 原生格式——Codex 本身完全不用改。

同一条编程任务实测：Claude Fable 5 在 Codex 上跑复杂逻辑，正确率不输 GPT-5.6 Sol，特别在长上下文代码推理上被明显低估了。日常 CRUD 用便宜的 GPT-5.6-Luna / DeepSeek V4，复杂重构切 Claude Fable 5，一个工具全搞定。

## 四、config.toml 还能调这些

除了上面那些，这几个字段很实用（来自阶跃官方接入教程的实测）。下面每个字段单独说明：

```
model_reasoning_effort = "high"
model_context_window = 256000
model_auto_compact_token_limit = 200000
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
preferred_auth_method = "apikey"
wire_api = "responses"
```

字段含义：

- `model_reasoning_effort`：推理强度，可选 `low` / `medium` / `high`，**别写 `xhigh`**（已不支持）。
- `model_context_window`：上下文窗口大小，单位 token。
- `model_auto_compact_token_limit`：自动压缩阈值，超过就压缩历史。
- `model_reasoning_summary`：推理摘要，网关不支持就显式写 `"none"`。
- `model_supports_reasoning_summaries`：是否支持推理摘要。
- `preferred_auth_method`：鉴权方式，填 `"apikey"`。
- `wire_api`：线协议，2026 年 2 月起强制 `"responses"`，只认 Responses API。

关键点：**从 2026 年 2 月起 Codex 强制用 Responses API（`wire_api = "responses"`），不再支持 Chat Completions。** 所以你的网关必须原生支持 Responses API，Codex 才能直接对接。填一个同时接了 GPT-5.6 和 Claude Fable 5 的 OpenAI 兼容聚合网关最稳——它把各家都翻译成了 Responses API 形状。

如果你把 `model_reasoning_summary` 写成了非 `"none"` 而网关不支持，会直接报 `Unsupported parameter`，记得显式关掉。

## 五、不想写文件？用环境变量也行

新版 Codex CLI（0.18.x+）优先读 `OPENAI_BASE_URL`，旧版（≤0.16）用 `OPENAI_API_BASE`。两个都设最稳：

```
export OPENAI_BASE_URL="https://genvis.xyz/v1"
export OPENAI_API_BASE="$OPENAI_BASE_URL"
export OPENAI_API_KEY="GENVIS_API_KEY"
export CODEX_MODEL="claude-fable-5"
```

`source ~/.zshrc` 之后，每次 `codex` 都继承这个地址。

## 六、一个会话里随时切模型

配好默认模型后，不用改文件，命令行加 `-m` 就能临时换：

```
codex -m gpt-5.6-sol "写个斐波那契"
codex -m claude-fable-5 "重构这段逻辑"
codex -m deepseek-v4 "补一段单元测试"
```

一般按任务切：小需求用便宜模型省成本，大项目 / 复杂重构切回 GPT-5.6 Sol 或 Claude Fable 5。

## 七、踩坑清单（都是真踩过的）

1. **模型名不在白名单，启动直接崩。** 先跑 `codex --list-models` 看支持哪些，或干脆用方式一（openai_base_url）绕过校验。
2. **base_url 必须以 `https://` 开头且含 `/v1`。** 漏了 `/v1` 是 401 的高发原因。
3. **超时。** 中转首包延迟普遍比官方高（300–800ms），Codex 默认超时为直连优化，接中转后频繁重试。显式加 `request_timeout = 60`。
4. **Key 读取顺序：环境变量 > 配置文件。** 配置文件里配了 Key，但系统环境变量也有一个，系统会覆盖配置里的。排查时注意。
5. **上下文窗口缩水。** 切到第三方模型后上下文可能从 272K 掉到 32K，大项目频繁"上下文已满"——按任务切模型。
6. **JSON 解析失败。** 网关返回了非标准 OpenAI Schema 时，加 `raw_response = true` 绕过。
7. **延迟高，开 HTTP/2。** 在 config.toml 加 `[http] http2 = true keep_alive = true`，实测 P95 延迟降 35%（28.4s → 18.3s）。

## 八、新手安全：先读，别急着改

Codex 能改文件、跑命令，安全边界很重要：

- **第一次任务让它只读不改**，先理解项目：`codex "请暂时不要修改任何文件，用中文解释这个项目结构"`。
- **改完一定看 diff**：`git diff`。看它动了哪些没允许的文件、有没有偷偷加依赖。
- **改之前打 Git 检查点**：`git add . && git commit -m "checkpoint before codex"`。
- **审批弹窗小心这些**：`rm -rf`、`sudo`、`curl ... | sh`、`npm install` 不认识的包——不确定就选范围更窄的或拒绝。

## 九、进阶：让 Codex 帮你 review

配好之后可以直接 review 未提交的改动：

```
codex review --uncommitted
codex review --uncommitted src/utils.ts
codex exec -o review.md "review 当前未提交的代码改动，列出潜在 bug 和可读性建议"
```

## 总结

把 `base_url` 直接填 `https://genvis.xyz/v1`，就是一套能同时调 GPT-5.6 和 Claude Fable 5 全系的配置——一个 Key，按需切模型，按量付费，不用为每个厂商各开订阅。

想直接用现成的一个 key 调 GPT-5.6 / Claude Fable 5 全系、还能看每个任务真实花了多少？入口在我个人主页。

*参考来源：OpenAI Help Center《GPT-5.6 in ChatGPT》、Anthropic《Introducing Claude Fable 5》、CSDN《Codex CLI 开放第三方模型了》、futureagi《Codex CLI Multi-Provider Gateway》、zeabur《Use Codex with your own Key》、sohu/Datawhale《Codex 原生支持其他模型》*