Installation d’Aider et configuration d’OmniProxy

Aider est un outil qui aide à modifier du code depuis le terminal. Il établit une cartographie de l’ensemble du dépôt afin d’aider le modèle à comprendre les projets volumineux. Git est un outil de gestion de versions qui enregistre les changements apportés au code et permet de consulter les différences ou de restaurer des modifications. Lorsque vous confiez une tâche à Aider, il la traite étape par étape et rédige un message de commit. Si les modifications ne vous conviennent pas, vous pouvez les annuler avec /undo.

Préparation avant l’installation

Deux méthodes d’installation sont couramment utilisées :

• Si Python 3.8 à 3.13 est déjà installé sur votre ordinateur, installez d’abord aider-install. Python est l’environnement d’exécution nécessaire à Aider.
• Si vous ne disposez pas d’une version adaptée de Python, utilisez la commande d’installation en une ligne. Elle installera é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éera son propre environnement

Assurez-vous qu’OmniProxy est en cours d’exécution. Une fois l’installation terminée, accédez au répertoire du projet que vous souhaitez modifier, puis lancez Aider.

Installation et premier lancement

Si Python 3.8 à 3.13 est déjà installé

Exécutez les commandes suivantes dans l’ordre :

python -m pip install aider-install
aider-install

aider-install installe Aider dans un environnement Python séparé afin d’éviter les conflits avec les autres projets Python présents sur l’ordinateur. Si nécessaire, il installe également une version de Python 3.12 destinée à Aider.

Installation en une ligne

Sur Mac et Linux, exécutez :

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

Si curl n’est pas installé sur l’ordinateur, utilisez à la place :

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 d’installation en une ligne reposent sur uv, un programme servant à 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. En cas d’installation directe avec python -m pip install aider-chat, les versions de Python prises en charge vont de 3.9 à 3.12. Cette méthode fait toutefois partie des solutions d’installation secondaires : privilégiez les méthodes précédentes. Les versions d’Aider proposées par les gestionnaires de paquets système peuvent présenter des incompatibilités de dépendances ; elles ne doivent donc pas être utilisées en priorité.

Le 2026-10-09, la commande d’installation en une ligne a installé Aider v0.86.2. Si un message indique pendant l’installation que le cache et la destination ne se trouvent pas sur le même disque et que les fichiers seront copiés, l’installation se terminera tout de même.

Une fois l’installation terminée, accédez au répertoire du projet. Une interface compatible désigne une interface qui communique avec d’autres services de modèles au format OpenAI. La commande de lancement prend la forme suivante :

aider --model openai/<model-name>

Remplacez <model-name> par l’identifiant complet du modèle copié depuis OmniProxy à l’étape suivante. L’identifiant du modèle est le nom qui permet de sélectionner précisément le 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 considérées 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 l’adresse de l’interface et doit obligatoirement se terminer par /v1. OPENAI_API_KEY est la clé utilisée pour accéder à l’interface.

Sous Windows, utilisez setx pour enregistrer les variables. Vous devrez rouvrir le terminal après avoir exécuté ces commandes :

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

Copiez intégralement le nom du modèle depuis la liste actuelle d’OmniProxy, en conservant également les barres obliques présentes dans son identifiant. Lorsque vous lancez Aider, ajoutez ensuite openai/ devant l’identifiant complet.

Le 2026-10-09, les deux identifiants de comparaison figurant dans la documentation des fournisseurs étaient gemini-3.8-flash et grok-4.7. Si ces noms ne figurent pas dans la liste actuelle, ne les recopiez pas directement : utilisez l’identifiant complet réellement disponible dans la liste.

Adresse

OPENAI_API_BASE

• Pointer vers OmniProxy
• Terminer par /v1
• Ne pas l’enregistrer dans le dépôt

Clé

OPENAI_API_KEY

• Utiliser celle fournie par la passerelle
• Sous Windows, rouvrir le terminal après la modification
• Conserver les clés des fournisseurs dans la passerelle

Démarrage

openai/modèle

• Utiliser cd pour accéder au répertoire du projet
• Préfixer le nom du modèle par openai/
• Utiliser le nom indiqué dans la liste de la passerelle

Saisir la configuration de l’outil

