Accueil › Aider › Installation

Installer Aider : guide pas à pas pour macOS, Linux et Windows

Aider s’installe en deux commandes avec pip, ou en une seule via Homebrew sur macOS. Les prérequis sont simples : Python 3.10-3.12, Git, et une clé API d’au moins un fournisseur de LLM. Ce guide couvre les trois systèmes d’exploitation, la configuration persistante et le dépannage des problèmes courants.

Prérequis

Avant d’installer Aider, vérifiez que ces trois éléments sont en place sur votre machine.

Python 3.10 à 3.12

Aider requiert Python 3.10 minimum et n’est pas encore compatible avec Python 3.13+. Vérifiez votre version :

python --version
# ou
python3 --version

Si vous n’avez pas la bonne version, téléchargez-la depuis python.org. Sur macOS, vous pouvez aussi utiliser brew install python@3.12. Si votre système a une version trop récente (3.13+) ou trop ancienne, utilisez pyenv pour installer une version compatible en parallèle sans toucher à votre Python système.

Git

Aider est profondément intégré à Git. Chaque modification est automatiquement commitée. Git est indispensable.

git --version

Si Git n’est pas installé : sur macOS, xcode-select --install l’inclut. Sur Ubuntu/Debian, sudo apt install git. Sur Windows, téléchargez-le depuis git-scm.com. Si vous travaillez sur un projet qui n’est pas encore un repo Git, initialisez-le avec git init avant de lancer Aider. Vous pouvez aussi utiliser --no-git pour contourner l’exigence Git, mais vous perdez alors les commits automatiques et la possibilité d’annuler proprement les modifications.

Clé API d’un fournisseur LLM

Aider est un outil gratuit, mais il a besoin d’un LLM pour fonctionner. Vous devez obtenir une clé API d’au moins un fournisseur. Les principales options :

Installation sur macOS

Méthode 1 : Homebrew (recommandée)

Homebrew est la méthode la plus propre sur macOS. Il gère automatiquement les dépendances et installe Aider dans un environnement isolé.

brew install aider

L’installation télécharge environ 400 Mo de dépendances (9 500+ fichiers). Une fois terminée, aider est disponible globalement dans votre terminal.

Méthode 2 : pip (universelle)

python -m pip install aider-install
aider-install

Cette méthode utilise le script d’installation officiel d’Aider, qui crée un environnement isolé propre. C’est la méthode recommandée par la documentation officielle si vous n’utilisez pas Homebrew.

Méthode 3 : pipx (environnement isolé)

brew install pipx
pipx ensurepath
pipx install aider-chat

pipx installe Aider dans un environnement virtuel dédié, isolé de vos packages Python système. C’est la méthode la plus propre si vous gérez plusieurs outils Python en parallèle.

Installation sur Linux

Méthode recommandée : pipx

Sur Ubuntu/Debian :

sudo apt update
sudo apt install pipx
pipx ensurepath
pipx install aider-chat

Sur Fedora/RHEL :

sudo dnf install pipx
pipx ensurepath
pipx install aider-chat

pipx place le binaire aider dans ~/.local/bin/aider et garde toutes les dépendances dans un virtualenv isolé. Après installation, relancez votre terminal (ou exécutez source ~/.bashrc) pour que le PATH soit mis à jour.

Méthode alternative : pip

python3 -m pip install aider-install
aider-install

Si vous préférez un environnement virtuel manuel :

python3 -m venv ~/.aider-env
source ~/.aider-env/bin/activate
pip install aider-chat

Installation sur Windows

Méthode native : pip

Assurez-vous que Python 3.10-3.12 est installé depuis python.org, puis ouvrez PowerShell :

python -m pip install aider-install
aider-install

Méthode WSL (recommandée pour les développeurs)

Si vous utilisez WSL (Windows Subsystem for Linux) avec Ubuntu, suivez les étapes Linux ci-dessus. WSL offre une expérience terminal complète et évite les problèmes spécifiques à Windows (encodage, chemins, dépendances natives).

Lancer votre première session

Naviguez dans le répertoire de votre projet (un repo Git existant ou un nouveau dossier) et lancez Aider avec le modèle de votre choix :

# Naviguez dans votre projet
cd /chemin/vers/votre/projet

# Lancement avec Claude Sonnet (recommandé pour le rapport qualité/prix)
aider --model sonnet --api-key anthropic=sk-ant-VOTRE_CLE

# Lancement avec DeepSeek (le moins cher)
aider --model deepseek --api-key deepseek=sk-VOTRE_CLE

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

