# Paseo

來源: https://docs.aicentos.com/zh-TW/clients/paseo

Language: zh-TW

> 在 Paseo 裡接入 aicentos —— 它不直連模型，要在底層 CLI 或 provider env 裡設定

Paseo 是編排層：桌面端、行動裝置端、Web 和 `paseo` CLI 都在，但**它自己不含 agent**，只負責執行你已安裝並登入好的編碼 CLI（Claude Code、Codex、OpenCode、Pi 等）。所以「在 Paseo 裡接入 aicentos」實際上是讓被託管的那個 CLI 走 aicentos。

## 準備工作

先裝 Paseo，並至少準備一個底層 CLI：

```bash
npm install -g @getpaseo/cli
paseo
```

桌面端與行動裝置端從官網下載。注意 Docker 映像檔不含任何 agent CLI，容器部署要自己安裝。

## 需要填寫的設定

Paseo 的 provider 定義在 `~/.paseo/config.json` 的 `agents.providers.<id>`，欄位是 `extends`、`label`、`env`、`models`。**它支援的是給底層 CLI 注入環境變數**，官方範例都是 Anthropic 相容協議：

| 欄位                       | 值                      |
| ------------------------ | ---------------------- |
| `extends`                | 底層 CLI，例如 `claude`     |
| `env.ANTHROPIC_BASE_URL` | `https://aicentos.com` |
| `env.ANTHROPIC_API_KEY`  | 控制台建立的 Key             |
| `models`                 | 控制台「模型廣場」中的模型名         |

## 設定步驟

編輯 `~/.paseo/config.json`：

```json
{
  "agents": {
    "providers": {
      "aicentos-claude": {
        "extends": "claude",
        "label": "aicentos",
        "env": {
          "ANTHROPIC_BASE_URL": "https://aicentos.com",
          "ANTHROPIC_API_KEY": "sk-你的-API-Key"
        }
      }
    }
  }
}
```

改完重新載入：

```bash
paseo reload
```

然後在 Paseo 裡把工作階段的 provider 選成 `aicentos`。

如果你託管的是 OpenAI 協議的 CLI（例如 Codex），把 `env` 換成對應 CLI 自己的變數（`OPENAI_BASE_URL`、`OPENAI_API_KEY`），Base URL 用 `https://aicentos.com/v1`。

## 測試

```bash
paseo run --provider aicentos-claude "用一句话自我介绍"
```

能返回即通。也可以直接在桌面端新建工作階段、看模型標籤是否顯示你設定的 provider。

## 注意事項

* **Paseo 本身沒有模型設定**。找不到 Base URL 輸入框是正常的，去底層 CLI 或 `env` 裡找。
* 官方文件只給了 Anthropic 相容的欄位範例，OpenAI 相容端點的寫法沒有明文規定，按底層 CLI 的變數名來寫、以實測為準。
* `env` 會覆寫底層 CLI 已儲存的登入狀態，設定錯誤會導致原本能用的工作階段也失敗，建議新開一個 provider 而不是改預設那條。
* 必須先完成底層 CLI 的驗證，Paseo 不代你登入。

## 相關連結

* [Paseo 自訂 provider 文件](https://paseo.sh/docs/custom-providers)
* [paseo 儲存庫](https://github.com/getpaseo/paseo)