> ## 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 CLI의 모든 하위 명령어 (login, logout, status, stop, update, uninstall, config, logs, version, org, help)와 일상적인 데몬 시작 명령어의 사용법, 매개변수, 일반적인 흐름.

## 하위 명령어

| 명령어                       | 동작                                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `reclaude`                | 데몬을 시작하고 Claude Code 실행(일상 명령어)                                                                                           |
| `reclaude app`            | reclaude가 할당한 계정으로 Claude Desktop 실행(전용 플랜, 비공개 베타); 첫 실행 / 시작 시 필요한 Claude Desktop을 자동으로 다운로드하고 업데이트(macOS / Windows 전용) |
| `reclaude app-reset`      | Claude Desktop 로그인 상태 재설정(쿠키 / 캐시 삭제, reclaude 자체에는 영향 없음)                                                                |
| `reclaude app-update`     | 로컬 Claude Desktop을 확인하고 업데이트; `--check`를 추가하면 다운로드 없이 확인만                                                                 |
| `reclaude login`          | 브라우저 디바이스 플로우 로그인, 이 컴퓨터 바인딩                                                                                              |
| `reclaude logout`         | 마지막 로그인 이전의 Claude Code 설정 복원                                                                                             |
| `reclaude org`            | 이 기기의 조직을 보거나 전환                                                                                                          |
| `reclaude config gateway` | 연결에 사용하는 gateway를 보기·고정·재설정                                                                                               |
| `reclaude status`         | 데몬 상태와 claude 경로 출력                                                                                                       |
| `reclaude stop`           | 백그라운드 데몬 중지 및 비활성화                                                                                                        |
| `reclaude update`         | reclaude 확인 및 업그레이드(`--check`는 확인만)                                                                                       |
| `reclaude setup`          | reclaude를 표준 디렉터리에 복사하고 PATH에 추가(바이너리를 수동으로 다운로드한 경우 사용)                                                                  |
| `reclaude unsetup`        | `reclaude setup`이 표준 디렉터리와 PATH에 적용한 변경을 되돌림                                                                              |
| `reclaude uninstall`      | 데몬을 중지하고 모든 로컬 상태 삭제                                                                                                      |
| `reclaude version`        | 현재 버전 출력                                                                                                                  |
| `reclaude logs`           | 데몬 로그의 끝부분 출력                                                                                                             |
| `reclaude help`           | 도움말 텍스트 출력                                                                                                                |

<Tip>
  하위 명령어 없는 `reclaude` = 데몬 시작 후 Claude Code 열기. 일상적인 사용법입니다.
</Tip>

## 일반적인 흐름

**처음 설정:**

```bash theme={null}
reclaude login   # 브라우저에서 한 번 인증
reclaude         # 데몬 시작 + Claude Code 열기
```

**서비스 일시 중지:**

```bash theme={null}
reclaude stop    # 데몬 중지; reclaude를 다시 실행하면 시작됩니다
```

**업그레이드:**

```bash theme={null}
reclaude update
```

**완전 제거:**

```bash theme={null}
reclaude uninstall
```

## 조직 전환

```bash theme={null}
reclaude org list           # 모든 조직과 기기의 현재 바인딩 나열
reclaude org use <org_id>   # 이 기기를 지정된 조직으로 전환
```

다음 요청은 새 조직의 계정을 사용합니다.

## 로그

로그 파일 위치: `~/.reclaude/logs/daemon.log`. 끝부분은 `reclaude logs`로 출력하세요.

## gateway 설정

`gateway`는 reclaude가 서비스에 접속하는 진입점입니다. 기본적으로 데몬은 시작 시 후보 목록을 탐색하여 가장 빠른 것을 선택합니다(auto 모드). 특정 URL에 고정하려면 수동으로 설정할 수 있습니다(manual 모드).

| 하위 명령어                                        | 동작                                         |
| --------------------------------------------- | ------------------------------------------ |
| `reclaude config gateway`                     | 모든 후보를 대화식으로 탐색하고 선택을 수동 설정으로 저장           |
| `reclaude config gateway test [url]`          | 탐색만 하고 저장하지 않음. url을 지정하면 하나를, 없으면 전체를 테스트 |
| `reclaude config gateway set [--force] <url>` | 직접 설정. 기본은 먼저 탐색으로 검증, `--force`는 탐색 건너뜀   |
| `reclaude config gateway current`             | 현재 적용 중인 gateway와 출처 출력                    |
| `reclaude config gateway reset`               | 수동 설정을 지우고 auto로 복귀                        |

**대화식으로 가장 빠른 것 선택:**

```bash theme={null}
reclaude config gateway
```

각 후보의 도달 가능 여부와 지연 시간이 실시간으로 출력됩니다. Enter는 가장 빠른 것 선택, 번호 입력은 특정 항목 선택, `q`는 취소입니다.

**현재 적용 중인 것 확인:**

```bash theme={null}
reclaude config gateway current
```

`url`(실제 사용 중인 URL), `source`(`RECLAUDE_GATEWAY_URL` / `device.json` / `default`), `mode`(`manual` 또는 `auto`)를 출력합니다.

**auto로 재설정:**

```bash theme={null}
reclaude config gateway reset
```

<Note>
  저장 시 데몬이 실행 중이면 `reclaude stop && reclaude`를 실행해야 적용됩니다.

  환경 변수 `RECLAUDE_GATEWAY_URL`은 로컬 설정보다 우선합니다.
</Note>