Installation d'Aider et configuration d'OmniProxy

Aider est un outil qui aide à modifier du code depuis le terminal. Il crée une carte de l’ensemble de la base de code pour aider le modèle à comprendre les projets plus vastes. Git est un outil de contrôle de version qui enregistre les modifications de code, vous permettant d’inspecter les différences et de restaurer des versions précédentes. Après avoir confié une tâche à Aider, il la traite étape par étape et rédige des messages de validation (commit). Si les changements ne vous plaisent pas, vous pouvez les annuler avec /undo.

Avant de commencer

Il existe deux options d’installation courantes :

Si votre ordinateur possède déjà Python 3.8 à 3.13, installez aider-install en premier. Python est l’environnement d’exécution requis par Aider.
Si vous n’avez pas de version de Python appropriée, utilisez la commande d’installation en une ligne. Elle configurera également Python 3.12 si nécessaire.

Mac et Linux

install.sh

Exécuter avec sh après curl
Installe Python si nécessaire
Utiliser wget si curl n'est pas disponible

Windows

install.ps1

Exécuter dans PowerShell
Rouvrir le terminal après l'installation
Définir les variables d'environnement avec setx

Python déjà installé

aider-install

Installer d'abord ce paquet avec pip
Ensuite, exécuter aider-install
Il crée son propre environnement

L'installateur en une ligne configure Python 3.12 si nécessaire. L'installation directe d'aider-chat avec pip est moins fiable.

Assurez-vous qu’OmniProxy est en cours d’exécution. Après l’installation, entrez dans le répertoire du projet que vous prévoyez de modifier avant de démarrer Aider.

Installation et premier lancement

Si vous avez déjà Python 3.8 à 3.13

Exécutez ces commandes dans l’ordre :

python -m pip install aider-install
aider-install

aider-install installe Aider dans un environnement Python séparé afin qu’il n’interfère pas avec d’autres projets Python sur votre ordinateur. Si nécessaire, il installe également Python 3.12 pour qu’Aider puisse l’utiliser.

Installation en une ligne

Sur Mac et Linux, exécutez :

curl -LsSf https://aider.chat/install.sh | sh

Si curl n’est pas installé, utilisez :

wget -qO- https://aider.chat/install.sh | sh

Dans Windows PowerShell, exécutez :

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Ces commandes en une ligne sont basées sur uv, un programme pour installer et gérer les outils et environnements Python. Vous pouvez également utiliser la commande suivante :

uv tool install --force --python python3.12 --with pip aider-chat@latest

Vous pouvez aussi utiliser pipx. Lors de l’installation directe avec python -m pip install aider-chat, les versions de Python prises en charge sont 3.9 à 3.12. Cependant, il s’agit d’une méthode d’installation alternative, privilégiez donc les méthodes décrites ci-dessus. Les paquets Aider provenant des gestionnaires de paquets système peuvent présenter des incompatibilités de dépendances, ils ne devraient donc pas être votre premier choix.

Le 2026-10-09, la commande d’installation en une ligne a installé Aider v0.86.2. Pendant l’installation, vous pourriez voir un message indiquant que le cache et la destination sont sur des disques différents et que les fichiers seront copiés. L’installation se terminera tout de même.

Après l’installation, entrez dans le répertoire du projet. Une API compatible est une interface qui communique avec d’autres services de modèles en utilisant le format OpenAI. Démarrez Aider en utilisant ce modèle :

aider --model openai/<model-name>

Remplacez <model-name> par l’ID complet du modèle copié depuis OmniProxy dans la section suivante. Un ID de modèle est le nom utilisé pour identifier précisément un modèle.

Obtenir les paramètres de connexion depuis OmniProxy

Vous devez définir les deux variables d’environnement suivantes. Les variables d’environnement peuvent être comprises comme un ensemble de paramètres de connexion lus par les programmes du terminal :

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE est le point de terminaison (endpoint) de l’API et doit inclure /v1. OPENAI_API_KEY est la clé utilisée pour accéder à l’API.

Sur Windows, utilisez setx pour enregistrer les variables. Vous devez rouvrir le terminal par la suite :

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Copiez le nom complet du modèle depuis la liste actuelle d’OmniProxy, y compris les barres obliques dans l’ID du modèle. Au démarrage d’Aider, ajoutez openai/ avant l’ID complet.

Au 2026-10-09, les deux ID de référence dans la documentation du fournisseur étaient gemini-3.8-flash et grok-4.7. Si ces noms ne figurent pas dans la liste actuelle, ne les copiez pas directement. Utilisez un ID complet qui apparaît réellement dans la liste.

Adresse

OPENAI_API_BASE

Pointez-la vers OmniProxy
Inclure /v1
Ne pas le mettre dans le dépôt

Clé

OPENAI_API_KEY

Utilisez celle fournie par la passerelle
Rouvrir les terminaux Windows après modification
Gardez les clés des fournisseurs dans la passerelle

Lancement

openai/modèle

