문제 해결

설치 실패

증상	해결
`DNS 확인 실패` 또는 `연결 실패 / 시간 초과`	네트워크를 확인하세요. 제한된 네트워크에서는 미러를 전환하거나 수동 다운로드에서 바이너리를 직접 가져오세요
`다운로드 실패(HTTP 4xx/5xx)`	보통 존재하지 않는 `--version` 값입니다; `latest`를 사용하려면 `--version` 없이 시도하세요
`지원되지 않는 OS / arch`	ReClaude는 현재 macOS / Linux의 amd64 + arm64, Windows amd64를 제공합니다. 32비트 x86, ARMv7, PowerPC, RISC-V는 아직 게시되지 않았습니다
`설치 디렉터리 쓰기 불가`	기본 설치 위치는 `~/.local/bin`입니다; 권한을 확인하거나 쓰기 가능한 디렉터리를 지정하세요

브라우저 메시지	해결
`이 CLI 세션이 만료되었거나 유효하지 않습니다`	`reclaude login`을 다시 실행해 새 링크를 받으세요
`기기 한도 도달: Y / X 기기`	기기 페이지에서 오래된 기기를 해지하세요
`선택한 조직에 바인딩된 계정이 없습니다`	승인 페이지에서 다른 조직을 선택하거나 지원에 문의하세요
승인 버튼이 회색 / 클릭 불가	계정이 아직 조직이나 요금제에 배정되지 않았습니다 — reclaude.ai 에서 구독을 시작하거나 운영팀에 개통을 요청한 뒤 다시 돌아와 승인하세요

증상	해결
셸이 `reclaude`를 찾지 못함	설치 후 새 터미널을 열지 않았습니다; 새 터미널을 열거나 셸 rc를 `source` 하세요
셸이 `claude`를 찾지 못함	Claude Code CLI가 설치되지 않았습니다; 설치 스크립트를 다시 실행해 Claude Code를 설치하게 하세요
`reclaude`가 즉시 종료됨	`reclaude status`를 확인하세요; 데몬이 실행 중이 아니면 `reclaude`를 다시 실행하세요
반복되는 `401 / 403` 오류	세션 만료일 가능성 — `reclaude login`을 다시 실행하세요

증상	해결
`401 device_revoked` / 서버가 계속 내 기기를 해지함	기기 → 자동으로 해지된 기기 참조
`403 x-claude-code-session-id missing`	Claude Code CLI 버전이 너무 낮아 게이트웨이가 거부합니다; 최신 버전으로 업데이트하세요 (`claude update` 또는 공식 CLI 재설치)
`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/logs/reclaude.log.

reclaude.ai에서 로그인한 다음 티켓 → 새로 만들기에서 제출: