跳到主要内容

Codex App + CLI

Codex App 与 CLI 共用本地 Provider 配置，并通过 Responses wire API 连接 PopGo API。

配置前先确认​

  • 本页只写占位符；实际 Key 从 PopGo API 密钥页复制，模型从模型与价格页复制。
  • 一键配置适合已安装并注册协议的软件；浏览器提示打开外部应用时，需要允许一次。
  • 手动配置时先保存一个最小 Provider，首个请求成功后再启用流式、工具调用或多模型路由。

官方来源与核验​

本页于 2026-07-14 根据官方来源核验 Codex App + CLI 0.144.4。 官方来源. 核验范围包括官方自定义 Provider 结构，以及 App 与 CLI 共用的本地配置。

一键配置​

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

手动配置​

先在终端设置 POPGO_API_KEY，再把以下 Provider 配置写入 Codex 配置文件；App 与 CLI 无需重复配置。

export POPGO_API_KEY="YOUR_API_KEY"
$env: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"
  • 配置文件通常位于用户目录下的 .codex/config.toml；Windows 是 %USERPROFILE%\.codex\config.toml，macOS/Linux 是 ~/.codex/config.toml。
  • 密钥通过 POPGO_API_KEY 环境变量读取，不要把真实 Key 写进 config.toml 或公开截图。

完整安装与配置流程​

Windows PowerShell​

  1. 安装 Node.js 22 或更高版本，然后检查：
node -v
npm -v
  1. 安装 Codex 并确认命令可用：
npm install -g @openai/codex
codex --version
  1. 创建配置目录并写入 config.toml：
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
@"
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"
"@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8
  1. 在启动 Codex 的同一终端设置 Key。长期使用可写入用户环境变量：
[Environment]::SetEnvironmentVariable("POPGO_API_KEY", "YOUR_API_KEY", "User")
  1. 关闭 PowerShell 后重新打开，再进入项目目录启动：
cd C:\path\to\your\project
codex

macOS / Linux​

  1. 安装并验证 Codex：
npm install -g @openai/codex
codex --version
  1. 写入配置文件：
mkdir -p ~/.codex
cat > ~/.codex/config.toml << "EOF"
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"
EOF
  1. 设置 Key 并启动：
export POPGO_API_KEY="YOUR_API_KEY"
cd /path/to/your/project
codex

配置文件说明​

字段作用
model默认模型，替换成实时模型页复制的模型 ID
model_provider当前默认 Provider 名称，必须对应下面的 [model_providers.popgo]
base_urlPopGo OpenAI compatible /v1 地址
env_key从环境变量读取 Key，避免把真实 Key 写进文件
wire_api使用 Responses wire API

常见现象​

  • codex: command not found：确认 Node.js 与 npm 全局路径，重新打开终端后再验证。
  • model not found：回到模型与价格页重新复制模型 ID，替换 YOUR_MODEL。
  • 认证错误：确认 POPGO_API_KEY 在启动 Codex 的同一终端中可见，不要把 Key 写进公开文件。

成功判断​

从已设置环境变量的终端启动 CLI，或重新打开 App，并用 YOUR_MODEL 发送请求。

常见错误和恢复​

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