Codex

本页以 Codex CLI 为例，通过自定义模型提供商连接豆子 API。安装与运行环境要求见 OpenAI 官方文档。

接入前提

目标渠道必须支持 Responses 协议以及 Codex 所需的流式和工具调用能力。仅有 OpenAI 兼容聊天接口不足以保证可用。请先阅读 Responses 接口，确认渠道支持后再配置。

1. 编辑配置

Codex 默认用户配置位于 ~/.codex/config.toml。Windows 通常为 %USERPROFILE%\.codex\config.toml；使用自定义 CODEX_HOME 时，以该目录为准。

先保留现有配置，再合并以下内容。顶层的 model 和 model_provider 应位于 TOML 的表声明之前，不要把同名键重复添加。

model = "YOUR_MODEL_ID"
model_provider = "beanc"

[model_providers.beanc]
name = "豆子 API"
base_url = "https://api.beanc.cn/v1"
wire_api = "responses"
env_key = "BEANC_API_KEY"

这里的 env_key 是环境变量名称，不是密钥。模型 ID 应替换为已确认支持所需能力的实际 ID。

2. 设置密钥并启动

Windows PowerShell

$env:BEANC_API_KEY = "YOUR_API_KEY_HERE"
codex

macOS / Linux

export BEANC_API_KEY="YOUR_API_KEY_HERE"
codex

从设置过环境变量的同一终端启动 CLI。桌面应用或 IDE 扩展是否能读取该变量，取决于它的启动环境；当前终端变量不会自动传给已运行的应用。

3. 验证连接

先确认加载的提供商是 beanc，模型 ID 与配置一致，再发起一条简单请求。测试时核对使用日志，确认请求到达豆子 API。

如果环境变量缺失，回到启动 Codex 的终端设置；如果出现协议、流事件或工具字段错误，检查渠道兼容性。不要把密钥写入 TOML、代码仓库或问题截图。

官方参考：Configuration Reference，model_provider、model_providers.<id>.base_url、env_key、wire_api；Config basics，配置文件位置与加载规则。