配置速查
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| Base URL | https://callapi8.com/v1 |
Codex 走 OpenAI 兼容接口时使用 /v1 地址。 |
| 环境变量 | OPENAI_API_KEY |
值为你在 CallAPI 控制台创建的令牌。 |
| wire_api | responses |
推荐优先使用 Responses API 线路。 |
设置 API Key
先在当前 shell 中设置 API Key:
export OPENAI_API_KEY="YOUR_API_KEY"
如果你希望长期生效,可以把这行写入自己的 shell 配置文件,或者按部署环境使用密钥管理工具。
配置 Codex Provider
编辑 ~/.codex/config.toml,加入 CallAPI provider:
model_provider = "callapi8"
model = "gpt-5.4"
model_reasoning_effort = "high"
[model_providers.callapi8]
name = "callapi8"
base_url = "https://callapi8.com/v1"
wire_api = "responses"
requires_openai_auth = true
示例模型名只用于说明。实际模型请以控制台可见模型或
/v1/models 返回结果为准。
验证连接
配置完成后,使用一个短任务测试:
codex -m gpt-5.4
codex exec -m gpt-5.4 "用一句话确认连通性"
如果命令能正常返回,再接入更长上下文或真实开发任务。
常见错误
401 Unauthorized
- 检查
OPENAI_API_KEY是否设置在当前 shell 中。 - 确认令牌没有过期、删除或禁用。
- 不要把引号、换行或多余空格复制进 Key。
404 或模型不存在
- 确认
base_url是https://callapi8.com/v1。 - 确认模型名在当前账号分组中可用。
- 先通过控制台或
/v1/models查看模型列表。
请求超时
- 先降低任务复杂度,用短提示词验证连接。
- 切换模型判断是线路问题还是单模型问题。
- 检查本地代理、DNS 和防火墙是否影响
callapi8.com。