Documentation Index
Fetch the complete documentation index at: https://docs.reclaude.ai/llms.txt
Use this file to discover all available pages before exploring further.
装不上
| 症状 | 怎么处理 |
|---|
DNS 解析失败 或 连接失败/超时 | 检查网络。如果在内网，可考虑切换镜像或先把二进制下载下来再 手动安装 |
下载失败 (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 台设备上限 | 到 设备 页撤销一台旧设备 |
所选组织没有可用的绑定账号 | 在批准页换一个有可用账号的组织，或联系运营分配 |
| 批准按钮灰色 / 不可点 | 当前账户还没分配到组织或套餐 —— 到 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 / 服务端总是吊销我的设备 | 见 设备 → 设备被自动撤销 |
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） |
付款相关
| 症状 | 怎么处理 |
|---|
| 已付款但订单仍显示 待支付 | 通常 1–3 分钟内由支付通道回调同步；超时仍未变化到 reclaude.ai 工单 → 财务问题 附订单号 |
| 已付款但订单显示 已过期 | 渠道扣款但回调失败 — 提工单附支付截图和订单号，运营核实后会重新挂账或退款 |
| 同一笔支付出现两条订单 | 别再点付款；提工单让运营合并 |
| 付款成功但主页仍显示 未订阅 / 没有可用套餐 | 多半是顶部选错了组织 —— 套餐挂在它所属的组织上，用 reclaude org use <org_id> 切到对应组织（或在网页切换顶部组织），再重开终端；状态同步偶有短暂延迟，稍候刷新即可 |
主页警示怎么处理
| 提示 | 含义 | 怎么处理 |
|---|
| 账号已被封禁 | 分配给你的账号被官方风控 | 系统会 自动换号，稍候即可；长时间未恢复时可手动点 申请换号 |
| 需要管理员确认 | 账号触发异常，处理前服务暂停 | 等待客服处理，或主动提工单咨询 |
| 订阅即将到期 / 已过期 | 续费窗口已到 | 点击续费提示进入支付流程 |
看日志
完整日志文件：~/.reclaude/logs/reclaude.log。
还是不行？
到 reclaude.ai 登录后，工单 → 新建 提交：
- 技术问题：连接异常、CLI 报错、无法启动等
- 运维请求 → 换号：当前账号不可用
- 财务问题：订单、退款、发票
- 其它：反馈或建议