跳转到内容
NoviaHub 文档

命令行 Agent

Codex

让 OpenAI Codex 通过 NoviaHub 调用模型：安装、编写 config.toml、设置环境变量、验证和切换模型。

Codex 是 OpenAI 的编程 Agent，可以在终端（Codex CLI）中使用。它支持在配置文件里添加自定义的模型服务商，通过 Responses 协议调用模型。把服务商指向 NoviaHub 后，就可以用 NoviaHub 的余额调用模型。

前提条件

Section titled “前提条件”
  • 一把 NoviaHub API 密钥，见 API 密钥；账户里有余额，见 钱包与充值。
  • 一个支持 Responses 协议的模型：到 模型&价格 打开模型详情，端点标签里要有 Response。

安装

Section titled “安装”
终端窗口
curl -fsSL https://chatgpt.com/codex/install.sh | sh

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 把密钥保存到环境变量 NOVIAHUB_API_KEY。 Codex 从环境变量读取密钥，不要把密钥直接写进配置文件。

    终端窗口
    # macOS 默认用 zsh；Linux 用 bash 的话把 ~/.zshrc 换成 ~/.bashrc
    echo 'export NOVIAHUB_API_KEY="sk-..."' >> ~/.zshrc
    source ~/.zshrc

  2. 编辑配置文件 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），没有就新建，写入：

    ~/.codex/config.toml
    model = "gpt-6-sol"
    model_provider = "noviahub"
    

    [model_providers.noviahub]
    name = "NoviaHub"
    base_url = "https://noviahub.com/v1"
    env_key = "NOVIAHUB_API_KEY"
    wire_api = "responses"
    配置项 作用
    model 默认使用的模型 ID。
    model_provider 使用哪个服务商，对应下面 [model_providers.noviahub] 里的 noviahub。
    name 服务商显示名称。
    base_url 接口地址，要带 /v1：https://noviahub.com/v1。
    env_key 存放密钥的环境变量名。
    wire_api 协议。官方说明 responses 是唯一支持的值，省略时也默认为它。

  3. 打开一个新终端，运行 codex。

验证

Section titled “验证”

  1. 在 Codex 里输入 /status，确认当前使用的模型是你设置的那个。

  2. 随便提一个问题，能正常回答就说明接通了。到 NoviaHub 控制台的 使用日志 里可以看到这次调用和费用。

  3. 如果配置没生效，可以用 /debug-config 查看 Codex 实际读取到的各层配置。

切换模型

Section titled “切换模型”
  • 临时切换：在 Codex 里输入 /model。
  • 长期修改：改 config.toml 里的 model。

Codex 只使用 Responses 协议，所以只能选端点标签里有 Response 的模型。2026-09-28 NoviaHub 上带这个标签的模型有 gpt-6-sol、gpt-6-luna、gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、deepseek-v4-flash、deepseek-flash、deepseek-v4-flash-vision-exp、kimi-k3；模型会增减，请以 模型&价格 为准。选了不支持 Responses 的模型会调用失败。

常见问题

Section titled “常见问题”

返回 401 Invalid token（无效的令牌） 先确认新开的终端里 NOVIAHUB_API_KEY 有值（macOS / Linux 运行 echo $NOVIAHUB_API_KEY），再到「API 密钥」页检查这把密钥是否为「已启用」状态。

返回 403 insufficient_user_quota 账户余额不足，先充值。

ChatGPT 桌面应用里的 Codex 官方文档说明，ChatGPT 桌面应用也会读取同一个 ~/.codex/config.toml。本页的步骤只针对命令行。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28：