> ## 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.

# 排查问题

> 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 报错、无法启动等
* **财务问题**：订单、退款、发票
* **其它**：反馈或建议