使用文档

简介

OpusCodex 是什么、适合谁、能做什么。

OpusCodex 让你在国内用订阅方式接入 官方 Codex 桌面端：支付宝开通、国内直连。我们负责账号调度、鉴权与额度；你用的仍是官方 App。

适合谁

想用官方 Codex App 干活，但不想折腾外币卡和网络
日常改稿、整理材料、推进项目，需要稳定桌面端用量
希望按用量分档、额度每周刷新、控制台能看进度的人

产品线

产品	域名	说明
OpusCodex	gpt.opusapi.xyz	订阅制接入官方 Codex App
OpusAPI	opusapi.xyz	按量 API（脚本 / 多模型）；与订阅线独立

我们做什么

一键装机与浏览器设备授权（密钥默认不出现在终端）
多路上游调度，尽量让你无感切换
周额度计量、设备绑定、控制台用量与订单
在线客服与工单（开票、选档、升级、排障）

工作原理

一次请求从 Codex 到上游，大致怎么走。

Codex / 桌面 / VS Code→ 本机 opcodex / helper 鉴权→ gpt.opusapi.xyz→ 上游账号池调度→ 上游

装机：一键脚本把本机 Codex 配置接到 gpt.opusapi.xyz。
桌面 App：官方 Codex 桌面端；授权后密钥默认不落盘为明文。
额度：请求经本站鉴权与调度，扣本站周额度。

同一订阅的周额度在控制台可看；设备绑定与解绑也在控制台完成。

我们记录什么

控制台主要展示用量、状态、模型、耗时等元数据。为排障、风控与账务可能保留必要技术日志，访问受权限控制。不会把你的内容用于模型训练。详见用户协议 · 数据与隐私。

快速开始

大约两分钟：开通 → 装机 → 授权 → 使用。

注册并开通套餐

打开注册页直接注册，在套餐页支付宝开通。登录控制台确认订阅 active。
一键接入（CLI）

macOS / Linux：

macOS / Linux

$ curl -fsSL https://gpt.opusapi.xyz/install.sh | bash

Windows（PowerShell）：

Windows

PS> irm https://gpt.opusapi.xyz/install.ps1 | iex
浏览器授权

脚本会打开授权页。用购买套餐的邮箱账号登录，点「授权此设备」。密钥自动写入本机，不在终端展示。
启动

启动

$ opcodex

开一个新终端再跑 opcodex。日常请用它启动，不要依赖裸 claude（除非你清楚自己在做什么）。

命令行版（opcodex）

终端里的官方 Codex，经 OpusCodex 鉴权与网关接入。

前提

建议 Codex ≥ 2.1.197（装机脚本会检测并尽量安装/升级）
需要 curl、python3；安装 CC 时用到 npm

也可先手动装官方 Codex：

可选：先装 Codex

$ npm install -g @anthropic-ai/claude-code

一键接入

macOS / Linux

$ curl -fsSL https://gpt.opusapi.xyz/install.sh | bash

Windows PowerShell

PS> irm https://gpt.opusapi.xyz/install.ps1 | iex

装机脚本常用参数

参数	作用
--check / --doctor	只读检查：环境配置、rc 泄漏、裸 claude 会走谁
--route india\|hk	装机时选 API 线路：india=印度直连，hk=香港默认（授权仍走香港）
--uninstall	彻底移除配置、启动器与 rc 残留
--key sk-xxx	高级：直接写入 key（一般用浏览器授权即可）
--email / --password	高级：账密登录回退
--keep-claude-state	不动本机既有 Claude 登录态
--reset-claude	强制复位可能覆盖运行配置的登录态
--no-verify	跳过装完端到端验证

日常使用

启动：opcodex（其后参数透传给 claude）
自检：opcodex --check
切线路：opcodex --route india（印度直连，建议自备梯子）/ opcodex --route hk（香港默认）
免确认（yes 模式）：opcodex --yes（别名 -y / --yolo）
导入 skill / plugin：opcodex --import-skills（别名 --sync-skills）
临时关闭 Fable/一方主开关：opcodex --no-fable5
密钥文件：~/.opuscodex/config（权限 600），不写进 shell 历史
独立配置目录：~/.opuscodex/claude-env

免确认模式（--yes）

等价于官方 Codex 的 claude --dangerously-skip-permissions：工具执行不再反复弹 yes / 权限确认。

