CA Codex Guide OpenAI 兼容接入

Codex 使用 CallAPI 教程

本页说明如何让 Codex 使用 CallAPI 的 OpenAI 兼容 API,包括环境变量、provider 配置、 Responses API 线路和常见错误排查。

配置速查

配置项 推荐值 说明
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_urlhttps://callapi8.com/v1
  • 确认模型名在当前账号分组中可用。
  • 先通过控制台或 /v1/models 查看模型列表。

请求超时

  • 先降低任务复杂度,用短提示词验证连接。
  • 切换模型判断是线路问题还是单模型问题。
  • 检查本地代理、DNS 和防火墙是否影响 callapi8.com