一键安装
- 自动识别 OS 和 CPU 架构(amd64 / arm64,含 macOS Rosetta 2 检测)。
- 下载对应二进制、校验 SHA256、写入 PATH。
脚本不再随安装顺带装 Claude Code。首次运行 reclaude 时会自动下载 Claude Code(无需 VPN);若你已装官方 Claude Code,会沿用你那份、不覆盖。
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):
例如装指定版本:
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 直连官方。-
打开扩展设置(
Ctrl/Cmd + ,→ 搜索Claude Process Wrapper)。 - 找到 Claude Code: Claude Process Wrapper(描述:Executable path used to launch the Claude process)。
-
把可执行文件路径填成
reclaude并保存。
- 重启 IDE 让设置生效。
这一步是 官方 Claude Code 插件提供的标准设置项,不需要装额外扩展。