Utiliser Aider avec une API LLM gratuite
Aider est un programmeur en binôme open source pour le terminal. Il modifie les fichiers de votre dépôt git et crée des commits. Ce guide connecte Aider à des modèles gratuits via FreeLLMAPI. Il présente aussi les réglages d'Aider importants pour les modèles gratuits : format d'édition, modèle faible et taille de la carte du dépôt.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Étape 1 : installer FreeLLMAPI
FreeLLMAPI est une passerelle open source. Il fonctionne sur votre ordinateur dans Docker. Il regroupe les offres gratuites de 45 fournisseurs derrière une seule clé compatible OpenAI.
Installer sur macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashOuvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Copiez votre clé unifiée depuis la même page.
Étape 2 : connecter Aider
La commande de configuration écrit ~/.aider.conf.yml. Elle crée d'abord une sauvegarde du fichier existant.
Une seule commande
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderLe fichier écrit par la commande ressemble à ceci :
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Le préfixe openai/ est obligatoire. Il indique à Aider d'envoyer le nom du modèle à une API compatible OpenAI. Pour utiliser des variables d'environnement sans fichier, procédez ainsi :
Variables d'environnement uniquement
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider cherche .aider.conf.yml dans votre répertoire personnel, puis à la racine de votre dépôt git, puis dans le répertoire courant. Le fichier chargé en dernier est prioritaire. Un fichier de projet peut donc changer le modèle pour un seul dépôt.
Étape 3 : choisir les modèles
Aider envoie vos fichiers et une carte du dépôt dans chaque requête. Il n'a pas besoin de l'appel d'outils pour sa boucle d'édition principale, car il lit les modifications dans le texte du modèle. Une grande fenêtre de contexte et un bon suivi des instructions sont plus importants. Le tableau indique les modèles gratuits avec au moins 128K de contexte à ce jour.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Oui | Non |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 de plus | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Non | Non |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Non | Non |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 de plus | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
Affichage de 12 modèles gratuits sur 184 correspondants. Voir tous les modèles.
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
Utilisez openai/auto pour laisser le routeur choisir un modèle. Utilisez openai/auto:smart pour privilégier les modèles les plus intelligents. Pour figer un seul modèle, utilisez openai/ suivi d'un identifiant du catalogue issu de GET /v1/models.
Vous pouvez aussi définir les modèles d'une session en ligne de commande. Cet exemple utilise les modèles les plus performants pour les modifications. Il utilise des modèles rapides pour les messages de commit et les résumés d'historique de chat :
Modèles pour une session
aider --model openai/auto:smart --weak-model openai/auto:fastPour un profil prévu, créez une chaîne de repli sur le tableau de bord FreeLLMAPI, par exemple une chaîne nommée coding. Utilisez ensuite --model openai/auto:coding. Un nom de profil inconnu renvoie une erreur 400, donc la requête ne passe pas vers une autre chaîne sans avertissement.
Réglages d'Aider pour les modèles gratuits
Aider connaît les réglages des modèles bien connus. Un modèle de passerelle tel que auto n'est pas connu, donc définissez ces valeurs vous-même.
| Réglage | Rôle | Valeur recommandée pour les modèles gratuits |
|---|---|---|
edit-format | Le format que le modèle utilise pour envoyer les modifications : whole, diff, diff-fenced ou udiff | diff pour les modèles performants. whole pour les modèles faibles, car il est plus simple mais envoie davantage de jetons. |
weak-model | Le modèle pour les messages de commit et les résumés d'historique de chat | openai/auto:fast, pour que les petites tâches n'utilisent pas le quota de votre modèle performant |
map-tokens | Le nombre de jetons pour la carte du dépôt. 0 la désactive. | 1024 ou moins sur les petites offres gratuites |
architect | Un modèle planifie la modification et un modèle éditeur écrit les modifications | Facultatif. Il double le nombre de requêtes. |
~/.aider.conf.yml avec les réglages pour modèles gratuits
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Pour donner à Aider la fenêtre de contexte d'un modèle de passerelle, ajoutez un fichier .aider.model.metadata.json. La clé est le nom complet du modèle. Aider cherche ce fichier aux mêmes emplacements que le fichier de configuration.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Limites de débit et basculement
Les offres gratuites ont des limites par minute et par jour. FreeLLMAPI compte l'usage de chaque clé. Lorsqu'un fournisseur envoie une erreur 429, le routeur envoie la requête au modèle suivant de votre chaîne. Aider ne voit pas l'erreur et continue.
- Ajoutez des clés d'au moins quatre fournisseurs. Plus de fournisseurs donnent plus de requêtes par jour.
- Ajoutez seulement les fichiers que vous voulez modifier avec
/add. Chaque fichier figure dans chaque requête. - Utilisez
/clearentre les tâches pour envoyer un historique de chat plus court. Un historique court réduit aussi les jetons par minute. - Utilisez
/droppour retirer les fichiers dont vous n'avez plus besoin.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
| « Model openai/auto: Unknown context window size and costs, using sane defaults. » | Aider ne connaît pas le modèle de passerelle | Cet avertissement est en général sans danger. Pour le supprimer, ajoutez .aider.model.metadata.json. |
| La modification ne s'est pas appliquée | Le modèle n'a pas suivi le format d'édition | Utilisez --edit-format whole, ou un modèle plus performant |
401 « Invalid API key » | Aider envoie une autre clé, par exemple depuis un autre fichier de configuration | Vérifiez les fichiers de configuration du répertoire personnel, de la racine git et du répertoire courant |
| Aider appelle api.openai.com | Le préfixe openai/ est utilisé, mais l'URL de base n'est pas définie | Définissez openai-api-base ou OPENAI_API_BASE |
| « All models rate-limited after N attempts » | Toutes les clés ont atteint leur limite | Ajoutez des clés d'autres fournisseurs, ou réduisez map-tokens |
Questions fréquentes
Puis-je utiliser Aider gratuitement ?
Oui. Aider est open source. Pointez-le vers FreeLLMAPI avec openai-api-base et le préfixe de modèle openai/. La passerelle utilise les offres gratuites des fournisseurs, donc l'inférence coûte 0 $.
Comment utiliser Aider avec une API compatible OpenAI ?
Définissez OPENAI_API_BASE et OPENAI_API_KEY, puis lancez aider --model openai/
Quel format d'édition utiliser avec les modèles gratuits ?
Utilisez diff pour les modèles performants, car il envoie moins de jetons. Si les modifications ne s'appliquent pas, utilisez whole. Il est plus simple pour les modèles faibles, mais envoie le fichier complet à chaque fois.
Que signifie « Unknown context window size and costs, using sane defaults » ?
Aider ne connaît pas le nom du modèle, donc il utilise des valeurs par défaut. L'avertissement est en général sans danger. Ajoutez .aider.model.metadata.json avec la fenêtre de contexte pour le supprimer.
Quel modèle gratuit est le meilleur pour Aider ?
Utilisez un modèle avec une grande fenêtre de contexte et un bon suivi des instructions. Le tableau de cette page montre les modèles gratuits les plus performants avec 128K de contexte ou plus à ce jour.
Guides associés
- Utiliser OpenCode avec une API LLM gratuite
- Utiliser Codex CLI avec des modèles gratuits
- Meilleures API gratuites de modèles de code
- URL de base des API gratuites compatibles OpenAI
- API LLM gratuite avec un contexte d'un million de tokens
Sources
- Aider docs: OpenAI-compatible APIs (vérifié le 20 November 2026)
- Aider docs: YAML config file (vérifié le 20 November 2026)
- Aider docs: options reference (vérifié le 20 November 2026)
- Aider docs: edit formats (vérifié le 20 November 2026)
- Aider docs: model warnings (vérifié le 20 November 2026)
- Aider docs: advanced model settings (vérifié le 20 November 2026)
- FreeLLMAPI CLI generators (vérifié le 20 November 2026)