Skip to main content

一键安装

脚本会:
  • 自动识别 OS 和 CPU 架构(amd64 / arm64,含 macOS Rosetta 2 检测)。
  • 下载对应二进制、校验 SHA256、写入 PATH。
脚本不再随安装顺带装 Claude Code。首次运行 reclaude 时会自动下载 Claude Code(无需 VPN);若你已装官方 Claude Code,会沿用你那份、不覆盖。
装完之后请打开新终端再跑命令,让 PATH 生效。验证用 reclaude version。

Windows 提示

  • 用普通 PowerShell,不要”以管理员身份运行”。安装会写入 %LOCALAPPDATA%\Programs\reclaude\bin(用户家目录),管理员 PowerShell 的 PATH 与你日常 shell 隔离,反而会让安装后 reclaude 命令找不到。
  • 必须 64 位 PowerShell。脚本会自检,若用了 32 位会直接退出。
  • 杀软 / EDR 误报:脚本会校验下载文件 SHA256,但部分企业杀软可能拦截写入。若提示 Access is denied,先关掉相关防护或把 %LOCALAPPDATA%\Programs\reclaude 加入白名单再重试。
  • Claude 桌面端:reclaude app 不使用你自己安装的 Claude Desktop,首次运行会另外下载一份 ReClaude 版(数百 MB),不需要指定路径。

常用选项

macOS / Linux(install.sh): 例如装指定版本:
Windows(install.ps1)用 iwr | iex 一行安装时不能直接带参数:锁版本改用环境变量,或先把脚本下载到本地再带参数运行。
install.ps1 同样支持 -Dir(默认 %LOCALAPPDATA%\Programs\reclaude\bin)、-Force、-Uninstall。

手动下载

如果脚本不可用,可以从下表直接下载二进制: 下载链接固定为 https://dl.reclaude.ai/latest/<文件名>。下载后赋予可执行权限并加到 PATH,再跑 reclaude setup 把它复制到标准目录(同时会创建 rec 别名)。

IDE 插件配置

如果你在 VS Code / Cursor / Windsurf 里用官方 Claude Code 扩展,需要让扩展通过 reclaude 启动 Claude,否则请求会绕过 reclaude 直连官方。
  1. 打开扩展设置(Ctrl/Cmd + , → 搜索 Claude Process Wrapper)。
  2. 找到 Claude Code: Claude Process Wrapper(描述:Executable path used to launch the Claude process)。
  3. 把可执行文件路径填成 reclaude 并保存。
    VS Code 设置中的 Claude Process Wrapper 输入框,值为 reclaude
  4. 重启 IDE 让设置生效。
填好之后 IDE 插件就会通过 reclaude 启动 Claude,账号、设备、配额都按你 reclaude 登录的账户走。
这一步是 官方 Claude Code 插件提供的标准设置项,不需要装额外扩展。

升级和卸载

请先 reclaude logout 再 reclaude uninstall。卸载只删 reclaude 自己的文件和它写进 ~/.claude/settings.json 的代理配置,不会把 Claude Code 还原到接入前的登录状态;卸载后备份也一起被删,无法再还原。
最后修改于 2026年10月14日