跳到主要内容

Codex CLI

Codex CLI 使用自定义 model_provider 和 Responses wire API。

官方来源与核验​

本页于 2026-07-13 根据官方来源核验 Codex CLI 0.144.3。 官方来源. 核验范围是官方配置文件中的自定义 Provider 结构。

一键配置​

登录 PopGo API 密钥页，在目标 Key 所在行打开操作菜单。公开文档不会生成或展示任何带 Key 的跳转链接。 依次选择 CC Switch 和 Codex。 导入 Codex 配置后，检查 Base URL 为 /v1 层级。

手动配置​

先在终端设置 POPGO_API_KEY，再把以下 Provider 配置写入 Codex 配置文件。

export POPGO_API_KEY="YOUR_API_KEY"
model = "YOUR_MODEL"
model_provider = "popgo"

[model_providers.popgo]
name = "PopGo"
base_url = "https://api.popgo.site/v1"
env_key = "POPGO_API_KEY"
wire_api = "responses"

成功判断​

从已设置环境变量的终端启动新会话，并用 YOUR_MODEL 发送请求。 使用 YOUR_MODEL 发起一个全新测试请求。收到正常内容且没有认证或地址错误，即可判定连接成功。

常见错误和恢复​

  • 提示缺少 Key 时，确认变量名严格为 POPGO_API_KEY，并从当前终端重新启动。
  • 出现 401 时，重新粘贴 YOUR_API_KEY 并检查是否带有首尾空格。
  • 出现 404 时，核对 Base URL 层级，避免客户端重复追加 /v1。