cd vers le répertoire du projet
Préfixez le nom du modèle avec openai/
Utilisez le nom de la liste de la passerelle

Les deux variables d'environnement, associées à un nom de modèle préfixé par openai/, forment la syntaxe de l'API compatible.

Entrer la configuration de l’outil

Vous n’avez pas besoin de créer un fichier de configuration séparé. Entrez dans le répertoire du projet, démarrez Aider et remplacez l’ID du modèle par un nom qui existe réellement dans la liste actuelle d’OmniProxy :

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Pour utiliser l’autre modèle d’exemple, exécutez :

aider --model openai/grok-4.7

Lorsqu’Aider rencontre un modèle inconnu, il affiche un avertissement. Cet avertissement ne signifie pas en soi que le point de terminaison est incorrect. Vérifiez les journaux de requêtes d’OmniProxy pour confirmer si la requête est apparue.

Aider n’ajoute au contexte que les fichiers déjà suivis par Git. Le contexte est le code et les informations que le modèle peut lire pendant la tâche en cours. Si le répertoire actuel n’est pas encore un dépôt Git, Aider en crée un, mais les fichiers que Git ne suit pas ne peuvent toujours pas être lus. Utilisez git add pour ajouter les fichiers et les valider avant de démarrer Aider.

Aider peut toujours modifier des fichiers. --no-auto-commits désactive uniquement les validations automatiques ; cela n’empêche pas les modifications de fichiers. Lorsque vous utilisez Aider pour la première fois, choisissez un dépôt sans importance et exécutez git diff après la tâche pour réviser les changements réels.

Ne mettez pas de vraies clés dans les fichiers de projet ou les pages publiques. Stockez les clés des fournisseurs uniquement dans OmniProxy. Si la passerelle ne valide pas les clés, vous pouvez définir OPENAI_API_KEY sur une chaîne de caractères fictive utilisée uniquement sur votre ordinateur local.

Vérifier avec une tâche réelle

Tout d’abord, assurez-vous que le fichier que vous voulez qu’Aider lise a été validé dans Git. Ensuite, exécutez la commande suivante depuis le répertoire du projet. Remplacez l’ID du modèle par un ID complet provenant de la liste actuelle d’OmniProxy :

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message envoie une tâche directement à Aider, tandis que --no-auto-commits indique à Aider de ne pas créer automatiquement de validations Git pendant cette exécution.

Le 2026-10-09, Aider v0.86.2 a lu avec succès la première ligne d’un fichier suivi. Si le fichier n’est pas suivi par Git, Aider dira qu’il ne peut pas voir le contenu. Cela ne signifie pas que le point de terminaison de l’API est incorrect. Après avoir terminé la requête, vérifiez les journaux de requêtes d’OmniProxy pour vérifier la source de la requête et l’ID du modèle.

Lancement

Aider se lance

La commande est disponible
Les variables d'environnement sont actives
Dans le répertoire du projet

Tâche

Il a inspecté le fichier

Poser une question sur un fichier spécifique
Réviser son explication
Les modèles inconnus peuvent déclencher un avertissement

Journaux

Visible dans la passerelle

La source est Aider
L'ID du modèle correspond
La clé n'a pas été saisie sur la page

Confirmez que les variables d'environnement sont actives et que la commande est disponible, puis effectuez une requête réelle.

Erreurs courantes

aider introuvable : Rouvrez d’abord le terminal. Si vous l’avez installé directement avec pip, essayez python -m aider.
Windows se connecte toujours à l’ancien point de terminaison après avoir modifié les variables : Vous devez rouvrir le terminal après avoir exécuté setx. Seule une nouvelle fenêtre lira les variables mises à jour.
Le nom du modèle ne commence pas par openai/: L’API compatible nécessite le format openai/<model-name>.
Un avertissement de modèle inconnu apparaît : Il s’agit d’un avertissement normal qui ne signifie pas que la connexion a échoué. Vérifiez si OmniProxy a reçu la requête.
L’ID du modèle est invalide : Copiez à nouveau l’ID complet depuis la liste actuelle d’OmniProxy. Gardez le préfixe openai/ et toutes les barres obliques déjà présentes dans l’ID.
Aider dit qu’il n’y a pas de contenu de fichier : Assurez-vous que le fichier est suivi par Git. Les fichiers dans un dépôt vide ou les fichiers non suivis ne sont pas ajoutés au contexte.

Références officielles

Pour les étapes d’installation, voir Installation d’Aider. Pour les variables d’environnement et le préfixe de modèle, voir API compatibles OpenAI. Les exemples d’ID de modèles se trouvent dans la liste des modèles Gemini et sur la page des modèles xAI.

Remplacez chaque espace réservé par des valeurs de votre propre configuration OmniProxy. Ne publiez jamais une vraie clé.

Un résultat sauvegardé ou un HTTP 200 seul ne prouve pas la compatibilité complète de l'Agent. Vérifiez la source et le modèle dans le journal d'appels d'OmniProxy.

Sources officielles · Aider ↗