Configuration des Coding Agents

Configurer Aider : clé API, Base URL et modèles

Installez Aider, configurez la Base URL et l’API Key BetterToken, choisissez un modèle disponible et résolvez les erreurs courantes. Plus.

Pour connecter Aider à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Prérequis

La version actuelle de l’outil est installée
Une BetterToken API Key : inscrivez-vous pour en obtenir une
Un Model ID du model plaza

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Exigences supplémentaires

Installez Python

Installation

Installer Aider

Exécutez les commandes suivantes dans un terminal :

python -m pip install aider-install
aider-install

Après l’installation, vérifiez qu’Aider est disponible :

aider --help

Configuration manuelle

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Configurer BetterToken pour le terminal actuel

macOS / Linux

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

Windows PowerShell

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

Après setx, fermez et rouvrez PowerShell. Placez-vous ensuite dans votre répertoire de projet et exécutez :

aider --model openai/YOUR_MODEL_ID

Remplacez YOUR_API_KEY par votre BetterToken API Key. YOUR_MODEL_ID n’est qu’un exemple. Remplacez-le par un model ID actuel disponible du model plaza et conservez le préfixe openai/.

Enregistrer la configuration avec .env

Pour éviter de définir les variables à chaque ouverture de terminal, créez un fichier .env à la racine Git de votre projet :

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

Ajoutez .env à .gitignore pour ne pas valider l’API Key. Placez-vous ensuite dans le répertoire du projet et exécutez :

aider

Pour utiliser un autre fichier dans un projet, indiquez-le explicitement :

aider --env-file ./aider-bettertoken.env

Facultatif : utiliser .aider.conf.yml

Pour conserver uniquement les paramètres non sensibles, créez .aider.conf.yml dans votre répertoire personnel ou de projet :

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

Conservez l’API Key dans la variable d’environnement OPENAI_API_KEY plutôt que dans un fichier YAML partagé.

Changer le Model ID

Remplacez le modèle dans la commande de lancement par un model ID actuel disponible :

aider --model openai/YOUR_MODEL_ID

Ne supprimez pas le préfixe openai/. Le Model ID doit être compatible avec l’endpoint configuré.

Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.

Erreurs fréquentes

Symptôme	Action à effectuer
`401`, `Unauthorized` ou `Invalid API key`	Vérifiez `OPENAI_API_KEY`, confirmez qu’il s’agit d’une BetterToken API Key et supprimez les espaces superflus.
`model not found` ou modèle indisponible	Copiez un model ID actuel disponible dans le model plaza et transmettez-le à Aider sous la forme `openai/model-id`.
URL de Request incorrecte ou `404`	Vérifiez que `OPENAI_API_BASE` est `https://bettertoken.ai/v1`. N’ajoutez pas `/chat/completions`.
Windows ne lit pas les nouvelles variables	`setx` ne s’applique qu’aux terminaux ouverts après son exécution. Fermez la fenêtre PowerShell actuelle et ouvrez-en une nouvelle.
Aider indique un modèle inconnu	Vérifiez d’abord le model ID et le fournisseur d’API. Aider peut afficher un avertissement pour un nouveau modèle, mais vous devez toujours utiliser un ID actuel du model plaza.

FAQ de configuration

Quelle Base URL Aider doit-il utiliser ?

Utilisez https://bettertoken.ai/v1. Il s’agit de la Base URL OpenAI compatible de BetterToken.

Pourquoi le nom du modèle doit-il avoir le préfixe openai/ ?

Aider utilise ce préfixe pour identifier un modèle OpenAI compatible. Son omission peut amener Aider à sélectionner le mauvais fournisseur.

Puis-je placer l’API Key dans .aider.conf.yml ?

Nous ne le recommandons pas. Utilisez des variables d’environnement ou un fichier .env ignoré par Git afin de réduire le risque d’exposer une API Key dans les fichiers du projet.

Configuration avancée

Guides associés

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.