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.
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 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 | 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 |
Runtime errors
| 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) |
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 doesn’t recover after a while, you can manually click Request switch |
| 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/logs/reclaude.log.
Still stuck?
Sign in at reclaude.ai, then Tickets → New to submit:
- Technical: connection issues, CLI errors, daemon won’t start
- Ops → Switch account: assigned account is unusable
- Billing: orders, refunds, invoices
- Other: feedback or suggestions