配置 Codex APP 完整流程
适用于 Windows 和 macOS · 整个过程约 5 分钟
irm https://relvox.xyz/install/codex.ps1 | iexcurl -fsSL https://relvox.xyz/install/codex.sh | bashnpm 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 才算退干净
第四步 · 执行一键脚本
- 开始菜单搜索「PowerShell」,在「Windows PowerShell」上右键 → 以管理员身份运行
- 粘贴下面这一行,回车:
irm https://relvox.xyz/install/codex.ps1 | iex - 出现
Paste the API key时,粘贴第二步复制的密钥,回车 - 出现
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
第五步 · 打开 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 · 提示密钥无效 / 一直转圈
- 确认第二步创建密钥时选的是 Codex 分组
- 确认余额充足(第一步)
- 确认粘贴时没有多带空格或引号(脚本会自动清理常见的引号和全角字符)
附 · 脚本到底改了什么
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 的部分,其余原样保留;每次改动前自动备份。
配置 Codex APP