> ## Documentation Index > Fetch the complete documentation index at: https://docs.reclaude.ai/llms.txt > Use this file to discover all available pages before exploring further. # 문제 해결 > ReClaude 설치 실패, 브라우저 승인 오류, claude 명령어를 찾을 수 없음, 401과 403 오류가 반복되는 등 증상별 문제 해결 방법과 권장 대응 절차, 재현 조건까지 한 페이지에 정리해 두었으니 참고하세요. ## 설치 실패 | 증상 | 해결 | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------- | | `DNS 확인 실패` 또는 `연결 실패 / 시간 초과` | 네트워크를 확인하세요. 제한된 네트워크에서는 미러를 전환하거나 [수동 다운로드](/ko/cli/install#수동-다운로드)에서 바이너리를 직접 가져오세요 | | `다운로드 실패(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 기기` | [기기](/ko/account/devices) 페이지에서 오래된 기기를 해지하세요 | | `선택한 조직에 바인딩된 계정이 없습니다` | 승인 페이지에서 다른 조직을 선택하거나 지원에 문의하세요 | | **승인 버튼이 회색 / 클릭 불가** | 계정이 아직 조직이나 요금제에 배정되지 않았습니다 — [reclaude.ai](https://reclaude.ai) 에서 구독을 시작하거나 운영팀에 개통을 요청한 뒤 다시 돌아와 승인하세요 | ## claude 실행 시 오류 | 증상 | 해결 | | -------------------- | ------------------------------------------------------------------ | | 셸이 `reclaude`를 찾지 못함 | 설치 후 새 터미널을 열지 않았습니다; 새 터미널을 열거나 셸 rc를 `source` 하세요 | | 셸이 `claude`를 찾지 못함 | Claude Code CLI가 설치되지 않았습니다; 설치 스크립트를 다시 실행해 Claude Code를 설치하게 하세요 | | `reclaude`가 즉시 종료됨 | `reclaude status`를 확인하세요; 데몬이 실행 중이 아니면 `reclaude`를 다시 실행하세요 | | 반복되는 `401 / 403` 오류 | 세션 만료일 가능성 — `reclaude login`을 다시 실행하세요 | ## 런타임 오류 | 증상 | 해결 | | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | `401 device_revoked` / 서버가 계속 내 기기를 해지함 | [기기 → 자동으로 해지된 기기](/ko/account/devices) 참조 | | `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 설정](/ko/cli/commands#gateway-설정) 참조) | ## 결제 관련 | 증상 | 해결 | | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 결제 완료했지만 주문이 여전히 **대기 중**으로 표시 | 일반적으로 결제 채널 콜백이 1–3분 이내에 동기화됩니다; 그래도 변경되지 않으면 [reclaude.ai](https://reclaude.ai) → **재무** 에 주문번호와 함께 티켓을 제출하세요 | | 결제 완료했지만 주문이 **만료**로 표시 | 채널에서는 결제되었지만 콜백이 실패한 경우입니다 — 결제 스크린샷과 주문번호를 첨부해 티켓을 제출하세요; 운영팀 확인 후 재반영 또는 환불 처리됩니다 | | 같은 결제로 주문이 두 건 생성됨 | 다시 결제하지 마세요; 티켓을 제출해 운영팀에 통합을 요청하세요 | | 결제는 성공했는데 홈페이지에 여전히 **미구독** / 사용 가능한 플랜 없음으로 표시 | 대개 상단에서 잘못된 조직을 선택한 경우입니다 — 플랜은 자신이 속한 조직에 있으므로 `reclaude org use `로 해당 조직으로 전환(또는 웹에서 상단 조직 전환)한 뒤 터미널을 다시 여세요; 상태 동기화가 가끔 잠깐 지연될 수 있으니 잠시 후 새로고침하세요 | ## 홈페이지 알림 | 알림 | 의미 | 해결 | | ------------------ | ------------------------------------ | ------------------------------------- | | **계정 차단됨** | 할당된 계정이 Anthropic에 의해 제재됨 | 시스템이 **자동으로 계정을 교체**합니다 — 잠시만 기다려 주세요 | | **검토 필요** | 계정이 예외 상황에 도달; 지원이 해결할 때까지 서비스 일시 중지 | 지원을 기다리거나 상태에 대한 티켓을 여세요 | | **구독 만료 예정 / 만료됨** | 갱신 윈도우 도달 | 갱신 배너를 클릭해 결제하세요 | ## 로그 읽기 ```bash theme={null} reclaude logs # 데몬 로그의 끝부분 ``` 전체 로그 파일: `~/.reclaude/logs/reclaude.log`. ## 그래도 막혔나요? [reclaude.ai](https://reclaude.ai)에서 로그인한 다음 **티켓 → 새로 만들기**에서 제출: * **기술**: 연결 문제, CLI 오류, 데몬이 시작되지 않음 * **결제**: 주문, 환불, 청구서 * **기타**: 피드백 또는 제안