你需要准备
- 已在本站注册并开通有效订阅（见 套餐）。
- 控制台中的 API Key（sk- 开头）。
- 本机已安装 Codex CLI 或 Codex 桌面 App。
- macOS / Linux 需要 bash、curl、python3；Windows 使用原生 PowerShell。
一键安装
推荐从 控制台 复制授权命令（浏览器点「授权此设备」，不用手抄密钥）：
macOS / Linux
curl -fsSL https://gpt.opusapi.xyz/install.sh | bash
Windows PowerShell
irm https://gpt.opusapi.xyz/install.ps1 | iex
授权完成后请完全退出再打开 Codex / ChatGPT 桌面 App。不要点「用 ChatGPT 登录」，不要填手机号；脚本已切到 API 网关模式。
高级：打开 /setup 粘贴 Key 后复制命令。也可以直接执行：
macOS / Linux（贴 Key）
curl -fsSL https://gpt.opusapi.xyz/setup-codex.sh | bash -s -- --key 'sk-你的密钥'
Windows PowerShell（贴 Key）
$k='sk-你的密钥'; & ([scriptblock]::Create((irm https://gpt.opusapi.xyz/setup-codex.ps1))) -Key $k
Windows 请在原生 PowerShell 中执行，不要再套一层 bash。脚本会写入 ~/.codex（或 $CODEX_HOME）中的配置与鉴权信息。
不要用其它产品线的通用安装命令。OpusCodex 只认本站 install.sh / install.ps1 与 setup-codex.sh / setup-codex.ps1。
脚本参数
| 场景 | 命令要点 |
|---|---|
| 安装 / 重装 | --key sk-…（PowerShell：-Key） |
| 指定线路 | --base-url URL（PowerShell：-BaseUrl） |
| 跳过联网探测 | --no-verify |
| 只读检查 | --check（PowerShell：-Check） |
| 卸载本站配置 | --uninstall（PowerShell：-Uninstall） |
# 示例：安装并指定线路
curl -fsSL https://gpt.opusapi.xyz/setup-codex.sh | bash -s -- --key 'sk-…' --base-url 'https://gpt.opusapi.xyz'
# 示例：只读自检
curl -fsSL https://gpt.opusapi.xyz/setup-codex.sh | bash -s -- --check
可用线路（base-url）
安装命令仍用本站。推理网关默认 https://api.opusapi.xyz/v1（可用 --base-url 覆盖）：
- https://api.opusapi.xyz（默认推理）
- https://gpt.opusapi.xyz（本站；也可作推理）
- https://opusapi.xyz（备用）
- https://india.opusapi.xyz（备用；网络环境自备）
Key 不变，只换入口。不要把 base-url 改成白名单以外的域名。
验证是否接上
- 打开 Codex App 或 CLI。
- 新建会话 / 新线程（旧会话可能仍指向其它地址）。
- 发送一条简单消息；成功后控制台「本站周额度」应有消耗。
- 可选：再跑一次 setup-codex --check 做只读自检。
若请求仍未走本站，请完全退出 App 后重开，确认配置目录里只保留本站写入的段落，然后新建会话。
用量与档位
- 各档均为本站周额度档位，以控制台进度为准，每周刷新。
- 长上下文、多轮连续会更快消耗额度；用尽后等待刷新或升级。
- 首页营销可能描述四档；实际可购列表、价格与是否在售以 购买页 服务端数据为准。
- 不把本站档位包装成任何第三方会员的 1:1 等值承诺。
卸载本站配置
curl -fsSL https://gpt.opusapi.xyz/setup-codex.sh | bash -s -- --uninstall
# Windows PowerShell
& ([scriptblock]::Create((irm https://gpt.opusapi.xyz/setup-codex.ps1))) -Uninstall
卸载只移除本站管理的配置段与对应鉴权写入，不会替你卸载 Codex 本体。
排障
| 现象 | 处理 |
|---|---|
| 鉴权失败 / 401 | 重新复制控制台 Key，重跑 setup-codex；确认订阅未过期 |
| 授权后仍要手机号 / 进不了 API 模式 | 重跑控制台授权命令；完全退出 ChatGPT/Codex 再开；不要点「用 ChatGPT 登录」。可执行 install.sh --check 确认 forced_login_method=api |
| Windows 装完仍要验证码、进不了网关模式 | 现网 2026 桌面 CLI 在 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe。脚本必须打印「已注册 API 登录」；只写 config 不够。先装官方 Codex App，完全退出后重跑 irm https://gpt.opusapi.xyz/install.ps1 | iex。不要点 ChatGPT 登录。 |
| 仍走其它地址 | 新建会话；完全退出 App 再开；检查 base-url 与配置目录 |
| base-url 被拒绝 | 只能使用上方白名单域名 |
| 额度掉得快 | 缩小上下文、减少重复开新会话；或升级更高档 |
| 支付后未生效 | 刷新控制台；若订单已付请提交工单并附订单号 |
| Windows 命令异常 | 确认在原生 PowerShell 中执行 setup-codex.ps1 |
数据与隐私
我们不会将对话正文用于训练或无关分析。系统可能保留必要的安全与排障日志（访问受权限控制）。详见 隐私政策 与 用户协议。
客服与活动
登录后打开 控制台，使用在线客服或工单。
「发帖有奖」请走 活动工单入口：填写平台、公开链接与播放量，人工审核后发放，不自动改订阅。