Qoder

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.

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Apri Qoder Settings, seleziona Models nel menu di navigazione a sinistra e fai clic su + Add.
3. Apri Provider e, in Custom, scegli OpenAI Compatible: non scegliere uno dei provider predefiniti sopra elencati. Seleziona poi Chat Completions API come tipo di API.
4. Inserisci il Base URL, la API Key e almeno un Model ID. La documentazione di Qoder non indica alcun rilevamento automatico dell'elenco dei modelli per questo campo, quindi inserisci gli ID manualmente; fai clic su Add Model ID per aggiungerne altri allo stesso endpoint.
5. Fai clic su Next e imposta le capacità che Qoder non può dedurre: Display name, Supported Context Windows e uno dei valori indicati come Default Context Window, oltre alle opzioni Vision e Thinking Mode se supportate dal modello.
6. Fai clic su Validate and Add Model. La pagina di Qoder dedicata alla selezione dei modelli spiega che, una volta aggiunto, «il modello diventa disponibile nei selettori di modelli per le attività, Agent e l'automazione».

Verificato rispetto a la pagina sui modelli personalizzati dell'app Qoder standalone 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 Qoder.

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

Perché nel tuo Qoder potrebbe mancare il campo Base URL

Tre interfacce di Qoder documentano l'uso della propria chiave e solo una documenta un endpoint a tua scelta. È questo l'unico elemento che determina se puoi configurare quanto indicato sopra dall'interfaccia che stai usando; conviene quindi verificarlo prima di modificare un file di configurazione. La pagina CLI dice esplicitamente di non modificarne uno.

Qoder CLI è il caso che crea più confusione, perché le note di rilascio e la documentazione ufficiale non concordano. La nota di rilascio 1.1.50 dell'11 settembre 2026 dice: «Gli utenti dell'edizione Personal ora possono configurare e gestire centralmente i modelli BYOK con endpoint URL personalizzati dalla pagina Custom». La pagina sui modelli personalizzati ancora disponibile, invece, descrive un catalogo: «i provider, i modelli e i campi delle credenziali disponibili sono determinati dal catalogo BYOK accessibile dall'account corrente». Entrambe le pagine, così come quella di IDE, limitano la funzionalità al piano Individual. Se la scheda Custom è assente o non mostra un campo endpoint, controlla il piano dell'account e le opzioni del relativo catalogo: non modificare un file di configurazione, perché la pagina CLI sconsiglia di farlo manualmente e il file viene comunque rigenerato dal catalogo.