Junie CLI

Junie CLI 將自訂端點作為 JSON 設定檔放在 $JUNIE_HOME/models/，其中 baseUrl 是完整端點 URL，fasterModel 決定輔助流量的去向。

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

逐步操作

1. 在 /app/keys 建立金鑰並複製 — 它只會顯示一次。請在啟動 Junie 的 shell 中將其匯出為 KUNAVO_API_KEY，或改為在檔案中直接填入金鑰；JetBrains 指出：「沒有任何 $${...} 參照的值會直接照原樣使用。」
2. 將上方的 JSON 儲存為你帳戶中的 $JUNIE_HOME/models/kunavo.json，或儲存為 .junie/models/kunavo.json 以與儲存庫共用。移除 .json 副檔名後的檔名會成為 profile id——下方選擇器顯示 custom:kunavo，就是由此而來。
3. 將 id 設為您實際要使用的模型 ID。其定義為「API 端點預期使用的模型識別碼」，因此可直接填入下方表格中的 Kunavo slug；ID 會由端點解析，而不是由 Junie 解析。
4. 啟動 Junie 並選取設定檔：junie --model custom:kunavo，或在互動式工作階段中使用 /model 指令。自訂模型「會在內建供應商之後出現在模型選取清單中」。
5. 交給它一項會編輯檔案的任務，而不是只打招呼。Junie 是代理型用戶端，幾乎所有工作都仰賴工具呼叫；因此，第一次執行時讓它讀取並寫入內容，比只收到單一回覆更能說明實際狀況。

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

除錯用戶端前先驗證

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

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

Kunavo 支援的另外兩種 apiType 值

apiType 指的是請求格式，而非供應商；Junie 接受四種值：OpenAICompletion、OpenAIResponses、Google 和 Anthropic。Kunavo 提供三種路由，因此其他三種值中有兩種在此處有對應的 baseUrl；而且由於 Junie 不會附加路徑，變更格式時也必須在同一次編輯中更改 URL：

1. "apiType": "OpenAICompletion" 搭配 https://api.kunavo.com/v1/chat/completions——也就是上方的設定檔。本文推薦這種組合，因為在三種路由中，這條路由的實際使用最廣泛。
2. "apiType": "Anthropic" 搭配 https://api.kunavo.com/v1/messages——Kunavo 會在該路徑提供 Messages 格式。
3. "apiType": "OpenAIResponses" 搭配 https://api.kunavo.com/v1/responses。

三種 Junie 驅動方式中，哪一種最適合特定模型，必須透過執行階段測試才能解答，光看文件無法判斷，因此本頁不會在首行之外為它們排名。選擇一種方式，讓 URL 與 apiType 保持一致；如果使用已設定金鑰的設定檔時收到 401，請明確指定憑證，不要臆測 Junie 使用的標頭格式：JetBrains 對 apiKey 的說明只有否定情況 —「若省略，請求將不包含 Authorization 標頭」— 並未說明填入時會使用哪種格式。文件將 extraHeaders 定義為「要加入每個請求的額外 HTTP 標頭」，且支援相同的 $${VAR} 參照，因此使用 "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} 是最明確的方式。