Crush

Crush 的設定使用 Bash — 在 crushrc 中執行一行 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`，即可讓 Charm 的終端代理使用 Claude 與 GPT。

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。將金鑰匯出為 KUNAVO_API_KEY，或直接從密碼管理工具在設定檔中讀取。
2. 將上方區塊放入 ~/.config/crush/crushrc。Crush 會依序讀取 ./.crushrc、./crushrc，再讀取全域設定，因此專案設定可以覆寫此電腦的設定——而你複製的儲存庫也可能附帶設定檔。
3. 啟動 crush，並按 ctrl+l 開啟模型選擇器。上方的 model large 和 model small 行已預先指定兩個欄位，因此模型選擇器用來切換模型，而非進行初始設定。
4. 如果不想手動登記 id：當 openai-compat 供應商的模型清單為空，或你傳入 --discover-models true 時，就會執行自動探索。Kunavo 會回應 GET /v1/models，因此模型清單會自動填入；若設定衝突，則以你自行設定的 model add 欄位為準。
5. 執行一項範圍明確的任務，然後查看帳戶在 /app/billing 記錄的費用。終端機顯示的數字是根據你輸入的 --price-* 數值計算得出；實際帳單則以帳務記錄為準。

已於 2026年9月21日 根據 Crush 的自訂供應商章節 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Crush 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。