> ## 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`                | 启动后台 daemon 并跑 Claude Code（日常用法）                                                                  |
| `reclaude app`            | 用 reclaude 分配的账号启动 Claude Desktop（独享套餐，内测中）；首次 / 启动时会自动下载并更新所需的 Claude Desktop（仅 macOS / Windows） |
| `reclaude app-reset`      | 重置 Claude Desktop 登录态（清 cookies / 缓存，不影响 reclaude 自身）                                             |
| `reclaude app-update`     | 检查并更新本地的 Claude Desktop；加 `--check` 只检查不下载                                                        |
| `reclaude login`          | 浏览器设备流登录、绑定本机                                                                                     |
| `reclaude logout`         | 恢复最近一次 login 之前的 Claude Code 配置                                                                   |
| `reclaude org`            | 查看或切换当前设备所属组织                                                                                     |
| `reclaude config gateway` | 查看 / 锁定 / 重置接入用的 gateway                                                                          |
| `reclaude status`         | 打印 daemon 状态和 claude 路径                                                                           |
| `reclaude stop`           | 停止并禁用后台 daemon                                                                                    |
| `reclaude update`         | 检查并升级 reclaude（加 `--check` 只检查不下载）                                                                |
| `reclaude setup`          | 把 reclaude 复制到标准目录并加进 PATH（手动下载二进制时用）                                                             |
| `reclaude unsetup`        | 撤销 `reclaude setup` 写入的标准目录与 PATH 修改                                                              |
| `reclaude uninstall`      | 停 daemon 并清除所有本地状态                                                                                |
| `reclaude version`        | 打印当前版本                                                                                            |
| `reclaude logs`           | 打印 daemon 日志的末尾几行                                                                                 |
| `reclaude help`           | 打印帮助文本                                                                                            |

<Tip>
  跑 `reclaude` 不带子命令 = 后台启动 daemon + 直接打开 Claude Code，这是日常用法。
</Tip>

## 常用流程

**首次接入：**

```bash theme={null}
reclaude login   # 浏览器授权一次
reclaude         # 启动 daemon + 打开 Claude Code
```

**临时停服务：**

```bash theme={null}
reclaude stop    # 停 daemon；下一次跑 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 接入服务的入口。默认情况下 daemon 启动时会自动探测多个候选并选最快的（auto 模式）；如果你想锁定到指定线路，可以手动设置（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
```

会实时打印每个候选的可用性和延迟，回车=最快，输入编号=指定，`q`=取消。

**查看当前生效：**

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

输出 `url`（实际生效的 URL）、`source`（来源：`RECLAUDE_GATEWAY_URL` / `device.json` / `default`）和 `mode`（`manual` 或 `auto`）。

**重置回自动选择：**

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

<Note>
  保存后如果 daemon 正在运行，需要 `reclaude stop && reclaude` 重启才会生效。

  环境变量 `RECLAUDE_GATEWAY_URL` 优先级最高，设置后会盖过本地配置。
</Note>