使用文档

简介

OpusClaude 是什么、适合谁、能做什么 / 不承诺什么。

OpusClaude（CLI 名 opclaude，亦称 OPClaude）让你用订阅方式接入 官方 Claude Code 与 Claude 桌面 App：支付宝开通、全系模型可用。我们负责账号调度、鉴权与额度管理；客户端仍是 Anthropic 官方发行版。

适合谁

想用官方 Claude Code、又不想按人头付独占价的开发者
官方高配额度一个人用不完，只想 按实际用量付费 的用户
需要 CLI + 桌面 + VS Code 多端，且共用一份订阅的人

产品线

产品	域名	说明
OpusClaude	claude.opusapi.xyz	订阅制接入官方 Claude Code / 桌面 / VS Code
OpusCodex	gpt.opusapi.xyz	GPT-6 编程订阅，官方 Codex App 接入；¥68 起，支付宝，开放注册
Wilco	wilco.run	多模型编程 agent，Claude / GPT / Grok 一份订阅；英文界面，美元计价

我们做什么

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

工作原理

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

Claude Code / 桌面 / VS Code→ 本机 opclaude / helper 鉴权→ claude.opusapi.xyz→ 上游账号池调度→ Anthropic

CLI：装机后用 opclaude 启动。它设置独立配置目录 ~/.opusclaude/claude-env，再 exec 官方 claude，避免污染裸 claude。
桌面 App：官方 Claude Desktop + 本机 credential-helper 定期换票；密钥默认不落盘为明文。
VS Code：写入用户设置 claudeCode.environmentVariables（扩展登录检查只认此处）。

三端共用同一订阅的周额度；同一台电脑上 CLI / 桌面 / VS Code 的 device_id 算法一致，通常只占 1 个设备名额。

我们记录什么

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

快速开始

通常 5 分钟内：开通 → 装 App → 接入授权 → 使用。推荐用官方桌面 App（macOS / Windows）。

第一次用、或者要用终端 / VS Code？直接打开 5 分钟上手教程：选好电脑和用法后，页面只显示你需要的那一条命令和对应步骤。想在 Excel、Word、PowerPoint 里用？看 Office 接入（只支持 Mac、Windows 桌面版）。

注册并开通套餐

打开注册页（邀请制，无码可向已订阅好友索取，或到官网加微信领码），在套餐页支付宝开通。登录控制台确认订阅 active。
安装官方 Claude 桌面 App

从 claude.ai/download 下载安装（需要能打开 claude.ai 的网络）。已经装过就跳过，版本请用 2.19675.0 或更新。Linux 没有官方桌面 App，请用命令行版。
一键接入（桌面 App）

macOS（「终端」App，中途会要一次电脑开机密码）：

macOS

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

Windows（PowerShell 要右键「以管理员身份运行」，用你平时登录的账号）：

Windows（管理员 PowerShell）

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

脚本会打开授权页（没弹出就复制终端里打印的链接）。用购买套餐的邮箱账号登录，核对页面上的设备码与终端一致并勾选确认，再点「授权此设备」。授权信息自动保存到本机，不在终端展示。
重开 App

授权成功后完全退出 Claude 桌面 App 再打开：Mac 按 ⌘Q；Windows 安装器会自动重启 App，没重启就在右下角托盘里右键 Claude 图标 →「退出」再打开。

打开后直接进入使用界面，不用再登录 Anthropic 账号；聊天、Cowork、Claude Code 都能用。

想在终端里用（opclaude），或者用 Linux：一条命令 install.sh / install.ps1，见命令行版。在编辑器里用：见 VS Code 扩展版。三种方式共用同一份订阅。

桌面 App 版（推荐）

官方 Claude 桌面图形界面，聊天、Cowork、Claude Code 都在里面，不用记命令。图文步骤也可看桌面接入教程。

前提

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

一键接入

macOS

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

Windows（管理员 PowerShell）

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

Windows 要在开始菜单搜索 PowerShell，右键「以管理员身份运行」，用你平时登录的账号（确认框要你输入别的账号和密码时先停下，联系客服）。普通窗口里运行会提示「请使用管理员模式运行 PowerShell」，按提示换管理员窗口重跑即可。

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

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

与 CLI 对照

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

命令行版（opclaude）

终端里的官方 Claude Code，经 OpusClaude 鉴权与网关接入。

前提

官方 Claude Code CLI（不是桌面 App）。建议 ≥ 2.1.197。装机脚本会先跑官方 native 安装，再回退 npm
需要 curl / Windows 的 PowerShell；python3 用于 Mac/Linux 装机器

也可先手动装官方 Claude Code CLI：

macOS / Linux

$ curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

PS> irm https://claude.ai/install.ps1 | iex

一键接入

macOS / Linux

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

Windows PowerShell

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

