Configuration des Coding Agents

Configuration de Crush : API Key, Base URL et modèles

Installez Crush et configurez BetterToken dans crushrc avec une API Key et une Base URL. Choisissez un modèle et résolvez l’erreur No providers configured.

Connectez Crush à BetterToken avec un fournisseur openai-compat dans crushrc. Lors d’un test sur macOS avec un modèle GPT, Crush 0.98.2 a réussi les trois requêtes texte à froid ainsi qu’un appel d’outil de lecture de fichier via /v1/chat/completions.

Paramètres clés

Élément	Valeur
API Key	BetterToken API Key transmise avec `--api-key`
Base URL	`https://bettertoken.ai/v1`, transmise avec `--base-url`
Modèle	`bettertoken/YOUR_MODEL_ID`
Type de fournisseur	`openai-compat`
Fichier de configuration	`~/.config/crush/crushrc`

Prérequis

Homebrew pour la commande d’installation ci-dessous
Une BetterToken API Key : inscrivez-vous pour en obtenir une
Un Model ID et sa limite de contexte, indiqués dans le model plaza

Installation

Utilisez la commande Homebrew du dépôt officiel de Crush :

brew install charmbracelet/tap/crush
crush --version

Configuration manuelle

Définissez votre BetterToken API Key dans le terminal qui exécutera Crush :

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Créez ~/.config/crush/crushrc avec le format de configuration Bash recommandé. Remplacez chaque YOUR_MODEL_ID et définissez --context-window sur la limite documentée du modèle choisi. La valeur 128000 de l’exemple est une déclaration du client, pas une limite de modèle BetterToken vérifiée.

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

Enregistrez ces commandes dans crushrc ; Crush les exécute au démarrage. permissions allow view autorise l’outil d’affichage des fichiers. L’ancien format JSON est obsolète en amont, mais fonctionne toujours ; sa requête texte a également réussi lors du test.

Vérifier la connexion

Lancez la commande depuis votre projet, dans le même terminal :

crush run "Reply with only: OK"

Vérifiez que la réponse finale est OK. Pour tester l’accès aux fichiers, demandez à Crush de lire un fichier connu de votre projet et vérifiez le résultat de l’outil view ainsi que la réponse finale.

Changer de modèle

Ajoutez un autre modèle avec model add, modifiez les sélections model large et model small dans crushrc, puis démarrez une nouvelle exécution.

Erreurs fréquentes

Symptôme	Vérification
`No providers configured`	Crush affiche ce message avant d’envoyer une requête lorsqu’aucun fournisseur utilisable n’est chargé. Vérifiez l’emplacement et le contenu de `crushrc`, ainsi que la configuration du projet qui peut la remplacer.
`401`	Exportez `BETTERTOKEN_API_KEY` avant de lancer Crush et vérifiez sa valeur.
Aucun modèle explicite dans la configuration	Avec uniquement un fournisseur configuré, Crush a découvert les modèles via `/v1/models` lors du test. Les entrées `model add` explicites vous permettent de nommer le modèle utilisé dans cet exemple.
Autorisation requise pour accéder aux fichiers	Vérifiez `permissions allow view` dans la configuration chargée.

Pages associées

Détails techniques

Le fournisseur openai-compat testé a envoyé les requêtes de génération vers /v1/chat/completions. La découverte des modèles utilisait /v1/models lorsque les entrées de modèle explicites étaient absentes.