> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitokenhub.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 qlaude 接入 TokenHub

> 安装 qlaude，用 TokenHub 账号登录，就能在终端里使用 Claude Code。

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

## 开始之前

你需要准备：

* 一个 TokenHub 账号，可以在 [aitokenhub.vip](https://aitokenhub.vip) 注册
* 个人或团队里有可用余额（团队余额由团队管理员充值）
* 空余的设备名额：每个个人 / 团队默认最多登录 3 台设备

不需要提前安装官方 Claude Code，qlaude 会自动下载。

## 第一步：安装 qlaude

**macOS / Linux**

打开终端，运行：

```bash theme={null}
curl -fsSL https://qlau.de/install.sh | bash -s -- --gateway https://aitokenhub.vip
```

**Windows**

打开 PowerShell，运行：

```powershell theme={null}
$env:QLAUDE_INSTALL_GATEWAY='https://aitokenhub.vip'; irm https://qlau.de/install.ps1 | iex
```

> [!TIP]
>
> 也可以直接打开 [get.qlau.de/tokenhub](https://get.qlau.de/tokenhub)，安装页已经填好 TokenHub 的地址，按你的系统复制命令即可。

安装完成后，**新开一个终端窗口**，`qlaude` 命令才会生效。

## 第二步：登录 TokenHub

**1. 启动 qlaude**

```bash theme={null}
qlaude
```

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

**2. 选择登录方式**

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

**3. 在浏览器里授权**

浏览器会打开 TokenHub 的「授权 qlaude」页面，没登录 TokenHub 的话先登录。确认下面两项后点 **授权**：

* **计费归属**：用哪个个人或团队的余额付费。只加入了一个时不会显示这一项。
* **分组**：决定使用哪条线路，选中后下方会显示计费倍率。不确定的话保持默认即可。

页面底部会显示设备名额的使用情况，例如「已授权设备 1 / 3 台」。

**4. 回到终端**

浏览器显示「登录成功」后，回到终端就可以开始使用了。

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

## 第三步：开始使用

把平时用的 `claude` 换成 `qlaude` 即可：

```bash theme={null}
qlaude                        # 进入交互模式
qlaude -p "帮我解释这段代码"    # 直接提问，输出结果后退出
qlaude --help                 # 查看全部参数
```

在交互模式里常用的命令：

| 命令 | 作用 |
| - | - |
| `/model` | 切换模型 |
| `/login` | 重新登录，比如想换一个个人 / 团队付费 |
| `/logout` | 退出登录 |

TokenHub 发布的平台公告会在 qlaude 启动时显示，同一条公告最多显示 3 次。

## 管理设备

每登录一次 qlaude，就会在 TokenHub 里多一台「设备」。在控制台左侧菜单 **账户 → 设备** 可以看到所有已授权的设备，以及每台设备的本月消费、累计用量和最近使用时间。点设备名称可以打开它的用量看板。

点设备右侧的 **设置** 可以：

* **换分组**：下一次请求就生效，不用重新登录。
* **设置支出上限**：给这台设备单独设一个美元上限，用满后这台设备的请求会被拒绝。留空或填 0 表示不限。
* **重置累计用量**：把累计用量清零，支出上限重新开始计算。

点 **移除**，这台设备会立即失效，名额同时释放。设备那头需要重新登录才能继续用。

设备的状态标签含义：

| 标签 | 含义 |
| - | - |
| 生效 | 正常使用中 |
| 长期 | 正常使用中，用的是一次签发的长期凭证，到期前不需要续期 |
| 已过期 | 登录已失效，在 qlaude 里重新登录即可 |
| 已被管理员停用 | 平台管理员停用了这台设备，请求会被拒绝，请联系管理员 |

> [!NOTE]
>
> 在团队里，团队管理员可以看到全体成员的设备，普通成员只能看到自己授权的设备。

## 费用和限额

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

## 登录有效期

只要持续使用，登录就一直有效：30 天内用过一次 qlaude，登录状态会自动续期；超过 30 天没用，需要重新登录。

> [!WARNING]
>
> 不要把 qlaude 的登录信息复制到别的电脑上同时使用。TokenHub 发现同一台设备的凭证在多处使用时，会出于安全考虑直接注销这台设备。每台电脑请各自登录一次。

## 常见问题

> **提示找不到 qlaude 命令**
>
> 安装时添加的环境变量还没在当前终端生效。新开一个终端窗口（Windows 新开一个 PowerShell）再试。

> **第一次运行下载很慢或失败**
>
> 官方下载源连不上时，qlaude 会自动改从 GitHub 下载。如果仍然失败，可以重新运行安装命令并加上 `--claude-source github`（Windows 用 `-ClaudeSource github`）指定从 GitHub 下载，然后再运行 `qlaude`。

> **授权页提示设备名额已满**
>
> 到 **账户 → 设备** 移除不再使用的设备，再回到终端重新登录。团队内的名额由全体成员共用。需要更多名额请联系平台管理员。

> **分组显示「暂无可用分组」**
>
> 所选个人或团队当前没有可用的线路。换一个计费归属，或联系平台管理员。

> **报错 402**
>
> 余额不足，或者这台设备的用量达到了支出上限。充值后再试，或在设备设置里调高上限、重置累计用量。

> **报错 429**
>
> 同时进行的请求太多，超过了个人 / 团队的并发上限。稍等片刻再试，或减少同时运行的任务。需要更高的并发请联系管理员。

> **报错 403**
>
> 这台设备被平台管理员停用了（设备页会显示原因），或者所属团队被停用。请联系管理员。

> **突然要求重新登录**
>
> 常见原因：设备在设备页被移除、超过 30 天没有使用、你被移出了团队，或者设备绑定的分组被删除。在 qlaude 里执行 `/login` 重新登录即可。

> **想换一个团队付费**
>
> 计费归属在授权时决定，之后不能修改。在 qlaude 里执行 `/logout`，再 `/login`，授权时选另一个个人或团队。用不到的旧设备记得在设备页移除，释放名额。

> **怎么更新 qlaude**
>
> qlaude 会在后台自动更新自己和官方 Claude Code，下次启动生效。想立即更新，重新运行一遍安装命令即可。

> **怎么卸载 qlaude**
>
> macOS / Linux 删除 `~/.qlaude` 目录，并从 `~/.zshrc`、`~/.bashrc` 等文件里删掉 qlaude 添加的 PATH 那一行；Windows 删除 `%USERPROFILE%\.qlaude`，并从用户环境变量 PATH 里移除这个目录。
>
> 最后到 TokenHub 的 **账户 → 设备** 移除这台设备，释放名额。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.