Install fails
| Symptom | Fix |
|---|---|
DNS resolution failed or connect failed / timeout | Check your network. On a restricted network, switch mirrors or grab the binary directly from Manual download |
Download failed (HTTP 4xx/5xx) | Usually a non-existent --version value; try without --version to use latest |
Unsupported OS / arch | ReClaude currently ships macOS / Linux / Windows, each on amd64 + arm64. 32-bit x86, ARMv7, PowerPC, s390x, and RISC-V aren’t published yet |
Install directory not writable | Default install location is ~/.local/bin; check permissions or pass a writable directory |
Browser approval fails
| Browser message | Fix |
|---|---|
This CLI session has expired or is invalid | Re-run reclaude login for a fresh link |
Device limit reached: Y / X devices | Revoke an old device on the Devices page |
The selected organization has no bound account | Pick a different org on the approval page, or contact support |
| Approve button is grayed out / unclickable | Your account hasn’t been assigned to an org or a plan yet — sign up for a subscription at reclaude.ai, or contact support to provision one, then come back to approve |
Errors when running claude
| Symptom | Fix |
|---|---|
Shell can’t find reclaude | You didn’t open a new terminal after install; open a fresh terminal or source your shell rc |
Shell can’t find claude | No separate install needed: just run reclaude again and it downloads Claude Code automatically (no VPN needed). If that still fails, follow the on-screen diagnostics — usually the network can’t reach dl.reclaude.ai; if you installed Claude Code in a custom location, write its absolute path into ~/.reclaude/claude.path |
reclaude exits immediately | Check reclaude status; if the daemon isn’t running, just run reclaude again |
| Claude Code shows the Chinese message “此设备已被解绑” (this device has been unbound) or “reclaude 登录状态失效” (reclaude login has expired) | Run reclaude again in the terminal (it starts the login flow automatically); do not use /login inside Claude Code |
Runtime errors
| Symptom | Fix |
|---|---|
| My device keeps getting revoked (message “此设备已被解绑”, this device has been unbound) | See Devices → Devices revoked automatically |
| Claude Code shows the Chinese message “仅支持 Claude Code 客户端访问 reclaude 网关” (only Claude Code clients can access the reclaude gateway) | Make sure Claude Code was launched through reclaude (or via the IDE extension setup), and update Claude Code to the latest version |
| Message saying reclaude needs to be upgraded (client too old) | Run reclaude update |
Unable to connect to API: SSL certificate has expired | First run reclaude stop, then re-run reclaude (restarting regenerates the local certificate); if it still fails, check that your system clock is correct |
Frequent 502 / upstream errors | Run reclaude config gateway to switch to a different route (see Command reference → Configure gateway) |
Payment issues
| Symptom | Fix |
|---|---|
| Payment went through but the order still shows Pending | The payment channel callback usually syncs within 1–3 minutes; if it still hasn’t updated, file a ticket at reclaude.ai → Billing with the order number |
| Payment went through but the order shows Expired | The channel charged you but the callback failed — file a ticket with the payment screenshot and order number; after support verifies, we’ll re-credit the order or issue a refund |
| The same payment created two orders | Stop paying again; file a ticket and support will merge them |
| Payment succeeded but the home page still shows No subscription / no available plan | Usually the wrong organization is selected at the top — the plan lives on its own org; use reclaude org use <org_id> to switch to it (or switch the top org on the web), then reopen your terminal. Status sync occasionally lags briefly, so refresh shortly after |
Home-page alerts
| Alert | Meaning | Fix |
|---|---|---|
| Account banned | The account assigned to you was flagged by Anthropic | The system will automatically switch you to a new account — just wait; if it takes too long, click Request switch on the home page |
| Needs review | The account hit an exception; service paused until support resolves | Wait for support, or open a ticket for status |
| Subscription expiring / expired | Renewal window has arrived | Click the renewal banner to pay |
Read the logs
reclaude logs # tail of the daemon log
reclaude daemon --debug # run the daemon in the foreground and print traffic live (troubleshooting)
~/.reclaude/logs/daemon.log (rotated to daemon.log.1 once it exceeds 5 MiB). On Linux, if the daemon runs as a systemd user service, its log is in journalctl --user -u reclaude.service; the daemon_log line printed by reclaude status is authoritative.
Still stuck?
Sign in at reclaude.ai, then Tickets → New to submit:- Technical: connection issues, CLI errors, daemon won’t start
- Billing: orders, refunds, invoices
- Operations → Switch account: your current account is unusable
- Other: feedback or suggestions