在 Codex 中切换 WanAPIs 的其它模型

接入步骤

1. 1

   先确认已接入 WanAPIs

   config.toml 里应当已经有一个指向 WanAPIs 的 provider。下面的例子把它命名为 wanapis,密钥从环境变量 WANAPIS_API_KEY 读取。

   ~/.codex/config.toml

   model_provider = "wanapis"
   model = "gpt-5.5"
   
   [model_providers.wanapis]
   name = "WanAPIs"
   base_url = "https://api.wanapis.com/v1"
   wire_api = "responses"
   env_key = "WANAPIS_API_KEY"

2. 2

   命令行:临时切换(只影响本次)

   加 -m 或 --model 启动即可,适合临时试模型。已经在会话里的话,输入 /model 可以直接调出选择器当场换 —— 注意这是命令行独有的,插件和桌面端没有斜杠命令,见下一步。

   shell

   codex --model deepseek-v4.1-flash
   
   # 非交互执行也一样
   codex exec -m deepseek-v4.1-flash '把这个函数改成异步的'

3. 3

   VS Code 插件 / 桌面端:用面板底部的模型选择器

   图形界面里没有斜杠命令(输 /model 只会被当成普通文本发出去),切换入口是 Codex 面板【底部】的模型选择器 —— 点开就能同时选模型和推理强度。桌面端还可以按 Ctrl+Shift+M 直接调出它,VS Code 插件没有预设快捷键。

4. 4

   选择器里没有你要的模型?这是正常的

   选择器列的是 Codex 内置认识的那些模型(GPT-5.4 / 5.4-mini / 5.5 等),经自定义 provider 接进来的名字(比如 deepseek-v4.1-flash)默认不在里面。有个很实用的细节:选择器只改 model、不动 model_provider,所以你在 WanAPIs 这个 provider 下选中 GPT-5.5,请求依然发给 WanAPIs —— 这些型号我们都有,选了就能直接用。真正需要动配置的,只有选择器里压根没有的名字,见下一步。

5. 5

   切到选择器里没有的模型:齿轮 → Open config.toml

   不用离开编辑器:点 Codex 侧边栏的齿轮图标 → Codex Settings → Open config.toml,把 model 改掉再重启插件即可。配置三端共用,改完命令行和桌面端也一起变。要经常来回切的话,直接看下一步的 profile 做法更省事。

   ~/.codex/config.toml

   model = "deepseek-v4.1-flash"

6. 6

   推荐:用 profile 维护多套配置

   经常在不同模型之间来回切的话,与其反复改 model 那一行,不如给每个模型建一个 profile。在 ~/.codex/ 下按 <名字>.config.toml 建文件,启动时用 --profile <名字> 选择。注意这是新版格式:老的 [profiles.xxx] 表写法已经不支持,继续用会直接报错并提示你迁移。

   ~/.codex/ds.config.toml

   model = "deepseek-v4.1-flash"
   model_provider = "wanapis"
   model_reasoning_effort = "high"
   model_context_window = 900000

7. 7

   用 profile 启动

   建好之后,一条命令切换整套配置(模型 + 推理强度 + 上下文上限)。可以按需要建多个,例如 ds / gpt / cheap 各一套。

   shell

   codex --profile ds

8. 8

   进阶:把自定义模型注册进模型目录

   如果你希望 Codex 把自定义模型当成「一等公民」—— 不再每次提示 Model metadata not found、上下文上限按真实值算 —— 可以用 model_catalog_json 指向一个模型目录文件,在里面为它写一条元数据。实测注册后那条警告确实消失、上下文按填写的值生效。条目里的 visibility 字段决定它是否列进选择器(list 显示 / hide 隐藏),不过图形界面是否一定会列出自定义条目跟客户端版本有关,没出现就仍按上一步改配置。

   ~/.codex/config.toml

   model_catalog_json = "/Users/你的用户名/.codex/models.json"

9. 9

   ⚠️ 写模型目录的三个坑

   一、格式很严:字段不全会直接报错,比如漏了 shell_type 就是 missing field `shell_type`。二、有些字段不接受 null(如 web_search_tool_type),填 null 会报 invalid type: null。三、也是最要命的 —— 目录文件解析失败会让 Codex 整个起不来(failed to parse model_catalog_json),命令行和插件一起罢工。所以最稳妥的做法不是从零手写,而是复制目录里一条已有条目,只改 slug、display_name、context_window 和推理强度这几项;改之前先备份。

10. 10

    验证

    启动后 Codex 会把当前配置打印在顶部,确认 model 和 provider 两行是你要的即可;也可以到 WanAPIs 控制台「日志」页核对最新一条的模型名与扣费。

    启动时的输出

    model: deepseek-v4.1-flash
    provider: wanapis
    reasoning effort: high

常见问题