跳转到主要内容
Codex 使用 Responses 协议。APIONE 提供 /v1/responses，但仍需选择支持该协议和编码工具调用的模型。

配置密钥

安装 Codex CLI 后，在启动它的终端设置：
PowerShell 使用 $env:APIONE_API_KEY="YOUR_APIONE_KEY"。不要把真实密钥写入项目仓库。

手动配置自定义供应商

编辑用户级 ~/.codex/config.toml。将前两项放在第一个 TOML 表头之前，并把供应商字段合并到现有的 [model_providers.apione] 表。每个键和表只定义一次。模型 ID 请从当前密钥可用的模型中选择。
env_key 指向存放 APIONE 密钥的环境变量。手动配置使用这一种认证方式。若原来的供应商块来自一键接入，切换前先备份，再从该供应商块移除旧的 experimental_bearer_token 和 requires_openai_auth。Base URL 填到 /v1。配置字段依据 OpenAI 官方配置参考。

APIONE 桌面端一键接入

在 APIONE 桌面端选择接入工具、价格分组和模型，再核对「确认改动」中的配置文件与 Responses 地址。一键接入和上面的手动配置是两条独立路径。客户端生成的本机模型目录请随对应配置一起保留。
APIONE 桌面端预览 Codex Responses 配置改动

APIONE 桌面端的一键接入改动预览。模型和配置文件路径随设备及选择变化。

启动与验证

在同一终端进入测试项目，运行 codex，先要求解释目录结构。确认 APIONE 控制台出现请求，再测试工具调用。普通文本成功并不保证远程压缩、联网搜索等扩展能力可用。 桌面端应使用同一用户的配置，并在修改后完全退出再启动。桌面图标启动的进程不一定继承 Shell 变量；若报告找不到 APIONE_API_KEY，按当前桌面端支持的凭据或启动环境方式配置，不能仅凭终端已有变量判断成功。

排查重点

  • 401：检查实际运行进程是否读取到有效密钥。
  • 404 或模型错误：核对模型 ID 与 Responses 权限。
  • 400：检查工具、推理和其他参数是否受当前模型支持。
  • 仍连接旧服务：检查项目级配置或启动参数是否覆盖用户配置。
APIONE API 费用与 ChatGPT/Codex 订阅分开计算；使用 APIONE 密钥不代表获得官方订阅权益。
返回集成目录 · 模型选择 · 错误排查