Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ReClaude 常见问题排查指南：安装失败、浏览器授权错误、找不到 claude 命令、设备被解绑或登录状态失效等症状的对照表与处理步骤，帮助你按症状快速定位并解决遇到的问题。
| 症状 | 怎么处理 |
|---|---|
DNS 解析失败 或 连接失败/超时 | 检查网络。如果在内网，可考虑切换镜像或先把二进制下载下来再 手动安装 |
下载失败 (HTTP 4xx/5xx) | 多半是 --version 指定的版本号不存在；不传 --version 用 latest 试一下 |
不支持的 OS / arch | ReClaude 当前发布平台：macOS / Linux / Windows 各自的 amd64 + arm64。32 位 x86、ARMv7、PowerPC、s390x、RISC-V 暂未发布二进制 |
安装目录不可写 | 默认装到 ~/.local/bin；该目录不可写时检查权限或换路径 |
| 浏览器提示 | 怎么处理 |
|---|---|
该 CLI 会话已过期或无效 | 回终端重跑 reclaude login 拿一条新链接 |
已达 X 台设备上限 | 到 设备 页撤销一台旧设备 |
所选组织没有可用的绑定账号 | 在批准页换一个有可用账号的组织，或联系运营分配 |
| 批准按钮灰色 / 不可点 | 当前账户还没分配到组织或套餐 —— 到 reclaude.ai 完成订阅，或联系运营开通后再回来批准 |
| 症状 | 怎么处理 |
|---|---|
终端找不到 reclaude 命令 | 装完没开新终端，PATH 还没生效；开个新终端，或手动 source 你的 shell 配置 |
终端找不到 claude 命令 | 不用单独安装：直接重跑 reclaude，它会自动下载一份 Claude Code（无需 VPN）。仍失败时按屏幕上的诊断看是不是到 dl.reclaude.ai 的网络不通；若你已把 Claude Code 装在自定义位置，把它的绝对路径写进 ~/.reclaude/claude.path 即可 |
reclaude 启动后立刻退出 | 用 reclaude status 看 daemon 是否在跑；不在就直接重跑 reclaude |
| 提示「此设备已被解绑」或「reclaude 登录状态失效」 | 在终端重新运行 reclaude（会自动进入登录流程）；不要在 Claude Code 里用 /login |
| 症状 | 怎么处理 |
|---|---|
| 设备反复被撤销（提示「此设备已被解绑」） | 见 设备 → 设备被自动撤销 |
| 提示「仅支持 Claude Code 客户端访问 reclaude 网关」 | 请确认是通过 reclaude（或按 IDE 插件配置）启动的 Claude Code，并把 Claude Code 升到最新版 |
| 提示需要升级 reclaude（客户端版本过低） | 运行 reclaude update |
Unable to connect to API: SSL certificate has expired | 先跑 reclaude stop，再重新运行 reclaude（重启会重新生成本地证书）；如仍报错，检查本机系统时间是否准确 |
频繁 502 / 上游错误 | 跑 reclaude config gateway 切到另一条线路（见 命令参考 → 配置 gateway） |
| 症状 | 怎么处理 |
|---|---|
| 已付款但订单仍显示 待支付 | 通常 1–3 分钟内由支付通道回调同步；超时仍未变化到 reclaude.ai 工单 → 财务问题 附订单号 |
| 已付款但订单显示 已过期 | 渠道扣款但回调失败 — 提工单附支付截图和订单号，运营核实后会重新挂账或退款 |
| 同一笔支付出现两条订单 | 别再点付款；提工单让运营合并 |
| 付款成功但主页仍显示 未订阅 / 没有可用套餐 | 多半是顶部选错了组织 —— 套餐挂在它所属的组织上，用 reclaude org use <org_id> 切到对应组织（或在网页切换顶部组织），再重开终端；状态同步偶有短暂延迟，稍候刷新即可 |
| 提示 | 含义 | 怎么处理 |
|---|---|---|
| 账号已被封禁 | 分配给你的账号被官方风控 | 系统会 自动换号，稍候即可；长时间未恢复可在主页点 申请换号 |
| 需要管理员确认 | 账号触发异常，处理前服务暂停 | 等待客服处理，或主动提工单咨询 |
| 订阅即将到期 / 已过期 | 续费窗口已到 | 点击续费提示进入支付流程 |
reclaude logs # 打印末尾几行
reclaude daemon --debug # 在前台运行 daemon，实时打印收发内容（排障用）
~/.reclaude/logs/daemon.log（超过 5 MiB 会滚动为 daemon.log.1）。Linux 上若 daemon 以 systemd 用户服务运行，日志在 journalctl --user -u reclaude.service；以 reclaude status 打印的 daemon_log 为准。
此页面对您有帮助吗？