Codex CLI 接入第三方 API

一句话结论

久连 9Link 支持 Codex 需要的 Responses API(/v1/responses)。在 ~/.codex/config.toml 里新增一个 provider:base_url 填 https://api.9linkai.com/v1,wire_api 填 responses;再把 Key 设为环境变量 OPENAI_API_KEY,启动 codex。

复制就能用的配置

第 1 步:写配置文件

打开 ~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml),没有就新建。改之前先备份一份。

model_provider = "ninelink"
model = "gpt-6.1-sol"

[model_providers.ninelink]
name = "久连 9Link"
base_url = "https://api.9linkai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

model 默认用 gpt-6.1-sol;想换别的模型,填模型广场里的模型 ID。

第 2 步:设置 Key 并启动

macOS / Linux:

export OPENAI_API_KEY="sk-你的密钥"
codex

Windows PowerShell:

$env:OPENAI_API_KEY="sk-你的密钥"
codex

想长期生效,macOS / Linux 把 export 那行加进 ~/.zshrc 或 ~/.bashrc;Windows 在「系统属性 → 环境变量」里新增用户变量 OPENAI_API_KEY。

一条命令验证是否生效

codex exec "用一句话说明你是哪个模型"

能返回内容就说明接通了。再到控制台「使用记录」里核对这一笔调用的模型和扣费。

最常见的三个坑

  1. 顶层配置写到了表下面:model_provider 和 model 必须写在第一个 [model_providers.xxx] 之前。写在后面会被当成那个表的字段,Codex 会悄悄忽略,继续走默认的 OpenAI。
  2. base_url 写错:要写到 /v1 为止。少写 /v1 或多写成 /v1/responses,都会报 404。
  3. provider 写在了项目目录里:model_provider 和 model_providers 只认用户目录下的 ~/.codex/config.toml,写在项目里的 .codex/config.toml 会被忽略。另外,VS Code 里的 Codex 插件改完环境变量要完全重启 VS Code 才能读到。

另外:provider 名字不要用 openai、ollama、lmstudio,这几个是 Codex 内置的保留名。

遇到报错

相关

最后更新:2026-11-14