> ## 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="/zh-Hant/desktop/providers/claude">
    託管供應商、本地 `settings.json`、CLI 登入。
  </Card>

  <Card title="Codex" href="/zh-Hant/desktop/providers/codex">
    `~/.codex/` 與沙箱。
  </Card>

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

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

  <Card title="OpenCode" href="/zh-Hant/desktop/providers/opencode">
    `opencode.json`，環境注入不改本地檔案。
  </Card>

  <Card title="Pi" href="/zh-Hant/desktop/providers/pi">
    `auth.json` 與 `/login`。
  </Card>

  <Card title="DeepSeek Harness" href="/zh-Hant/desktop/providers/dsh">
    host / port 與 Web UI。
  </Card>

  <Card title="多供應商總覽" href="/zh-Hant/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`