文件
整合
Kunavo 支援每款主流用戶端都已支援的兩種線路格式,因此只需設定 base URL 和金鑰,不必安裝 SDK。以下是各用戶端的設定方式。
Kunavo 是獨立且相容於 OpenAI 的 AI API 閘道:使用一組 API 金鑰和一筆隨用隨付餘額,即可呼叫 Claude、GPT 以及圖像、影片和音訊模型,無須為各家供應商個別註冊帳戶。 不需要安裝 Kunavo SDK:任何有 base URL 欄位的用戶端都能使用。將 OpenAI 相容用戶端指向 https://api.kunavo.com/v1,或將 Anthropic 類用戶端指向 https://api.kunavo.com,再填入 Kunavo 金鑰即可。
/v1 上有所不同:OpenAI SDK 需要將它放在 base_url 中,而 Anthropic 用戶端會自行附加 /v1/messages,因此只需要來源網址。設定錯誤是最常見的故障原因——請參閱 ANTHROPIC_BASE_URL 頁面。下方各頁會說明該用戶端需要哪一種格式,以及上次依據該用戶端文件查核其設定的日期。程式開發代理、編輯器和 CLI
這些用戶端都有自訂供應商欄位,而且都將「OpenAI 相容」或「Anthropic」視為一種協定,而非供應商——因此在 OpenAI 相容供應商中輸入 Claude 模型 ID 是預期用法,不是權宜之計。
在 ~/.openclaw/openclaw.json 中新增一筆 models.providers 設定,指定 baseUrl https://api.kunavo.com、api "anthropic-messages",即可讓常駐執行的 OpenClaw 代理使用 Claude;並在旁設定 cacheRetention,因為自訂 Anthropic 端點在設定此參數之前,不會收到任何快取標記。
在 ~/.hermes/config.yaml 中新增具名供應商,設定 api https://api.kunavo.com、transport anthropic_messages,並以 provider: custom:kunavo 選取後,Hermes Agent 就會透過 Messages 協定使用 Claude,並自行傳送快取標記及輸出上限。
兩個環境變數 — ANTHROPIC_BASE_URL 與 ANTHROPIC_AUTH_TOKEN — 無需變更安裝方式,即可讓 Claude Code 改用隨用隨付。
Providers → Custom provider → OpenAI Compatible,設定帶有 /v1 的基礎 URL,並輸入 Claude 模型 ID — Kilo Code 不會知道背後是哪家供應商。
選擇 OpenAI Compatible 供應商,貼上基礎 URL 與金鑰,並設定模型的上下文視窗與最大輸出,讓 Roo Code 的預算計算正確。
Cline 的 OpenAI Compatible 供應商需要基礎 URL、金鑰與模型 ID,另加上它用來顯示工作階段即時成本的各模型價格。
在 ~/.codex/config.toml 中設定 [model_providers.kunavo] 區塊與 env_key,讓金鑰留在環境變數中,永不出現在設定檔。
在 opencode.json 中設定一個供應商區塊 — 聊天完成使用 @ai-sdk/openai-compatible,需要 /v1/responses 介面時使用 @ai-sdk/openai。
CCR 現在是桌面應用程式,不再使用 config.json:將 Kunavo 新增為自訂 API 端點,接著讓路由規則將每種請求類別傳送至不同模型。
settings.json 中的 language_models.openai_compatible 區塊宣告端點與模型;金鑰放在 Agent Panel UI 中,絕不放入檔案。
Continue 的 `openai` 供應商名稱代表協定而非廠商:提供 apiBase,並為每個模型 — 聊天、編輯、自動完成 — 在 config.yaml 中建立一個項目。
設定 OPENAI_API_BASE 與 OPENAI_API_KEY,然後執行 `aider --model openai/<id>` — 這個前綴會將 ID 路由至你的端點,而不是 Aider 的供應商表。
新增 Kunavo 為 Custom Configuration:以服務根目錄作為端點,將 ANTHROPIC_AUTH_TOKEN 設為驗證欄位,使用原生 Anthropic Messages — Claude Code 端不需要本機路由。
不存在 base_url 選項 — SDK 會啟動 Claude Code CLI 並傳遞完整環境,因此可由 ANTHROPIC_BASE_URL 路由,或透過 ClaudeAgentOptions(env=...) 為每個用戶端設定。
在 Amp 的 Model Routing 中新增 Custom URL 連線 — API format 設為 chat-completions,base URL 為 https://api.kunavo.com/v1,金鑰作為 bearer token — 在支援該選項的層級上,將已對應的模型切換至同一個金鑰。
四個環境變數 — COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_TYPE、COPILOT_PROVIDER_API_KEY 與 COPILOT_MODEL — 將 Copilot CLI 移至你自己的端點;GitHub 文件指出 BYOK 不需要 GitHub 登入。
Crush 的設定使用 Bash — 在 crushrc 中執行一行 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`,即可讓 Charm 的終端代理使用 Claude 與 GPT。
Settings → Models → “Add model provider” → “Custom model API” 需要五個欄位 — Provider ID、display name、base URL、API protocol 與 API key — 讓 Claude 與 GPT 和內建 DeepSeek 卡片出現在同一個選擇器中。
Dyad 可透過 Settings → AI Providers → Add Custom Provider 使用任何 OpenAI 相容端點:API Base URL 設為 https://api.kunavo.com/v1,金鑰填在供應商自己的頁面,然後每個模型 ID 新增一列 Add Custom Model。
在 ~/.factory/settings.json 中設定 customModels 項目 — model、baseUrl 與 provider — 讓 Droid 使用任何支援 Anthropic Messages 或 OpenAI Chat Completions 的端點。
Settings → Models → Configure providers → OpenAI:Host URL 填寫純 origin,因為 goose 會自行附加請求路徑(v1/chat/completions)。
執行一行 `jan config set --base-url https://api.kunavo.com/v1`,即可將 Kunavo 寫入 ~/.jan/config.toml;Jan Agent 預覽 CLI 本身不含推理引擎,會使用該金鑰執行。
Junie CLI 將自訂端點作為 JSON 設定檔放在 $JUNIE_HOME/models/,其中 baseUrl 是完整端點 URL,fasterModel 決定輔助流量的去向。
Kimi Code 將供應商保存在 ~/.kimi-code/config.toml — 將 providers.<name>.base_url 設為 https://api.kunavo.com/v1,並設定 type = "openai",CLI 即可透過一組金鑰執行 Claude 與 GPT ID。
mini-SWE-agent 沒有基礎 URL 環境變數 — 端點放在 YAML 設定中的 model.model_kwargs.api_base 下,mini 會將其直接傳給 litellm.completion。
在 .vibe/config.toml 中設定五行 [[providers]] 區塊 — api_base、api_key_env_var、api_style — 將 Vibe CLI 指向 Kunavo,金鑰存於環境變數而非檔案。
Settings > Model Providers 需要 Base URL 與 API key — 共五個文件化欄位,其中兩個需要你透過測試決定 Msty Go 的設定。
在 agents.config.json 的 nanocoder.providers 下新增 Custom Provider 項目 — name、baseUrl、apiKey、models — 不需要 sdkProvider,因為預設就是 openai-compatible。
在 ~/.omp/agent/models.yml 中設定供應商區塊 — baseUrl、api、apiKey — 將 Oh My Pi 指向 Kunavo,並透過 GET /v1/models 自動填入模型清單。
在 ~/.openinterpreter/config.toml 中設定一個 [model_providers.kunavo] 表格 — base_url、env_key、wire_api = "chat" — Rust 終端代理即可執行金鑰可存取的任何模型。
Settings → LLM → Advanced 需要三個欄位 — Custom Model、Base URL、API Key — 模型 ID 帶有 openai/ 前綴,Base URL 保留 /v1。
在 ~/.pi/agent/models.json 中設定自訂供應商區塊 — baseUrl、api 與模型 ID — 讓 Earendil 的 Pi 終端程式設計代理透過一組金鑰使用 Claude 與 GPT。
Qoder Settings → Models → + Add → Provider → Custom 需要 OpenAI 相容 Base URL、API Key 與手動輸入的 Model IDs — 因此獨立 Qoder 桌面應用程式可連線至 Claude 與 GPT,而這兩者都不在其自身目錄中。
Qwen Code 從 ~/.qwen/settings.json 的 modelProviders 讀取端點 — 一個包含 baseUrl 與 envKey 的項目,即可讓 Claude 與 GPT 出現在其 /model 選擇器中。
在 ai-features.openAiCustom.customOpenAiModels 中新增一個項目 — model、url 與 apiKey — 即可讓 Theia Coder、Architect 與行內完成使用 Kunavo。
twinny 沒有基礎 URL 欄位 — Add provider → OpenAI-compatible server,接著設定 Protocol https、Hostname api.kunavo.com、Port 留白、API path /v1,聊天面板即可使用你的金鑰。
聊天用戶端與自架介面
桌面應用程式和自架前端的優勢,在於透過單一模型選擇器共用一把金鑰和同一筆餘額,不必為每家供應商各設一個帳戶。
在 Admin Settings 中新增一個 OpenAI 連線,或在容器啟動時設定 OPENAI_API_BASE_URL 與 OPENAI_API_KEY — 兩者最終都指向同一個 /v1。
Settings → Model Services → 自訂供應商:貼上金鑰與 API 位址,按下 Get Model List,整個目錄就會填入選擇器。
新增一個類型為 OpenAI API Compatible 的供應商,將 API Host 設為服務根目錄 — Chatbox 會自行附加 /v1/chat/completions。
三個環境變數 — OPENAI_API_KEY、OPENAI_PROXY_URL 與 OPENAI_MODEL_LIST — 將 Claude 與 GPT 放入同一個自託管 LobeChat 選擇器。
將 SillyTavern 的 Chat Completion 來源指向 Kunavo,設定自訂端點與一組 API 金鑰 — Claude 與 GPT 會出現在同一個模型下拉選單中。
API Settings → Proxy → Add Configuration:Proxy URL 是完整的 /v1/chat/completions 路徑,Model Name 必須精確符合目錄 ID。
Ollama 與 Kunavo 的 OpenAI 相容介面形狀相同,因此為本機 Ollama 編寫的工具只需變更基礎 URL 即可切換。
AnythingLLM 透過名為 Generic OpenAI 的供應商連線至沒有專用供應商的端點 — Base URL 加上 /v1、金鑰與手動輸入的模型 ID,因為它不會取得模型清單。
Settings → Providers → "+" 透過三個欄位建立自訂供應商 — Provider name、設為 https://api.kunavo.com/v1 的 API Base URL,以及 API Key — 然後 Fetch 從端點讀取模型清單。
一個必要欄位 — OpenAI-API-compatible 外掛 Add Model 表單中的 API Base URL — 可將 Dify 工作區中的每個 LLM 節點指向 Kunavo。
LibreChat 在 librechat.yaml 中以 endpoints.custom 區塊設定閘道 — 四個必要欄位,金鑰來自 .env,並須重新啟動後選擇器才會顯示。
Model Hub > Model Providers > Add Provider > Open AI Compatible:設定 API Key 與 https://api.kunavo.com/v1 的 Inference Endpoint — 應用程式自己的說明指出,大多數 OpenAI 相容端點需要 /v1。
OpenAI 憑證的 Base URL 欄位 — https://api.kunavo.com/v1,保留 /v1 — 可讓 n8n 工作流程中的所有 OpenAI Chat Model 使用 Kunavo;模型節點本身沒有端點欄位。
三個環境變數 — OPENAI_API_KEY、BASE_URL(純 origin)與 CUSTOM_MODELS — 讓自託管 NextChat 透過一組金鑰使用 Claude 與 GPT。
Settings → Copilot → BYOK → Add a custom provider:設定 Display name、你的金鑰與 https://api.kunavo.com/v1 — 一律支援 Quick Chat,若供應商顯示在 opencode 中,也支援 Agent Chat。
Settings → OpenAI Compatible API → Add Provider → Custom:設定 Provider Name、保留 /v1 的 Base URL 與金鑰,然後從 Page Assist 自行取得的清單中勾選模型 ID。
Models → Add custom model:完整 Endpoint URL https://api.kunavo.com/v1/chat/completions、包含 Bearer 與你的金鑰的 Authorization 標頭、Model ID 及其上下文長度 — 每個模型一個項目,直接從瀏覽器呼叫。
其他用戶端
此處未列出的用戶端幾乎也都能使用。關鍵在於它是否允許您變更端點:如果有「base URL」、「自訂端點」或「OpenAI 相容供應商」設定,就能使用 Kunavo。請從快速入門開始,再依用戶端支援的格式參閱聊天完成 API或Messages API。模型 ID 來自 GET /v1/models,也會填入有模型下拉式選單的用戶端;完整的機器可讀介面規格是 OpenAPI 3.1 描述文件,大多數用戶端產生器和代理程式框架都能直接使用。