装不上
| 症状 | 怎么处理 |
|---|---|
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 台设备上限(当前 Y 台) 或 该独享账号已达 X 台设备上限(全部成员合计 Y 台) | 到 设备 页撤销一台旧设备。同一台电脑加绑别的组织不占每人名额 |
所选组织没有可用的绑定账号 | 在批准页换一个有可用账号的组织,或联系运营分配 |
订单已付款,正在为你分配账号,分配好后重新运行登录命令。 | 订单还在排队发货,发货后回终端重跑 reclaude login 即可,不用联系运营 |
你还没有可用的订阅,下单完成后重新运行登录命令。 或 当前没有任何组织分配了可用绑定账号。 | 到 reclaude.ai 完成订阅后再登录;团队组织的成员请让组织管理员分配账号 |
跑 claude 报错
| 症状 | 怎么处理 |
|---|---|
终端找不到 reclaude 命令 | 装完没开新终端,PATH 还没生效;开个新终端,或手动 source 你的 shell 配置 |
终端找不到 claude 命令 | 不用单独安装:直接重跑 reclaude,它会自动下载一份 Claude Code(无需 VPN)。仍失败时按屏幕上的诊断看是不是到 dl.reclaude.ai 的网络不通;若你已把 Claude Code 装在自定义位置,把它的绝对路径写进 ~/.rec/claude/claude.path 即可 |
reclaude 启动后立刻退出 | 用 reclaude status --check 看后台服务是否在跑、reclaude doctor 检查安装(reclaude doctor --fix 补齐缺失项);然后重跑 reclaude |
| 提示「此设备已被解绑」或「reclaude 登录状态失效」 | 在终端运行 reclaude login 重新登录(刷新的是缺省绑定;被解绑的是别的组织时 reclaude login --org <org_id>),不必先 reclaude logout。直接跑 reclaude 会提示「本机的登录已失效。请先运行 reclaude logout,再重新运行 reclaude,它会重新登录」——直接 reclaude login 效果相同;reclaude logout 现在只退出缺省绑定,不影响其它组织。本机有多条绑定又没有缺省时命令会先列出可选组织并退出,先 reclaude org use <org_id> 设一个缺省。不要在 Claude Code 里用 /login |
运行时报错
| 症状 | 怎么处理 |
|---|---|
| 设备反复被撤销(提示「此设备已被解绑」) | 多半是本机给 Claude Code 设过环境变量(如关闭遥测):看终端配置文件、Windows 系统环境变量和项目目录下 .claude/ 里的设置(reclaude 启动的 Claude Code 用独立配置,~/.claude/settings.json 对它无效),清掉后重新运行 reclaude 登录;见 设备 → 设备被自动撤销 |
| 提示「仅支持 Claude Code 客户端访问 reclaude 网关」 | 请确认是通过 reclaude(或按 IDE 插件配置)启动的 Claude Code,并把 Claude Code 升到最新版 |
| 提示需要升级 reclaude(客户端版本过低) | 运行 reclaude update |
Unable to connect to API: SSL certificate has expired | 先跑 reclaude service stop,再重新运行 reclaude(重启会重新生成本地证书);如仍报错,检查本机系统时间是否准确 |
| 提示「账号已被限制使用,如有疑问请登录 reclaude.ai 提交工单联系客服」 | 账号被限制使用:网页仍能登录,可以提交工单、查看订单和退款进度,但不能使用服务和购买。按提示到 reclaude.ai 提交工单 |
| 提示「账号不可用,如有疑问请发邮件至 contact@reclaude.ai」 | 账号已被完全封禁,网页登录也会提示「您的账户当前不可用,请联系客服。」。按提示发邮件到 contact@reclaude.ai |
| 提示「订阅已到期,请前往 reclaude.ai 续费后继续使用」或「当前没有有效订阅,请前往 reclaude.ai 购买后使用」 | 当前组织没有有效订阅:续费,或换一个有订阅的组织启动(reclaude --org <org_id>) |
| 提示「拼车本周额度已用完,约 … 后重置,请稍后再来」 | 拼车席位本周的用量上限已用完,到点自动恢复;急用可换一个有额度的组织启动 |
| 提示「当前绑定账号暂不可用,系统将自动处理,请稍后重试」或「组织暂无可用账号,系统正在自动补号…」 | 分配的账号正在换号或补号,稍候重开该组织的 Claude Code;长时间未恢复提工单 |
| 提示「你申请了退款,这个组织已停用;款项开始退回之前撤回就能恢复」或「组织已停用(退款处理中),请联系组织所有者」 | 这个组织有退款在处理,已停用。想继续用,由申请人在订单详情的退款卡片里撤回(款项开始退回之前都能撤回);见 账单 → 退款怎么走 |
频繁 502 / 上游错误 | 跑 reclaude config gateway 切到另一条线路(见 命令参考 → 配置 gateway) |
敲 reclaude(或 reclaude app / IDE 插件)直接退出,提示 本机有多条 Claude 绑定,请用 --org <org_id> 选一条,或运行 reclaude org use <org_id> 设为缺省: 并列出一张表 | 本机绑了多个组织但没有缺省绑定:按表里的 org_id 运行 reclaude org use <org_id> 设一个缺省,或每次带 --org <org_id>(裸 reclaude 的 --org 必须是第一个参数)。见 命令参考 → 多组织绑定 |
reclaude org use / reclaude --org 提示「本机还没有绑定组织 N,请先运行 reclaude org bind N」 | 是组织成员不等于本机已绑定:运行 reclaude org bind N 走浏览器批准。刚从旧版本升级的用户对自己原来的组织也会撞到这句,同样运行 reclaude org bind N,已绑过的会当场补齐并提示「本机已绑定组织:…,无需再绑」 |
每条命令都提示「检测到仍在运行的 Claude Code / Claude 桌面端(pid …),多账号布局的迁移这次先不做;全部退出之后再运行一次 reclaude 即可完成」,login / org bind 直接退出并提示「多账号布局的迁移还没有完成,这条命令先不继续」 | 从旧版本升级后的一次性迁移要搬 ~/.claude,有 Claude 在跑就整步推迟。括号里的 pid <n> (<程序名>) 就是要退的进程:你自己装的原生 claude、IDE 插件里的 Claude Code、Claude 桌面端都算。全部退出后再跑一次 reclaude;之后 reclaude status 里不再出现「数据迁移:…」一行即完成(成功没有别的提示)。见 安装 CLI → 从旧版本升级 |
| 提示「暂时无法把 … 搬进多账号布局(…),这次先不做」 | ~/.claude 这时搬不动(常见于 Windows 上文件被占用):退出所有 Claude Code 与 Claude 桌面端,关掉打开着这些文件的程序,再运行一次 reclaude |
reclaude app 提示「Claude 桌面端正在运行,它的数据目录还没搬进这条绑定;请先完全退出 Claude 桌面端,再运行 reclaude app」,或升级时见过「Claude 桌面端正在运行,它的数据目录暂时留在原位置(…)」 | 升级迁移要把原来的桌面端数据搬进第一条绑定,桌面端在跑时不搬。完全退出 Claude 桌面端(macOS 用 ⌘Q)再运行 reclaude app,成功会提示「已把 Claude 桌面端原来的数据目录搬进这条绑定(…)」 |
reclaude app 提示「reclaude app: … 的补丁版本(…)缺少桌面媒体代理保护(需要 v10 及以上);请运行 reclaude app-update 更新后再试…」 | 本机的 ReClaude 版桌面端太旧:运行 reclaude app update,再重新 reclaude app;更新后仍如此说明新版本还没发布,按提示等待 |
reclaude org bind 提示「服务端暂不支持多绑定,请稍后再试」 | 按提示稍后重试;持续出现请提工单 |
reclaude org use 报 意外状态码 403: … 本机在该组织已有另一条绑定(新版 reclaude 创建),请升级 reclaude 到最新版后再运行 reclaude org use 切换 | 这台电脑上的 reclaude 还是旧版本:运行 reclaude update,重新打开终端 / 重启 reclaude 后再 reclaude org use |
Claude Code 的 MCP / hooks / statusLine 报 ~/.claude/... 下的文件不存在(如 ENOENT … posix_spawn '…/.claude/bin/<工具>') | 升级迁移把 ~/.claude 整目录搬到了 ~/.rec/claude/accounts/<device_id>/config/,配置里写死的旧绝对路径失效。改成新路径、把工具挪到 ~/.local/bin 之类与 reclaude 无关的位置、或只给 bin/ 这类只放可执行文件的目录建符号链接;做法与禁忌见 常见问题 与 安装 CLI → 从旧版本升级 |
付款相关
| 症状 | 怎么处理 |
|---|---|
| 已付款但订单仍显示 待支付 | 通常 1–3 分钟内由支付通道回调同步;超时仍未变化到 reclaude.ai 工单 → 财务问题 附订单号 |
| 已付款但订单显示 已过期 | 渠道扣款但回调失败 — 提工单附支付截图和订单号,运营核实后会重新挂账或退款 |
| 同一笔支付出现两条订单 | 别再点付款;提工单让运营合并 |
| 付款成功但主页仍显示 未订阅 / 没有可用套餐 | 多半是顶部选错了组织 —— 套餐挂在它所属的组织上。主页显示哪个组织,用网页顶部的 切换组织;电脑上的 Claude 走哪个组织与网页无关:reclaude org list 看该组织本机是否已绑定,未绑定先 reclaude org bind <org_id>,再 reclaude org use <org_id> 设为缺省或用 reclaude --org <org_id> 启动;状态同步偶有短暂延迟,稍候刷新即可 |
主页警示怎么处理
| 提示 | 含义 | 怎么处理 |
|---|---|---|
| 账号已被封禁 | 分配给你的账号被官方风控 | 系统会 自动换号,稍候即可;长时间未恢复可在主页点 申请换号 |
| 需要管理员确认 | 账号触发异常,处理前服务暂停 | 等待客服处理,或主动提工单咨询 |
| 订阅即将到期 / 已过期 | 一周内到期、处于宽限期,或已过期(「你的订阅已过期。续费前服务已暂停。」) | 点续费提示,或到 订阅与账单 → Claude 套餐 续费 |
| 账号受限,仅可开工单、查看订单和退款进度 | 账号被限制使用,服务、购买和管理操作已暂停 | 点 联系支持 提交工单 |
看日志
reclaude logs # 打印最后 200 行(-f 持续跟踪)
reclaude service run --debug # 在前台运行后台服务,实时打印收发内容(排障用)
~/.rec/logs/daemon.log(超过 5 MiB 会滚动为 daemon.log.1)。Linux 上若后台服务以 systemd 用户服务运行,日志在 journalctl --user -u reclaude.service;以 reclaude status --verbose 打印的 daemon_log 为准。Claude 桌面端的启动日志按绑定存放在 ~/.rec/claude/accounts/<device_id>/app.log。
还是不行?
到 reclaude.ai 登录后,工单 → 新建 提交(报错末尾的「(请求 ID: …)」请一并贴上):- 技术问题:连接异常、CLI 报错、无法启动等
- 财务问题:订单、退款、发票
- 运维请求 → 换号:当前账号不可用
- 其他:反馈或建议