Installer et utiliser Aider : pip/uv, clé API, première édition
Installer Aider avec pip ou uv, connecter une clé API, puis terminer une première édition dans un vrai dépôt Git.
Il vous faut un agent de pair-programming qui lit un dépôt Git local, propose un diff et modifie des fichiers — sans quitter le terminal.
Ce parcours couvre comment installer et utiliser Aider : installer aider-chat avec pip, pipx ou uv, connecter une clé API, puis une première édition dans un vrai dépôt. Étapes d’après aider.chat/docs/install.html et aider.chat/docs/usage.html.
À qui ça s’adresse
Aider travaille sur un dépôt Git local : inspecter, proposer des rustines, écrire après accord, éventuellement committer. Ce n’est pas un onglet web, et l’extension IDE n’est pas obligatoire. Le dossier doit déjà être un projet Git.
Démarrer dans un vrai dépôt
Faire cd dans un projet Git existant avant de lancer. Au premier run, un ou deux fichiers comme le README, une ligne relisible.
Les clés vivent dans l’environnement
Usage officiel : OPENAI_API_KEY ou ANTHROPIC_API_KEY. Les exporter, ou les mettre dans un .env à la racine. Ne pas les coller dans le prompt, ne pas committer ce fichier.
Les commits peuvent être actifs
Après acceptation, git commit tourne souvent. Arbre propre et secrets dans .gitignore avant de commencer.
Installer, clé, première édition
-
1
Installer aider-chat
Le nom PyPI est
aider-chat, pas un paquetaidernu. Typique :python3 -m pip install aider-chat. Isolé :pipx install aider-chatouuv tool install --python python3.12 aider-chat. Vérifier avecaider --help. -
2
Connecter une clé API
Dans le shell,
export OPENAI_API_KEY=…ouexport ANTHROPIC_API_KEY=…. Pour les sessions répétées, les mêmes noms dans un.envracine, puis gitignore.aider --list-modelsliste les fournisseurs reconnus. IDs : aider.chat/docs/llms.html. -
3
Faire une première édition
Entrer dans le dépôt et lancer
aider README.md. Demander un changement ciblé, par exemple une ligne de README. Lire le diff avant d’accepter. Pour couper l’auto-commit, le commutateur des docs Usage — ne pas extraire une clé de l’historique plus tard.
python3 -m pip install aider-chat
# pipx install aider-chat
# uv tool install --python python3.12 aider-chat
export OPENAI_API_KEY=sk-...
# export ANTHROPIC_API_KEY=sk-ant-...
cd ~/code/your-repo
aider README.md
# Add a one-line note to the README that this repo uses Aider for local edits
Ce qui bloque souvent le premier run
| Méthode | Facturation | Mieux pour |
|---|---|---|
| OPENAI_API_KEY | Tarifs OpenAI Platform | GPT en local sur le dépôt |
| ANTHROPIC_API_KEY | Usage Anthropic | Claude en local sur le dépôt |
| .env racine | Même clé | Sessions locales répétées |
- Il faut déjà du Git
- Aider s’appuie sur Git pour le contexte et les commits. Dossier vide :
git initet au moins un commit avant la première session. Ne pas tester un répertoire sans version. - Traiter .env comme un mot de passe
- Ne pas le committer ni le coller dans un ticket. S’il a déjà atteint un distant, faire tourner la clé dans la console du fournisseur — effacer le message de commit ne suffit pas.
- L’auto-commit emporte l’arbre sale
- Vérifier la zone d’index avant d’accepter. Clés, surcharges locales et gros artefacts doivent déjà être ignorés. Commits manuels : couper l’auto-commit selon la doc.
Rappel officiel : les appels API facturent aux tarifs du fournisseur. Apprendre la boucle avec un modèle moins cher et court, puis passer au modèle que vous voulez vraiment payer.
Quand le diff doit se discuter
Après les édits, il manque souvent une image : ce qui a changé et pourquoi ça peut fusionner. Pas de suite de réunion en plus. Ouvrir un espace court sur tidemeet ou voir comment créer un espace. Canevas : bases du tableau. Autre agent terminal sur ce site : Codex CLI.
Questions
Faut-il installer une extension IDE ?
Non. Aider est un programme terminal autonome. Une première édition dépôt n’a besoin que de Python, Git et une clé API valide.
Quelle différence entre pip et uv ?
Le même paquet aider-chat. pip écrit dans l’interpréteur courant ; pipx et uv tool installent une commande isolée, mieux pour un portable durable. Prenez celui que vous avez déjà.
La première édition doit-elle être un gros refactor ?
Non. Nommer les fichiers, demander un changement relisible, arbre propre, secrets ignorés, lire le diff avant d’accepter.
Quel rapport avec un outil de réunion temporaire ?
Aucun lien produit. S’il s’agit seulement de parler d’un diff, outils de réunion temporaires dit quand un court espace navigateur suffit.