Codex CLI 接入 BazaarLink：config.toml 配置与实测（/v1/responses）

开始之前

需要 Codex CLI 与 BazaarLink API Key。以下示例把密钥放在环境变量中，不写入 config.toml。

1. 获取 API Key 并设置环境变量

获取 BazaarLink API Key 后，在运行 Codex CLI 的终端中设置 BAZAARLINK_API_KEY。请用自己的密钥替换示例中的占位文字。

macOS / Linux

export BAZAARLINK_API_KEY="YOUR_BAZAARLINK_API_KEY"

Windows PowerShell

$env:BAZAARLINK_API_KEY = "YOUR_BAZAARLINK_API_KEY"

2. 编辑 ~/.codex/config.toml

在 Windows 上，对应路径是 %USERPROFILE%\.codex\config.toml。将下列配置写入文件；如果已有配置，请修改相同字段。

model = "openai/gpt-5.4-mini"
model_provider = "bazaarlink"

[model_providers.bazaarlink]
name = "BazaarLink"
base_url = "https://api.bazaarlink.ai/v1"
env_key = "BAZAARLINK_API_KEY"
wire_api = "responses"

3. 运行第一条命令

在终端中运行以下测试命令。这是 2026-10-05 实测所用的命令。

codex exec --skip-git-repo-check "Reply with exactly one line: hello from BazaarLink"

实测输出摘要

provider: bazaarlink
model: openai/gpt-5.4-mini
hello from BazaarLink
tokens used

实测时，标头显示 provider 与 model，回答是一行 hello from BazaarLink，末尾显示 tokens used。即使提示很短，Codex 仍会发送自己的系统指令和工具定义；该次约用了 10k tokens。

该次测试中，模型发出 shell 函数调用，Codex 在本地执行或拦截后把结果发回，模型随后作出回答。这验证了 /v1/responses 的 function_call 往返；并不代表所有 Codex 功能都已验证。

4. 更换模型

config.toml 的 model 值可以换成模型页（/models）上列出的任何模型。

把 config.toml 中的 model 值换成模型页或 GET /v1/models 列出的可用 model ID。密钥或路由未启用的模型可能返回 503，请选择另一个 model ID。

5. 常见问题与故障排查

Model metadata 警告

Codex 可能显示 `Model metadata for openai/gpt-5.4-mini not found. Defaulting to fallback metadata`，标头也可能显示 `reasoning effort: none`。这是本次实测看到的警告，可以忽略。

HTTP 503：模型不可用

如果看到 `Service unavailable for this model. Please try a different model or contact support.`，说明该模型对当前密钥或路由未启用。请从模型页或 GET /v1/models 选择另一个 model ID。

401 或密钥设置问题

检查运行 Codex CLI 的终端是否已设置 BAZAARLINK_API_KEY，并确认 config.toml 中 env_key 的拼写与之相同。

base_url 应该填什么？

建议使用 https://api.bazaarlink.ai/v1。https://bazaarlink.ai/api/v1 也受支持。

常见问答