Documentazione

Documentazione

Integrazioni

Kunavo supporta i due formati di comunicazione già disponibili nella maggior parte dei client professionali, quindi per integrarlo bastano un URL di base e una chiave, senza bisogno di un SDK. Ecco le istruzioni di configurazione per ciascun client.

Kunavo è un gateway API AI indipendente e compatibile con OpenAI: con un’unica chiave API e un saldo a consumo puoi accedere ai modelli Claude, GPT e di immagini, video e audio, senza bisogno di un account per ciascun fornitore. Non c’è alcun SDK di Kunavo da installare: funziona qualsiasi client con un campo per l’URL di base. Indirizza un client compatibile con OpenAI a https://api.kunavo.com/v1 oppure un client in stile Anthropic a https://api.kunavo.com e fornisci una chiave Kunavo.

Le due convenzioni differiscono intenzionalmente per /v1: l’SDK OpenAI lo richiede in base_url, mentre i client Anthropic aggiungono autonomamente /v1/messages e vogliono quindi la sola origine. Invertirli è l’errore di configurazione più comune: consulta la pagina ANTHROPIC_BASE_URL. Ogni pagina qui sotto specifica quale formato richiede il client e la data dell’ultima verifica della configurazione sulla documentazione del client stesso.

Agenti di programmazione, editor e CLI

Tutti questi client dispongono di un campo per un provider personalizzato e considerano «compatibile con OpenAI» o «Anthropic» un protocollo, non un fornitore. Per questo, inserire l’ID di un modello Claude in un provider compatibile con OpenAI è la combinazione prevista, non un espediente.

OpenClawAnthropic

Una voce models.providers in ~/.openclaw/openclaw.json — baseUrl https://api.kunavo.com, api "anthropic-messages" — consente a un agente OpenClaw sempre attivo di usare Claude; cacheRetention è impostato accanto, perché un endpoint Anthropic personalizzato non riceve marcatori di cache finché questa opzione non è configurata.

Hermes AgentAnthropic

Un provider con nome in ~/.hermes/config.yaml — api https://api.kunavo.com, transport anthropic_messages, selezionato con provider: custom:kunavo — consente a Hermes Agent di usare Claude tramite il protocollo Messages, inviando i propri marcatori di cache e il limite di output.

Claude CodeAnthropic

Due variabili d'ambiente — ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN — portano Claude Code su un modello pay-as-you-go senza modificare l'installazione.

Kilo CodeOpenAI

Providers → Custom provider → OpenAI Compatible, URL di base con /v1 e ID del modello Claude inserito — Kilo Code non saprà mai quale fornitore vi sia dietro.

Roo CodeOpenAI

Seleziona il provider OpenAI Compatible, incolla l'URL di base e la chiave, quindi imposta la finestra di contesto e l'output massimo del modello affinché il budget interno di Roo Code sia corretto.

ClineOpenAI

Il provider OpenAI Compatible di Cline accetta un URL di base, una chiave e un ID modello, oltre ai prezzi per modello usati per mostrare il costo corrente della sessione.

Codex CLIOpenAI

Un blocco [model_providers.kunavo] in ~/.codex/config.toml con env_key, così la chiave resta nell'ambiente e non finisce mai nel file di configurazione.

opencodeOpenAI

Un blocco provider in opencode.json — @ai-sdk/openai-compatible per i completamenti chat, @ai-sdk/openai quando vuoi la superficie /v1/responses.

Claude Code RouterAnthropic

CCR è ora un'app desktop, non un config.json: aggiungi Kunavo come endpoint API personalizzato, poi lascia che le regole di routing inviino ogni classe di richiesta a un modello diverso.

ZedOpenAI

Un blocco language_models.openai_compatible in settings.json dichiara l'endpoint e i relativi modelli; la chiave va inserita nell'interfaccia Agent Panel, mai nel file.

ContinueOpenAI

Il provider `openai` di Continue indica un protocollo, non un fornitore: assegnagli un apiBase e ogni modello — chat, edit, autocomplete — diventa una voce in config.yaml.

AiderOpenAI

OPENAI_API_BASE più OPENAI_API_KEY, poi `aider --model openai/<id>` — il prefisso instrada l'ID verso il tuo endpoint invece che verso la tabella dei provider di Aider.

CC SwitchAnthropic

Aggiungi Kunavo come Custom Configuration: radice del servizio come endpoint, ANTHROPIC_AUTH_TOKEN come campo di autenticazione, Anthropic Messages nativo — così il lato Claude Code non necessita di routing locale.

Claude Agent SDKAnthropic

Non esiste alcuna opzione base_url — l'SDK avvia la CLI Claude Code e passa l'intero ambiente, quindi ANTHROPIC_BASE_URL lo instrada, oppure ClaudeAgentOptions(env=...) lo fa per client.

AmpOpenAI

