Codex CLI 使用 Responses 协议接入 VisionCoder 网关：配置网关地址、API 密钥和模型名，附可复制配置、验证命令和常见报错；当前 12 个公开模型可用，如 deepseek-v4-flash、deepseek-v4-pro、deepseek-v4-pro-0813。
协议：Responses；核对于 2026-11-10；12 个模型可用
注意：官方没写 Codex 会在 base_url 后追加什么路径。本站已于 2026-11-10 用 Codex CLI 0.164.0 对本机模拟服务（不是真实上游）验证：base_url 写 https://<网关地址>/v1 时 Codex 请求 /v1/responses，与本站 Responses 接口一致；不带 /v1 则请求 /responses，网关没有这个路径。本站未用真实上游做过完整对话验证；连接失败时，先用下方验证命令确认网关本身可用，再对照官方文档调整。
Codex CLI 使用 Responses 协议（/v1/responses）。网关不做协议转换，只有声明了该协议的模型能用；用错协议会返回 400，并提示该用的接口路径。
登录后在「API密钥」页创建 Key 并查看网关地址，下文用占位符 <网关地址> 表示。个人空间 Key 以 sk-u- 开头，企业员工 Key 以 sk-e- 开头，企业 Token 以 sk-org- 开头，均可调用；管理 Key（sk-mgmt-）调用会被拒绝。
VISIONCODER_API_KEY；下一步的 env_key 引用它。~/.codex/config.toml。model_provider 和 model_providers 写在项目里的 .codex/config.toml 会被 Codex 忽略。[model_providers.<id>]：name 是显示名，base_url 填 https://<网关地址>/v1（Codex 会在它后面追加 /responses），env_key 填上一步的变量名，wire_api 填 responses（官方说明它是唯一支持的取值，省略时默认也是它）。<id> 不能用保留名，例如 openai、ollama、lmstudio 等。model 设为下表里的模型名，model_provider 设为上面的 <id>。codex。终端环境变量（Bash / Zsh）
export VISIONCODER_API_KEY=sk-...配置文件 ~/.codex/config.toml
model = "<模型名>"
model_provider = "visioncoder"
[model_providers.visioncoder]
name = "VisionCoder"
base_url = "https://<网关地址>/v1"
env_key = "VISIONCODER_API_KEY"
wire_api = "responses"把模型名换成下表里的任意一个；返回 JSON 即说明网关和 Key 可用。
curl https://<网关地址>/v1/responses \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"<模型名>","input":"Hello"}'只列出声明了 Responses 协议的公开模型；点击模型名查看完整价格。单位：元 / 百万 token。
| 模型名 | 厂商 | 区域 | 上下文 | 输入 / 输出 |
|---|---|---|---|---|
| deepseek-v4-flash | DeepSeek | 国内 | 1M | ¥1.95 / ¥5.85 |
| deepseek-v4-pro | DeepSeek | 国内 | 1M | ¥5.85 / ¥17.55 |
| deepseek-v4-pro-0813 | DeepSeek | 国内 | 1M | ¥5.85 / ¥17.55 |
| deepseek-v4.1-flash | DeepSeek | 国内 | 1M | ¥1.95 / ¥5.85 |
| glm-5.2 | GLM | 国内 | 1M | ¥6.80 / ¥23.80 |
| glm-5.3 | GLM | 国内 | 1M | ¥6.80 / ¥23.80 |
| kimi-k3 | Kimi | 国内 | 1M | ¥17.00 / ¥85.00 |
| kimi-k3.1-pro | Kimi | 国内 | 1M | ¥11.05 / ¥57.80 |
| qwen3.7-max-2026-06-08 | Qwen | 国内 | 1M | ¥10.20 / ¥30.60 |
| qwen3.7-plus-2026-05-26 | Qwen | 国内 | 1M | ¥1.70 / ¥6.80 |
| qwen3.8-flash | Qwen | 国内 | 1M | ¥0.68 / ¥2.295 |
| qwen3.8-max-0902 | Qwen | 国内 | 200K | ¥10.20 / ¥30.60 |
| 现象 | 原因与处理 | 依据 |
|---|---|---|
| 自定义提供方不生效，或提示不能覆盖内置提供方 | <id> 不能是保留名，例如 openai、ollama、lmstudio 等；model_providers 要写在 ~/.codex/config.toml，写在项目的 .codex/config.toml 里会被忽略。 | 官方文档 |
| 401，提示 Key 无效 | 确认 env_key 指向的环境变量在启动 codex 的终端里有值，且是在 VisionCoder 创建、未被停用的 Key。（错误号 401060） | 网关 |
| 400，该模型不支持当前接口 | 模型没有声明 Responses 协议；响应里会列出它支持的接口路径。只选下表里的模型。（错误号 400159） | 网关 |
| 404，模型不存在 | 模型名写错或不存在，要和下表完全一致。（错误号 404042） | 网关 |
| 403，模型当前不可用 | 模型存在，但你的 Key 所在空间不能调用它。（错误号 403060） | 网关 |
| 错误信息以 [402070] 或 [402072] 开头，提示额度不足或已用完 | 账户没有可用额度，请先购买订阅套餐或加油包；企业成员请联系管理员。各工具对这类错误显示的 HTTP 状态码不同，以错误信息开头的错误号为准。（错误号 402070、402072） | 网关 |
| 错误信息以 [402073] 开头，提示订阅套餐已过期 | 订阅套餐已过期，请购买订阅套餐或加油包；企业成员请联系管理员。（错误号 402073） | 网关 |
| 错误信息以 [402074] 开头，提示已达每月用量上限 | 企业 Token 当月用量已达上限，请联系企业管理员。（错误号 402074） | 网关 |
| 429，触发限流 | 请求过于频繁或同时进行的请求数已满，稍后重试，或等当前请求结束。（错误号 429000、429060、429062、429063） | 网关 |
| 错误信息以 [503060] 开头，提示当前没有可用的模型通道 | 该模型暂时没有健康的通道，稍后重试。各工具对这类错误显示的 HTTP 状态码不同，以错误信息开头的错误号为准。（错误号 503060） | 网关 |
核对于 2026-11-10。非官方教程：VisionCoder 与 Codex CLI 的权利人无隶属或合作关系，Codex CLI 的名称和商标归其权利人所有。配置方法依据其官方文档，工具更新后界面可能不同，以官方文档为准。