Installation d'Aider et configuration d'OmniProxy

Aider est un outil qui aide à modifier le code depuis le terminal. Il construit une carte de l’ensemble du projet pour aider le modèle à comprendre les bases de code volumineuses. 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. Une fois que vous avez confié une tâche à Aider, il la traite étape par étape et rédige les messages de commit. Si les changements ne vous conviennent 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 d’abord. 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
Puis 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 de aider-chat avec pip est moins fiable.

Assurez-vous qu’OmniProxy est en cours d’exécution. Après l’installation, accédez au 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 09/10/2026, 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, accédez au 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 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 ensuite :

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. Lors du démarrage d’Aider, ajoutez openai/ avant l’ID complet.

Au 09/10/2026, 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
Garder les clés des fournisseurs dans la passerelle

Lancement

openai/modèle

cd vers le répertoire du projet
Préfixer le nom du modèle avec openai/
Utiliser 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é. Accédez au 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 non suivis par Git 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 commits automatiques ; cela n’empêche pas les modifications de fichiers. Lors de l’utilisation d’Aider pour la première fois, choisissez un dépôt sans importance et exécutez git diff après la tâche pour examiner 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

Assurez-vous d’abord que le fichier que vous souhaitez 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 de commits Git automatiquement pendant cette exécution.

Le 09/10/2026, 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 indiquera 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
Examiner 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 : C’est 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 indique 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 une compatibilité complète de l'Agent. Vérifiez la source et le modèle dans l'enregistrement d'appel d'OmniProxy.

Sources officielles · Aider ↗