Si le dossier n’est pas un repo Git, Aider proposera de l’initialiser. Acceptez et vous êtes prêt.

Aider affiche alors la liste des fichiers détectés, la carte du repo (repo map) et un prompt de chat. Tapez votre première instruction : « Ajoute un fichier README.md avec une description du projet » ou /add fichier.py pour commencer à travailler sur un fichier existant.

Configuration persistante

Passer les clés API et les options en ligne de commande à chaque lancement est fastidieux. Aider offre trois mécanismes de configuration persistante.

Fichier .env (clés API)

Créez un fichier .env à la racine de votre repo pour stocker vos clés API :

# .env
ANTHROPIC_API_KEY=sk-ant-votre-cle-anthropic
OPENAI_API_KEY=sk-votre-cle-openai
DEEPSEEK_API_KEY=sk-votre-cle-deepseek

Aider charge automatiquement ce fichier au lancement. Ajoutez .env à votre .gitignore pour ne pas commiter vos clés.

Fichier .aider.conf.yml (préférences)

Créez un fichier .aider.conf.yml à la racine du repo (ou dans votre home directory pour des réglages globaux) :

# .aider.conf.yml
model: sonnet
auto-commits: true
auto-accept-architect: true
chat-language: fr
commit-language: en
vim: false
notifications: true

Ce fichier définit vos préférences par défaut : modèle, langue du chat, comportement des commits, mode d’édition, etc. Aider cherche ce fichier dans l’ordre : racine du repo Git, répertoire courant, puis répertoire home.

Variables d’environnement

Chaque option de configuration d’Aider a une variable d’environnement correspondante (préfixée AIDER_). Par exemple, AIDER_MODEL=sonnet définit le modèle par défaut. Utile pour les configurations CI/CD ou les scripts d’automatisation.

Intégration avec votre IDE

Aider fonctionne avec n’importe quel éditeur puisqu’il opère directement sur les fichiers. Mais l’intégration peut être encore plus fluide.

Mode watch (recommandé)

Lancez Aider avec --watch-files et travaillez dans votre IDE habituel. Aider surveille vos fichiers et réagit aux commentaires # AI: que vous ajoutez dans le code. C’est la méthode la plus simple et la plus fiable, compatible avec tous les éditeurs.

Terminal intégré VS Code

Ouvrez un terminal dans VS Code et lancez Aider directement. Vous verrez les modifications apparaître en temps réel dans l’éditeur, avec les indicateurs de changement Git habituels de VS Code. Il existe des plugins tiers pour VS Code, mais la documentation officielle recommande d’utiliser le terminal intégré avec --watch-files pour garantir la compatibilité avec la dernière version d’Aider.

Neovim, JetBrains, Emacs et autres

Le mode --watch-files est la méthode universelle qui fonctionne avec tout éditeur. Lancez Aider dans un terminal à côté de votre IDE et ajoutez des commentaires # AI: votre instruction dans les fichiers. Aider détecte le commentaire, exécute l’instruction et supprime le commentaire. Votre éditeur détecte le changement de fichier et met à jour l’affichage automatiquement.

Pour les utilisateurs de Neovim ou Vim, le flag --vim (ou vim: true dans la config) active le mode vi dans le prompt Aider pour une navigation familière. Des plugins tiers existent pour Neovim et JetBrains, mais leur compatibilité avec la dernière version d’Aider n’est pas garantie.

Mise à jour d’Aider

Aider évolue rapidement (la version 0.86.2 date de février 2026, et le rythme des releases est soutenu). Pour mettre à jour :

# Via Homebrew
brew upgrade aider

# Via pipx
pipx upgrade aider-chat

# Via pip
pip install --upgrade aider-chat

# Depuis Aider lui-même
aider --upgrade

Configuration avancée

Fichier de conventions de code

Pour que le code généré par Aider respecte les standards de votre projet, créez un fichier de conventions. Ce fichier est automatiquement inclus dans le contexte envoyé au LLM à chaque requête. Vous pouvez y spécifier votre style de nommage, les patterns architecturaux préférés, les bibliothèques à utiliser (ou à éviter), les règles de formatage et toute autre convention propre à votre équipe.

Placez le fichier dans votre repo (par exemple CONVENTIONS.md) et ajoutez-le en lecture seule au lancement :

aider --read CONVENTIONS.md --model sonnet

Ou ajoutez-le dans votre .aider.conf.yml pour qu’il soit chargé automatiquement à chaque session :

# .aider.conf.yml
read:
  - CONVENTIONS.md
  - docs/architecture.md