免确认启动

$ opcodex --yes

别名：opcodex -y、opcodex --yolo
环境变量（等效）：OPUSCLAUDE_YES=1 opcodex
可叠参数：opcodex --yes -p "fix bug"
风险：会自动批准读写文件、跑命令等工具操作。只在你信任的项目/沙箱里用；默认交互仍应走普通 opcodex
需要新启动器：若提示未知参数，先重跑装机命令升级

启动横幅可能显示 Claude Max（展示用）；计费走你的订阅周额度。状态栏出现 API Usage Billing 时，多为鉴权走 AUTH_TOKEN 稳定路径的展示差异，一般不影响订阅计费。

Skill / 插件「没了」怎么办

不是被删了。为避免官方登录态盖掉网关，opcodex 使用独立配置目录 ~/.opuscodex/claude-env，与原生 ~/.claude 分开。以前装在原生目录里的 skill / plugin，在 opcodex 里默认读不到，看起来像「全没了」。

一键把原生目录里的技能资料导入隔离环境（只同步目录，不碰登录态与密钥）：

导入 skill / plugin

$ opcodex --import-skills

会同步：skills / plugins / commands / agents（源目录里有才拷）
不会拷贝 settings.json、历史对话、projects，也不会改密钥
导入后重新运行 opcodex 即可
项目级 skill（仓库里的 .claude/）不受隔离影响，打开对应项目即可
若提示命令不支持该参数：先重跑一次装机命令升级启动器，再执行导入

卸载

彻底移除配置与启动器：Mac/Linux 加 --uninstall；Windows 用 OPUSCLAUDE_ACTION=uninstall 或 -Uninstall。

卸载

$ curl -fsSL https://gpt.opusapi.xyz/install.sh | bash -s -- --uninstall

桌面 App 版

官方 Claude 桌面图形界面。图文步骤也可看桌面接入教程。

前提

从 claude.ai/download 安装官方桌面 App（用你自己的网络）
接入脚本默认不下载 App，只做本机配置与授权
面向 macOS / Windows；Linux 请用 CLI

一键接入

macOS

$ curl -fsSL https://gpt.opusapi.xyz/desktop-install.sh | bash

Windows（建议管理员 PowerShell）

PS> irm https://gpt.opusapi.xyz/desktop-install.ps1 | iex

授权后请完全退出再打开 Claude 桌面 App。应直接进入使用界面，无需再登录 Anthropic 账号。模型列表通常含 Opus / Fable / Sonnet / Haiku 等（以当期号池为准）。

默认 helper 模式：本机小脚本按 TTL 向服务端换票。认证失败请看 ~/.opuscodex/helper.log（Windows 为同路径用户目录）。

与 CLI 对照

项	CLI（opcodex）	桌面 App
界面	终端 Codex	官方桌面 GUI
装机脚本	install.sh / .ps1	desktop-install.sh / .ps1
额度	同一订阅周额度
同机设备名额	通常共用 1 台

VS Code 扩展版

官方 Codex 扩展。图文：VS Code 教程。

前提

已安装 VS Code
扩展市场安装 Codex（发布者 Anthropic，ID Anthropic.claude-code）

一键接入

macOS / Linux

$ curl -fsSL https://gpt.opusapi.xyz/vscode-install.sh | bash

Windows

PS> irm https://gpt.opusapi.xyz/vscode-install.ps1 | iex

装完后完全退出 VS Code 再打开。Codex 面板应不再要求登录 Anthropic，对话走订阅额度。

扩展登录检查只读用户设置里的 claudeCode.environmentVariables，不认 shell 环境变量。已跑过 CLI 装机时会复用 ~/.opuscodex/config。

卸载（仅 VS Code 接入）

卸 VS Code 接入

$ curl -fsSL https://gpt.opusapi.xyz/vscode-install.sh | bash -s -- --uninstall

Windows 对脚本加 -Uninstall。不影响 CLI / 桌面。

Cursor / JetBrains

落地页声明原生 Codex 兼容；VS Code 系扩展接入路径已提供独立脚本。JetBrains / Cursor 若使用官方 Codex 插件且支持同类环境变量注入，可咨询客服当前推荐配置；勿把网关改成未说明的第三方域名。

命令与路径速查