Una connessione Custom URL in Model Routing di Amp — formato API chat-completions, URL di base https://api.kunavo.com/v1, chiave come bearer token — sposta i modelli mappati su una sola chiave, nei livelli che offrono l'opzione.

GitHub Copilot CLIOpenAI

Quattro variabili d'ambiente — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY e COPILOT_MODEL — portano Copilot CLI sul tuo endpoint, e GitHub documenta che BYOK non richiede un accesso GitHub.

CrushOpenAI

La configurazione di Crush è Bash — un solo `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` in un crushrc porta l'agente da terminale di Charm su Claude e GPT.

DeepSeek HarnessOpenAI

Settings → Models → “Add model provider” → “Custom model API” richiede cinque campi — Provider ID, display name, base URL, API protocol e API key — e inserisce Claude e GPT nello stesso selettore della scheda DeepSeek integrata.

DyadOpenAI

Dyad accetta qualsiasi endpoint compatibile con OpenAI tramite Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, la chiave nella pagina del provider, poi una riga Add Custom Model per ogni ID modello.

Factory DroidAnthropic

Una voce customModels in ~/.factory/settings.json — model, baseUrl e provider — porta Droid su qualsiasi endpoint che supporti Anthropic Messages o OpenAI Chat Completions.

gooseOpenAI

Settings → Models → Configure providers → OpenAI: Host URL richiede l'origine senza percorso, perché goose aggiunge autonomamente il percorso della richiesta (v1/chat/completions).

Jan AgentOpenAI

Una riga `jan config set --base-url https://api.kunavo.com/v1` scrive Kunavo in ~/.jan/config.toml, e la CLI di anteprima Jan Agent — priva di motore di inferenza — usa quella chiave.

Junie CLIOpenAI

Junie CLI accetta un endpoint personalizzato come profilo JSON in $JUNIE_HOME/models/, dove baseUrl è l'URL completo dell'endpoint e fasterModel determina dove arriva il traffico ausiliario.

Kimi CodeOpenAI

Kimi Code conserva i provider in ~/.kimi-code/config.toml — imposta providers.<name>.base_url su https://api.kunavo.com/v1 con type = "openai" e la CLI esegue gli ID Claude e GPT con una sola chiave.

mini-SWE-agentOpenAI

mini-SWE-agent non ha una variabile d'ambiente per l'URL di base — l'endpoint va in model.model_kwargs.api_base in una configurazione YAML, che mini passa direttamente a litellm.completion.

Mistral Vibe CLIOpenAI

Un blocco [[providers]] di cinque righe in .vibe/config.toml — api_base, api_key_env_var, api_style — collega Vibe CLI a Kunavo, mantenendo la chiave in una variabile d'ambiente anziché nel file.

Msty GoOpenAI

Settings &gt; Model Providers richiede un Base URL e una chiave API — cinque campi documentati, due dei quali la documentazione di Msty Go lascia da determinare tramite test.

NanocoderOpenAI

Una voce Custom Provider in nanocoder.providers dentro agents.config.json — name, baseUrl, apiKey, models — senza bisogno della riga sdkProvider, poiché il valore predefinito è openai-compatible.

Oh My PiOpenAI

Un blocco provider in ~/.omp/agent/models.yml — baseUrl, api, apiKey — collega Oh My Pi a Kunavo, mentre il rilevamento compila l'elenco dei modelli da GET /v1/models.

Open InterpreterOpenAI

Un'unica tabella [model_providers.kunavo] in ~/.openinterpreter/config.toml — base_url, env_key, wire_api = "chat" — e l'agente da terminale Rust funziona con qualsiasi modello raggiungibile dalla chiave.

OpenHandsOpenAI

Settings → LLM → Advanced richiede tre campi — Custom Model, Base URL, API Key — con l'ID modello che include il prefisso openai/ e l'URL di base che conserva /v1.

PiOpenAI

Un blocco provider personalizzato in ~/.pi/agent/models.json — baseUrl, api e gli ID dei modelli — porta l'agente di programmazione da terminale Pi di Earendil su Claude e GPT tramite una sola chiave.

QoderOpenAI

Qoder Settings → Models → + Add → Provider → Custom richiede un Base URL compatibile con OpenAI, una API Key e Model IDs inseriti manualmente — così l'app desktop autonoma Qoder raggiunge Claude e GPT, nessuno dei quali è presente nel suo catalogo.

Qwen CodeOpenAI

Qwen Code legge gli endpoint da modelProviders in ~/.qwen/settings.json — una voce con baseUrl e envKey mette Claude e GPT nel suo selettore /model.

Theia IDEOpenAI

Una voce in ai-features.openAiCustom.customOpenAiModels — model, url e apiKey — mette Kunavo dietro Theia Coder, Architect e il completamento inline.

twinnyOpenAI

