> ## 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.

# Pi

> 配置 PI CLI、~/.pi/agent/auth.json 與訂閱授權。

Pi 走本機 `pi`。認證和模型留在 `~/.pi/`。開啟 **設定 → CLI配置管理 → PI CLI** 檢測版本、安裝，並配置憑證。

## 接入方式

1. 在該頁覆蓋 `pi` 可執行檔案路徑（可選）
2. 在 **供應商認證** 裡填 API Key，或點 **登入** 走訂閱授權
3. 未安裝時在該頁點 **安裝**，或按下面的終端命令安裝

<Note>
  配置只存在你的電腦上。客戶端不會把 Key 上傳到 CC GUI 自己的伺服器。
</Note>

## 供應商認證

### API Key

寫入 `~/.pi/agent/auth.json`（許可權 `0600`），優先順序高於環境變數。

常用項包括 Anthropic、OpenAI、Google Gemini、DeepSeek、xAI、OpenRouter、Groq、Mistral、智譜、Kimi For Coding、Qwen、MiniMax。其餘供應商摺疊在 **顯示全部**。

### 訂閱授權

點 **登入**：客戶端開啟內建終端啟動 `pi`，再傳送 `/login anthropic` 這類命令。也可以自己在系統終端執行 `pi /login`。

客戶端不代你走 OAuth，只讀 `auth.json` 狀態。支援：

* Claude Pro / Max（`pi /login anthropic`）
* ChatGPT Plus / Pro (Codex)（`pi /login openai`）
* GitHub Copilot
* xAI
* OpenRouter
* Radius

### 解析順序

`--api-key` → `auth.json` → 環境變數 → `models.json`

## 安裝

```bash theme={null}
curl -fsSL https://pi.dev/install.sh | sh
pi --version
```

備選：

```bash theme={null}
npm install -g @earendil-works/pi-coding-agent
```

應用內 **安裝** 預覽的是備選裡的 `npm install -g @earendil-works/pi-coding-agent`。

文件：[https://pi.dev/docs/latest/usage](https://pi.dev/docs/latest/usage)

## 能力差異

相對 Claude Code：

* 沒有規劃模式
* 不走客戶端 MCP
* 支援推理強度、會話續寫與圖片輸入
* 停止按鈕會結束 `pi` 子程序
* 歷史按 runtime 隔離

## 檢測失敗時

見 [檢測與安裝](/zh-Hant/desktop/providers/cli)。

## 下一步

* [多供應商總覽](/zh-Hant/desktop/providers/overview)
* [發出第一條訊息](/zh-Hant/desktop/start/first-task)