Accueil › Aider › Guide

Aider : guide complet du pair programming IA en terminal

Aider est un outil open-source qui transforme votre terminal en session de pair programming avec un LLM. Il lit votre codebase, modifie les fichiers directement et commite automatiquement dans Git. Gratuit, compatible avec Claude, GPT, Gemini, DeepSeek et les modèles locaux, c’est l’alternative légère aux IDE IA comme Cursor.

Pourquoi utiliser Aider plutôt qu’un IDE IA ?

Aider occupe une niche précise dans l’écosystème des outils de coding IA. Contrairement à Cursor (IDE complet) ou Claude Code (agent terminal intégré à l’écosystème Anthropic), Aider est un outil léger, agnostique et centré sur Git.

Ses avantages distinctifs : il fonctionne avec n’importe quel éditeur (VS Code, Neovim, JetBrains, Emacs, peu importe), car il opère directement sur les fichiers de votre repo. Chaque modification est automatiquement commitée dans Git avec un message descriptif. Vous gardez un historique complet et pouvez annuler n’importe quel changement IA avec un simple git revert. Il est compatible avec pratiquement tous les LLM du marché, des API cloud aux modèles locaux via Ollama.

La philosophie d’Aider : l’IA modifie les fichiers, Git traque les changements, vous gardez le contrôle total. Pas de lock-in vers un IDE propriétaire, pas d’abonnement (sauf le coût API du modèle), pas de fonctionnalités cachées derrière un paywall.

Installation rapide

Aider s’installe en deux commandes. Vous avez besoin de Python 3.10 à 3.12 et de Git.

python -m pip install aider-install
aider-install

Ensuite, naviguez dans le répertoire de votre projet et lancez Aider avec le modèle de votre choix :

# Avec Claude Sonnet
cd /chemin/vers/votre/projet
aider --model sonnet --api-key anthropic=VOTRE_CLE

# Avec DeepSeek
aider --model deepseek --api-key deepseek=VOTRE_CLE

# Avec GPT-5.4
aider --model gpt-5.4 --api-key openai=VOTRE_CLE

# Avec un modèle local via Ollama
aider --model ollama/codellama

Pour une installation plus détaillée (environnements virtuels, configuration persistante, intégration IDE), consultez la page Installation d’Aider.

Concepts clés à comprendre

La carte du repo (Repo Map)

Quand vous lancez Aider dans un projet, il génère automatiquement une carte interne de votre codebase. Cette carte utilise tree-sitter pour parser la structure de votre code (classes, fonctions, imports, dépendances) et créer un index sémantique. C’est ce qui permet à Aider de comprendre les relations entre les fichiers et de faire des modifications cohérentes dans un projet de grande taille.

La repo map est transmise au LLM dans le contexte, ce qui lui permet de savoir quels fichiers existent, quelles fonctions sont définies où, et comment les modules s’interconnectent, même sans avoir lu chaque fichier en intégralité. C’est un avantage significatif par rapport à un simple copier-coller de code dans un chat LLM.

Fichiers dans le chat

Aider distingue deux types de fichiers dans une session :

Les fichiers éditables (ajoutés avec /add) : Aider peut les lire ET les modifier. Chaque modification sera commitée. Ajoutez uniquement les fichiers sur lesquels vous voulez que l’IA travaille.

Les fichiers en lecture seule (ajoutés avec /read-only) : Aider peut les lire pour comprendre le contexte, mais ne les modifiera pas. Utile pour les fichiers de configuration, les types partagés ou les dépendances que vous voulez exposer au LLM sans risquer de modification.

Cette distinction est cruciale pour le contrôle. Ne mettez pas tout votre repo en mode éditable. Ajoutez précisément les fichiers concernés par votre tâche, et mettez les fichiers de contexte en lecture seule.

Formats d’édition

Aider utilise différents formats d’édition pour communiquer les changements au LLM. Le format par défaut dépend du modèle utilisé. Les principaux : diff (le LLM génère un patch diff classique), whole (le LLM réécrit le fichier entier), editor-diff (un modèle éditeur corrige le diff du modèle principal). Aider sélectionne automatiquement le meilleur format pour chaque modèle, mais vous pouvez le forcer si nécessaire.

Les quatre modes de chat

Aider propose quatre modes qui définissent comment l’IA interagit avec votre code. Comprendre ces modes est essentiel pour un usage efficace.

Mode Code (par défaut)

Le mode standard. Vous décrivez ce que vous voulez, Aider génère les modifications et les applique directement aux fichiers. C’est le mode pour l’implémentation : « Ajoute une fonction de validation d’email dans utils.py », « Corrige le bug dans la gestion des erreurs du endpoint /api/users ».

Mode Architect

Lancez avec aider --architect ou basculez avec /architect. Dans ce mode, le LLM principal (par exemple Opus 4.6) planifie les changements, puis un modèle éditeur (par exemple Sonnet 4.6) les implémente. C’est optimal pour les refactors complexes et les tâches de design architectural où la planification est aussi importante que l’exécution.

Le flag --auto-accept-architect (activé par défaut) permet d’accepter automatiquement les propositions de l’architecte sans confirmation manuelle, ce qui fluidifie le workflow.

