Crush

Agent dans le terminal · OpenAI Chat, Anthropic Messages

Guide complet

Format	Où configurer
OpenAI Chat, Anthropic Messages	crushrc, configuration Bash : ./.crushrc, ./crushrc ou ~/.config/crush/crushrc ; l’ancien format crush.json est obsolète, mais fonctionne encore

Configuration

Copiez la configuration et remplacez sk-... par votre clé de l’espace personnel Ailoot. Il est préférable de stocker la clé dans la variable d’environnement AILOOT_API_KEYsi l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, POST /v1/messages, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du 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

# Format Anthropic pour Claude : adresse sans /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

Cette configuration lit la clé dans la variable AILOOT_API_KEY. Définissez-la avant de lancer l’application :

export AILOOT_API_KEY="sk-..."   # Ajoutez à ~/.zshrc ou ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # Puis redémarrez le terminal

Exemple de modèle : deepseek-v4-pro. Choisissez tout autre modèle dans catalogue — vérifiez qu’il prend en charge le format requis.

À savoir

Le type openai-compat utilise OpenAI Chat avec une adresse incluant /v1. Le type anthropic utilise Messages avec une adresse sans /v1 : Crush la transmet à anthropic-sdk-go, qui ajoute lui-même /v1/messages. L’exemple du README Crush avec /v1 produirait /v1/v1/messages et une erreur 404. La clé est transmise dans x-api-key, accepté par Ailoot. Si la liste des modèles est vide, openai-compat la charge depuis /v1/models. crushrc est exécuté comme du code : ne lancez pas Crush dans des dossiers tiers contenant ce fichier. Dans cet exemple, Claude utilise supports-images = false : l’instantané du catalogue du 2026-09-30 n’annonce que du texte pour le format Messages choisi. Si votre version de Crush accepte cette option, ne l’activez que pour un modèle dont la fiche actuelle annonce une entrée image dans le format API choisi ; une option du client n’ajoute pas cette capacité au modèle.

Vérification

Pour le format OpenAI, l’adresse est https://api.ailoot.ai/v1 (ou le chemin complet si l’application demande une adresse complète).
Pour le format Anthropic, l’adresse est https://api.ailoot.ai sans /v1.
Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page Erreurs et limites.
Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de /v1.
Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : explication.

Documentation de l’application : https://github.com/charmbracelet/crush#custom-providers

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à comprendre.Contacter l’assistance