Documentazione

Aider

Aider legge OPENAI_API_BASE e OPENAI_API_KEY. Configurale per Kunavo, anteponi openai/ all'ID del modello e potrai passare da Claude a GPT cambiando un solo argomento --model.

Due variabili d'ambiente e un prefisso. Imposta OPENAI_API_BASE su https://api.kunavo.com/v1, OPENAI_API_KEY sulla tua chiave sk-kn-…, quindi avvia Aider con --model openai/<id>. Non devi modificare il repository né l'installazione di Aider.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

Il prefisso openai/ è obbligatorio e l'URL di base deve terminare con /v1. Senza il prefisso, Aider cerca di risolvere l'ID usando la propria tabella dei provider e restituisce l'errore «modello sconosciuto»; senza /v1, la richiesta non raggiunge l'endpoint corretto.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Esporta OPENAI_API_BASE e OPENAI_API_KEY nella shell da cui avvii Aider, oppure inseriscile in ~/.aider.conf.yml come mostrato qui sotto.
Avvia Aider nel tuo repository con aider --model openai/claude-sonnet-5.
All'avvio, Aider indica il modello risolto. Se la riga mostra l'ID richiesto, la configurazione dell'endpoint è corretta.

Il riferimento di Aider al riguardo è la pagina delle API compatibili con OpenAI.

Evita di inserirle nel profilo della shell

Gli stessi due valori si possono inserire nel file di configurazione di Aider, una scelta migliore se passi da un endpoint all'altro per ogni progetto.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Verifica prima di fare debug di Aider

Una richiesta basta per stabilire se il problema riguarda l'endpoint, la chiave o la risoluzione del modello da parte di Aider. Se questa richiesta restituisce un elenco JSON di ID modello, in Aider funzionano gli stessi URL di base e chiave; gli errori rimanenti dipendono dal prefisso openai/.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quali modelli scegliere

Puoi raggiungere ogni modello testuale su Kunavo come openai/<id>. L'elenco completo è disponibile nella pagina dei modelli e viene restituito in tempo reale da GET /v1/models. Le tariffe sono espresse in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Ideale per
`claude-haiku-4-5`	$0.70 / $3.50	Claude più economico, ideale per le chiamate di Aider alla mappa del repository e ai messaggi di commit
`claude-sonnet-5`	$1.40 / $7.00	Il miglior equilibrio tra qualità e prezzo per la modifica
`claude-opus-5`	$3.50 / $17.50	Il livello Claude di qualità più alta, per modifiche a livello architetturale
`gpt-5-6-terra`	$0.70 / $4.20	Stessa chiave, famiglia diversa: utile per un secondo parere su una modifica complessa

A ogni scambio, Aider invia di nuovo la mappa del repository e i file modificati, quindi il consumo di token dipende dalle dimensioni del contesto, non da quelle della modifica. Per questo, la memorizzazione nella cache dei prompt è il fattore più determinante e --model insieme a --weak-model openai/claude-haiku-4-5 rappresentano l'abbinamento più economico: il modello potente esegue le modifiche, quello più leggero scrive i messaggi di commit e i riepiloghi. La fatturazione è per token, sul saldo prepagato e senza canone mensile: maggiori dettagli nella sezione fatturazione.

Domande frequenti

Come si usa Aider con un'API compatibile con OpenAI?

Imposta OPENAI_API_BASE sull'URL di base dell'endpoint e OPENAI_API_KEY sulla tua chiave, quindi avvia Aider con l'ID del modello preceduto da openai/, ad esempio `aider --model openai/claude-sonnet-5`. Per Kunavo, l'URL di base è https://api.kunavo.com/v1. Il prefisso è obbligatorio: senza di esso, Aider prova a risolvere l'ID usando la propria tabella dei provider invece di inviarlo al tuo endpoint.

Aider può usare modelli Claude tramite un endpoint compatibile con OpenAI?

Sì. Aider comunica con l'indirizzo indicato da OPENAI_API_BASE usando il protocollo OpenAI, quindi può raggiungere un modello Claude fornito in quel formato senza credenziali Anthropic: l'ID del modello è semplicemente un'altra stringa nell'elenco /v1/models. Su Kunavo, gli ID Claude e GPT sono tutti accessibili con la stessa chiave, quindi per passare dall'uno all'altro basta cambiare l'argomento --model, senza modificare la configurazione.

Perché Aider segnala che il modello è sconosciuto?

Quasi sempre manca il prefisso openai/. Aider interpreta un ID senza prefisso come un modello che dovrebbe riconoscere e dà errore se non lo trova; `openai/<id>` gli indica di passare l'ID direttamente a OPENAI_API_BASE. La seconda causa più comune è un URL di base senza il suffisso /v1: in tal caso si verifica un errore di connessione o 404, non di modello sconosciuto.

Aider mostra il costo di una sessione?

Aider indica il conteggio dei token e una stima del costo per ogni scambio, calcolata in base ai metadati dei modelli di Aider. Per un endpoint personalizzato, la stima può essere errata perché Aider non conosce le tariffe del tuo endpoint. Considera affidabile il conteggio dei token e verifica il costo effettivo presso il tuo provider. Su Kunavo, il costo per richiesta è nella vista di utilizzo e viene addebitato sul saldo prepagato, senza canone mensile.