场景	命令 / 路径
CLI 装机	curl -fsSL https://gpt.opusapi.xyz/install.sh \| bash
启动	opcodex
自检	opcodex --check
导入 skill / plugin	opcodex --import-skills（见说明）
免确认 yes 模式	opcodex --yes → claude --dangerously-skip-permissions
关 Fable 一方开关	opcodex --no-fable5
配置目录	~/.opuscodex/
密钥配置	~/.opuscodex/config
CLI 专属 CC 环境	~/.opuscodex/claude-env
桌面 helper 日志	~/.opuscodex/helper.log
桌面装机	…/desktop-install.sh 或 .ps1
VS Code 装机	…/vscode-install.sh 或 .ps1

可信网关域名：https://gpt.opusapi.xyz。装机脚本内置白名单，勿把 gateway 改成陌生域名。

套餐与额度

以套餐页实时展示为准；下列为当前对客口径。

当前档位

档位	标价（月）	周额度$	相对官方 Plus	适合
专业	¥68	81	约 1×	日常续杯 · 对齐一份 Plus 周限
进阶	¥168	203	约 2.5×	Plus 与 Pro 5x 之间
重度	¥349	409	约 5×（对齐 Pro 5x）	连续干活主力
旗舰	¥699	810	约 10×	高用量（已取消 20×）

额度口径

硬顶是控制台周额度进度，自开通日起按周刷新。
1× 基线按实测官方 Plus 周限约 $81；5× 对齐实测 Pro 5x 周限约 $409；旗舰为 10×（约 $810），不再提供 20×。
卖价按约 0.2 标定（月面值≈周×4.3）。与官方 5 小时限速条不是逐条对拍。
吃本站额度的主要是用法：上下文长短、多轮连续、一次塞多少材料。以套餐页与控制台为准。

模型

以 Codex App 当期列表与号池为准（常见如 gpt-5.x 系列）。全档同权可用。

升级

优先在控制台 / 定价页自助升级；剩余价值按剩余天数折算到新档（服务端计算为准）。
人工升级需走完整流程（新订阅生效 + 密钥切组 + 旧订阅收尾），否则可能 403。

支付与售后

支付

主要方式：套餐页 支付宝 扫码，支付成功后系统开通
对公 / 特殊需求：登录控制台走在线客服或工单
发票：在线客服说明订单与抬头（见联系客服）

订单与售后

本服务为虚拟数字商品，订阅权益开通后即开始履行。订单、开票、异常服务等问题请优先通过控制台在线客服 / 工单沟通；是否受理及具体处理方式，以当期规则、订单情况与客服确认为准。更多约定见用户服务协议。

设备管理

浏览器授权 / 装机会注册设备；可在控制台查看设备列表与最近使用情况。
默认每账号有设备数上限（以控制台提示为准）。满额时请先解绑旧设备再授权新机。
同一台电脑上 CLI / 桌面 / VS Code 通常共享同一 device_id，只占 1 名额。
撤销设备后，该机旧会话立即失效，需重新跑接入命令。

不要把密钥贴到公开仓库、群聊或截图外传。怀疑泄漏：控制台解绑设备 + 重新授权 + 联系客服。

常见问题

用的是官方能力吗？会降智吗？

客户端是官方 Codex App；模型走真实上游能力。我们不做「换假模型」。档位差异主要在周额度，不在故意阉割模型。

需要科学上网吗？

不需要。国内直连 gpt.opusapi.xyz。装官方桌面 App 本体时若官网下载慢，用你自己的网络环境处理下载即可。

代码 / 对话你们能看见吗？

产品定位是鉴权与请求转发；控制台以元数据为主。不会把对话用于模型训练。细节见协议。

为什么状态栏写 API Usage Billing？

鉴权走稳定 token 路径时的客户端展示差异；订阅计费仍以控制台周额度为准。Max 字样主要在 opcodex 启动横幅。

裸 claude 和 opcodex 有什么区别？

opcodex 才会注入 OpusCodex 运行配置并使用独立配置目录。裸 claude 应保持未接入状态。

接入后 skill / 插件全没了？

多半是配置目录隔离，不是资料被删。原生装在 ~/.claude 的 skill/plugin，在 opcodex 的 ~/.opuscodex/claude-env 里默认不可见。运行 opcodex --import-skills 一键导入（详见 Skill / 插件）。若命令不存在，先重跑装机升级启动器。

支持哪些系统？

