Codex 接入

Codex 使用 OpenAI Responses API。接入时不仅要替换地址和 Key，还要选择支持 Responses、流式输出与工具调用的模型。

1. 安装并确认版本

npm install -g @openai/codex
codex --version

系统要求和其他安装方式见 Codex 官方文档 。

2. 配置 Fenno 提供商

备份并编辑用户级 ~/.codex/config.toml。合并以下字段，保留已有 MCP、权限与其他供应商配置；不要把文件整体覆盖掉。

model = "<YOUR_MODEL_ID>"
model_provider = "fenno"
 
[model_providers.fenno]
name = "Fenno"
base_url = "https://api.fenno.ai/v1"
env_key = "FENNO_API_KEY"
wire_api = "responses"
requires_openai_auth = false

把 <YOUR_MODEL_ID> 替换为控制台中支持 Responses 的精确模型 ID。提供商名称 fenno 是本地配置标识，不需要加到 model 字段前。

3. 设置 Key

macOS / Linux / WSL 使用第一段，Windows PowerShell 使用第二段。环境变量必须存在于启动 Codex 的同一个终端中：

export FENNO_API_KEY="<YOUR_FENNO_API_KEY>"

$env:FENNO_API_KEY = "<YOUR_FENNO_API_KEY>"

本例使用 env_key，无需把 Fenno Key 写入 auth.json，也不要把它用于 OpenAI 官方登录。

4. 验证首次请求

进入已有的测试 Git 仓库，先进行不会改文件的请求：

cd your-test-project
codex exec "Reply with OK only. Do not read or modify files."

核对启动信息中的提供商和模型，并在 Fenno 控制台确认对应时间的请求。再用一个临时文件测试工具调用；收到文本回复不代表完整编码流程已验证。

常见问题

详细配置参见 OpenAI 官方高级配置 。其他连接问题见通用排错。