Fichier de configuration Aider pour votre propre clé API : .aider.conf.yml et setx sous Windows

Deux variables, OPENAI_API_BASE et OPENAI_API_KEY, et un argument de modèle comme openai/<model id> suffisent pour pointer Aider vers CheapTokens. Les bases pas à pas (installation, première requête, 401/404/400/402) se trouvent dans How to connect Aider to CheapTokens ; cette page couvre ce que ce guide laisse de côté : le setx sous Windows, le fichier de configuration et son ordre de chargement, et une estimation du coût d'une session.

Source : la documentation d'Aider pour les API compatibles OpenAI (page consultée le 26 octobre 2026 ; la documentation n'indique ni date ni version, et la dernière aider-chat sur PyPI ce jour-là était 0.86.2).

Windows : setx et un nouveau terminal#

Sur Mac et Linux, vous export les deux variables. Sous Windows (PowerShell ou cmd), utilisez setx :

setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Sous Windows, il y a un piège. setx écrit les variables pour les sessions futures, pas pour celle dans laquelle vous tapez, donc fermez le terminal et ouvrez-en un nouveau avant de lancer Aider. Si vous définissez les variables et qu'Aider demande encore une clé, c'est la raison habituelle.

Quel modèle pour quelles modifications#

L'argument de modèle est openai/ suivi de l'id complet, donc pour CheapTokens il comporte deux barres obliques :

cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 a un contexte de 180K et répond jusqu'à 8 192 tokens, ce qui convient aux modifications petites et moyennes où les réponses restent courtes. Si vos modifications reviennent sous forme de longs diffs, l'autre modèle à essayer est DeepSeek-V4-Flash : jusqu'à 32 768 tokens par réponse, un contexte de 380K et un prix unique à toute heure de la journée.

aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Copiez l'id complet depuis la documentation CheapTokens ou la liste des modèles sur la page pricing.

Lancer une première modification#

Aider fonctionne à l'intérieur d'un dépôt git, donc commencez dans un dépôt. Ajoutez un fichier et demandez quelque chose de petit :

> /add app.py
> Add a --verbose flag that prints each file before it is processed

Quand Aider répond par une modification du fichier, la clé, l'URL de base et l'id du modèle sont tous corrects.

Arrêtez de tout retaper : .aider.conf.yml#

Aider lit .aider.conf.yml depuis votre répertoire personnel, puis la racine du dépôt git, puis le répertoire courant, et les fichiers suivants l'emportent. Un fichier global peut donc contenir la clé et l'URL de base, et un fichier de dépôt peut choisir le modèle. Si vous voulez un fichier précis et rien d'autre, aider --config <file> ne charge que celui-là.

Un fichier dans le répertoire personnel (exemple, mettez votre propre clé) :

openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Maintenant, aider seul démarre avec le bon endpoint et le bon modèle. Si vous committez le fichier dans un dépôt, laissez la clé de côté et gardez-la dans la variable d'environnement ou dans un fichier .env ; les lignes de clé sont destinées à votre répertoire personnel.

Pour un modèle qu'Aider ne connaît pas, la documentation décrit un model-settings-file (.aider.model.settings.yml) où vous pouvez spécifier ses paramètres.

Ce que coûte une session#

Aider renvoie les fichiers que vous avez ajoutés et l'historique de conversation à chaque message, donc les tokens d'entrée augmentent plus vite que ceux de sortie. Disons qu'une session de travail d'environ 20 messages envoie 400 000 tokens d'entrée et reçoit 40 000 tokens de sortie (une hypothèse pour l'exemple ; mettez vos propres chiffres). Sur MiniMax-M2.7, cela fait $0.026, et c'est moins cher qu'OpenRouter au total, entrée et sortie comptées ensemble. Le tableau ci-dessous déroule la même session sur nos modèles :

Comment garder le côté entrée petit (fichiers en lecture seule, /drop, taille de la repo map) est couvert dans How much does Aider cost. Les prix actuels sont toujours sur la page pricing.

Si ça ne fonctionne pas#

• Aider demande une clé API ou parle au mauvais service. Les variables ne sont pas visibles pour le processus. Sous Windows, redémarrez le terminal après setx ; sur Mac et Linux, exécutez echo $OPENAI_API_BASE dans le même shell.
• Votre configuration semble ignorée. Rappelez-vous l'ordre : répertoire personnel, racine du dépôt, répertoire courant. Un fichier plus proche de vous écrase le fichier global.
• Modèle introuvable, 404 ou erreur d'authentification. Ces cas sont couverts dans How to connect Aider to CheapTokens.

La même adresse compatible OpenAI fonctionne dans d'autres outils ; si vous utilisez aussi un agent d'éditeur, voir connecting OpenCode ou l'aperçu de where to plug in your own API key.