> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 检测与安装

> 检测本机 CLI、确认安装计划，以及 PATH 与自定义路径排障。

打开 **设置 → CLI配置管理**，在左侧选一条引擎。客户端会检测本机二进制，并提供 **安装** / **更新**。点下去会先出示计划，确认后再执行。**不会静默替你跑安装脚本。**

凭证、供应商和能力差异写在各引擎页，本页只讲检测、安装入口和排障。

<Columns cols={2}>
  <Card title="Claude Code" href="/desktop/providers/claude">
    托管供应商、本地 `settings.json`、CLI 登录。
  </Card>

  <Card title="Codex" href="/desktop/providers/codex">
    `~/.codex/` 与沙箱。
  </Card>

  <Card title="Kimi" href="/desktop/providers/kimi">
    `~/.kimi-code/config.toml`。
  </Card>

  <Card title="Grok" href="/desktop/providers/grok">
    `~/.grok/config.toml`；Windows 用 WSL。
  </Card>

  <Card title="OpenCode" href="/desktop/providers/opencode">
    `opencode.json`，环境注入不改本地文件。
  </Card>

  <Card title="Pi" href="/desktop/providers/pi">
    `auth.json` 与 `/login`。
  </Card>

  <Card title="DeepSeek Harness" href="/desktop/providers/dsh">
    host / port 与 Web UI。
  </Card>

  <Card title="多供应商总览" href="/desktop/providers/overview">
    怎么选、能力差异、配置落盘。
  </Card>
</Columns>

Gemini、Cursor、Copilot、Qwen 等显示在「暂未开放」。本文不写安装步骤。

## 使用流程

<Steps>
  <Step title="选引擎">
    打开 **设置 → CLI配置管理**，点进要装的引擎。
  </Step>

  <Step title="安装">
    点 **安装** 并确认计划，或按该引擎页的终端命令自己装。
  </Step>

  <Step title="确认命令可用">
    新开终端执行对应 `--version`，例如 `claude --version`、`codex --version`、`kimi --version`。
  </Step>

  <Step title="配凭证">
    回到该引擎页：本地配置、托管供应商、Pi 的 `auth.json`，或 DSH Web UI。
  </Step>

  <Step title="在输入框切换">
    状态就绪后即可提问。
  </Step>
</Steps>

## 应用内安装预览的是什么

客户端点 **安装** 时，预览命令因引擎而异：

| 引擎                                 | 预览命令类型                    |
| ---------------------------------- | ------------------------- |
| Claude / Grok                      | 官方安装脚本                    |
| Codex / Kimi / OpenCode / Pi / DSH | `npm install -g …@latest` |

Grok 没有 npm 发行版。Windows 上应用内 **安装** 对 Grok 不可用，请在 WSL 里跑官方脚本。OpenCode 和 DSH 没有应用内卸载，以免误删登录数据或 `$DSH_HOME`。

具体命令见各引擎页的「安装」一节。

## 检测失败时

1. 新开终端确认二进制在 `PATH` 上
2. 从启动器打开的 GUI 有时读不到 shell 的 `PATH`，写入系统环境变量后重启客户端
3. 在该引擎页覆盖自定义 CLI 路径
4. 回到设置重新检测
5. 确认该引擎没有被放进「未启用」分组
6. DSH 还要确认宿主已起来：浏览器打开 `http://127.0.0.1:3080`