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.

Installer Connecter une clé API Première édition dépôt

À 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.

01

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.

02

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.

03

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. 1

    Installer aider-chat

    Le nom PyPI est aider-chat, pas un paquet aider nu. Typique : python3 -m pip install aider-chat. Isolé : pipx install aider-chat ou uv tool install --python python3.12 aider-chat. Vérifier avec aider --help.

  2. 2

    Connecter une clé API

    Dans le shell, export OPENAI_API_KEY=… ou export ANTHROPIC_API_KEY=…. Pour les sessions répétées, les mêmes noms dans un .env racine, puis gitignore. aider --list-models liste les fournisseurs reconnus. IDs : aider.chat/docs/llms.html.

  3. 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.

0
IDE supplémentaire
2
Variables de clé courantes
1
Premier prompt
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éthodeFacturationMieux pour
OPENAI_API_KEYTarifs OpenAI PlatformGPT en local sur le dépôt
ANTHROPIC_API_KEYUsage AnthropicClaude en local sur le dépôt
.env racineMê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 init et 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.

Créer un espace gratuit