跳转到主要内容
qlaude 是基于官方 Claude Code 的客户端，用法和 claude 命令完全一样。不同的是它登录的是你的 TokenHub 账号：不需要 Anthropic 订阅，用量直接从你在 TokenHub 的余额里扣。

​
开始之前

你需要准备：
  • 一个 TokenHub 账号，可以在 aitokenhub.vip 注册
  • 个人或团队里有可用余额（团队余额由团队管理员充值）
  • 空余的设备名额：每个个人 / 团队默认最多登录 3 台设备
不需要提前安装官方 Claude Code，qlaude 会自动下载。

​
第一步：安装 qlaude

打开终端，运行：
也可以直接打开 get.qlau.de/tokenhub，安装页已经填好 TokenHub 的地址，按你的系统复制命令即可。
安装完成后，新开一个终端窗口，qlaude 命令才会生效。

​
第二步：登录 TokenHub

1

启动 qlaude

第一次运行会先下载官方 Claude Code（约 280MB），需要稍等一会儿，之后启动就很快了。
2

选择登录方式

出现登录方式选择时，选 Claude account with subscription。qlaude 已经把登录指向 TokenHub，不会跳转到 Anthropic 官网，也不需要你有 Claude 订阅。
3

在浏览器里授权

浏览器会打开 TokenHub 的「授权 qlaude」页面，没登录 TokenHub 的话先登录。确认下面两项后点 授权：
  • 计费归属：用哪个个人或团队的余额付费。只加入了一个时不会显示这一项。
  • 分组：决定使用哪条线路，选中后下方会显示计费倍率。不确定的话保持默认即可。
页面底部会显示设备名额的使用情况，例如「已授权设备 1 / 3 台」。
4

回到终端

浏览器显示「登录成功」后，回到终端就可以开始使用了。
服务器上打不开浏览器时，终端会打印一个登录链接。把链接复制到你自己电脑的浏览器里打开，授权后页面会显示「复制授权码」。点 复制，粘贴回终端的提示处按回车即可。授权码 10 分钟内有效，只能用一次。过期了重新登录就行。

​
第三步：开始使用

把平时用的 claude 换成 qlaude 即可：
在交互模式里常用的命令： TokenHub 发布的平台公告会在 qlaude 启动时显示，同一条公告最多显示 3 次。

​
管理设备

每登录一次 qlaude，就会在 TokenHub 里多一台「设备」。在控制台左侧菜单 账户 → 设备 可以看到所有已授权的设备，以及每台设备的本月消费、累计用量和最近使用时间。点设备名称可以打开它的用量看板。 点设备右侧的 设置 可以：
  • 换分组：下一次请求就生效，不用重新登录。
  • 设置支出上限：给这台设备单独设一个美元上限，用满后这台设备的请求会被拒绝。留空或填 0 表示不限。
  • 重置累计用量：把累计用量清零，支出上限重新开始计算。
点 移除，这台设备会立即失效，名额同时释放。设备那头需要重新登录才能继续用。 设备的状态标签含义：
在团队里，团队管理员可以看到全体成员的设备，普通成员只能看到自己授权的设备。

​
费用和限额

  • 用量从授权时选的个人或团队余额中扣除，按所选分组的倍率计费。
  • 设备和 API 密钥共用同一个个人 / 团队的余额和并发上限。
  • 在团队里，团队给你设置的成员额度对设备同样有效。

​
登录有效期

只要持续使用，登录就一直有效：30 天内用过一次 qlaude，登录状态会自动续期；超过 30 天没用，需要重新登录。
不要把 qlaude 的登录信息复制到别的电脑上同时使用。TokenHub 发现同一台设备的凭证在多处使用时，会出于安全考虑直接注销这台设备。每台电脑请各自登录一次。

​
常见问题

安装时添加的环境变量还没在当前终端生效。新开一个终端窗口（Windows 新开一个 PowerShell）再试。
官方下载源连不上时，qlaude 会自动改从 GitHub 下载。如果仍然失败，可以重新运行安装命令并加上 --claude-source github（Windows 用 -ClaudeSource github）指定从 GitHub 下载，然后再运行 qlaude。
到 账户 → 设备 移除不再使用的设备，再回到终端重新登录。团队内的名额由全体成员共用。需要更多名额请联系平台管理员。
所选个人或团队当前没有可用的线路。换一个计费归属，或联系平台管理员。
余额不足，或者这台设备的用量达到了支出上限。充值后再试，或在设备设置里调高上限、重置累计用量。
同时进行的请求太多，超过了个人 / 团队的并发上限。稍等片刻再试，或减少同时运行的任务。需要更高的并发请联系管理员。
这台设备被平台管理员停用了（设备页会显示原因），或者所属团队被停用。请联系管理员。
常见原因：设备在设备页被移除、超过 30 天没有使用、你被移出了团队，或者设备绑定的分组被删除。在 qlaude 里执行 /login 重新登录即可。
计费归属在授权时决定，之后不能修改。在 qlaude 里执行 /logout，再 /login，授权时选另一个个人或团队。用不到的旧设备记得在设备页移除，释放名额。
qlaude 会在后台自动更新自己和官方 Claude Code，下次启动生效。想立即更新，重新运行一遍安装命令即可。
macOS / Linux 删除 ~/.qlaude 目录，并从 ~/.zshrc、~/.bashrc 等文件里删掉 qlaude 添加的 PATH 那一行；Windows 删除 %USERPROFILE%\.qlaude，并从用户环境变量 PATH 里移除这个目录。最后到 TokenHub 的 账户 → 设备 移除这台设备，释放名额。