Skip to Content
aicentos

Paseo

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

最後更新於:

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

準備工作

先裝 Paseo,並至少準備一個底層 CLI:

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_URLhttps://aicentos.com
env.ANTHROPIC_API_KEY控制台建立的 Key
models控制台「模型廣場」中的模型名

設定步驟

編輯 ~/.paseo/config.json:

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

改完重新載入:

paseo reload

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

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

測試

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

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

注意事項

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

相關連結