Il n’est pas nécessaire de créer un autre fichier de configuration. Accédez d’abord au répertoire du projet, puis lancez Aider en remplaçant l’identifiant du modèle par un nom réellement présent dans la liste actuelle d’OmniProxy :

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

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

aider --model openai/grok-4.7

Lorsqu’Aider rencontre un modèle qu’il ne connaît pas, l’interface affiche un avertissement. Cet avertissement ne signifie pas à lui seul que l’adresse est incorrecte. Vérifiez dans l’historique des appels d’OmniProxy si cette requête a bien été reçue.

Aider ajoute uniquement au contexte les fichiers déjà suivis par Git. Le contexte correspond au code et aux informations que le modèle peut lire pour la tâche en cours. Si le répertoire actuel n’est pas encore un dépôt Git, Aider en crée un automatiquement, mais les fichiers non suivis par Git restent illisibles. Ajoutez d’abord les fichiers avec git add et créez un commit avant de lancer Aider.

Aider peut toujours modifier les fichiers. L’option --no-auto-commits désactive uniquement la création automatique de commits ; elle n’empêche pas la modification des fichiers. Pour une première utilisation, choisissez un dépôt sans importance et exécutez git diff à la fin de la tâche afin d’examiner les changements réellement apportés.

N’inscrivez pas de clé réelle dans les fichiers du projet ou sur une page publique. Les clés des fournisseurs doivent être enregistrées uniquement dans OmniProxy. Si la passerelle ne valide pas les clés, vous pouvez renseigner dans OPENAI_API_KEY une chaîne factice utilisée uniquement sur votre ordinateur.

Vérifier avec une tâche réelle

Commencez par vérifier que le fichier à lire a été ajouté à Git et inclus dans un commit, puis exécutez la commande suivante dans le répertoire du projet. Remplacez l’identifiant du modèle par l’identifiant complet figurant dans la liste actuelle d’OmniProxy :

aider --model openai/gemini-3.8-flash --message "Quelle est la première ligne de ce fichier ? Ne modifiez pas le fichier." --no-auto-commits

--message permet de confier directement une tâche unique à Aider. --no-auto-commits indique qu’aucun commit Git ne doit être créé automatiquement pendant cette exécution.

Le 2026-10-09, Aider v0.86.2 a réussi à lire la première ligne d’un fichier suivi par Git. Si le fichier n’est pas encore suivi par Git, Aider répondra qu’il ne peut pas en voir le contenu ; cela ne signifie pas que l’adresse de l’interface est incorrecte. Une fois la question traitée, vérifiez dans l’historique des appels d’OmniProxy la source de la requête et l’identifiant du modèle.

Démarrage

aider se lance

• La commande est trouvée
• Les variables d’environnement sont actives
• Le terminal se trouve dans le répertoire du projet

Tâche

Il a consulté le fichier

• Poser une question sur un fichier précis
• Lire son explication
• Un avertissement apparaît pour les modèles inconnus

Journaux

La passerelle reçoit l’appel

• La source est Aider
• L’ID du modèle correspond
• La clé n’apparaît pas dans la page

Erreurs courantes

• Commande aider introuvable : commencez par rouvrir le terminal. Si vous avez effectué une installation directe avec pip, essayez python -m aider.
• Sous Windows, la connexion utilise encore l’ancienne adresse après la modification des variables : après avoir exécuté setx, vous devez rouvrir le terminal. Seules les nouvelles fenêtres liront les variables mises à jour.
• Le préfixe openai/ est absent du nom du modèle : l’interface compatible exige le format openai/<model-name>.
• Un avertissement signale un modèle inconnu : il s’agit d’un message normal qui ne signifie pas que la connexion a échoué. Vérifiez ensuite si OmniProxy a reçu la requête.
• L’identifiant du modèle est invalide : recopiez l’identifiant complet depuis la liste actuelle d’OmniProxy en conservant le préfixe openai/ ainsi que les barres obliques déjà présentes dans l’identifiant.
• Aider indique qu’aucun contenu de fichier n’est disponible : vérifiez d’abord que le fichier est suivi par Git. Un dépôt vide ou des fichiers non suivis ne sont pas ajoutés au contexte.

Références

Pour les étapes d’installation, consultez Aider installation. Pour les variables d’environnement et le préfixe du modèle, consultez OpenAI compatible APIs. Les identifiants de modèles utilisés dans les exemples sont consultables 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 ↗