Junie CLI

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.

{
  "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"
  }
}

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta. Esportala come KUNAVO_API_KEY nella shell da cui avvierai Junie, oppure inserisci direttamente la chiave nel file; JetBrains precisa che «I valori senza alcun riferimento $${...} vengono usati così come sono».
2. Salva il JSON qui sopra come $JUNIE_HOME/models/kunavo.json per il tuo account oppure come .junie/models/kunavo.json per condividerlo con un repository. Il nome del file senza .json diventa l'ID del profilo, ed è per questo che il selettore qui sotto mostra custom:kunavo.
3. Imposta id sull'ID del modello che vuoi usare. È descritto come «L'identificatore del modello previsto dall'endpoint API», quindi puoi inserire direttamente uno slug Kunavo dalla tabella qui sotto: gli ID vengono risolti sull'endpoint, non all'interno di Junie.
4. Avvia Junie e seleziona il profilo: junie --model custom:kunavo oppure il comando /model in una sessione interattiva. I modelli personalizzati «compaiono nell'elenco di selezione dei modelli dopo i provider integrati».
5. Assegna un'attività che modifichi un file, non un semplice saluto. Junie è un client agentico e si affida alle chiamate agli strumenti per quasi tutto ciò che fa, quindi una prima esecuzione che legge e scrive qualcosa ti dice molto più di una singola risposta.

Verificato rispetto a Pagina JetBrains sui modelli LLM personalizzati per Junie il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in 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-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

Gli altri due valori apiType a cui risponde Kunavo

apiType indica un formato di richiesta, non un fornitore, e Junie accetta quattro valori: OpenAICompletion, OpenAIResponses, Google e Anthropic. Kunavo offre tre route, quindi due degli altri tre valori hanno una baseUrl corrispondente. Poiché Junie non aggiunge alcun percorso, cambiare formato significa cambiare l'URL nella stessa modifica:

1. "apiType": "OpenAICompletion" con https://api.kunavo.com/v1/chat/completions — il profilo qui sopra, consigliato in questa pagina perché è la route più ampiamente collaudata delle tre.
2. "apiType": "Anthropic" con https://api.kunavo.com/v1/messages — Kunavo risponde in formato Messages su quel percorso.
3. "apiType": "OpenAIResponses" con https://api.kunavo.com/v1/responses.

Quale dei tre funzioni meglio per un dato modello in Junie è proprio il tipo di domanda a cui risponde un test in esecuzione, ma non la lettura della documentazione; perciò questa pagina non li classifica oltre alla prima riga. Scegline uno, mantieni coerenti URL e apiType e, se un profilo con chiave impostata restituisce 401, specifica esplicitamente la credenziale invece di indovinare l'header usato da Junie: JetBrains documenta apiKey solo in negativo — «Se omesso, le richieste vengono inviate senza un header Authorization» — e non specifica mai lo schema usato quando è presente. extraHeaders è documentato come «header HTTP aggiuntivi da includere in ogni richiesta» e accetta gli stessi riferimenti $${VAR}, perciò "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} è la forma inequivocabile.