원라인 설치
- OS 와 CPU 아키텍처 자동 인식 (amd64 / arm64, macOS Rosetta 2 포함).
- 해당 바이너리 다운로드, SHA256 검증, PATH 등록.
설치 스크립트는 더 이상 Claude Code 를 함께 설치하지 않습니다. reclaude 를 처음 실행할 때 Claude Code 를 자동으로 다운로드합니다 (VPN 불필요). 이미 공식 Claude Code 가 설치되어 있다면 reclaude 가 그것을 사용하며 덮어쓰지 않습니다.
Windows 주의 사항
- 일반 PowerShell 로 실행 하세요. “관리자 권한으로 실행” 하면 안 됩니다. 설치는
%LOCALAPPDATA%\Programs\reclaude\bin(사용자 홈 디렉터리 하위) 에 기록되며, 관리자 PowerShell 의 PATH 는 평소 사용하는 셸과 분리되어 있어 설치 후reclaude명령을 찾을 수 없게 됩니다. - 반드시 64 비트 PowerShell 이어야 합니다. 스크립트가 자체 확인하며 32 비트면 즉시 종료합니다.
- 백신 / EDR 오탐: 스크립트는 다운로드 파일의 SHA256 을 검증하지만, 일부 기업 보안 솔루션은 쓰기를 차단할 수 있습니다.
Access is denied가 표시되면 관련 보호를 잠시 끄거나%LOCALAPPDATA%\Programs\reclaude를 화이트리스트에 추가한 뒤 다시 시도하세요. - Claude Desktop:
reclaude app은 직접 설치한 Claude Desktop 을 사용하지 않습니다. 첫 실행 시 ReClaude 버전 (수백 MB) 을 따로 다운로드하므로 경로를 지정할 필요가 없습니다.
주요 옵션
macOS / Linux (install.sh):
예를 들어 특정 버전 설치:
install.ps1) 를 iwr | iex 한 줄로 설치할 때는 인자를 넘길 수 없습니다. 버전을 고정하려면 환경 변수를 사용하거나, 스크립트를 먼저 내려받은 뒤 매개변수를 붙여 실행하세요.
install.ps1 도 -Dir (기본값 %LOCALAPPDATA%\Programs\reclaude\bin), -Force, -Uninstall 을 지원합니다.
수동 다운로드
스크립트를 사용할 수 없다면 아래 표에서 바이너리를 직접 다운로드할 수 있습니다:
다운로드 URL 은
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 플러그인이 제공하는 표준 설정 항목 이며, 별도의 확장은 필요하지 않습니다.