OpenAI · CLI

Codex CLI

Codex CLI 从 ~/.codex/config.toml 读取模型提供商配置。添加一个指向 NextModel 端点的 provider 并导出密钥，之后每次 codex 调用都会经过 NextModel。

快速开始

  1. 获取你的 NextModel API 密钥

    在 NextModel 控制台创建密钥并复制，下一步会把它接入你的 shell。

  2. 在 ~/.codex/config.toml 中添加自定义模型提供商

    wire_api = "chat" 让 Codex 走 NextModel 提供的 OpenAI 兼容 chat completions 端点。

    官方文档

    TOML
    model = "claude-sonnet-4-5"
model_provider = "nextmodel"

[model_providers.nextmodel]
name = "NextModel"
base_url = "https://api.nextmodel.app/v1"
env_key = "NEXTMODEL_API_KEY"
wire_api = "chat"

  3. 把密钥导出为环境变量

    Codex 按 env_key 指定的变量名读取密钥。把它写进 shell 配置即可，不要写进会提交的文件。

    Shell
    export NEXTMODEL_API_KEY=<YOUR_API_KEY>

  4. 试跑第一条指令

    能正常流式返回，就说明 provider 已经生效。

    Shell
    codex "Explain what this repository does and list its entry points"

示例提示词

提示词保持英文以获最佳效果

提示词
Refactor src/utils/date.ts to use Temporal and update the affected tests.
Find the flakiest test in this repo, explain why it flakes, and fix the root cause.

常见问题

为什么用 wire_api = "chat"？

NextModel 提供的是 OpenAI 兼容的 chat completions 端点，chat 与它一一对应。

Codex 从哪里读取 API 密钥？

从 provider 配置中 env_key 指定的环境变量读取（示例中是 NEXTMODEL_API_KEY），密钥本身不会写进 config.toml。

还能同时保留 OpenAI 官方 provider 吗？

可以。model_provider 决定当前使用哪个 provider，改一行即可在 nextmodel 和 openai 之间切换。

故障排除

Codex 返回 401 Unauthorized

启动 Codex 的那个终端里没有设置环境变量。在同一终端重新 export NEXTMODEL_API_KEY=...，再启动 Codex。

Codex 没有使用我的 provider 配置

检查 model_provider 的值是否与 model_providers 后面的表名完全一致（示例中是 nextmodel），并确认 TOML 里没有重复的表头。

其他 Agent

IDEAnysphere

Cursor

AI 优先的 IDE，接上你自己的端点。

Cursor 支持为 OpenAI 兼容端点自带密钥（BYOK）。在 Settings → Models 中粘贴你的 NextModel 密钥，并把 OpenAI 提供商的 Base URL 指向 NextModel，OpenAI 格式的请求就会发往 NextModel。

Cursor
IDECline

Cline

VS Code 里的自主编程代理，用你自己的密钥。

Cline 是一个 VS Code 扩展，会在每一步征求你的确认后规划和修改代码。它的 OpenAI Compatible provider 接受任意端点，填一张表就能接上 NextModel。

Cline
桌面端Cherry Studio

Cherry Studio

开箱即说 OpenAI 的桌面聊天客户端。

Cherry Studio 把模型提供商作为服务来管理。把 NextModel 作为 OpenAI 兼容服务添加一次，它就会出现在你已有的服务列表旁边。

Cherry Studio
SDKOpenAI

OpenAI SDK

任意 OpenAI SDK，只差一个 base_url。

官方 OpenAI SDK（Python 和 Node）都接受自定义端点。把 base_url 设为你的 NextModel 端点、密钥放在环境变量里，其余代码保持不变。

OpenAI SDK