Mode Ask

Activez avec /ask. Le LLM répond à vos questions sans modifier de fichier. Utilisez-le pour comprendre du code existant, discuter d’une approche avant de la mettre en œuvre, ou obtenir des explications sur une logique complexe. C’est le mode exploration.

Un workflow productif consiste à alterner entre /ask (« Comment fonctionne la gestion du cache ici ? ») et /code (« Ajoute un TTL de 5 minutes à ce cache ») dans la même session.

Mode Help

Activez avec /help. Fournit de l’aide sur Aider lui-même : commandes disponibles, configuration, bonnes pratiques.

Commandes essentielles

Intégration Git : le point fort d’Aider

L’intégration Git est ce qui distingue fondamentalement Aider des chatbots de code classiques. Chaque modification appliquée par Aider est automatiquement commitée avec un message descriptif. Les messages de commit incluent par défaut une attribution co-authored-by pour tracer les contributions IA.

En pratique, cela signifie que vous pouvez utiliser tous les outils Git classiques pour gérer les changements IA : git log pour voir l’historique, git diff pour comparer, git revert pour annuler, git stash pour mettre de côté. Si l’IA produit une modification qui ne vous convient pas, un simple /undo annule le dernier commit et restaure l’état précédent.

Pour les sessions de travail où vous voulez plus de contrôle, le flag --no-auto-commits désactive les commits automatiques. Les modifications sont appliquées aux fichiers mais restent non commitées, vous laissant le soin de les staguer et commiter manuellement.

Linting et tests automatiques

Aider peut automatiquement exécuter vos linters et suites de tests après chaque modification. Si des erreurs sont détectées, Aider les voit et propose des corrections. Ce cycle edit-lint-fix-test crée une boucle de feedback rapide qui améliore significativement la qualité du code généré.

Pour activer cette fonctionnalité, configurez vos commandes de lint et de test dans le fichier .aider.conf.yml ou passez-les en ligne de commande. Aider détecte automatiquement les frameworks de test courants (pytest, jest, etc.) dans la plupart des cas.

Quel modèle utiliser avec Aider ?

Le choix du modèle impacte directement la qualité des résultats et le coût. Voici les recommandations basées sur les benchmarks d’Aider :

Pour un guide détaillé sur la configuration de chaque fournisseur, consultez Aider : modèles compatibles.

Fonctionnalités avancées

Coding vocal

Aider supporte le voice-to-code : vous pouvez dicter vos instructions vocalement. L’outil transcrit votre voix et envoie la commande au LLM. C’est particulièrement utile pour décrire des changements complexes sans taper de longs prompts. La transcription utilise votre micro système et fonctionne avec les APIs de transcription standard.

Images et pages web dans le chat

Vous pouvez ajouter des images (screenshots, maquettes, diagrammes) et des pages web au chat pour donner du contexte visuel au LLM. Exemple : partagez une capture d’écran d’un bug visuel et demandez à Aider de corriger le CSS. Ou ajoutez l’URL d’une documentation de référence pour que l’IA s’en inspire.

Intégration IDE (commentaires AI)

Aider peut surveiller vos fichiers et répondre aux commentaires que vous ajoutez directement dans votre code. Ajoutez un commentaire # AI: refactor this function to use async/await dans votre éditeur, sauvegardez, et Aider détecte le commentaire et exécute la modification. Cela permet de travailler avec Aider sans quitter votre IDE favori.

Conventions de code personnalisées

Créez un fichier de conventions pour indiquer à Aider comment coder selon vos standards : style de nommage, patterns préférés, frameworks à utiliser, règles spécifiques à votre projet. Aider inclut ces conventions dans le contexte envoyé au LLM, ce qui améliore la cohérence du code généré avec votre codebase existante.

Scripting et automatisation

Aider peut être scripté via la ligne de commande ou via Python. Vous pouvez intégrer Aider dans des pipelines CI/CD, des scripts de migration ou des workflows d’automatisation. Le flag --yes accepte automatiquement toutes les confirmations, ce qui permet une exécution non interactive.

Limites à connaître

Aider est un outil en beta (version 0.86.x). Quelques limites à considérer avant adoption.

Les performances sur les très gros repos peuvent être lentes. La génération de la repo map prend du temps sur des codebases de plusieurs milliers de fichiers. Les options --subtree-only et .aiderignore permettent de limiter le scope.

Pas de collaboration temps réel. Aider est un outil mono-utilisateur. Il n’y a pas de fonctionnalités d’équipe intégrées, de partage de sessions ou de gestion de permissions.

Le coût API peut surprendre. Avec les modèles premium (Opus, GPT-5.4), le coût moyen par commande atteint 0,50 $ à 0,70 $. Sur une journée de travail intensif, la facture peut monter à 20-50 $. Surveillez votre consommation et utilisez des modèles moins coûteux pour les tâches routinières.

L’interface terminal peut rebuter les développeurs habitués aux IDE graphiques. Il n’y a pas de prévisualisation diff visuelle intégrée (vous devez utiliser vos outils Git habituels), pas de système de suggestions inline, et l’expérience est entièrement textuelle.