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/crushrccrushrc
config
# ~/.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é.

bash
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"
EOF

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

  1. Pas encore de Crush ? Installez-le (ignorez si déjà installé)

    Exécutez npm i -g @charmland/crush, puis crush --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
  2. Collez la configuration dans crushrc et ajoutez votre clé API

    Ouvrez ~/.config/crush/crushrc, collez le bloc depuis le haut de cette page, et remplacez sk-*** 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-***)
  3. 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". OK signifie 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é.
  4. 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.

  5. Changer de modèle Crush : modifiez le nom après -m

    Après -m, écrivez aicodewith/ suivi d'un modèle que vous avez ajouté avec model add dans crushrc, par exemple aicodewith/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 →

Aucune clé définie : crushrc fait référence à "$AICODEWITH_API_KEY" mais le nouveau terminal n'a pas cette variable. L'exécution de crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" affiche, sous une étiquette ERROR rouge : Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. (Anglais : "Veuillez fournir une clé API valide dans la requête.")

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 →

Mauvaise clé : grep -n sk-wrong ~/.config/crush/crushrc montre que la ligne 3 est --api-key "sk-wrong". L'exécution de crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" affiche, sous une étiquette ERROR rouge : Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. (Anglais : "Veuillez fournir une clé API valide dans la requête.") — la même chose que sans clé

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 →

Erreur courante : sans -m aicodewith/<model>, Crush appelle le point de terminaison Anthropic par défaut (api.anthropic.com) et obtient 403 Interdit (le texte du message varie selon le réseau, par ex. Request not allowed ou Country, region, or territory not supported). Ajoutez -m aicodewith/deepseek-flash (ou un autre modèle de la configuration)

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.

Sources

Liens associés