使用文档

简介

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

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

适合谁

想用官方 Claude Code、又不想按人头付独占价的开发者
官方高配额度独享吃不完，希望 拼车均摊 成本的用户
需要 CLI + 桌面 + VS Code 多端，且共用一份订阅的人

产品线

产品	域名	说明
OpusClaude	claude.opusapi.xyz	订阅制接入官方 Claude Code / 桌面 / VS Code
OpusAPI	opusapi.xyz	按量 API（脚本 / 多模型）；与订阅线独立

我们做什么

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

工作原理

一次请求从 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 个设备名额。

我们记录什么

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

快速开始

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

注册并开通套餐

打开注册页（邀请制，无码可向已订阅好友索取，或到官网加微信领码），在套餐页支付宝开通。登录控制台确认订阅 active。
一键接入（CLI）

macOS / Linux：

macOS / Linux

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

Windows（PowerShell）：

Windows

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

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

启动

$ opclaude

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

命令行版（opclaude）

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

前提

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

也可先手动装官方 Claude Code：

可选：先装 Claude Code

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

一键接入

macOS / Linux

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

Windows PowerShell

PS> irm https://claude.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	跳过装完端到端验证

日常使用

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

免确认模式（--yes）

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

免确认启动

$ opclaude --yes

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

状态栏显示 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

桌面 App 版

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

前提

从 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

授权后请完全退出再打开 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 台

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（见说明）
免确认 yes 模式	opclaude --yes → claude --dangerously-skip-permissions
配置目录	~/.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 改成陌生域名。

套餐与额度

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

拼车档位

档位	标价（月）	周额度关系	适合
6 人拼车	¥349	约 1/6 完整档	轻量 / 偶尔 Opus · 中小仓库
3 人拼车（推荐）	¥699	约 1/3 完整档	日常项目
2 人拼车	¥999	约 1/2 完整档	重度 · 长上下文 + 高频 Opus
独享	私聊	完整档	独占不拼车

额度口径

完整档：本站标定的 Max 级「一周等值用量」（内部互校，与官方 Max 同量级），不是官方 App 限速条的截图对拍，也不等于拆卖官方账号座位。
拼车 = 完整档的约 1/N；硬顶是控制台周额度进度，自开通日起按周刷新。
各档模型清单一致（全系可用、不阉割）；吃额度的主要是用法（模型档、推理强度、上下文长度），不存在「低档故意降智」。
Fable 5：默认可用（与官方模型列表对齐）；因官方/客户端有单独进度条，会更贵、更吃本周额度（与主周额度不是同一条）。省额度可用 Opus / Sonnet。
体验套餐（¥88）已售罄下架；存量客户可用到到期。

模型

当期主力通常包括：Claude Opus 5 / Opus 4.8 / Fable 5 / Sonnet / Haiku 等（以客户端列表与号池为准）。全档同权可用；Fable 5 因官方单独进度条会更贵。

升级

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

支付与售后

支付

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

订单与售后

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

设备管理

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

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

常见问题

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

客户端是官方 Claude Code / 桌面 App；模型走真实 Claude 能力。我们不做「换假模型」式降智。拼车差异在额度与调度，不在模型阉割。Fable 5 全档可用；因官方有单独进度条，会更贵。

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

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

状态栏为什么是 Claude Max？

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

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

裸 claude 和 opclaude 有什么区别？

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

接入后 skill / 插件全没了？

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

支持哪些系统？

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

和 OpusAPI 按量有什么关系？

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

邀请制怎么拿码？

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

排查问题

装不上 / 命令找不到

症状	处理
找不到 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，扫码或搜微信号，备注「邀请码」
也可向已订阅好友索取邀请码 / 邀请链接

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

快速开始

命令行

排障

简介

适合谁

产品线

我们做什么

工作原理

我们记录什么

快速开始

注册并开通套餐

一键接入（CLI）

浏览器授权

启动

命令行版（opclaude）

前提

一键接入

装机脚本常用参数

日常使用

免确认模式（--yes）

Skill / 插件「没了」怎么办

卸载

桌面 App 版

前提

一键接入

与 CLI 对照

VS Code 扩展版

前提

一键接入

卸载（仅 VS Code 接入）

Cursor / JetBrains

命令与路径速查

套餐与额度

拼车档位

额度口径

模型

升级

支付与售后

支付

订单与售后

设备管理

常见问题

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

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

状态栏为什么是 Claude Max？

裸 claude 和 opclaude 有什么区别？

接入后 skill / 插件全没了？

支持哪些系统？

和 OpusAPI 按量有什么关系？

邀请制怎么拿码？

排查问题

装不上 / 命令找不到

授权失败

401 / 403 / 不可用

模型列表空 / 异常

Skill / 插件消失

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

联系客服

已注册 / 售后

没有邀请码（售前）