Theia IDE

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

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Attiva la funzionalità: secondo la documentazione di Theia, vai in Preferences e abilita l’impostazione «AI-features => AI Enable». Le opzioni seguenti non compariranno finché non lo avrai fatto.
3. Apri la vista AI Configuration: Alt+A, oppure seleziona AI Configuration nel menu Manage (ingranaggio) in basso a sinistra, subito sotto Settings. Le categorie sono General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage e MCP Servers.
4. Aggiungi le voci sopra. La documentazione descrive l’operazione come un clic sul link nella sezione delle impostazioni per OpenAI Compatible Models — la preferenza è un elenco strutturato e Theia specifica che le impostazioni strutturate senza un editor dedicato “rimandano a settings.json”, il file in cui si arriva. Un oggetto per ogni ID modello; url e apiKey si ripetono.
5. Associa qualcosa a questo modello. In Agents, ogni agente ha un selettore Language Model; molti agenti risolvono invece un alias del modello, quindi impostare default/code, default/universal, default/code-completion, default/summarize e default/fast in Model Aliases consente di spostare più agenti insieme.
6. Invia un messaggio in chat a Theia Coder, poi chiedigli di intervenire su un file. Gli agenti di questo IDE si affidano alle chiamate agli strumenti e ai contenuti dell’area di lavoro, quindi una prima esecuzione che legge o modifica qualcosa è più indicativa di un saluto — e Token Usage nella stessa vista mostra quanti token è costato il turno.

Verificato rispetto a la pagina delle funzionalità IA dell’IDE Theia, sezione OpenAI Compatible Models 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 Theia IDE.

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

Cosa dichiara Theia per questo provider

La tabella LLM Providers Overview nella pagina ufficiale di Theia valuta ogni provider su tre assi. Si tratta di quanto dichiara Theia su Theia, riportato da quella tabella alla data indicata sopra — non è il risultato di un test di Kunavo; in questa tabella, solo la colonna intitolata “Cosa richiede l’ID modello” è stata redatta qui.

Due paragrafi sopra la tabella, Theia aggiunge un’avvertenza che vale la pena ripetere perché definisce con onestà l’intera pagina: non tutti i modelli “possono funzionare subito, perché potrebbero richiedere personalizzazioni o ottimizzazioni specifiche”.

Cosa comporta davvero un costo

L’IDE Theia è open source e si scarica gratuitamente; le sue funzionalità IA non comportano costi propri — si paga per le chiamate al modello, fatturate da chi detiene la chiave in apiKey. Ci sono due impostazioni, entrambe documentate, che incidono sulla fattura più della scelta del modello:

1. Automatic Code Completion è attivo per impostazione predefinita e la documentazione indica che effettua “richieste continue all’LLM sottostante mentre si scrive codice”. È l’agente che si attiva migliaia di volte al giorno. Imposta default/code-completion su un ID economico oppure passa l’agente alla modalità manuale in 'AIFeatures'=>'CodeCompletion' e attivalo con Ctrl+Alt+Space.
2. Max Context Lines, nello stesso gruppo di impostazioni, limita la quantità di contenuto circostante del file inclusa in ogni richiesta di completamento. Ogni riga viene fatturata come input a ogni chiamata avviata dalla digitazione.

Gli agenti di chat funzionano al contrario: effettuano meno chiamate, usano un contesto molto più ampio e inviano di nuovo gli stessi file dell’area di lavoro a ogni turno. È proprio a questo che serve la memorizzazione nella cache dei prompt — vedi /docs/caching — ed è per questo che le due parti della tabella dei modelli sopra sono suddivise in base alla frequenza di attivazione dell’agente, non alla sua intelligenza.

Quando la connessione non riesce

1. 404 — url. Kunavo serve /v1/chat/completions, quindi il campo deve contenere la radice /v1; un’origine senza altro percorso o un .../chat/completions completo non funzionano.
2. 401 — la chiave. Il Readme di Theia afferma che apiKey “verrà inviato come Bearer Token nella richiesta di autorizzazione”, esattamente ciò che si aspetta una chiave sk-kn-. Nota il valore predefinito documentato: se manca del tutto apiKey, Theia invia no-key, quindi un campo mancante sembra una chiave rifiutata, anziché assente. (true significa “usa la chiave API OpenAI globale” — non è ciò che vuoi in questo caso.)
3. L’ID modello non compare nel selettore — l’elenco deriva dalle tue voci customOpenAiModels, non dall’endpoint; quindi, se manca un ID, manca l’oggetto corrispondente. Il campo id è quello mostrato nell’interfaccia; se lo ometti, viene usato il nome del modello.
4. Il primo messaggio di sistema viene rifiutato o ignorato — è developerMessageSettings. Il valore predefinito è developer, un ruolo nel formato OpenAI; nell’esempio di Theia per un fornitore non OpenAI è impostato system, motivo per cui il blocco qui sopra fa lo stesso. user, mergeWithFollowingUserMessage e skip sono le alternative documentate.
5. Non arriva alcuna risposta, da nessuna parte — controlla Workspace Trust. Theia subordina tutte le funzionalità IA a questa impostazione; in un’area di lavoro non attendibile, l’input della chat e il completamento in linea vengono disattivati e viene mostrato il messaggio AI Features are Restricted.