EE-17 此模型不支持图片输入

字段	内容
影响组件	Codex CLI / CC Switch
系统环境	Linux / macOS / Windows

---

问题现象

在 Codex 中粘贴或发送图片时，请求没有继续执行，并显示：

text

此模型不支持图片输入，请尝试其他模型

同一模型仍可正常处理纯文本请求。

---

根因分析

text

Codex 从本地模型目录读取当前模型能力
  → 当前模型的 input_modalities 只有 "text"
  → Codex 将该模型判断为不支持图片
  → 图片在发送前被客户端拒绝

关键配置通常如下：

json

"input_modalities": [
  "text"
]

这属于本地模型目录的能力声明问题。只修改 config.toml 中的模型名，不能补充图片输入能力。

---

修复步骤

第一步：确认模型目录由谁维护

• 不使用 CC Switch：修改 Codex 自带的 models_cache.json
• 使用 CC Switch，且供应商协议为原生 Responses 直连模式（openai_responses）：优先升级 CC Switch；旧版本需要修改 cc-switch-model-catalog.json

第二步：使用 CC Switch 时优先升级

将 CC Switch 升级到 v3.17.0 或更高版本，然后在 CC Switch 中重新保存一次对应的 Codex 供应商，使模型目录重新生成。

新版会为 GPT 系列、模型别名、新后缀及未知模型补全图片输入能力，无需手动维护目录文件。

第三步：不使用 CC Switch 时打开 Codex 模型缓存

macOS / Linux

text

~/.codex/models_cache.json

Windows

text

C:\\Users\\<USERNAME>\\.codex\\models_cache.json

在文件中按 slug 找到当前实际使用的模型，将：

json

"input_modalities": [
  "text"
]

改为：

json

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

只修改当前使用的模型条目，其他模型无需调整。

第四步：旧版 CC Switch 用户修改生成目录

如果暂时无法升级 CC Switch，请打开下列文件：

macOS / Linux

text

~/.codex/cc-switch-model-catalog.json

Windows

text

C:\\Users\\<USERNAME>\\.codex\\cc-switch-model-catalog.json

同样按 slug 找到当前模型，把 input_modalities 从 ["text"] 改为：

json

[
  "text",
  "image"
]

旧版 CC Switch 再次保存该供应商时会重新生成并覆盖此文件，因此手动修改后不要再次保存该供应商。

第五步：完全退出并重启 Codex

Codex 不会热重载模型目录。保存文件后完全退出 Codex，再重新启动并发送一张图片验证。

如果当前模型的 input_modalities 已经包含 image，则不是本文所述问题，应改用确认支持图片的模型，并继续检查上游接口是否支持图片输入。

---

预防措施

做法	避免的问题
使用 CC Switch v3.17.0 或更高版本生成 Codex 模型目录	避免新模型因缺少 image 能力声明而被客户端拒绝
新增或切换模型后核对对应 slug 的 input_modalities	避免只验证文本请求而遗漏图片能力
手动配置时只修改当前使用的模型条目	避免无关模型配置被批量改动
修改模型目录后完全退出并重启 Codex	避免客户端继续使用内存中的旧目录