# 邀请奖励
Source: https://docs.reclaude.ai/account/affiliate

把你的邀请链接分享给朋友，他们首笔符合条件的付费订单结算后你会拿到邀请奖励：按实付金额 15% 折算成订阅天数 / 拼车天数 / 按量额度，不可提现。

入口：网页后台 nav → **邀请奖励**。

## 邀请码和邀请链接

页面上方能看到你的 **邀请码** 和 **专属邀请链接**，可一键复制或扫码访问。朋友通过这条链接注册后，系统会自动绑定邀请关系。

## 奖励规则

* 朋友通过你的邀请链接注册后，**首笔符合条件的付费订单** 会触发奖励。
* 每笔合格首单按 **实付金额的 15%** 发到你当前的权益里。
* 奖励在订单结算后自动入账，可在 **奖励流水** 中查看明细。
* **邀请人需在奖励触发时持有有效付费权益**（订阅、拼车或按量），才能拿到奖励。
* **兑换码订单不计** 入邀请奖励。
* 每位邀请人的月度发奖次数可能受运营策略限制。
* 奖励可能因后续退款或异常被撤销，详情见奖励流水。
* 返佣 **折算成订阅 / 拼车天数或按量 credit** 落到你当前的权益中，**不可提现**。

## 状态名义

在 **我邀请的人** 列表里，每位被邀请人会标记一个状态：

| 状态        | 含义                 |
| --------- | ------------------ |
| **待首单**   | 已注册，还没下首单          |
| **已下单**   | 首单已生成（可能还在等支付或结算）  |
| **已发奖**   | 奖励已结算并入账           |
| **下单未发奖** | 首单已结算但未触发奖励（见下方原因） |
| **已撤销**   | 已发的奖励因退款或异常被撤回     |

### "下单未发奖" 的两种常见原因

* **邀请人下单时未持有有效付费权益**：你那时还没有有效订阅 / 拼车 / 按量 → 该笔奖励不发放。
* **本月发奖次数已达上限**：超过本月运营策略上限 → 该笔不发，但被邀请人不受影响。

