Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ReClaude 설치 실패, 브라우저 승인 오류, claude 명령어를 찾을 수 없음, 기기 연결 해제 또는 로그인 상태 만료 등 증상별 문제 해결 방법과 권장 대응 절차, 재현 조건까지 한 페이지에 정리해 두었으니 참고하세요.
| 증상 | 해결 |
|---|---|
DNS 확인 실패 또는 연결 실패 / 시간 초과 | 네트워크를 확인하세요. 제한된 네트워크에서는 미러를 전환하거나 수동 다운로드에서 바이너리를 직접 가져오세요 |
다운로드 실패(HTTP 4xx/5xx) | 보통 존재하지 않는 --version 값입니다; latest를 사용하려면 --version 없이 시도하세요 |
지원되지 않는 OS / arch | ReClaude는 현재 macOS / Linux / Windows 각각의 amd64 + arm64를 제공합니다. 32비트 x86, ARMv7, PowerPC, s390x, RISC-V는 아직 게시되지 않았습니다 |
설치 디렉터리 쓰기 불가 | 기본 설치 위치는 ~/.local/bin입니다; 권한을 확인하거나 쓰기 가능한 디렉터리를 지정하세요 |
| 브라우저 메시지 | 해결 |
|---|---|
이 CLI 세션이 만료되었거나 유효하지 않습니다 | reclaude login을 다시 실행해 새 링크를 받으세요 |
기기 한도 도달: Y / X 기기 | 기기 페이지에서 오래된 기기를 해지하세요 |
선택한 조직에 바인딩된 계정이 없습니다 | 승인 페이지에서 다른 조직을 선택하거나 지원에 문의하세요 |
| 승인 버튼이 회색 / 클릭 불가 | 계정이 아직 조직이나 요금제에 배정되지 않았습니다 — reclaude.ai 에서 구독을 시작하거나 운영팀에 개통을 요청한 뒤 다시 돌아와 승인하세요 |
| 증상 | 해결 |
|---|---|
셸이 reclaude를 찾지 못함 | 설치 후 새 터미널을 열지 않았습니다; 새 터미널을 열거나 셸 rc를 source 하세요 |
셸이 claude를 찾지 못함 | 별도 설치는 필요 없습니다. reclaude를 다시 실행하면 Claude Code를 자동으로 다운로드합니다(VPN 불필요). 그래도 실패하면 화면의 진단 메시지를 확인하세요. 대개 dl.reclaude.ai에 연결되지 않는 경우입니다. Claude Code를 직접 다른 위치에 설치했다면 그 절대 경로를 ~/.reclaude/claude.path에 적어 두세요 |
reclaude가 즉시 종료됨 | reclaude status를 확인하세요; 데몬이 실행 중이 아니면 reclaude를 다시 실행하세요 |
| Claude Code에 중국어 메시지 “此设备已被解绑”(이 기기는 연결이 해제되었습니다) 또는 “reclaude 登录状态失效”(reclaude 로그인 상태가 만료되었습니다)가 표시됨 | 터미널에서 reclaude를 다시 실행하세요(자동으로 로그인 흐름이 시작됩니다). Claude Code 안의 /login은 사용하지 마세요 |
| 증상 | 해결 |
|---|---|
| 기기가 반복해서 해지됨(메시지 “此设备已被解绑”, 이 기기는 연결이 해제되었습니다) | 기기 → 자동 폐기된 기기 참조 |
| Claude Code에 중국어 메시지 “仅支持 Claude Code 客户端访问 reclaude 网关”(reclaude 게이트웨이는 Claude Code 클라이언트만 접근할 수 있습니다)가 표시됨 | reclaude(또는 IDE 플러그인 설정)를 통해 Claude Code를 실행했는지 확인하고 Claude Code를 최신 버전으로 업데이트하세요 |
| reclaude 업그레이드가 필요하다는 메시지(클라이언트 버전이 낮음) | reclaude update를 실행하세요 |
Unable to connect to API: SSL certificate has expired | 먼저 reclaude stop을 실행한 뒤 reclaude를 다시 실행하세요(재시작 시 로컬 인증서가 재생성됩니다); 그래도 실패하면 시스템 시계가 정확한지 확인하세요 |
잦은 502 / 업스트림 오류 | reclaude config gateway를 실행해 다른 경로로 전환하세요 (명령어 레퍼런스 → gateway 설정 참조) |
| 증상 | 해결 |
|---|---|
| 결제 완료했지만 주문이 여전히 대기 중으로 표시 | 일반적으로 결제 채널 콜백이 1–3분 이내에 동기화됩니다; 그래도 변경되지 않으면 reclaude.ai → 재무 에 주문번호와 함께 티켓을 제출하세요 |
| 결제 완료했지만 주문이 만료로 표시 | 채널에서는 결제되었지만 콜백이 실패한 경우입니다 — 결제 스크린샷과 주문번호를 첨부해 티켓을 제출하세요; 운영팀 확인 후 재반영 또는 환불 처리됩니다 |
| 같은 결제로 주문이 두 건 생성됨 | 다시 결제하지 마세요; 티켓을 제출해 운영팀에 통합을 요청하세요 |
| 결제는 성공했는데 홈페이지에 여전히 미구독 / 사용 가능한 플랜 없음으로 표시 | 대개 상단에서 잘못된 조직을 선택한 경우입니다 — 플랜은 자신이 속한 조직에 있으므로 reclaude org use <org_id>로 해당 조직으로 전환(또는 웹에서 상단 조직 전환)한 뒤 터미널을 다시 여세요; 상태 동기화가 가끔 잠깐 지연될 수 있으니 잠시 후 새로고침하세요 |
| 알림 | 의미 | 해결 |
|---|---|---|
| 계정 차단됨 | 할당된 계정이 Anthropic에 의해 제재됨 | 시스템이 자동으로 계정을 교체합니다 — 잠시만 기다려 주세요. 오래 복구되지 않으면 홈에서 전환 요청을 누르세요 |
| 검토 필요 | 계정이 예외 상황에 도달; 지원이 해결할 때까지 서비스 일시 중지 | 지원을 기다리거나 상태에 대한 티켓을 여세요 |
| 구독 만료 예정 / 만료됨 | 갱신 윈도우 도달 | 갱신 배너를 클릭해 결제하세요 |
reclaude logs # 데몬 로그의 끝부분
reclaude daemon --debug # 데몬을 포그라운드에서 실행하고 송수신 내용 출력(문제 해결용)
~/.reclaude/logs/daemon.log (5 MiB를 넘으면 daemon.log.1로 롤링됩니다). Linux에서 데몬이 systemd 사용자 서비스로 실행 중이면 로그는 journalctl --user -u reclaude.service에 있습니다. reclaude status가 출력하는 daemon_log를 기준으로 하세요.
이 페이지가 도움이 되었나요?