Documentazione

Roo Code

Il provider OpenAI Compatible di Roo Code richiede tre campi e un blocco con le capacità del modello. Quest’ultimo non è un’aggiunta facoltativa: determina il budget di contesto che Roo Code assegna.

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.

Pannello delle impostazioni di Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code usa chiamate native agli strumenti senza fallback, quindi il modello scelto deve supportare le chiamate agli strumenti compatibili con OpenAI. Tutti gli id nella tabella seguente lo fanno; un modello solo testuale o multimediale configurato qui fallirà al primo strumento che l’agente tenterà di usare, non durante la configurazione.

Compila Context Window e Max Output Tokens invece di lasciare i valori predefiniti. Roo Code usa questi numeri per decidere quando compattare la conversazione: una finestra di contesto troppo piccola lo porta a troncare la cronologia quando non ce n’è bisogno, mentre una troppo grande genera errori 400 upstream invece di una compattazione regolare.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Roo Code.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Apri il pannello delle impostazioni di Roo Code e imposta API Provider su OpenAI Compatible.
Inserisci il Base URL https://api.kunavo.com/v1 e la tua chiave. Il suffisso /v1 deve essere incluso nell’URL di base: Roo Code aggiunge solo il percorso.
Seleziona o digita l’id del modello, poi apri Model Configuration e imposta la finestra di contesto, il numero massimo di token in output, il supporto alle immagini e i prezzi di input/output indicati nella tabella seguente.
Invia un messaggio in modalità Code. I prezzi inseriti qui sono quelli usati dal calcolo dei costi per attività di Roo Code, quindi è importante impostarli correttamente.

Verificato rispetto a la pagina del provider OpenAI Compatible di Roo Code il 6 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.

Questa è la versione breve. La guida completa, con scelta del modello, costo di una sessione reale e modalità di errore, è in la guida dettagliata di Roo Code + Claude.

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 Roo Code.

# 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.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Roo Code
`claude-sonnet-5`	$1.40 / $7.00	modalità Code — quella predefinita e su cui è calibrato il calcolo dei costi
`claude-opus-5`	$3.50 / $17.50	modalità Architect, in cui un piano sbagliato costa più dei token
`claude-haiku-4-5`	$0.70 / $3.50	modalità Ask e letture ripetute dei file
`gpt-5-6-terra`	$0.70 / $4.20	passaggi con contesto lungo su un repository di grandi dimensioni

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Domande frequenti

Come si configura un endpoint OpenAI compatibile personalizzato in Roo Code?

Nel pannello delle impostazioni di Roo Code, imposta API Provider su "OpenAI Compatible", inserisci Base URL e API Key dell’endpoint e scegli un modello. L’URL di base è la radice /v1 del servizio, perché Roo Code vi aggiunge solo il percorso. La documentazione di Roo Code definisce cruciale il campo Base URL: è quello che stabilisce la destinazione di ogni richiesta.

Quali modelli sono compatibili con Roo Code tramite un endpoint personalizzato?

Qualsiasi modello offerto dall’endpoint che supporti le chiamate native agli strumenti compatibili con OpenAI. Roo Code usa esclusivamente chiamate native agli strumenti e non dispone di una modalità di fallback; pertanto, un modello senza supporto agli strumenti si connetterà, ma poi fallirà non appena l’agente tenterà di leggere o scrivere un file. Tutti i modelli testuali Claude e GPT sono compatibili; i modelli per immagini, video e audio non lo sono.

Quali valori devo inserire in Context Window e Max Output Tokens di Roo Code?

I limiti effettivi del modello selezionato, non i valori predefiniti. Roo Code usa questi due numeri per decidere quando compattare la conversazione: un valore inferiore al contesto reale del modello lo induce a eliminare inutilmente la cronologia, mentre un valore superiore genera errori 400 upstream invece di una compattazione regolare. I dati per ciascun modello sono disponibili nel catalogo dell’endpoint.

Perché Roo Code indica un costo errato per un’attività?

Perché i campi Input Price e Output Price in Model Configuration vengono compilati manualmente e sono impostati per impostazione predefinita a zero oppure alle tariffe di un altro provider. Roo Code calcola il costo per attività interamente sulla base di questi due campi: non legge i prezzi dall’endpoint. Il valore è quindi accurato solo quanto i dati inseriti. Copia le tariffe dal catalogo del provider.