<Note>
  如果你看到一位朋友显示"下单未发奖"但不属于上述两种原因，请通过 [工单](https://reclaude.ai) → **财务问题** 附上邀请人 / 被邀请人邮箱与订单号，运营会核对。
</Note>


# 账单
Source: https://docs.reclaude.ai/account/billing

管理 ReClaude 订阅、拼车、独享与按量付费方案的支付方式、订单状态、兑换码、发票与退款。讲清订单生命周期、支付失败排查、发票申请与退款条款。

入口：网页后台 nav → **订阅与账单**。

## 支付方式

| 方式              | 说明                        |
| --------------- | ------------------------- |
| **在线支付**        | 跳转到收银台完成付款，付款成功后系统自动开通    |
| **对公转账 / 人工确认** | 提交订单后联系客服并说明订单号，运营核对入账后开通 |
| **兑换码**         | 直接抵扣套餐天数或按量额度             |
| **优惠码**         | 下单时输入，按比例减免应付金额           |

## 订单状态

| 状态   | 含义              |
| ---- | --------------- |
| 待支付  | 订单已创建，等你完成付款    |
| 已支付  | 支付成功，订阅 / 额度已开通 |
| 已过期  | 超时未支付，订单作废      |
| 已取消  | 你主动取消了订单        |
| 支付失败 | 渠道返回失败，可重新下单    |
| 已退款  | 已完成退款           |

每条订单都可以点进 **详情页** 查看支付时间线、票据和订阅延期信息。

**已付款但仍显示待支付？** 通常 1–3 分钟内会由支付通道回调自动同步；若超时仍未变化，见 [排查问题 → 付款相关](/help/troubleshooting#付款相关)。

## 使用兑换码

兑换码格式：`RC-XXXX-XXXX-XXXX-XXXX`。入口在 **订阅与账单 → 选套餐下单** 页面，套餐区下方有兑换码输入框，粘贴后即可完成兑换。

* 个人订阅、拼车、按量套餐均可直接兑换：兑换成功后订阅按天延期，或按量额度立即到账。
* **组织订阅 / 席位续费** 暂不支持普通兑换码，请按席位续费或购买原档套餐。
* **升级订单不接受兑换码** —— 升级走付款 + 旧档抵扣链路，与兑换码核销互斥。
* 兑换码可能带有有效期；过期或已禁用的码无法使用。

## 发票

支付成功后，进入对应订单的 **详情页** 点击 **立即开具** 发起开票，开票完成后可在线打开、复制链接或打印。普票通常即时完成。

### 几种场景

* **待开票（暂存抬头信息）**：当前已支付但暂不想立刻开票，可以先把抬头、税号等信息存好，到时再触发开票即可。
* **公对公付款**：用对公转账下的订单同样在订单详情页申请开票。需要专票或特殊版式请走 [工单](https://reclaude.ai) → **财务问题** 说明。
* **报销凭证**：电子普票即为正式凭证，可直接用于报销。
* **多笔合并 / 开票后改抬头**：默认不支持自助合并或开票后改抬头。如有需要，提工单说明诉求。

<Note>
  **已开票订单退款受限**：见下方 [退款 → 已开票订单](#已开票订单)。
</Note>

## 退款

ReClaude 是虚拟数字服务，涉及账号、订阅、API 资源、支付通道与人工支持成本，**退款不是无条件的**。**套餐页或订单页有专项退款规则的，按专项规则执行**；未覆盖到的情况按下面口径处理。

### 按量套餐

* **已使用额度不退**。
* **未使用额度可申请退款**。
* 退款过程中产生的第三方支付手续费、异常消耗、人工处理成本等，可从未使用余额中扣除。

### 拼车套餐

* **默认不支持用户主动退款**。
* 仅当 ReClaude 无法提供可用账号、或服务长期不可用时，才按未履约部分协商处理 —— 形式包括退款、补偿或服务延长。

### 独享套餐

* 可按 **剩余有效天数** 申请退款；已使用天数不退。
* 期间发生过换号的，**每次换号扣 ¥200 手续费**。
* 同时可扣除已发生的支付通道费、开票费、人工处理等合理成本。

### 升级订单

升级订单及其源订单均 **不可退款**。升级会立即用旧档剩余按比例抵扣到新订单，原 allocation 失效后无法回滚 —— 请在升级页确认目标套餐和应付金额后再付款。

### 已开票订单

* 默认 **不支持退款**。
* 若法律强制要求或双方书面确认可退，需先完成发票红冲、税费等手续。

### 不退款的情况

因 **违规使用、滥用、转售、非指定工具调用、触发第三方风控、或用户自身环境** 等原因导致的封禁、限制、不可用或损失，不支持退款。

<Note>
  **一句话总结**：按量退未用、拼车原则不退、独享退剩余天数；违规不退、已开票严格限制、套餐页专项规则优先。
</Note>

## 退款怎么走

1. 到 [reclaude.ai](https://reclaude.ai) 登录后，**工单 → 新建 → 财务问题** 提交申请，附订单号和退款原因。
2. 运营核对后在工单内告知是否受理。
3. 受理后 **打回原支付渠道**，到账时间随银行 / 渠道而定（通常 1–7 个工作日）。
4. 全程在工单内告知进度；订单详情页的 **退款** 状态也会同步更新。


# 设备
Source: https://docs.reclaude.ai/account/devices

在 ReClaude 网页后台查看活跃设备、撤销会话密钥、管理设备数量上限并新增机器到账户。涵盖设备字段、SK 前缀识别、撤销立即生效与多机协同。

每跑一次 `reclaude login` 都会注册一台 **设备** 到你的账户。一个设备 = 一台机器上的一份会话密钥。

## 在哪查看

网页后台 nav → **设备**。每条设备记录包含：

| 字段               | 说明                               |
| ---------------- | -------------------------------- |
| **设备名称**         | 你在登录时给本机起的名字                     |
| **SK 前缀**        | 这台设备会话密钥的前几位，用于辨认                |
| **所属组织**         | 这台设备绑定到哪个组织、用哪个组织的账号             |
| **客户端版本**        | 当前运行的 reclaude 版本                |
| **客户端平台**        | 设备的操作系统（macOS / Linux / Windows） |
| **最近使用 / 最近 IP** | 上一次产生请求的时间和来源 IP                 |
| **添加时间**         | 设备的注册时间                          |

## 添加新设备

在新机器上跑：

```bash theme={null}
reclaude login
```

按 [登录](/cli/login) 流程在浏览器里批准即可。

## 撤销设备

不再使用某台设备时，到设备页点 **撤销**。撤销之后：

* 这台设备 **立即失去访问权限**，再发请求会被拒绝。
* 如果未来想重新使用，再跑一次 `reclaude login` 即可。

## 设备被自动撤销

少数情况下系统会自动撤销某台设备的登录态，这台机器再发请求会拿到 `401 device_revoked`。常见触发因素：

* 同一账号在多台机器同时高频使用，触发风控
* reclaude CLI 或 Claude Code CLI 版本过低
* 登录态校验异常

**怎么处理**：在这台机器上重跑 `reclaude login`，按 [登录](/cli/login) 流程重新批准即可。月套餐期内重新登录不计次。如果反复出现，请通过 [工单](https://reclaude.ai) 让运营核对账号状态。

## 设备数量上限

每个账户的设备数有上限。达到上限再登录新机器时，浏览器批准页会提示：

> 已达 X 台设备上限（当前 Y 台），请先到设备管理撤销旧设备

撤掉一台不再用的设备就能腾出位置。

## 换号

如果分配给你的账号 **不可用**（被风控、暂停等），系统会 **自动** 为你重新分配账号，无需任何操作，稍候重试即可。月套餐期内换号不计次。


# 安全
Source: https://docs.reclaude.ai/account/security

在 ReClaude 网页后台修改密码、启用基于 TOTP 的双因素认证（MFA）、保存恢复码、查看并撤销活跃会话。涵盖账号安全设置、登录保护与设备会话管理。

入口：网页后台 nav → **设置**。

## 修改密码

**设置 → 安全 → 修改密码**。要求：

* 至少 12 个字符
* 含大写、小写、数字和符号
* 不超过 72 个字符

修改成功后，**当前浏览器会话保持登录**，但这个账户在其它设备 / 浏览器上的会话会被全部撤销。

## 忘记密码

登录页点 **忘记密码？**，输邮箱拿到 6 位验证码后即可设置新密码。

## 双因素认证 (MFA)

启用后，在新设备登录时会要求输入身份验证器 App 的 6 位动态码。

### 启用

1. **设置 → 安全 → 双因素认证 → 启用 MFA**。
2. 用 Google Authenticator、1Password 等 App 扫描二维码（或手动输入密钥）。
3. 输入 6 位验证码确认。
4. 屏幕会显示 **10 个一次性恢复码** —— 立刻下载或抄下保存。

<Warning>
  恢复码只显示一次。丢了设备又没存恢复码，将无法登录，只能通过工单走身份验证流程恢复。
</Warning>

### 禁用

输入 **当前密码 + TOTP 或恢复码** 即可禁用。

### 重新生成恢复码

如果恢复码用了一些或不放心被人看过，可以 **重新生成**。原有的恢复码会立即失效，你会拿到一组新的。

## 活跃会话

**设置 → 会话** 列出当前账户在所有浏览器 / 设备上的活跃会话，每条记录包含 IP、创建时间、最近活跃时间。

* 点 **撤销** 立即让某个会话失效。
* 退出当前浏览器：用账户菜单的 **退出登录** 或会话页的撤销按钮，效果一致。


# 订阅
Source: https://docs.reclaude.ai/account/subscription

对比 ReClaude 拼车、独享与按量付费三种方案，了解每种订阅状态的含义、续费扣费规则、账号切换担保与到期处理。一页看懂订阅生命周期与计费逻辑。

ReClaude 提供 **独享 / 拼车 / 按量** 三种方案。开通方式、价格、当期活动以 [reclaude.ai](https://reclaude.ai) 为准。

## 三种方案

| 方案     | 谁在用                  | 计费方式     | 适合场景                 |
| ------ | -------------------- | -------- | -------------------- |
| **独享** | 一个账号专属于你             | 月套餐      | 把 Max 额度用满的重度开发者     |
| **拼车** | N 人共享一个账号，单人限额 = 1/N | 月套餐      | 想用上原生订阅额度但用量没那么大     |
| **按量** | 独立美元额度，按真实接口成本扣减     | 充值开通、不过期 | 用量不固定、临时跑大单或月套餐用完补一点 |

月套餐共享 **质保一月**：套餐期内官方封号 100% 兜底，期内无限换号、不计次。

<Note>
  独享套餐另含 **Claude Desktop 启动入口（内测中）**，通过 `reclaude app` 跑起来。命令详见 [命令参考](/cli/commands)。
</Note>

## 订阅状态

网页后台主页能看到当前订阅的状态、剩余天数和到期时间。状态含义：

| 状态       | 含义         | 服务行为        |
| -------- | ---------- | ----------- |
| **未订阅**  | 还没开通过任何套餐  | 服务不可用       |
| **生效中**  | 有效订阅       | 正常使用        |
| **即将到期** | 一周内到期      | 正常使用，建议提前续费 |
| **宽限期**  | 已过期、还在容忍窗口 | 服务可能受限，尽快续费 |
| **已过期**  | 续费窗口已过     | 服务暂停        |

如果分配给你的账号被风控，主页也会出现 **账号已被封禁** 或 **需要管理员确认** 的提示，这跟订阅状态独立。

## 拼车的 5 小时配额

拼车套餐为了均衡成员之间的用量，会有 5 小时滚动窗口的配额上限。主页能看到当前窗口已用、剩余、距离归零的时间。配额参数会随实际运营调整。

## 续费与到期

* **即将到期** 时主页会出现续费提示，点击直接进入续费页。
* **宽限期 / 已过期** 时服务可能暂停，续费成功后立即恢复。
* 拼车套餐 **立即开通**，无需等其他成员。
* 按量套餐 **立即到账美元额度**，永不过期，可以随时叠加在月套餐上。

## 升级（拼车专属）

拼车套餐支持自助升级到 **任何更高档**（更少的拼车人数，或独享套餐）。

* **方向**：单向。不能降级、不能反向。
* **生效**：立即生效，原拼车 allocation 失效。
* **新档周期**：从升级时刻起重新计算 —— 拼车恒定 1 个月、独享按你选的月数（1 / 3 / 6 / 12）。原有剩余按比例抵扣到本次支付。
* **优惠码**：升级订单可以叠加优惠码；但源订单是 **兑换码 / 人工开通** 的时候不允许叠加。
* **兑换码**：升级订单不接受兑换码。
* **退款**：升级后，**原订单与升级订单均不可退款**。请确认目标套餐后再支付。

入口：网页后台 → **订阅与账单** → 升级。最终应付与抵扣金额会在升级页实时预览，不会预先扣费。

## 改人数 / 合并 / 转出

**降级不支持** —— 套餐升级是单向的，开通后无法降级或反向调整。合并多笔订单、把独享转回拼车等需求暂未做自助，请通过 [工单](https://reclaude.ai) 联系运营。

## 同时持有多个套餐

可以。比如你想既要 **个人独享** 跑日常、又要一份 **4 人拼车** 团队均摊、再囤一笔 **按量额度** 救急 —— 三份套餐能并存，互不冲突。

实现方式：ReClaude 的订阅挂在 **组织** 上 —— 个人组织、团队组织、拼车组织各自一份套餐。买多个套餐 = 创建 / 加入多个组织。所以 **切套餐 = 切组织**：

```bash theme={null}
reclaude org list           # 列出你加入的所有组织和它们的订阅
reclaude org use <org_id>   # 把当前设备切到指定组织
```

切完下一次请求就走新组织的账号和额度。

### 几个要点

* **每台设备同一时刻只走一个组织**。不同电脑可以绑不同组织 —— 笔记本走个人独享、台式机走团队拼车都行，互不影响。
* 不同组织的额度 **完全独立**：拼车 5h 窗口、按量美元、月套餐天数各算各的，不能跨组互补。
* **不会自动 fallback**：当前组织额度用完了请求会直接失败（提示订阅过期 / 额度耗尽 / 5h 配额耗尽），需要 `reclaude org use` 手动切到另一个有额度的组织、或在当前组织续费。


# 命令参考
Source: https://docs.reclaude.ai/cli/commands

reclaude CLI 全部子命令参考：login、logout、status、stop、update、uninstall、config、logs、version、org、help 以及守护进程启动命令的用法、参数与典型流程。

## 子命令一览

| 命令                        | 作用                                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------------- |
| `reclaude`                | 启动后台 daemon 并跑 Claude Code（日常用法）                                                                  |
| `reclaude app`            | 用 reclaude 分配的账号启动 Claude Desktop（独享套餐，内测中）；首次 / 启动时会自动下载并更新所需的 Claude Desktop（仅 macOS / Windows） |
| `reclaude app-reset`      | 重置 Claude Desktop 登录态（清 cookies / 缓存，不影响 reclaude 自身）                                             |
| `reclaude app-update`     | 检查并更新本地的 Claude Desktop；加 `--check` 只检查不下载                                                        |
| `reclaude login`          | 浏览器设备流登录、绑定本机                                                                                     |
| `reclaude logout`         | 恢复最近一次 login 之前的 Claude Code 配置                                                                   |
| `reclaude org`            | 查看或切换当前设备所属组织                                                                                     |
| `reclaude config gateway` | 查看 / 锁定 / 重置接入用的 gateway                                                                          |
| `reclaude status`         | 打印 daemon 状态和 claude 路径                                                                           |
| `reclaude stop`           | 停止并禁用后台 daemon                                                                                    |
| `reclaude update`         | 检查并升级 reclaude（加 `--check` 只检查不下载）                                                                |
| `reclaude setup`          | 把 reclaude 复制到标准目录并加进 PATH（手动下载二进制时用）                                                             |
| `reclaude unsetup`        | 撤销 `reclaude setup` 写入的标准目录与 PATH 修改                                                              |
| `reclaude uninstall`      | 停 daemon 并清除所有本地状态                                                                                |
| `reclaude version`        | 打印当前版本                                                                                            |
| `reclaude logs`           | 打印 daemon 日志的末尾几行                                                                                 |
| `reclaude help`           | 打印帮助文本                                                                                            |

<Tip>
  跑 `reclaude` 不带子命令 = 后台启动 daemon + 直接打开 Claude Code，这是日常用法。
</Tip>

## 常用流程

**首次接入：**

```bash theme={null}
reclaude login   # 浏览器授权一次
reclaude         # 启动 daemon + 打开 Claude Code
```

**临时停服务：**

```bash theme={null}
reclaude stop    # 停 daemon；下一次跑 reclaude 会再起来
```

**升级到最新：**

```bash theme={null}
reclaude update
```

**完整卸载：**

```bash theme={null}
reclaude uninstall
```

## 切换组织

```bash theme={null}
reclaude org list           # 列出当前账户下的所有组织和当前设备绑定
reclaude org use <org_id>   # 把当前设备切到指定组织
```

切换后下一次请求会改用新组织名下的可用账号。

## 日志

日志文件路径：`~/.reclaude/logs/daemon.log`，可用 `reclaude logs` 直接打印末尾几行。

## 配置 gateway

`gateway` 是 reclaude 接入服务的入口。默认情况下 daemon 启动时会自动探测多个候选并选最快的（auto 模式）；如果你想锁定到指定线路，可以手动设置（manual 模式）。

| 子命令                                           | 作用                        |
| --------------------------------------------- | ------------------------- |
| `reclaude config gateway`                     | 交互式探测全部候选并保存为手动选择         |
| `reclaude config gateway test [url]`          | 只测速不保存。带 url 测单个；不带测全部    |
| `reclaude config gateway set [--force] <url>` | 直接设。默认会先探测验证，`--force` 跳过 |
| `reclaude config gateway current`             | 打印当前生效的 gateway 与来源       |
| `reclaude config gateway reset`               | 清空手动配置，回到 auto            |

**交互式选择最快的：**

```bash theme={null}
reclaude config gateway
```

会实时打印每个候选的可用性和延迟，回车=最快，输入编号=指定，`q`=取消。

**查看当前生效：**

```bash theme={null}
reclaude config gateway current
```

输出 `url`（实际生效的 URL）、`source`（来源：`RECLAUDE_GATEWAY_URL` / `device.json` / `default`）和 `mode`（`manual` 或 `auto`）。

**重置回自动选择：**

```bash theme={null}
reclaude config gateway reset
```

<Note>
  保存后如果 daemon 正在运行，需要 `reclaude stop && reclaude` 重启才会生效。

  环境变量 `RECLAUDE_GATEWAY_URL` 优先级最高，设置后会盖过本地配置。
</Note>


# 安装 CLI
Source: https://docs.reclaude.ai/cli/install

一行命令在 macOS、Linux、Windows 上安装 reclaude CLI，包含 amd64/arm64 自动识别、Claude Code 首次运行自动下载、IDE 扩展配置、PATH 验证与版本固定参数。

## 一键安装

<CodeGroup>
  ```bash macOS / Linux theme={null}
  curl -fsSL https://reclaude.ai/install.sh | bash
  ```

  ```powershell Windows theme={null}
  iwr https://reclaude.ai/install.ps1 -UseBasicParsing | iex
  ```
</CodeGroup>

脚本会：

* 自动识别 OS 和 CPU 架构（amd64 / arm64，含 macOS Rosetta 2 检测）。
* 下载对应二进制、校验 SHA256、写入 PATH。

<Note>
  脚本不再随安装顺带装 Claude Code。首次运行 reclaude 时会自动下载 Claude Code（无需 VPN）；若你已装官方 Claude Code，会沿用你那份、不覆盖。
</Note>

<Tip>
  装完之后请打开**新终端**再跑命令，让 PATH 生效。验证用 `reclaude version`。
</Tip>

## Windows 提示

* **用普通 PowerShell**，不要"以管理员身份运行"。安装会写入 `%LOCALAPPDATA%\Programs\reclaude\bin`（用户家目录），管理员 PowerShell 的 PATH 与你日常 shell 隔离，反而会让安装后 `reclaude` 命令找不到。
* 必须 **64 位 PowerShell**。脚本会自检，若用了 32 位会直接退出。
* 杀软 / EDR 误报：脚本会校验下载文件 SHA256，但部分企业杀软可能拦截写入。若提示 `Access is denied`，先关掉相关防护或把 `%LOCALAPPDATA%\Programs\reclaude` 加入白名单再重试。
* **Claude Desktop**（MSIX 渠道）路径会被 reclaude 自动反查，不需要额外指定。

## 常用选项（macOS / Linux）

| 参数                | 作用                 |
| ----------------- | ------------------ |
| `--version <ver>` | 锁定安装版本，默认 `latest` |

例如装指定版本：

```bash theme={null}
curl -fsSL https://reclaude.ai/install.sh | bash -s -- --version v1.4.2
```

## 手动下载

如果脚本不可用，可以从下表直接下载二进制：

| 平台      | 架构    | 文件                           |
| ------- | ----- | ---------------------------- |
| macOS   | arm64 | `reclaude-darwin-arm64`      |
| macOS   | amd64 | `reclaude-darwin-amd64`      |
| Linux   | arm64 | `reclaude-linux-arm64`       |
| Linux   | amd64 | `reclaude-linux-amd64`       |
| Windows | amd64 | `reclaude-windows-amd64.exe` |

下载链接固定为 `https://dl.reclaude.ai/latest/<文件名>`。下载后赋予可执行权限并加到 PATH，再跑 `reclaude setup` 把它复制到标准目录。

## IDE 插件配置

如果你用 VS Code / JetBrains 等官方 Claude Code IDE 插件，需要让插件**通过 reclaude 启动 Claude**，否则请求会绕过 reclaude 直连官方。

1. 打开插件设置（VS Code：`Ctrl/Cmd + ,` → 搜索 `Claude Process Wrapper`；JetBrains：`Settings → Tools → Claude Code`）。

2. 找到 **Claude Code: Claude Process Wrapper**（描述：*Executable path used to launch the Claude process*）。

3. 把可执行文件路径填成 `reclaude` 并保存。

   <Frame>
     <img alt="VS Code 设置中的 Claude Process Wrapper 输入框，值为 reclaude" />
   </Frame>

4. 重启 IDE 让设置生效。

填好之后 IDE 插件就会通过 reclaude 启动 Claude，账号、设备、配额都按你 reclaude 登录的账户走。

<Note>
  这一步是 **官方 Claude Code 插件提供的标准设置项**，不需要装额外扩展。
</Note>

## 升级和卸载

```bash theme={null}
reclaude update      # 检查并升级到最新版
reclaude uninstall   # 完整卸载
```


# 登录
Source: https://docs.reclaude.ai/cli/login

使用 reclaude login 通过浏览器设备流程把这台机器绑定到 ReClaude 账户，再用分配到的官方 Anthropic 账号直接运行 Claude Code，无需 API key、无需配置。

## 在终端发起登录

```bash theme={null}
reclaude login
```

终端会打印一条授权链接，类似：

```
请在浏览器打开此 URL 授权此 CLI 会话：
https://reclaude.ai/cli/auth?state=...
```

## 在浏览器里批准

1. 复制链接到浏览器（或直接点击）。
2. 没登录的话，先用邮箱密码登录 ReClaude 账户。
3. 核对页面上的 **设备详情**：主机名、平台、客户端 IP、User-Agent。
4. 给这台设备起一个易记的名字 —— 之后会显示在 [设备](/account/devices) 页。
5. 如果你属于多个组织，**选择**用哪个组织的绑定账号：不同组织可用的账号不同。
6. 点击 **批准**。

回到终端，几秒后会看到登录成功的提示，会话密钥已写入本地配置。

<Warning>
  如果不是你本人发起的登录页，**直接关闭它**。批准别人发起的会话等于把账号权限交给对方。
</Warning>

## 登录失败的常见原因

| 提示               | 怎么办                                     |
| ---------------- | --------------------------------------- |
| 链接已过期 / state 无效 | CLI 会话有时效，回终端重跑 `reclaude login` 拿一条新链接 |
| 设备数量已达上限         | 先到 [设备](/account/devices) 页撤销不再使用的设备    |
| 所选组织没有可用账号       | 换一个有可用账号的组织，或在网页后台联系运营                  |

## 切换登录账户 / 切组织

* 想换登录的 ReClaude 账户：点登录页右上角的 **换个账号登录**。
* 同一台机器想切换默认组织：用 `reclaude org`（详见 [命令参考](/cli/commands)）。

## 退出登录

```bash theme={null}
reclaude logout
```

会恢复成上次 `login` 之前的 Claude Code 配置。如果想完整卸载并清掉本地凭据，用 `reclaude uninstall`。


# 常见问题
Source: https://docs.reclaude.ai/help/faq

ReClaude 最常被问到的问题汇总：支持的客户端、封号风险、切换担保、拼车配额、退款政策、团队共享、操作系统支持，购买前后都能在这里找到答案。

<Accordion title="ReClaude 能跑在哪些工具里？">
  当前支持 **Claude Code 官方 CLI** 和官方 Claude Code IDE 插件（VS Code / JetBrains 等）。IDE 插件需要做一步配置 —— 见 [安装 CLI → IDE 插件配置](/cli/install#ide-插件配置)。

  其他客户端（如 Cursor、Cline 等兼容 Anthropic API 的工具）暂不支持，后续会跟进。
</Accordion>

<Accordion title="我的个人 Claude 账号会被封吗？">
  不会。ReClaude 用的是我们自己运营的 Anthropic 官方账号，跟你的个人账号完全无关。封号风险由我们承担，监测到风控会自动换号。
</Accordion>

<Accordion title="换号要多久？质保是怎么算的？">
  月套餐期内提供质保，官方封号 100% 兜底。监测到当前账号被风控后，下一次请求会自动切到备用账号。期内无限换号、不计次。
</Accordion>

<Accordion title="拼车的额度怎么算？">
  单人限额 = 平均额度。N 人拼车每人可用 1/N 个 Max 的额度，按 5 小时滚动窗口均衡。具体车型（人数）参见 [reclaude.ai](https://reclaude.ai) 套餐页。
</Accordion>

<Accordion title="支持哪些操作系统？">
  macOS、Linux、Windows 全部支持，提供 amd64 和 arm64 二进制（Windows 仅 amd64）。详见 [安装 CLI](/cli/install)。
</Accordion>

<Accordion title="支持团队共享吗？">
  支持。如果只是想多人均摊成本，直接选拼车套餐即可；需要正式的团队 / 组织能力（席位管理、AI 账号分配），创建一个 **团队组织** 即可。具体方案如有特殊需求请联系商务对接。
</Accordion>

<Accordion title="我能同时持有多个套餐吗？">
  能。比如「个人独享 + 4 人拼车 + 一笔按量额度」可以并存，每份套餐挂在自己的组织上，额度互不影响。每台设备同一时刻只走一个组织，用 `reclaude org use <org_id>` 切换。完整说明见 [订阅 → 同时持有多个套餐](/account/subscription#同时持有多个套餐)。
</Accordion>

<Accordion title="可以退款吗？">
  按量套餐已使用额度不退、未使用额度可申请退款；**拼车套餐默认不支持** 用户主动退款；独享套餐可按剩余天数退，期间换号会扣手续费。**已开票订单默认不退**；违规使用导致的损失不退。完整规则见 [账单 → 退款](/account/billing#退款)。
</Accordion>

<Accordion title="和发 API key 的中转方案有什么不同？">
  最大区别：ReClaude 直接为你分配官方 Claude 账号，Claude Code 用的是 **官方订阅额度**，不是 API key。这意味着 Pro/Max 的订阅资源你都能用上，且 Claude Code 不需要任何配置改动。按 token 加价的中转模型在我们这里不存在；按量套餐按真实接口美元成本扣减、不加价。
</Accordion>

<Accordion title="对话内容会被记录吗？">
  后台默认只展示元数据（调用次数、时间、状态码、模型、token 数），都可在网页查询和导出。

  系统会保留相关技术日志；在 **排障、风控、计费争议** 等必要场景下，工程团队可能访问这些日志，访问受后台权限控制。完整规则见 [隐私政策](https://reclaude.ai/privacy)。
</Accordion>

<Accordion title="按量套餐怎么计费？">
  充值后立即开通，美元额度永不过期。每次请求按真实接口成本扣减，没有月费、不绑定换号质保。适合用量不固定、临时跑大单或月套餐用完想补一点的场景。
</Accordion>

<Accordion title="为什么我不能用 claude.ai 网页登录？">
  ReClaude 给拼车 / 按量套餐分配的账号 **不开放 web 端**：通过 claude.ai 网页登录会被拒绝。请只在 **Claude Code CLI** 或官方 IDE 插件里使用，这两种方式由 reclaude 接管转发，账号资源、订阅额度、5 小时配额都按你的 ReClaude 账户走。

  独享套餐另有 Claude Desktop 启动入口（内测中），通过 `reclaude app` 启动 —— 不需要也不应该直接登录 claude.ai。
</Accordion>

<Accordion title="reclaude 会改我的 settings.json 吗？">
  reclaude 采用**合并**的方式，不会覆盖你的 `~/.claude/settings.json`。它只会按需调整 `env` 段里跟接入相关的少数变量，`theme`、`permissions`、`hooks`、插件等其它配置都原样保留。

  `reclaude logout` 会把 settings.json 还原到你上次 `reclaude login` 之前的状态。
</Accordion>

<Accordion title="怎么切回原来的 claude？能和 cc-switch 等工具共存吗？">
  随时可以切回：跑 `reclaude logout` 就会把 Claude Code 配置还原到接入 reclaude 之前。

  如果想让 reclaude 和原生 claude（或 cc-switch 之类的切换工具）并存，可以用 `claude --settings <你自己的配置文件>` 指定一份独立配置，与 reclaude 各走各的。

  需要注意的是：这些工具共用同一份 `~/.claude/settings.json` 的 `env` 段，所以在同一份配置上来回切换时，以**最后一次写入**的为准。
</Accordion>

<Accordion title="出问题了去哪反馈？">
  唯一官方售后渠道是 [reclaude.ai](https://reclaude.ai) 登录后的 **工单**：账户、订单、退款、运维请求都在这里发。我们目前没有官方售后群，请勿在群里求售后 —— 可能错过、也无法核身。
</Accordion>


# 排查问题
Source: https://docs.reclaude.ai/help/troubleshooting

ReClaude 常见问题排查指南：安装失败、浏览器授权错误、找不到 claude 命令、反复 401 或 403 等症状的对照表与处理步骤，并给出复现条件，帮助你按症状快速定位并解决遇到的问题。

## 装不上

| 症状                     | 怎么处理                                                                                            |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| `DNS 解析失败` 或 `连接失败/超时` | 检查网络。如果在内网，可考虑切换镜像或先把二进制下载下来再 [手动安装](/cli/install#手动下载)                                         |
| `下载失败 (HTTP 4xx/5xx)`  | 多半是 `--version` 指定的版本号不存在；不传 `--version` 用 `latest` 试一下                                         |
| `不支持的 OS / arch`       | ReClaude 当前发布平台：macOS / Linux 的 amd64 + arm64 / Windows amd64。32 位 x86、ARMv7、PPC、RISC-V 暂未发布二进制 |
| `安装目录不可写`              | 默认装到 `~/.local/bin`；该目录不可写时检查权限或换路径                                                             |

## 登录批准失败

| 浏览器提示            | 怎么处理                                                                      |
| ---------------- | ------------------------------------------------------------------------- |
| `该 CLI 会话已过期或无效` | 回终端重跑 `reclaude login` 拿一条新链接                                             |
| `已达 X 台设备上限`     | 到 [设备](/account/devices) 页撤销一台旧设备                                         |
| `所选组织没有可用的绑定账号`  | 在批准页换一个有可用账号的组织，或联系运营分配                                                   |
| **批准按钮灰色 / 不可点** | 当前账户还没分配到组织或套餐 —— 到 [reclaude.ai](https://reclaude.ai) 完成订阅，或联系运营开通后再回来批准 |

## 跑 claude 报错

| 症状                  | 怎么处理                                                  |
| ------------------- | ----------------------------------------------------- |
| 终端找不到 `reclaude` 命令 | 装完没开新终端，PATH 还没生效；开个新终端，或手动 `source` 你的 shell 配置      |
| 终端找不到 `claude` 命令   | 没装官方 Claude Code CLI；重跑 `curl ... \| bash` 让安装脚本自动装一份 |
| `reclaude` 启动后立刻退出  | 用 `reclaude status` 看 daemon 是否在跑；不在就直接重跑 `reclaude`  |
| 请求一直 `401 / 403`    | 多半是登录态过期；重跑 `reclaude login`                          |

## 运行时报错

| 症状                                                      | 怎么处理                                                                                 |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `401 device_revoked` / 服务端总是吊销我的设备                      | 见 [设备 → 设备被自动撤销](/account/devices#设备被自动撤销)                                           |
| `403 x-claude-code-session-id missing`                  | Claude Code CLI 版本过低被网关拒绝；升级到最新版（`claude update` 或重装官方 CLI）                          |
| `Unable to connect to API: SSL certificate has expired` | 先跑 `reclaude stop`，再重新运行 `reclaude`（重启会重新生成本地证书）；如仍报错，检查本机系统时间是否准确                   |
| 频繁 `502` / 上游错误                                         | 跑 `reclaude config gateway` 切到另一条线路（见 [命令参考 → 配置 gateway](/cli/commands#配置-gateway)） |

## 付款相关

| 症状                          | 怎么处理                                                                                               |
| --------------------------- | -------------------------------------------------------------------------------------------------- |
| 已付款但订单仍显示 **待支付**           | 通常 1–3 分钟内由支付通道回调同步；超时仍未变化到 [reclaude.ai](https://reclaude.ai) 工单 → **财务问题** 附订单号                  |
| 已付款但订单显示 **已过期**            | 渠道扣款但回调失败 — 提工单附支付截图和订单号，运营核实后会重新挂账或退款                                                             |
| 同一笔支付出现两条订单                 | 别再点付款；提工单让运营合并                                                                                     |
| 付款成功但主页仍显示 **未订阅** / 没有可用套餐 | 多半是顶部选错了组织 —— 套餐挂在它所属的组织上，用 `reclaude org use <org_id>` 切到对应组织（或在网页切换顶部组织），再重开终端；状态同步偶有短暂延迟，稍候刷新即可 |

## 主页警示怎么处理

| 提示               | 含义             | 怎么处理              |
| ---------------- | -------------- | ----------------- |
| **账号已被封禁**       | 分配给你的账号被官方风控   | 系统会 **自动换号**，稍候即可 |
| **需要管理员确认**      | 账号触发异常，处理前服务暂停 | 等待客服处理，或主动提工单咨询   |
| **订阅即将到期 / 已过期** | 续费窗口已到         | 点击续费提示进入支付流程      |

## 看日志

```bash theme={null}
reclaude logs                       # 打印末尾几行
```

完整日志文件：`~/.reclaude/logs/reclaude.log`。

## 还是不行？

到 [reclaude.ai](https://reclaude.ai) 登录后，**工单 → 新建** 提交：

* **技术问题**：连接异常、CLI 报错、无法启动等
* **财务问题**：订单、退款、发票
* **其它**：反馈或建议


# 工作原理
Source: https://docs.reclaude.ai/how-it-works

ReClaude 在你电脑和 Claude 官方 API 之间做了什么：分配真实的 Anthropic 账号，让 Claude Code 直接走原生订阅配额，不绕代理、不加价、不改原有配置。

ReClaude 由两部分组成：

1. **本地客户端**（`reclaude`）跑在你的电脑上，处理 Claude Code 发出的请求。
2. **ReClaude 服务** 由 ReClaude 团队运营，负责为你分配健康的 Anthropic 官方账号。

```mermaid theme={null}
flowchart LR
  A[Claude Code] --> B[reclaude<br/>本地 daemon]
  B --> C[ReClaude]
  C --> D[Anthropic 官方 API]
```

## 一次请求会发生什么

* Claude Code 发起一次会话请求。
* 本地 daemon 把请求转给 ReClaude。
* ReClaude 用**分配给你**的官方账号、用它的订阅额度，直连官方 API。
* 响应原路返回给 Claude Code。

整个过程对 Claude Code 完全透明 —— 它以为自己在用一个本地账号。

## 你不用关心的事

* **配 API key**：ReClaude 用的是官方订阅额度，不发 API key。
* **手动换号**：分配给你的账号被风控时，ReClaude 自动切到备用账号；月套餐期内不计次。
* **风险隔离**：某个账号被风控不会影响其他用户的账号。

## 我们记录什么

后台默认只展示元数据：调用次数、时间、状态码、模型、token 数 —— 用来给你看用量、给我们做调度判断。

系统会保留相关技术日志用于排障、风控、计费争议等必要场景，访问受后台权限控制。

完整规则见 [隐私政策](https://reclaude.ai/privacy)。

## 用量从哪里来

主页的 **整体用量、订阅剩余天数** 透传自 Anthropic OAuth 接口 —— 我们只是把官方数据呈现给你。

**拼车的 5 小时配额** 由 ReClaude 自己均衡，**不是** Anthropic 的官方窗口 —— 为了保证拼车成员之间公平分配，我们单独维护一个 5 小时滚动窗口。


# 简介
Source: https://docs.reclaude.ai/introduction

ReClaude 是什么、为谁而做、它如何让你免去 API key 配置与封号担忧，让 Claude Code 以原生体验直连 Anthropic 官方账号；本文同时介绍三种适合不同用量的方案与典型使用场景。

ReClaude 是 **Claude Code 的续杯助手**。我们为你分配 Anthropic 官方账号，并在你的电脑上跑一个本地客户端，让 Claude Code 像往常一样直连官方 —— 你不用配 API key、不用换工具、也不用关心账号被风控。

## 适合谁

* 在用 Claude Code 但担心 **账号频繁封停** 的开发者
* 觉得 Max 月度额度独享 **吃不完**、想拼车均摊成本的用户
* 用量不固定、想 **按真实接口成本** 临时跑大单的用户

## 三种方案

<Columns>
  <Card title="独享" icon="user">
    一个账号专属于你，无竞争，体验最接近原生 Max。
  </Card>

  <Card title="拼车" icon="users">
    多人共享一个账号，单人额度 = 平均额度，性价比最高。
  </Card>

  <Card title="按量" icon="gauge">
    充值后立即开通，按真实接口美元成本扣减、不过期。
  </Card>
</Columns>

具体价格、当期活动、套餐细节请到 [reclaude.ai](https://reclaude.ai) 查看。

## ReClaude 帮你做了什么

* **自动换号**：ReClaude 分配给你的账号被风控时，自动切到备用账号；月套餐期内无限换号、不计次。
* **封号风险隔离**：某个账号被风控不会影响 ReClaude 分配给其他用户的账号。
* **质保一月**（月套餐）：套餐期内官方封号 100% 兜底。
* **用量透明**：调用次数、时间、状态码可在网页后台查询并导出。

## 不会做什么

* 不发 API key —— Claude Code 直接用官方订阅额度。
* 不改 Claude Code 配置，官方更新自动跟得上。

## 下一步

<Card title="快速开始" icon="rocket" href="/quickstart">
  装 CLI、登录、跑起来 —— 不到两分钟。
</Card>


# 快速开始
Source: https://docs.reclaude.ai/quickstart

装好 reclaude CLI、用浏览器设备流程登录、跑起 Claude Code —— 不到两分钟搞定。支持 macOS、Linux、Windows，一条命令安装，一次登录即用，无需配 API key。

<Note>
  开始前请先到 [reclaude.ai](https://reclaude.ai) 注册账户并开通一份套餐。
</Note>

<Steps>
  <Step title="安装 CLI">
    打开终端，按系统粘贴下面的命令：

    <CodeGroup>
      ```bash macOS / Linux theme={null}
      curl -fsSL https://reclaude.ai/install.sh | bash
      ```

      ```powershell Windows theme={null}
      iwr https://reclaude.ai/install.ps1 -UseBasicParsing | iex
      ```
    </CodeGroup>

    安装脚本会识别 CPU 架构、把 `reclaude` 写入 PATH。Claude Code 本身无需单独安装——首次运行 reclaude 时会自动下载（无需 VPN），已装官方版则沿用你那份。
  </Step>

  <Step title="登录">
    ```bash theme={null}
    reclaude login
    ```

    终端会打印一条授权链接。在浏览器里打开、登录你的 ReClaude 账户、给本机起一个设备名称，点击 **批准**。回到终端，几秒后即完成登录。
  </Step>

  <Step title="跑 Claude Code">
    直接执行：

    ```bash theme={null}
    reclaude
    ```

    ReClaude 会在后台启动本地 daemon，然后照常打开 Claude Code。请求会用 ReClaude 分配给你的账号执行。
  </Step>
</Steps>

## 验证

| 命令                 | 用途                          |
| ------------------ | --------------------------- |
| `reclaude status`  | 查看 daemon 是否在跑、当前 claude 路径 |
| `reclaude version` | 打印当前版本                      |

## 遇到问题？

先到 [排查问题](/help/troubleshooting) 看常见症状对照表，或在网页后台提交工单。