浏览器授权同快速开始。授权成功后通常会自动进入 Claude Code：macOS / Linux 在同一个终端窗口里直接进入，Windows 会自动弹出一个新窗口。以后每次使用，开一个新终端输入 opclaude（全小写）：

启动

$ opclaude

日常请用 opclaude 启动，不要依赖裸 claude（除非你清楚自己在做什么）。没有自动进入、或提示找不到命令：关掉当前窗口，开一个新终端再输入；还不行就把上面的一键接入命令再跑一遍。

装机脚本常用参数

参数	作用
--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	跳过装完端到端验证

日常使用

启动：opclaude（其后参数透传给 claude）
自检：opclaude --check
切线路：opclaude --route hk（香港默认）
默认已是 Bypass（免确认）；想逐个确认：opclaude --permission-mode default
导入 skill / plugin：opclaude --import-skills（别名 --sync-skills）
密钥文件：~/.opusclaude/config（权限 600），不写进 shell 历史
独立配置目录：~/.opusclaude/claude-env

默认 Bypass 模式（免确认）

opclaude 现在默认进入 Bypass 模式：Claude 执行命令、修改文件不再逐个询问。它可能直接改动或删除文件，请只在信任的目录里使用。root 用户仍是手动模式。

想逐个确认

$ opclaude --permission-mode default

界面里按 Shift+Tab 可切换模式
项目设置里的 deny 规则仍然生效
opclaude --yes（别名 -y / --yolo）和环境变量 OPUSCLAUDE_YES=1 仍可用
已经装过的：先重跑装机命令升级，之后才默认进入 Bypass

状态栏显示 Claude Max（展示用）；计费走你的订阅周额度。启动时若有新版本会展示更新说明，可自选是否升级。

Skill / 插件「没了」怎么办

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

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

导入 skill / plugin

$ opclaude --import-skills

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

卸载

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

卸载

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

VS Code 扩展版

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

前提

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

一键接入

macOS / Linux

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

Windows

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

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

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

卸载（仅 VS Code 接入）

卸 VS Code 接入

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

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

Cursor / JetBrains

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

命令与路径速查

场景	命令 / 路径
CLI 装机	curl -fsSL https://claude.opusapi.xyz/install.sh \| bash
启动	opclaude
自检	opclaude --check
导入 skill / plugin	opclaude --import-skills（见说明）
默认 Bypass（免确认）	逐个确认用 opclaude --permission-mode default
配置目录	~/.opusclaude/
密钥配置	~/.opusclaude/config
CLI 专属 CC 环境	~/.opusclaude/claude-env
桌面 helper 日志	~/.opusclaude/helper.log
桌面装机	…/desktop-install.sh 或 .ps1
VS Code 装机	…/vscode-install.sh 或 .ps1

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

套餐与额度

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

订阅档位

档位	标价（月）	周额度关系	适合
基础版	¥449	约 1/6 完整档	轻量 / 偶尔 Opus · 中小仓库
专业版（推荐）	¥899	约 1/3 完整档	日常项目
旗舰版	¥1,399	约 1/2 完整档	重度 · 长上下文 + 高频 Opus
独享	私聊	完整档	一人独占

额度口径

完整档：本站独立标定的「一周等值用量」，对标官方 Ultra，但和官方用量不能直接换算，不是官方 App 限速条的截图对拍，也不等于拆卖官方账号座位。
三档分别约为完整档的 1/6、1/3、1/2；硬顶是控制台周额度进度，自开通日起按周刷新。
各档模型清单一致（全系可用、不阉割）；吃额度的主要是用法（模型档、推理强度、上下文长度），不存在「低档故意降智」。
号池折算：请求由平台在号池内的多个账号间自动调度。个别账号成本较高，经这些账号处理的请求会按账号成本折算额度消耗，其余请求不受影响；每笔实际消耗以控制台「用量明细」为准。
Fable 5.1：默认可用（与官方模型列表对齐）。Fable 不是另给的额度，和其他模型共用同一份周额度：扣得比其他模型快，一周最多用到周额度的一半，和官方 Max、Ultra 的 Fable 规则一致（见常见问题）。省额度可用 Opus / Sonnet。

模型

当期主力通常包括：Claude Opus 5.5 / Opus 5 / Fable 5.1 / Sonnet / Haiku 等（以客户端列表与号池为准）。全档同权可用；Fable 5.1 和其他模型共用周额度，最多用一半。

升级

优先在控制台 / 定价页自助升级；补差 = 新档全价 − 旧套餐剩余价值，升完从今天起算满 30 天，本周已用结转到新档，未用完的周额度不折现（服务端计算为准）。
人工升级需走完整流程（新订阅生效 + 密钥切组 + 旧订阅收尾），否则可能 403。

支付与售后

支付

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

订单与售后

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

设备管理

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

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

常见问题

用的是真的 Claude 吗？会降智吗？

