Nanocoder

在 agents.config.json 的 nanocoder.providers 下新增 Custom Provider 項目 — name、baseUrl、apiKey、models — 不需要 sdkProvider，因為預設就是 openai-compatible。

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

逐步操作

1. 在 /app/keys 建立金鑰並複製 — 金鑰只會顯示一次。請將金鑰匯出為 KUNAVO_API_KEY，不要直接貼入檔案：Nanocoder 會在服務商項目的每個字串中遞迴替換 $VAR、${VAR} 和 ${VAR:-default}，並從工作目錄讀取 .env。
2. 在 Nanocoder 中執行 /settings providers，然後選取 Custom Provider。精靈會依序詢問 Provider name、Base URL、API key (optional)、Model names 和 Request timeout，並提供從端點擷取模型清單的選項 — Kunavo 會回應 GET /v1/models，因此可自動填入該清單。
3. 你也可以略過精靈，直接依照上方區塊自行編寫 agents.config.json。請注意，設定會以檔案為單位解析：若專案層級的檔案定義了 nanocoder.providers，就會採用該整個區塊，因此全域設定檔中的項目不會合併到其中。
4. 設定上下文視窗。Nanocoder 依序從 /context-max、contextWindows[model]、contextWindow、NANOCODER_CONTEXT_LIMIT 和 models.dev 解析上限 — Kunavo 不是 models.dev 上的服務商，因此若未設定前四者之一，預算會依據並非你所用模型的備援值計算。數值請見 /models。
5. 開啟 /model，選取你列出的其中一個 ID — 選擇器會在你指定的 name 下顯示這些 ID — 然後執行一項需要呼叫工具的小型工作。如果特定模型傳回格式錯誤的工具呼叫，disableToolModels 可以針對該模型停用此功能，而非針對整個服務商停用。

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

除錯用戶端前先驗證

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

# 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 權杖的美元價格，輸入／輸出。