Codex CLI 接入 Models Hub:一键配置与 config.toml

用 Models Hub CLI 一条命令配置 Codex CLI,或手动编辑 ~/.codex/config.toml 添加自定义模型供应商,附验证步骤与常见报错排查。

Codex CLI 是 OpenAI 官方的终端编码代理,在本地运行、直接读写你的项目文件。把它的模型供应商换成 Models Hub 后,codex 里的对话与代码修改都会用 Models Hub 的额度调用你指定的模型。本文只讲接入,不讲 Codex CLI 本身的用法。

三样东西

接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com、一个模型名。推荐先用一键配置,30 秒完成。

准备

已安装 Codex CLI。没装的话按官方安装说明运行 npm install -g @openai/codex,装完 codex --version 能出版本号即可。
一个 Models Hub API Key。在控制台的令牌页创建,令牌所在分组要能访问你打算用的模型。

用途	模型名	定价	实时状态
最高质量、复杂编码任务	`gpt-6-astra`	查看价格	可用率与延迟
日常编码首选	`gpt-5.5`	查看价格	可用率与延迟
更强推理与长任务	`gpt-5.6-luna`	查看价格	可用率与延迟
便宜快速的小改动	`gpt-5.4-mini`	查看价格	可用率与延迟

方式一:一键配置(推荐)

Models Hub CLI 会把 API Key、接入地址和默认模型写入 ~/.codex/config.toml 与 ~/.codex/auth.json。

macOS / Linux:

curl -fsSL https://modelsok.com/cli/install.sh | sh

Windows(PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://modelsok.com/cli/install.ps1 | iex"

装好后运行 models,在交互菜单里选择 Codex,按提示粘贴 API Key、选模型即可;也可以用 models configure --target codex --api-key <你的_API_KEY> 免交互配置。默认模型是 gpt-5.5,想换成上表里其它模型可以在交互时选,或用 --codex-model 指定。完整用法见 CLI 一键配置。

Models Hub CLI 交互菜单,选择配置 Codex

方式二:手动配置

Codex 使用 Responses API

Codex 自定义供应商使用 Responses 协议。Models Hub 已验证 /v1/responses 可调用 gpt-6-astra;手动配置时明确写上 wire_api = "responses",不要改成 Chat Completions。

先在当前 shell 或你的 .zshrc / .bashrc 里导出密钥:

export MODELSOK_API_KEY="你的 Models Hub API Key"

编辑 ~/.codex/config.toml,加入一个自定义 provider 并把它设为默认:

model = "gpt-6-astra"
model_provider = "modelsok"
model_reasoning_effort = "low"

[model_providers.modelsok]
name = "Models Hub"
base_url = "https://modelsok.com/v1"
env_key = "MODELSOK_API_KEY"
wire_api = "responses"
stream_idle_timeout_ms = 300000

字段	作用
`model`	默认模型名,以定价页上的名字为准
`model_provider`	顶层字段,指向下面 `model_providers` 里的 provider id
`model_reasoning_effort`	推理强度。`gpt-6-astra` 不支持 `none`;对延迟敏感时从 `low` 开始
`model_providers.modelsok.base_url`	Models Hub 接入地址,固定为 `https://modelsok.com/v1`
`model_providers.modelsok.env_key`	存放 API Key 的环境变量名,需要在启动 `codex` 前已经 `export`
`model_providers.modelsok.wire_api`	Codex 使用的协议,固定为 `responses`
`model_providers.modelsok.stream_idle_timeout_ms`	流式连接空闲超时,示例为 5 分钟;它不能消除上游服务本身的超时

验证

在任意项目目录运行 codex,输入一句话,例如「用一句话介绍当前目录」。能正常回复即接通。再打开 Models Hub 控制台的用量日志,几秒内会出现一条对应模型名的请求。

常见报错

现象	原因	处理
`401` / 鉴权失败	Key 写错、多了空格,或令牌已被禁用	到令牌页重新复制;一键配置的话重新运行一次 `models`
`model not found` / 无可用渠道	模型名拼错,或令牌所在分组没有该模型	对照定价页核对名字
请求 404 / 连接失败(手动配置)	`base_url` 或 `wire_api` 写错	确认 `base_url = "https://modelsok.com/v1"` 且 `wire_api = "responses"`
`524` / 很久才出现首个回复	上游线路首 token 较慢或超时;高推理强度会增加等待时间	先把 `model_reasoning_effort` 调为 `low`;仍异常时带请求 ID 和上游请求 ID联系客服
`429`	触发限流,通常是并发过高	稍后重试;持续出现联系客服提额
环境变量在新终端里失效	`export` 只在当前会话生效	写进 `.zshrc` / `.bashrc` 并重开终端,或改用一键配置写入的 `auth.json`

更多排查见故障排查。

常见问题

计费方式? 按请求实际消耗的输入与输出 token 计费,价格在各模型的定价页,用量日志里能看到每一条请求的明细。

和直接用 OpenAI 官方账号有什么区别? 配置后 Codex CLI 的所有请求(包括预设模型)都会走 Models Hub 接入点,不再消耗官方账号额度;你不需要 ChatGPT Plus/Pro 订阅。

怎么切换模型? 在 Codex CLI 里输入 /model 选择,或修改 config.toml 里的 model 字段后重启。

gpt-6-astra 和 GPT-5.6 调用方式一样吗? Codex 中都走 Responses API,不需要更换接入地址。GPT-6 的参数约束更严格,例如不支持 reasoning_effort = "none";完整差异见 GPT-6 Astra 调用指南。

Codex CLI 接入 Models Hub:一键配置与 config.toml

准备

推荐模型

方式一:一键配置(推荐)

方式二:手动配置

验证

常见报错

常见问题

相关

本页目录