在 Codex 中使用 ApiClo 自定义供应商

开始之前

• 使用当前版本的 Codex CLI 或 IDE 扩展，并创建 ApiClo API 密钥。
• 确认所选模型可通过 Responses 接口使用，并查看当前费率。

操作步骤

1. 编辑用户配置

   打开用户级 ~/.codex/config.toml 文件。供应商和认证设置应放在用户配置中，不要放在项目的 .codex/config.toml。

2. 添加供应商

   设置 model_provider=apiclaude、base_url=https://apiclo.com/v1、env_key=APICLAUDE_API_KEY 和 wire_api=responses，并选择准确的 ApiClo 模型 ID。

3. 设置密钥并测试

   让 Codex 进程读取 APICLAUDE_API_KEY；必要时重启 Codex。在测试文件夹中请求简短回复，并检查 ApiClo Logs。

示例

model = "claude-sonnet-5"
model_provider = "apiclaude"

[model_providers.apiclaude]
name = "ApiClo"
base_url = "https://apiclo.com/v1"
env_key = "APICLAUDE_API_KEY"
wire_api = "responses"

export APICLAUDE_API_KEY="YOUR_APICLO_KEY"
codex

$env:APICLAUDE_API_KEY="YOUR_APICLO_KEY"
codex

检查结果

Codex 应返回简短回复，且该请求应以所选模型出现在 ApiClo 用量记录中。正式依赖智能体流程前，还需单独测试工具调用。

常见问题

• 401：确认 Codex 进程可以读取 APICLAUDE_API_KEY，且其中是有效的 ApiClo 密钥。
• 404 或模型错误：核对准确的模型 ID 和带 /v1 的 Base URL；不要在 base_url 中再加 /responses。
• 如果 Codex 拒绝配置，请更新客户端并保持 wire_api=responses，这是支持的自定义供应商协议。

兼容性与计费

ApiClo 与 OpenAI 独立。自定义供应商的行为可能因 Codex 版本与界面而异；API 密钥不等于 ChatGPT 订阅。ApiClo 按所选模型费率计费用量。

参考资料

• Codex configuration reference