twinny non ha un campo per l'URL di base — Add provider → OpenAI-compatible server, poi Protocol https, Hostname api.kunavo.com, Port vuoto e API path /v1; il pannello chat usa la tua chiave.

Client di chat e interfacce self-hosted

App desktop e interfacce self-hosted, ideali per usare una sola chiave e un solo saldo con un unico selettore dei modelli, invece di un account per ogni fornitore.

Open WebUIOpenAI

Una connessione OpenAI in Admin Settings, oppure OPENAI_API_BASE_URL e OPENAI_API_KEY all'avvio del container — entrambe terminano sullo stesso /v1.

Cherry StudioOpenAI

Settings → Model Services → un provider personalizzato: incolla la chiave e l'indirizzo API, fai clic su Get Model List e l'intero catalogo riempie il selettore.

ChatboxOpenAI

Aggiungi un provider di tipo OpenAI API Compatible con API Host impostato sulla radice del servizio — Chatbox aggiunge autonomamente /v1/chat/completions.

LobeChatOpenAI

Tre variabili d'ambiente — OPENAI_API_KEY, OPENAI_PROXY_URL e OPENAI_MODEL_LIST — riuniscono Claude e GPT in un unico selettore LobeChat self-hosted.

SillyTavernOpenAI

Configura la sorgente Chat Completion di SillyTavern su Kunavo con un endpoint personalizzato e una sola chiave API — Claude e GPT nello stesso menu a discesa dei modelli.

Janitor AIOpenAI

API Settings → Proxy → Add Configuration: Proxy URL è il percorso completo /v1/chat/completions, e Model Name deve essere esattamente un ID del catalogo.

OllamaOpenAI

La superficie compatibile con OpenAI di Ollama e quella di Kunavo hanno la stessa struttura, quindi gli strumenti scritti per un Ollama locale funzionano cambiando l'URL di base.

AnythingLLMOpenAI

AnythingLLM raggiunge un endpoint per cui non offre alcun provider nominativo tramite Generic OpenAI — Base URL con /v1, una chiave e un ID modello inserito manualmente, poiché non recupera alcun elenco.

ChatWiseOpenAI

Settings → Providers → "+" crea un provider personalizzato da tre campi — Provider name, API Base URL impostato su https://api.kunavo.com/v1 e API Key — poi Fetch legge l'elenco dei modelli dall'endpoint.

DifyOpenAI

Un solo campo obbligatorio — API Base URL, nel modulo Add Model del plugin compatibile con OpenAI API — indirizza ogni nodo LLM di uno spazio di lavoro Dify verso Kunavo.

LibreChatOpenAI

LibreChat usa un gateway come blocco endpoints.custom in librechat.yaml — quattro campi obbligatori, la chiave da .env e un riavvio prima che il selettore lo mostri.

Msty StudioOpenAI

Model Hub > Model Providers > Add Provider > Open AI Compatible: una API Key e un Inference Endpoint di https://api.kunavo.com/v1 — la nota dell'app indica che la maggior parte degli endpoint compatibili con OpenAI richiede /v1.

n8nOpenAI

Il campo Base URL delle credenziali OpenAI — https://api.kunavo.com/v1, mantenendo /v1 — porta ogni OpenAI Chat Model in un flusso di lavoro n8n su Kunavo; il nodo modello non ha un campo endpoint.

NextChatOpenAI

Tre variabili d'ambiente — OPENAI_API_KEY, BASE_URL (origine senza percorso) e CUSTOM_MODELS — collegano un NextChat self-hosted a Claude e GPT tramite una sola chiave.

Copilot for ObsidianOpenAI

Settings → Copilot → BYOK → Add a custom provider: un Display name, la tua chiave e https://api.kunavo.com/v1 — Quick Chat sempre disponibile, Agent Chat in opencode quando il provider viene mostrato lì.

Page AssistOpenAI

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, un Base URL che conserva /v1 e la chiave — poi seleziona gli ID modello dall'elenco che Page Assist recupera autonomamente.

TypingMindOpenAI

Models → Add custom model: l'Endpoint URL completo https://api.kunavo.com/v1/chat/completions, un header Authorization con Bearer e la tua chiave, il Model ID e la sua lunghezza di contesto — una voce per modello, chiamata direttamente dal browser.

Tutti gli altri client

È molto probabile che anche un client non elencato qui funzioni. Verifica se consente di modificare l’endpoint: se ha un’impostazione «base URL», «custom endpoint» o «OpenAI-compatible provider», puoi usarlo con Kunavo. Inizia dalla guida introduttiva, poi consulta chat completions oppure la Messages API, a seconda del formato supportato dal client. Gli ID dei modelli sono disponibili in GET /v1/models: sono anche i valori che popolano il menu a discesa nei client che ne hanno uno. Il contratto completo, leggibile dalle macchine, è la descrizione OpenAPI 3.1, utilizzabile direttamente dalla maggior parte dei generatori di client e dei framework per agenti.