WOW3 文档

主题

Codex CLI 专项问题 ​

本页收录 Codex CLI 特有的配置与报错。通用请求报错请看请求错误类问题。

Base URL 要怎么填？ ​

Codex 的 Base URL 需要 /v1 后缀，这一点与 Claude Code 相反：

text
Claude Code：https://api.wow3.top        （不带 /v1）
Codex CLI ：https://api.wow3.top/v1     （带 /v1）

写反是最常见的报错来源。

配置文件在哪？怎么手动配置？ ​

两个文件，都在用户主目录下的 .codex 目录里（Windows 为 C:\Users\用户名\.codex\）：

  • ~/.codex/config.toml — 模型与服务商配置
  • ~/.codex/auth.json — 令牌

config.toml 参考：

toml
model_provider = "wow3_codex"
model = "gpt-5.6-sol"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_effort = "high"
disable_response_storage = true
supports_websockets = false

[model_providers.wow3_codex]
name = "wow3_codex"
base_url = "https://api.wow3.top/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 参考：

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

Codex 没有热重载

改完配置必须完全退出并重启 Codex 才会生效，仅新建会话无效。

报错 401 Unauthorized: Invalid token ​

现象：运行时报 unexpected status 401 Unauthorized: Invalid token。

原因：之前登录过 OpenAI 账号，~/.codex/auth.json 被覆盖，里面已经不是本站令牌了。

修复：手动打开 ~/.codex/auth.json，把内容改回本站令牌：

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

保存后重启 Codex。必须手动改这个文件，通过其他工具改无效。

启动卡在 Reconnecting，一分多钟后又自己恢复 ​

现象：Codex 启动时卡在 Reconnecting，卡一分多钟后往往又自己好了。

原因：Codex 每次启动会先尝试用 WebSocket 协议连接后端，而中转走的是标准 HTTP 接口，本就没有 WebSocket，握手必然失败。Codex 把失败当成普通网络抖动去重试，连撞 5 次后才退回 HTTP，这就是「先卡一分多钟再自己恢复」的由来。

修复：在 ~/.codex/config.toml 里把本站配成自定义 provider，并加上 supports_websockets = false，让它从第一步就走 HTTP：

toml
model_provider = "wow3_codex"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
supports_websockets = false

[model_providers.wow3_codex]
name = "wow3_codex"
base_url = "https://api.wow3.top/v1"
wire_api = "responses"
requires_openai_auth = true

关键三点：

  1. 必须配成自定义 provider（如上例的 wow3_codex），不要用默认 provider
  2. 必须加 supports_websockets = false
  3. base_url 必须以 /v1 结尾

改完完全退出并重启 Codex。如仍不稳定，参考网络与连接问题换网络环境试试。

报错 Selected model is at capacity ​

现象：⚠ Selected model is at capacity. Please try a different model.

原因：上游模型容量限流，表示该模型当前满载。不是余额、令牌、分组或网关问题，也不是额度用完。高峰期和新模型放量时尤其高发，热门型号最常遇到。

应对：

  • 直接回一句「继续」重试，一般再发一次就能继续，偶尔要多发几次——属于正常现象
  • 也可以换个型号（修改 ~/.codex/config.toml 里的 model），可用模型见模型广场

报错 Image generation is not enabled for this group ​

原因：当前分组未开通图像生成能力，而 Codex 默认带上了图像生成特性，导致请求被拒。

修复：打开 ~/.codex/config.toml，在 [features] 段中加入：

toml
[features]
image_generation = false

如果文件里没有 [features] 段，新增该段再写入。保存后完全退出并重启 Codex。

报错「此模型不支持图片输入，请尝试其他模型」 ​

原因：Codex 依据模型目录文件中每个模型的 input_modalities 字段判断能否接收图片。只要目录里对应模型的 input_modalities 里没有 image，就会拒绝图片输入。要改哪个文件取决于你的配置方式。

情况一：手动配置 Codex（改 models_cache.json） ​

适用于不通过 cc-switch、直接手动配置的用户。编辑 ~/.codex/models_cache.json（Windows 为 C:\Users\用户名\.codex\models_cache.json）。

按 "slug" 找到你正在使用的模型，把它的 input_modalities 从：

json
"input_modalities": [
  "text"
],

改成：

json
"input_modalities": [
  "text",
  "image"
],

只改你实际在用的那一个即可；已经含 "image" 的模型无需改动。保存后完全退出并重启 Codex。

情况二：用 cc-switch 管理（改 cc-switch-model-catalog.json） ​

适用于用 cc-switch、且 Codex 供应商为原生 Responses 直连模式的用户。这种模式下 cc-switch 会自己生成一份模型目录 ~/.codex/cc-switch-model-catalog.json，部分模型会被写成仅 ["text"]，即使模型本身支持识图也会误报。此时改 models_cache.json 无效。

推荐做法：把 cc-switch 升级到最新版本，新版会自动把 GPT 系模型写为 ["text", "image"]，不再误报。升级后需要在 cc-switch 里重新保存一次对应的 Codex 供应商，以重新生成目录。

仍用旧版本的话，也可以手动改 cc-switch-model-catalog.json，改法同情况一。

手动改动会被覆盖

手动改完后，如果又在 cc-switch 里重新保存了该供应商，这份目录会被重新生成、手动改动丢失。优先升级版本而不是手改。

推理速度慢怎么办？ ​

调低 config.toml 中的 model_reasoning_effort：

取值速度适用场景
low快简单代码生成、快速问答
medium中日常开发任务（推荐）
high慢复杂算法、架构设计

令牌无效？ ​

  • 检查 ~/.codex/auth.json 中的令牌是否正确
  • 确认控制台里余额充足、令牌未过期、分组与所选模型匹配

内容如有疑问请联系客服

Copyright © 2026 WOW3