StdAPI配置 Codex APP使用文档返回主站 →

配置 Codex APP 完整流程

适用于 Windows 和 macOS · 整个过程约 5 分钟

先看这里:全程只需要一条命令。复制、粘贴、回车,然后按提示粘贴密钥即可。
irm https://relvox.xyz/install/codex.ps1 | iex
macOS:打开「终端」(Terminal),粘贴这一行,回车后按提示粘贴密钥:
curl -fsSL https://relvox.xyz/install/codex.sh | bash
macOS 上用的是 Codex CLI:先装它 npm install -g @openai/codex(装了 Homebrew 也可以 brew install codex),再执行上面那一行,然后在终端里输入 codex 就能用。

第一步 · 充值余额

打开 relvox.xyz/wallet 充值。

充值后余额会显示在网页右上角,也可以在「控制台 → 钱包」查看。

第二步 · 创建 API 密钥

打开 relvox.xyz/keys,点「创建密钥」。

字段填什么
分组选 Codex Pro(仅限Codex)
只有 Codex 分组才能用 gpt-6.1-sol / gpt-6-sol / gpt-6-astra 这些模型。
如果希望这把密钥同时给别的客户端用,选 Codex Pro(外接版)。
名称随便填,例如 codex
无限额度保持勾选即可

创建完成后,点密钥右边的「复制」按钮把密钥复制好(第四步要粘贴)。密钥形如 sk-xxxxxxxxxxxxxxxx。

请注意:密钥只在创建时完整显示一次,请立即复制保存。

第三步 · 下载并安装 Codex(Windows)

macOS 用户跳过这一步,按上面的 macOS 说明装 Codex CLI 即可。

微软商店官方安装器:

https://get.microsoft.com/installer/download/9PLM9XGG6VKS

安装后如果它自动启动了:
  • 不要登录,直接彻底退出
  • 只关窗口是不够的 —— 右下角托盘里的图标也要右键退出
  • 任务管理器里看不到 Codex / ChatGPT 才算退干净

第四步 · 执行一键脚本

  1. 开始菜单搜索「PowerShell」,在「Windows PowerShell」上右键 → 以管理员身份运行
  2. 粘贴下面这一行,回车:
    irm https://relvox.xyz/install/codex.ps1 | iex
  3. 出现 Paste the API key 时,粘贴第二步复制的密钥,回车
  4. 出现 Model [gpt-6.1-sol] 时,直接回车即可
    想用别的模型就输入模型名,模型清单见 relvox.xyz/pricing

脚本会自动写好这两个文件(改之前自动备份成 .bak.时间戳):

Windows: %USERPROFILE%\.codex\config.toml  ·  %USERPROFILE%\.codex\auth.json
macOS:   ~/.codex/config.toml  ·  ~/.codex/auth.json
你原有的 MCP server、profile 等配置都会保留,不会被覆盖。

第五步 · 打开 Codex APP 就能用了

如果第四步执行时 Codex 没关干净,请关掉它,再重新执行一次第四步。

常见问题

Q1 · 发消息后报 model not found(模型不存在)

说明这个模型名网关上没有。重新执行第四步,在 Model 那一步输入一个面板里真实有的模型名(清单见 relvox.xyz/pricing)。

也可以按下面这种带参数的方式执行(注意:iex 不能直接透传参数,所以要多写一步):

iwr https://relvox.xyz/install/codex.ps1 -OutFile $env:TEMP\codex.ps1
& $env:TEMP\codex.ps1 -Model "gpt-6-sol"

Q2 · 弹窗「无法加载 Codex 配置」,写着 failed to parse model_catalog_json ... missing field: slug

这是旧版安装包留下的坏文件,跟密钥无关。在出问题那台机器上执行一次修复脚本:

irm https://relvox.xyz/install/repair-codex-catalog.ps1 | iex

它会备份坏文件后删掉,Codex 就能正常启动了。

Q3 · 我已经登录过 Codex 了

先彻底退出 Codex;如果它记住了 ChatGPT 账号,在 Codex 里退出登录,再执行第四步。

Q4 · 提示密钥无效 / 一直转圈

  1. 确认第二步创建密钥时选的是 Codex 分组
  2. 确认余额充足(第一步)
  3. 确认粘贴时没有多带空格或引号(脚本会自动清理常见的引号和全角字符)

附 · 脚本到底改了什么

1. 写入 %USERPROFILE%\.codex\config.toml:

model_provider = "stdapi"
model = "gpt-6.1-sol"

[model_providers.stdapi]
base_url = "https://relvox.xyz/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

2. 写入 %USERPROFILE%\.codex\auth.json:

{"auth_mode":"apikey","OPENAI_API_KEY":"你的密钥"}

3. 只改这两个文件里属于 StdAPI 的部分,其余原样保留;每次改动前自动备份。