PrimeRouter × Codex Desktop

一键安装 Codex Desktop接入 PrimeRouter

下载一个已内置你 API Key 的安装包，双击运行：安装 Codex 桌面版、写好与 CLI 共用的 ~/.codex/config.toml、先备份再覆盖。装完打开应用即可。按量计费，余额永不过期。

一行命令安装

需要先注册或登录，完成后会自动回到这里的安装步骤。已有账号？直接登录

KEY
安装包内置你的 API Key，不用手动粘贴
BACKUP
config.toml 与 auth.json 先备份再写入
HISTORY
沿用原有 model_provider，codex resume 历史不丢
SHARED
与 Codex CLI 共用一份配置，装一次两边可用
安装流程

三步接入

01

注册或登录

点「获取安装包」。未登录会先带你注册，完成后自动回到安装步骤，分享链接里的来源标签不会丢。

02

下载并运行安装包

得到 PrimeRouter-CodexDesktop-Installer.zip，解压后双击 PrimeRouter-CodexDesktop-Installer.command。它会先从 PrimeRouter 镜像下载 DMG 并安装，再写配置。

03

打开 Codex 应用

macOS 上当前安装包内的应用可能显示为 ChatGPT.app（bundle id 仍是 Codex），脚本装完会打印实际路径。打开后即可使用；遇到登录提示或模型列表异常，先看排错页。

命令行安装

已有 API Key？一行命令

不想登录网页也行：脚本会交互式询问你的 API Key，不会把 key 写进命令或历史记录。

curl -fsSL https://primerouter.ai/install/codex-desktop.sh | bash

脚本会做什么：macOS 从 PrimeRouter 镜像下载 DMG（镜像没有时回落官方地址）并安装到「应用程序」→ 询问 API Key → 备份并写入 ~/.codex/config.toml 与 auth.json。Windows 由脚本通过 Microsoft Store（winget）安装桌面版并写配置。

查看脚本源码：codex-desktop.sh · codex-desktop.ps1

没有 Key？到令牌页创建一把。

使用价值

为什么用 PrimeRouter 跑 Codex Desktop

按量计费，余额永不过期

充多少用多少，没有订阅、没有月底清零。

法币或加密货币充值

多种本地支付方式，或 USDT / USDC 多链到账。

个人账号零风险

请求消耗的是服务侧的采购额度，与你在 OpenAI 持有的任何账号完全隔离。

一把 Key，所有编程工具

同一把 Key 也能接 Claude Code、Gemini CLI、Cursor 等 OpenAI / Anthropic 协议客户端。

FAQ

常见问题

会。Codex 只保存一份凭证（~/.codex/auth.json），安装后 PrimeRouter 的 Key 会顶掉 ChatGPT 登录；原文件已备份成 auth.json.bak.<时间戳>，随时 codex login 换回。 查看排错页 →
在。安装脚本沿用这台机器原有的 model_provider id，所以 codex resume 照常列出旧会话，文件一个都没动。 查看排错页 →
多半是执行过 codex login 顶掉了 Key，或 Key 在控制台被删除、禁用。重跑安装包即可恢复；也可以手动写回：printf '%s' "sk-你的key" | codex login --with-api-key。 查看排错页 →
config.toml 里的模型在你的分组里不可用。安装包会按你的分组自动选一个可用的默认模型，重跑一次即可；或到控制台模型页查可用模型名后手动改 model = "…"（保持它在 [model_providers] 之上）。 查看排错页 →
脚本先走 PrimeRouter 镜像，失败回落到官方地址。下载中断重跑即可；提示映像损坏是没下完整，删掉重下并确认磁盘剩余空间大于 1 GB；首次打开被拦截时在「应用程序」里右键该 app → 打开。 查看排错页 →
安装包只对你本人生成，内含你账号下的一把令牌，请勿转发给他人。若不慎泄露，到控制台令牌页删除或重建这把令牌即可，其他令牌不受影响。 令牌页 →
CLI 与桌面版共用 ~/.codex/config.toml，装一次两边都能用。只想用命令行的话，到 Codex CLI 安装页。 Codex CLI 安装页 →

现在就把 Codex Desktop 接上

一个 API Key，同时可用于 Claude Code、Gemini CLI 与所有 OpenAI / Anthropic 协议的客户端。