直接答案：Codex 接入第三方 API 的关键是正确填写提供方 Base URL、API Key 和可用模型代号。适合希望为 Codex 更换模型线路或统一计费的开发者；配置完成后先运行只读小任务，并在控制台核对用量。
1. 配置前准备
- 已完成 Codex CLI 安装，运行
codex --version能显示版本。 - 已在 island AI Coding 创建 API Key，并为它选择支持 Codex 的模型分组。
- 已从创建密钥页面复制准确模型代号。
- 确认目标模型支持
/v1/responses协议。
协议需要匹配Codex CLI 使用 Responses API。普通聊天接口调用成功，不代表该模型一定能用于 Codex。
2. 在 config.toml 添加模型提供方
Codex 用户配置文件通常位于 ~/.codex/config.toml。Windows 中的 ~ 对应当前用户目录。
~/.codex/config.toml
model = "MODEL_ID"
model_provider = "island"
[model_providers.island]
name = "island AI Coding"
base_url = "https://www.codex789.com/v1"
env_key = "ISLAND_API_KEY"
wire_api = "responses"
requires_openai_auth = false将 MODEL_ID 替换为创建密钥页面显示的模型代号。不要根据模型卡片标题自行拼写。
3. 使用环境变量保存 API Key
配置文件只声明环境变量名称，真实密钥保存在当前系统环境中。
PowerShell
$env:ISLAND_API_KEY = "YOUR_API_KEY"
codexmacOS / Linux
export ISLAND_API_KEY="YOUR_API_KEY"
codex以上命令只对当前终端会话生效，关闭终端后需要重新设置，或使用操作系统提供的持久环境变量方式。
4. 验证 Codex API 是否配置成功
- 进入一个测试项目目录，避免第一次测试直接操作重要代码。
- 运行
codex。 - 先发送只读任务，例如“列出项目结构并说明入口文件”。
- 确认返回正常后，再尝试读取文件、运行测试等任务。
- 在控制台核对调用记录、模型和 Token 消耗。
出现认证或模型错误时，参阅AI API 错误码排查。
5. 切换 Codex 模型时检查什么
- 新模型是否属于当前密钥分组。
- 模型代号是否与创建密钥页面完全一致。
- 新模型是否支持 Responses API 和所需工具能力。
- 不同模型的倍率、上下文和响应速度是否适合当前任务。
频繁切换前可为不同项目保留独立配置与密钥，便于统计成本和定位问题。
6. Codex API 常见配置错误
| 现象 | 检查项 |
|---|---|
| 配置文件解析失败 | TOML 引号、节名、重复字段和文件编码 |
| 提示缺少密钥 | 环境变量名称是否与 env_key 完全一致 |
| 401 认证失败 | 密钥是否有效，环境变量值是否包含引号或空格 |
| 模型不存在 | 模型代号、密钥分组和 Responses API 支持 |
| 连续 Reconnecting 1/5 到 5/5 | 按Codex 重连排查指南检查 WebSocket、代理和 HTTP 回退 |
| 内置浏览器被策略阻止 | 检查 Chrome 企业策略，并参考Codex 浏览器企业策略修复 |
| 响应缓慢 | 模型类型、上下文长度、任务范围和网络状态 |
7. 常见问题
Codex API 的 Base URL 填什么？
使用 https://www.codex789.com/v1。
Codex 为什么不能使用普通聊天模型？
Codex 自定义提供方使用 Responses API，模型和密钥分组必须支持该协议。
API Key 应直接写进 config.toml 吗？
建议只在配置文件中声明环境变量名称，通过环境变量保存真实密钥。