CLI：macOS / Linux / Windows。桌面 App 接入：macOS / Windows。Linux 桌面请用 CLI。

和 OpusAPI 按量有什么关系？

OpusAPI 是按量 API 产品线，适合脚本与多模型对接。需要「订阅价用官方 Codex」选 OpusCodex。两站账号/权益默认不自动互通。

邀请制怎么拿码？

向已订阅好友索取邀请码 / 邀请链接；没有码可到官网加微信领码。注册页无有效邀请时无法注册。

排查问题

装不上 / 命令找不到

症状	处理
找不到 opcodex	装完开新终端；或确认 ~/.local/bin / /usr/local/bin 在 PATH
找不到 claude	装机脚本会尽量装；也可 npm i -g @anthropic-ai/claude-code
npm 权限错误	按脚本提示修 npm 全局目录权限，勿盲目 sudo 乱装
curl 连接失败	检查网络 / DNS；确认访问的是 https://gpt.opusapi.xyz

授权失败

症状	处理
授权链接过期	重跑装机/授权流程拿新链接
设备数已满	控制台解绑旧设备后再授权
登录了错误邮箱	退出后用购买订阅的账号重新授权
无有效订阅	先到套餐页开通，再回来授权

401 / 403 / 不可用

症状	处理
401 / 未授权	重跑接入命令并授权；检查 config 是否存在
403	订阅过期、周额度用尽、或升级后 key 未切组；看控制台
额度用尽	等周窗口刷新，或升级/续费
桌面认证失败	看 helper.log；完全退出 App 后重开；重跑 desktop-install
VS Code 仍要 Anthropic 登录	必须跑 vscode-install；完全退出 VS Code 再开

模型列表空 / 异常

桌面：完全退出 App → 重开；必要时重跑桌面接入
CLI：opcodex --check，确认网关指向 gpt.opusapi.xyz
客户端过旧：升级 Codex 后再试

Skill / 插件消失

症状	处理
接入后 skill 全没了	opcodex --import-skills；再开 opcodex
提示未知参数 --import-skills	先重跑 install.sh / install.ps1 升级启动器
导入后仍没有	查 ls ~/.claude/skills ~/.claude/plugins 是否本来就有；项目 skill 看仓库 .claude/

自检清单（提交工单 / 在线客服前）

系统与架构（macOS/Win/Linux，arm/x64）
客户端版本：Codex / 桌面 App
使用端：CLI / 桌面 / VS Code
opcodex --check 输出（可打码密钥）
报错原文或截图；控制台订阅与额度状态

联系客服

日常售后优先站内在线客服；没有邀请码时加微信领码。

已注册 / 售后

登录控制台
点页面右下角气泡即时对话（不在线可留言，上线后回复）
或打开侧栏工单：提交工单、查看回复记录

没有邀请码（售前）

官网 Contact：微信 zeyuhello，扫码或搜微信号，备注「邀请码」
也可向已订阅好友索取邀请码 / 邀请链接

官网：https://gpt.opusapi.xyz
控制台 / 工单：/dashboard
用户协议：/terms.html

快速开始

命令行

排障

简介

适合谁

产品线

我们做什么

工作原理

我们记录什么

快速开始

注册并开通套餐

一键接入（CLI）

浏览器授权

启动

命令行版（opcodex）

前提

一键接入

装机脚本常用参数

日常使用

免确认模式（--yes）

Skill / 插件「没了」怎么办

卸载

桌面 App 版

前提

一键接入

与 CLI 对照

VS Code 扩展版

前提

一键接入

卸载（仅 VS Code 接入）

Cursor / JetBrains

命令与路径速查

套餐与额度

当前档位

额度口径

模型

升级

支付与售后

支付

订单与售后

设备管理

常见问题

用的是官方能力吗？会降智吗？

需要科学上网吗？

代码 / 对话你们能看见吗？

为什么状态栏写 API Usage Billing？

裸 claude 和 opcodex 有什么区别？

接入后 skill / 插件全没了？

支持哪些系统？

和 OpusAPI 按量有什么关系？

邀请制怎么拿码？

排查问题

装不上 / 命令找不到

授权失败

401 / 403 / 不可用

模型列表空 / 异常

Skill / 插件消失

自检清单（提交工单 / 在线客服前）

联系客服

已注册 / 售后

没有邀请码（售前）