> ## 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. # Troubleshooting > Fixes for ReClaude install, browser approval, and runtime issues — DNS errors, device limits, missing claude binary, and recurring 401 errors. ## 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](/en/cli/install#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](/en/account/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](https://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](/en/account/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](/en/cli/commands#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](https://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 ` 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 | | **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 ```bash theme={null} reclaude logs # tail of the daemon log ``` Full log file: `~/.reclaude/logs/reclaude.log`. ## Still stuck? Sign in at [reclaude.ai](https://reclaude.ai), then **Tickets → New** to submit: * **Technical**: connection issues, CLI errors, daemon won't start * **Billing**: orders, refunds, invoices * **Other**: feedback or suggestions