排查问题

装不上

症状	怎么处理
`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 完成订阅，或联系运营开通后再回来批准

症状	怎么处理
终端找不到 `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/logs/reclaude.log。

到 reclaude.ai 登录后，工单 → 新建 提交：