Skip to main content

​
One-line install

The script will:
  • Detect your OS and CPU architecture (amd64 / arm64, including macOS Rosetta 2).
  • Download the matching binary, verify SHA256, and place it on your PATH.
The script no longer bundles Claude Code. reclaude downloads Claude Code automatically the first time you run it (no VPN needed); if you already have the official Claude Code, reclaude uses yours and won’t override it.
After installing, open a new terminal so PATH refreshes. Verify with reclaude version.

​
Windows notes

  • Use a normal PowerShell window, don’t “Run as administrator”. The installer writes to %LOCALAPPDATA%\Programs\reclaude\bin (under your user home); admin PowerShell uses a separate PATH from your daily shell and will leave the reclaude command unreachable.
  • A 64-bit PowerShell is required. The script self-checks and exits if it detects 32-bit.
  • Antivirus / EDR false positives: the script verifies SHA256 on the download, but some corporate antivirus tools may block writes. If you see Access is denied, disable the relevant protection or whitelist %LOCALAPPDATA%\Programs\reclaude and retry.
  • Claude Desktop: reclaude app doesn’t use the Claude Desktop you installed yourself; the first run downloads a separate ReClaude build (a few hundred MB), no path to configure.

​
Common flags

macOS / Linux (install.sh): For example, pin to a specific version:
On Windows (install.ps1) the one-line iwr | iex install can’t take arguments: to pin a version, set an environment variable, or download the script first and run it with parameters.
install.ps1 also accepts -Dir (default %LOCALAPPDATA%\Programs\reclaude\bin), -Force and -Uninstall.

​
Manual download

If the script can’t run, grab the binary directly: URL pattern: https://dl.reclaude.ai/latest/<filename>. After downloading, mark it executable and put it on your PATH, then run reclaude setup to copy it into the standard location (this also creates the rec alias).

​
IDE extension setup

If you use the official Claude Code extension in VS Code, Cursor or Windsurf, configure it to launch Claude through reclaude. Otherwise, requests bypass reclaude and go straight to Anthropic.
  1. Open the extension settings (Ctrl/Cmd + , → search Claude Process Wrapper).
  2. Find Claude Code: Claude Process Wrapper (description: Executable path used to launch the Claude process).
  3. Set the executable path to reclaude and save.
    VS Code settings showing the Claude Process Wrapper field set to reclaude
  4. Restart the IDE so the setting takes effect.
Once configured, the IDE extension launches Claude through reclaude, and your account, device, and quota follow whichever reclaude account you’re signed into.
This is a built-in setting on the official Claude Code extension — no extra plugins required.

​
Update and uninstall

Run reclaude logout before reclaude uninstall. Uninstalling only removes reclaude’s own files and the proxy settings it wrote to ~/.claude/settings.json — it does not restore Claude Code to the login state from before reclaude, and the backup is deleted along with the local data, so it can’t be restored afterwards.
Last modified on October 14, 2026