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.
설치 실패
| 증상 | 해결 |
|---|
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 에서 구독을 시작하거나 운영팀에 개통을 요청한 뒤 다시 돌아와 승인하세요 |
claude 실행 시 오류
| 증상 | 해결 |
|---|
셸이 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에서 로그인한 다음 티켓 → 새로 만들기에서 제출:
- 기술: 연결 문제, CLI 오류, 데몬이 시작되지 않음
- 운영 → 계정 전환: 할당된 계정이 사용 불가
- 결제: 주문, 환불, 청구서
- 기타: 피드백 또는 제안