Codex CLI 接入

适用于支持自定义供应商与 Responses 协议的 Codex CLI。桌面应用、编辑器扩展或组织托管环境的配置入口可能不同，请按实际版本确认。

1. 准备密钥和模型

在控制台创建 API Key，并从模型目录取得支持 Responses 和工具调用的模型 ID。可用模型与能力以当前账户及服务配置为准。

2. 设置环境变量

把占位文字替换为你的密钥。

macOS / Linux
Windows PowerShell

Bash 或 Zsh：

export KEENKIND_API_KEY='替换为你的 KeenKind API Key'

$env:KEENKIND_API_KEY = '替换为你的 KeenKind API Key'

以上设置只对当前终端及其启动的程序生效。完成下一步后，要在同一终端启动 Codex；新终端需要重新设置。

3. 配置供应商

先备份用户级配置文件，再编辑：

macOS / Linux：~/.codex/config.toml
Windows：用户目录下的 .codex\config.toml

合并以下配置，保留文件中其他需要的设置。model 和 model_provider 放在第一个 [表名] 之前；已有同名项时修改原项，避免重复。把 YOUR_MODEL_ID 替换为实际模型 ID。

model = "YOUR_MODEL_ID"
model_provider = "keenkind"

[model_providers.keenkind]
name = "KeenKind"
base_url = "https://api.keenkind.ai/v1"
env_key = "KEENKIND_API_KEY"
wire_api = "responses"
request_max_retries = 0
stream_max_retries = 0

示例将密钥留在环境变量中，并关闭自动重试，方便核对初次调用结果。模型与供应商配置应放在用户级文件中；当前 Codex 不从项目级 .codex/config.toml 加载供应商配置。

4. 启动并检查

在项目目录、同一终端运行：

codex

确认显示的模型与所填 ID 一致。发送一个读取 README 并说明启动方式的任务，检查是否读取了文件，再到用量记录核对调用。

常见问题

现象	先检查
提示缺少环境变量	是否在设置密钥的同一终端启动 Codex
仍使用原供应商或模型	用户级配置是否生效，是否有其他配置或启动参数覆盖
返回 404	模型 ID、Base URL，是否重复出现 `/v1/v1`
可以回复但工具失败	所选模型是否支持工具调用，工具权限是否允许读取项目
中断后没有完整结果	先查看用量，再按 API 常见问题处理

配置字段依据 Codex 高级配置与配置参考，资料核对日期：2026-10-18。