客户端是官方 Claude Code / 桌面 App；模型走真实 Claude 能力。我们不做「换假模型」式降智。各档差异在额度与调度，不在模型阉割。Fable 5.1 全档可用，和其他模型共用周额度。

Fable 额度和周额度是分开的吗？

不是，是同一份。和官方 Max、Ultra 的 Fable 规则一样：Fable 也从你的周额度里扣，而且扣得比其他模型快；一周最多能把周额度的一半用在 Fable 上，Fable 和其他模型加起来不会超过周额度。

控制台「其中 Fable」那条只是把花在 Fable 上的部分单独标出来，满格 = 周额度的一半。比如本周只用了 Fable、花掉周额度的 30%：「本周额度」显示 30%，「其中 Fable」显示 60%；如果另外用 Opus 又花了 20%，两条就分别是 50% 和 60%。

Fable 那条满了：只停 Fable，Opus / Sonnet 继续用剩下的周额度。「本周额度」满了：所有模型一起停，Fable 那条没满也一样。周额度刷新时，两条一起清零重算。

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

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

状态栏为什么是 Claude Max？

接入后状态栏固定显示 Claude Max（展示用）。订阅计费仍以控制台周额度为准，不等于官方 Max / Ultra 的用量条。

若仍显示 API Usage Billing，请重跑装机命令升级启动器后开新终端再试。

裸 claude 和 opclaude 有什么区别？

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

接入后 skill / 插件全没了？

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

支持哪些系统？

推荐桌面 App：macOS / Windows。CLI：macOS / Linux / Windows。Linux 请用 CLI。

想用 GPT-6 / Codex，或多家模型一起用？

用官方 Codex App 写代码选 OpusCodex（GPT-6，¥68 起，支付宝，开放注册）；想在一个 agent 里同时用 Claude / GPT / Grok 选 Wilco（英文界面，美元计价）。三个站点账号与额度互相独立，需分别注册。

邀请制怎么拿码？

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

排查问题

连不上 / connection dropped：一键网络自检

报 connection dropped、ECONNREFUSED、超时、时好时坏，可能和电脑上的代理 / 加速器软件有关（例如开着 TUN 模式，或同时开了两个代理软件）。按你的系统跑下面对应的一条命令（耗时取决于网络和代理软件数量），它会列出代理设置、正在运行的代理软件、虚拟网卡，并实际测一遍直连和每个本机代理端口能不能连上 OPClaude，最后一行给出中文结论。

macOS 终端

$ curl -fsSL https://claude.opusapi.xyz/netcheck.sh | bash

Windows PowerShell

PS> irm https://claude.opusapi.xyz/netcheck.ps1 | iex

只读检查：不改任何设置、不装任何东西，只测连通性；输出里会显示代理配置等诊断信息，代理地址里的账号密码会尽量打码成 ***@，但不保证遮全。跑完只截自检输出那一部分，发之前看一眼，有密码、token 或其他个人信息先打码，再发给在线客服或附到工单里。

目前只有 macOS 和 Windows 版本，Linux 暂不支持。如果命令本身就下载失败，直接把报错截图发给客服。

装不上 / 命令找不到

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

授权失败

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

401 / 403 / 不可用

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

模型列表空 / 异常

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

Skill / 插件消失

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

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

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

联系客服

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

已注册 / 售后

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

没有邀请码（售前）

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

QQ 交流群

二群 1108896854（一群已满）：交流用法、看公告；订单与售后仍请走在线客服 / 工单

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

5 分钟上手

桌面 App（推荐）

排障

简介

适合谁

产品线

我们做什么

工作原理

我们记录什么

快速开始

注册并开通套餐

安装官方 Claude 桌面 App

一键接入（桌面 App）

浏览器授权

重开 App

桌面 App 版（推荐）

前提

一键接入

与 CLI 对照

命令行版（opclaude）

前提

一键接入

装机脚本常用参数

日常使用

默认 Bypass 模式（免确认）

Skill / 插件「没了」怎么办

卸载

VS Code 扩展版

前提

一键接入

卸载（仅 VS Code 接入）

Cursor / JetBrains

命令与路径速查

套餐与额度

订阅档位

额度口径

模型

升级

支付与售后

支付

订单与售后

设备管理

常见问题

用的是真的 Claude 吗？会降智吗？

Fable 额度和周额度是分开的吗？

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

状态栏为什么是 Claude Max？

裸 claude 和 opclaude 有什么区别？

接入后 skill / 插件全没了？

支持哪些系统？

想用 GPT-6 / Codex，或多家模型一起用？

邀请制怎么拿码？

排查问题

连不上 / connection dropped：一键网络自检

装不上 / 命令找不到

授权失败

401 / 403 / 不可用

模型列表空 / 异常

Skill / 插件消失

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

联系客服

已注册 / 售后

没有邀请码（售前）

QQ 交流群