Configuration de la clé API Crush
Clé API Crush : définissez votre propre clé dans crushrc
Collez le bloc ci-dessous dans crushrc, remplacez par votre propre clé API, et Crush peut utiliser les modèles Claude et d'autres modèles. Paiement à l'usage.
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
--base-url "https://api.aicodewith.ai/v1" \
--api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"Étapes de configuration
Enregistrez cette clé pour les terminaux suivants
Une fois connecté, cette commande inclut votre propre clé. Copiez-la, exécutez-la une fois, et l'outil conserve la clé à l'emplacement que nous avons testé.
mkdir -p "$(dirname "$HOME/.config/crush/crushrc")"
cat > "$HOME/.config/crush/crushrc" << 'EOF'
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
--base-url "https://api.aicodewith.ai/v1" \
--api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"
EOFLes visiteurs déconnectés ne voient qu'un espace réservé. Connectez-vous et nous remplirons votre clé. Sign in · Obtenir une clé dans la console
Copier ne fait que placer la commande dans le presse-papiers. Vous devez encore l'exécuter dans un terminal, ou coller la clé dans les paramètres de l'outil. Comment obtenir une clé API
Ces étapes ont été testées sur Linux (bash). macOS et Windows n'ont pas encore été testés, ils ne sont donc pas listés.
Pas encore de Crush ? Installez-le (ignorez si déjà installé)
Exécutez
npm i -g @charmland/crush, puiscrush --version. Un numéro de version signifie qu'il est installé.Installez Crush avec npm i -g @charmland/crush. crush --version dessine ensuite son logo pixel et affiche la version de crush v0.98.1 Collez la configuration dans crushrc et ajoutez votre clé API
Ouvrez
~/.config/crush/crushrc, collez le bloc depuis le haut de cette page, et remplacezsk-***par votre clé API (Obtenir une clé API). Écrivez la clé elle-même après--api-key, et non"$AICODEWITH_API_KEY", afin qu'un nouveau terminal la conserve.Dans ~/.config/crush/crushrc, définissez --api-key sur votre clé (masquée ici en sk-***) Ouvrez un nouveau terminal et testez Crush
Ouvrez un nouveau terminal et exécutez
crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK".OKsignifie que Crush utilise votre clé API.Vérification : fermez le terminal, ouvrez-en un nouveau, exécutez crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" ; une réponse OK signifie que c'est configuré. Pas de OK ? Faites correspondre votre erreur
Comparez l'erreur dans votre terminal avec les erreurs courantes ci-dessous. Chacune liste la cause et le correctif.
Changer de modèle Crush : modifiez le nom après -m
Après
-m, écrivezaicodewith/suivi d'un modèle que vous avez ajouté avecmodel adddans crushrc, par exempleaicodewith/deepseek-flash. Les identifiants de modèle sont sur Modèles et tarifs.
Erreurs courantes
Aucune clé définie : Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
Ce que vous voyez
Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(Anglais : "Veuillez fournir une clé API valide dans la requête.")- Cause
- --api-key dans crushrc est "$AICODEWITH_API_KEY", et le nouveau terminal n'a pas cette variable
- Comment corriger
- Écrivez votre clé directement après --api-key, comme à l'étape 2
Revenir à l’étape 2 : Collez la configuration dans crushrc →
Mauvaise clé : Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
Ce que vous voyez
Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(Anglais : "Veuillez fournir une clé API valide dans la requête.")- Cause
- La clé dans --api-key est incorrecte ; l'erreur est la même que sans clé
- Comment corriger
- Copiez à nouveau la clé depuis la console et remplacez la valeur entre les guillemets de --api-key
Revenir à l’étape 2 : Collez la configuration dans crushrc →
403 Interdit
Ce que vous voyez
403 Interdit (le texte du message varie selon le réseau, par ex. Request not allowed ou Country, region, or territory not supported)
- Cause
- La commande n'a pas de -m aicodewith/<model>, donc Crush appelle le point de terminaison Anthropic par défaut (api.anthropic.com)
- Comment corriger
- Ajoutez -m aicodewith/deepseek-flash (ou un autre modèle de la configuration)
Revenir à l’étape 3 : Ouvrez un nouveau terminal et testez Crush →
FAQ
Comment utiliser ma propre clé API dans Crush ?
Dans ~/.config/crush/crushrc, provider add un fournisseur openai-compat avec --base-url https://api.aicodewith.ai/v1 et écrivez votre clé après --api-key. Un nouveau terminal la conserve.
openai ou openai-compat ?
Utilisez openai-compat. Gardez openai pour vous connecter directement à OpenAI.
Où se trouve le crushrc de Crush ?
Global : ~/.config/crush/crushrc. Un .crushrc ou crushrc de projet est prioritaire.
Crush affiche unauthorized. Que faire ?
--api-key dans crushrc est vide ou incorrect. Voir les erreurs courantes ci-dessus pour la solution.