Configurare un provider

Configura almeno un provider, poi scegli uno dei suoi modelli abilitati dal selettore provider/modello nel compositore della chat.

Metodi di connessione

Pagina delle Impostazioni	Quando usarla	Credenziale o prerequisito
ChatGPT Plus/Pro	Vuoi usare un account OpenAI ChatGPT	Accesso nel browser o codice dispositivo
Models.dev	Il provider è nel catalogo models.dev oppure espone un’API OpenAI-compatibile	Chiave API del provider
Kora	Possiedi una chiave Kora Cloud per Flash	Chiave Kora Cloud
ByteDance (ModelArk)	Usi la Standard API o il Coding Plan	Chiave API ModelArk
OpenCode CLI	OpenCode è installato e già autenticato	Eseguibile opencode funzionante
Local	È in esecuzione Ollama, LM Studio, omlx o un altro server locale OpenAI-compatibile	URL del server locale; chiave API solo se richiesta

ChatGPT Plus/Pro

1. Apri Impostazioni → ChatGPT Plus/Pro.
2. Seleziona Sign in with OpenAI.
3. Completa l’autorizzazione nel browser.
4. Torna in Kora e seleziona Refresh Models.
5. Controlla l’elenco specifico dell’account in Available models.
6. Chiudi le Impostazioni e scegli uno di quei modelli nel compositore.

Se l’autorizzazione nel browser non torna a Kora, seleziona Or sign in with a device code, apri l’URL di verifica mostrato e inserisci il codice. Usa Disconnect per rimuovere l’account da Kora.

L’elenco disponibile è quello restituito per l’account. Non dare per scontato che ogni modello associato a un piano OpenAI sia supportato o abilitato in Kora.

Models.dev

1. Apri Impostazioni → Models.dev.
2. Cerca in Search providers from models.dev….
3. Seleziona il provider.
4. Controlla il Base URL precompilato e inserisci la sua API Key.
5. Controlla l’elenco dei modelli e seleziona Add Provider.
6. Apri il provider aggiunto per abilitare o disabilitare i singoli modelli, modificarne le capacità, aggiungere un modello personalizzato o aggiornare la voce del catalogo.

Usa Add manually quando il provider non è nel catalogo. Consulta Aggiungere provider con Models.dev.

Kora Cloud Flash

1. Apri Impostazioni → Kora.
2. Incolla la chiave Kora Cloud in API Key.
3. Attendi lo stato di convalida, poi seleziona Save.
4. Chiudi le Impostazioni e seleziona Flash nel compositore.

Consulta Collegare Kora Cloud per creare account e chiave.

ByteDance ModelArk

1. Apri Impostazioni → ByteDance (ModelArk).
2. Incolla la chiave API.
3. In API Mode, scegli Standard API (Seed Models) o Coding Plan (Subscription).
4. Lascia vuoto Custom Base URL per usare l’endpoint della modalità selezionata, poi seleziona Save.
5. Abilita i modelli necessari nel gestore dei modelli.

OpenCode CLI

1. Installa e autentica OpenCode fuori da Kora.
2. Apri Impostazioni → OpenCode CLI.
3. Verifica che Kora rilevi l’eseguibile e carichi i modelli restituiti da OpenCode.
4. Seleziona un modello OpenCode nel compositore.

Le credenziali restano gestite da OpenCode. Kora non richiede una chiave API OpenCode.

Local

1. Avvia il server di inferenza locale.
2. Apri Impostazioni → Local.
3. Seleziona un preset oppure inserisci un base URL locale OpenAI-compatibile.
4. Usa l’azione di rilevamento del server nel modulo per caricare i modelli, poi aggiungi il provider.
5. Abilita i modelli che devono comparire nel compositore.

Risoluzione problemi

• ChatGPT non mostra modelli → seleziona Refresh Models; se l’account continua a non restituirne, disconnettilo e autenticati di nuovo.
• Un provider Models.dev non supera il test di connessione → verifica base URL e chiave API; i metadati del catalogo non forniscono la tua credenziale.
• OpenCode non mostra modelli → esegui opencode models in un terminale e verifica che l’eseguibile sia disponibile nel PATH di Kora.
• Un server locale non viene rilevato → avvialo, controlla la porta e usa un URL di loopback come http://127.0.0.1:<porta>/v1.