Troubleshooting

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 on amd64 + arm64, and Windows amd64. 32-bit x86, ARMv7, PowerPC, 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 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

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`	Claude Code CLI isn’t installed; re-run the install script and let it install Claude Code for you
`reclaude` exits immediately	Check `reclaude status`; if the daemon isn’t running, just run `reclaude` again
Repeated `401 / 403` errors	Likely an expired session — re-run `reclaude login`

Symptom	Fix
`401 device_revoked` / the server keeps revoking my device	See Devices → Auto-revoked devices
`403 x-claude-code-session-id missing`	Your Claude Code CLI is too old and the gateway is rejecting it; update to the latest version (`claude update` or reinstall the official CLI)
`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)

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

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

reclaude logs                       # tail of the daemon log

Full log file: ~/.reclaude/logs/reclaude.log.