Crush

La configurazione di Crush è Bash — un solo `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` in un crushrc porta l'agente da terminale di Charm su Claude e GPT.

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

Passo dopo passo

1. Crea una chiave in /app/keys e copiala: viene mostrata una sola volta. Esportala come KUNAVO_API_KEY oppure leggila da un gestore di password direttamente nella configurazione.
2. Inserisci il blocco qui sopra in ~/.config/crush/crushrc. Crush legge prima ./.crushrc, poi ./crushrc e infine il file globale; in questo modo un progetto può sovrascrivere le impostazioni della macchina, ma anche un repository clonato può includere un file di configurazione.
3. Avvia crush e premi ctrl+l per aprire il selettore dei modelli. Le righe model large e model small qui sopra hanno già fissato entrambi gli slot, quindi usa il selettore per passare da un modello all’altro, non per configurarlo.
4. Se preferisci non registrare gli ID manualmente: il rilevamento automatico viene eseguito quando l’elenco dei modelli di un provider openai-compat è vuoto oppure quando passi --discover-models true. Kunavo risponde a GET /v1/models, quindi l’elenco viene compilato automaticamente; in caso di conflitto prevalgono i campi model add definiti manualmente.
5. Esegui un’attività circoscritta, quindi controlla l’addebito registrato sul tuo account in /app/billing. La cifra mostrata nel terminale è calcolata a partire dai valori --price-* inseriti manualmente; il registro contiene l’importo addebitato.

Verificato rispetto a La sezione Custom Providers di Crush 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 Crush.

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