Crush

Agente nel terminale · OpenAI Chat, Anthropic Messages

Guida completa

Formato	Dove configurare
OpenAI Chat, Anthropic Messages	crushrc (config Bash): ./.crushrc, ./crushrc oppure ~/.config/crush/crushrc; il vecchio formato crush.json è obsoleto, ma funziona

Configurazione

Copia la configurazione e sostituisci sk-... con la tua chiave dall’area personale Ailoot. È meglio conservarla nella variabile d’ambiente AILOOT_API_KEY, se l’applicazione lo supporta.

Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.

~/.config/crush/crushrc

export AILOOT_API_KEY="sk-..."
provider add ailoot --type openai-compat \
  --base-url "https://api.ailoot.ai/v1" \
  --api-key "$AILOOT_API_KEY"

model add ailoot/deepseek-v4-pro \
  --name "DeepSeek V4 Pro (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 32000

# formato Anthropic per Claude: indirizzo senza /v1
provider add ailoot-claude --type anthropic \
  --base-url "https://api.ailoot.ai" \
  --api-key "$AILOOT_API_KEY"

model add ailoot-claude/claude-sonnet-5-5 \
  --name "Claude Sonnet 5.5 (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 64000 \
  --can-reason true --supports-images false

Questa configurazione legge la chiave dalla variabile AILOOT_API_KEY. Impostala prima di avviare l’applicazione:

export AILOOT_API_KEY="sk-..."   # aggiungi a ~/.zshrc o ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # poi riavvia il terminale

Modello di esempio: deepseek-v4-pro. Scegli qualsiasi altro modello dal catalogo — verifica che supporti il formato necessario.

Da sapere

Il tipo openai-compat usa OpenAI Chat con indirizzo che include /v1. Il tipo anthropic usa Messages con indirizzo senza /v1: Crush lo passa ad anthropic-sdk-go, che aggiunge da solo /v1/messages. L’esempio nel README Crush con /v1 produrrebbe /v1/v1/messages e un errore 404. La chiave viene inviata nell’header x-api-key, accettato da Ailoot. Se l’elenco dei modelli è vuoto, il provider openai-compat lo recupera da /v1/models. crushrc viene eseguito come codice: non avviare Crush in cartelle altrui con questo file. Nell’esempio Claude ha supports-images = false: lo snapshot del catalogo 2026-09-30 dichiara solo testo per il formato Messages selezionato. Se la tua versione Crush supporta questo flag, attivalo solo per un modello la cui scheda attuale dichiari input image nel formato API scelto; il flag del client non aggiunge da solo il supporto delle immagini al modello.

Verifica

Per il formato OpenAI l’indirizzo è https://api.ailoot.ai/v1 (oppure il percorso completo, se l’applicazione chiede l’indirizzo completo).
Per il formato Anthropic l’indirizzo è https://api.ailoot.ai senza /v1.
Fai una domanda breve. Se ricevi un errore, controlla codice e Request ID e consulta la pagina Errori e limiti.
404 subito dopo la configurazione indica quasi sempre un indirizzo errato: manca o è superfluo il segmento /v1.
402 — il saldo non basta per la riserva. Gli agenti riservano più di una chat: perché.

Documentazione dell’applicazione: https://github.com/charmbracelet/crush#custom-providers

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.Contatta l’assistenza