Le fichier .aiderignore

Le fichier .aiderignore fonctionne comme un .gitignore mais pour Aider spécifiquement. Il indique à Aider quels fichiers et dossiers ignorer lors de la génération de la repo map et des suggestions de fichiers. C’est essentiel pour les gros repos :

# .aiderignore
node_modules/
dist/
build/
*.min.js
*.bundle.js
vendor/
__pycache__/
*.pyc
.next/
coverage/

En excluant les dossiers volumineux et non pertinents, vous réduisez le temps de génération de la repo map et améliorez la pertinence des suggestions de l’IA.

Alias de modèles personnalisés

Aider supporte les alias de modèles pour simplifier les commandes. Au lieu de taper le nom complet du modèle à chaque fois, vous pouvez utiliser des raccourcis prédéfinis (sonnet, opus, deepseek, grok3) ou créer les vôtres dans la configuration. Les alias intégrés sont mis à jour avec chaque release pour pointer vers les versions les plus récentes des modèles.

Prompt caching (économies de coûts)

Aider supporte le prompt caching pour les fournisseurs qui le proposent (Anthropic, OpenAI). Le caching réduit le coût des requêtes répétitives en réutilisant les prompts système et le contexte de la repo map déjà envoyés. Chez Anthropic, le cache read coûte environ 10 % du prix de l’input standard, ce qui peut représenter des économies significatives sur des sessions longues où le contexte (repo map, fichiers en lecture seule) reste stable d’une requête à l’autre.

Le caching est généralement activé automatiquement quand le fournisseur le supporte. Vous n’avez rien à configurer.

Sécurité des clés API

Quelques bonnes pratiques pour la gestion de vos clés API avec Aider :

Ne commitez jamais vos clés dans Git. Stockez-les dans un fichier .env ajouté au .gitignore, ou utilisez des variables d’environnement système. Si vous travaillez en équipe, chaque développeur devrait avoir ses propres clés API sur des comptes séparés pour tracer la consommation individuelle.

Pour les environnements corporate sensibles, Aider peut fonctionner avec des modèles locaux via Ollama, éliminant tout envoi de code vers des API externes. C’est la seule option véritablement « air-gapped » : votre code ne quitte jamais votre machine. La qualité des résultats dépend du modèle local utilisé, mais les modèles de 14B+ paramètres offrent des résultats corrects pour les tâches de base.

Si votre entreprise utilise un proxy ou un endpoint API custom (par exemple Azure OpenAI ou Amazon Bedrock), Aider supporte la configuration d’URL de base personnalisées pour chaque fournisseur via les variables d’environnement ou le fichier de configuration.

Désinstallation

Si vous devez désinstaller Aider :

# Via Homebrew
brew uninstall aider

# Via pipx
pipx uninstall aider-chat

# Via pip
pip uninstall aider-chat

La désinstallation ne supprime pas vos fichiers de configuration (.aider.conf.yml, .env, .aiderignore). Supprimez-les manuellement si nécessaire. Les commits Git créés par Aider restent dans votre historique Git : ils font partie de votre repo et n’ont rien de spécifique à Aider.

Dépannage des problèmes courants

« Python version not supported »

Aider requiert Python 3.10-3.12. Si vous avez Python 3.13+, installez une version compatible avec pyenv : pyenv install 3.12.8 puis pyenv local 3.12.8 dans votre repo.

« Git not found » ou erreurs Git

Vérifiez que Git est installé et dans votre PATH. Si le dossier n’est pas un repo Git, initialisez-le : git init. Pour travailler sans Git (non recommandé), utilisez --no-git.

Erreurs de clé API

Vérifiez que votre clé est correcte et que vous avez des crédits sur le compte du fournisseur. La syntaxe en ligne de commande est --api-key fournisseur=clé (par exemple --api-key anthropic=sk-ant-...). Si vous utilisez un fichier .env, vérifiez que le nom de la variable correspond exactement au format attendu (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.).

Repo map très lent sur un gros projet

Pour les repos de plus de quelques milliers de fichiers, la génération de la carte peut prendre du temps. Solutions : utilisez --subtree-only pour limiter le scope au sous-répertoire courant, créez un fichier .aiderignore pour exclure les dossiers volumineux (node_modules, build, dist, .git), ou réduisez le budget de tokens de la repo map dans la configuration.

Conflits de dépendances Python

Si l’installation via pip entre en conflit avec d’autres packages, utilisez pipx (qui crée un environnement isolé) ou un virtualenv dédié. C’est la solution la plus fiable pour éviter les conflits de dépendances.