PrimeRouter × Codex CLI

一键安装 Codex接入 PrimeRouter

Q: 已经用 ChatGPT 账号登录了 Codex，会被覆盖吗？

会。Codex 只保存一份凭证（~/.codex/auth.json），安装后 PrimeRouter 的 Key 会顶掉 ChatGPT 登录；原文件已备份成 auth.json.bak. ，随时 codex login 换回。

Q: 之前接的是别的服务商，codex resume 的历史会话还在吗？

在。安装脚本沿用这台机器原有的 model_provider id，所以 codex resume 照常列出旧会话，文件一个都没动。

Q: Codex 报 401，或突然要我登录 ChatGPT

多半是执行过 codex login 顶掉了 Key，或 Key 在控制台被删除、禁用。重跑安装包即可恢复；也可以手动写回：printf '%s' "sk-你的key" | codex login --with-api-key。

Q: 提示 model_not_found / 无可用渠道

config.toml 里的模型在你的分组里不可用。安装包会按你的分组自动选一个可用的默认模型，重跑一次即可；或到控制台模型页查可用模型名后手动改 model = "…"（保持它在 [model_providers] 之上）。

Q: Windows 提示「因为在此系统上禁止运行脚本」

PowerShell 执行策略拦截了 .ps1 文件。用一行命令 irm … | iex 直接从网络执行不需要改策略；已经下载了 codex.ps1 的话，用 powershell -ExecutionPolicy Bypass -File .\codex.ps1 只放行本次。不建议全局 Set-ExecutionPolicy Unrestricted。

Q: 我用的是 Codex Desktop（桌面版）

桌面版与 CLI 共用 ~/.codex/config.toml，配置一次两边都生效。macOS / Windows 请到 Codex Desktop 安装页；Linux 暂无官方桌面版，请用 CLI。

下载一个已内置你 API Key 的安装包，双击运行：自动安装 Codex CLI、写好配置、先备份再覆盖。装完直接运行 codex。按量计费，余额永不过期。

一行命令安装

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

KEY

安装包内置你的 API Key，不用手动粘贴

BACKUP

config.toml 与 auth.json 先备份再写入

HISTORY

沿用原有 model_provider，codex resume 历史不丢

REVERSIBLE

随时 codex login 换回 ChatGPT 账号

安装流程

三步接入

注册或登录

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

下载并运行安装包

得到 PrimeRouter-Codex-Installer.zip，解压后双击 PrimeRouter-Codex-Installer.command。首次运行如被系统拦截，右键该文件 → 打开。

得到 PrimeRouter-Codex-Installer.bat，双击运行，按窗口提示完成。

得到 PrimeRouter-Codex-Installer.sh，在终端运行：bash ~/Downloads/PrimeRouter-Codex-Installer.sh。

启动 Codex

新开一个终端，运行 codex。默认模型已写进配置；遇到报错先看下方常见问题或排错页。

命令行安装

已有 API Key？一行命令

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

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

irm https://primerouter.ai/install/codex.ps1 | iex

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

脚本会做什么：检查 Node v22+ → 缺 @openai/codex 时询问后用 npm 全局安装 → 询问 API Key → 备份并写入 ~/.codex/config.toml 与 auth.json（沿用已有的 model_provider id）。

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

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

使用价值

为什么用 PrimeRouter 跑 Codex

按量计费，余额永不过期

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

法币或加密货币充值

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

个人账号零风险

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

一把 Key，所有编程工具

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

FAQ

常见问题

已经用 ChatGPT 账号登录了 Codex，会被覆盖吗？

会。Codex 只保存一份凭证（~/.codex/auth.json），安装后 PrimeRouter 的 Key 会顶掉 ChatGPT 登录；原文件已备份成 auth.json.bak.<时间戳>，随时 codex login 换回。查看排错页 →

之前接的是别的服务商，codex resume 的历史会话还在吗？

在。安装脚本沿用这台机器原有的 model_provider id，所以 codex resume 照常列出旧会话，文件一个都没动。查看排错页 →

Codex 报 401，或突然要我登录 ChatGPT

多半是执行过 codex login 顶掉了 Key，或 Key 在控制台被删除、禁用。重跑安装包即可恢复；也可以手动写回：printf '%s' "sk-你的key" | codex login --with-api-key。查看排错页 →

提示 model_not_found / 无可用渠道

config.toml 里的模型在你的分组里不可用。安装包会按你的分组自动选一个可用的默认模型，重跑一次即可；或到控制台模型页查可用模型名后手动改 model = "…"（保持它在 [model_providers] 之上）。查看排错页 →

Windows 提示「因为在此系统上禁止运行脚本」

PowerShell 执行策略拦截了 .ps1 文件。用一行命令 irm … | iex 直接从网络执行不需要改策略；已经下载了 codex.ps1 的话，用 powershell -ExecutionPolicy Bypass -File .\codex.ps1 只放行本次。不建议全局 Set-ExecutionPolicy Unrestricted。查看排错页 →

安装包里带着我的 API Key，安全吗？

安装包只对你本人生成，内含你账号下的一把令牌，请勿转发给他人。若不慎泄露，到控制台令牌页删除或重建这把令牌即可，其他令牌不受影响。令牌页 →

我用的是 Codex Desktop（桌面版）

桌面版与 CLI 共用 ~/.codex/config.toml，配置一次两边都生效。macOS / Windows 请到 Codex Desktop 安装页；Linux 暂无官方桌面版，请用 CLI。 Codex Desktop 安装页 →

现在就把 Codex 接上

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