🚀 Connecter les modèles personnalisés CodingPlanX à Aider
> Introduction : Ce document vous guidera sur la façon d'utiliser l'assistant de codage IA open source très populaire Aider, pour le connecter de manière transparente à l'API CodingPlanX.ai et obtenir une expérience de programmation assistée par l'IA ultime dans votre terminal.
Aider est un assistant de codage IA en ligne de commande open source très apprécié (plus de 39K étoiles sur GitHub). Il s'exécute directement dans votre terminal et prend en charge plus de 100 langages de programmation. Grâce à une simple configuration de variables d'environnement, vous pouvez connecter Aider aux puissants modèles de CodingPlanX.ai.
✨ Pourquoi choisir Aider ?
- 🆓 Entièrement open source et gratuit : Le logiciel lui-même est gratuit, vous ne payez que les frais d'API de CodingPlanX.ai.
- 🧠 Mode Architect : Un mécanisme de collaboration original à deux modèles (un modèle s'occupe de la planification de l'architecture et l'autre de l'écriture du code), améliorant considérablement la qualité du code pour les tâches complexes.
- 🌳 Repository Map : Basé sur la technologie
tree-sitter, capable de générer et de comprendre intelligemment la structure de l'ensemble du dépôt de code. - 🔗 Intégration profonde avec Git : Chaque modification de code effectuée par l'IA génère automatiquement un message de commit Git standard, facilitant la traçabilité à tout moment.
- ⚡ Configuration minimaliste : Seulement deux lignes de variables d'environnement suffisent pour se connecter rapidement à CodingPlanX.ai.
🛠️ Préparation et Installation
1. Prérequis
- Python 3.8 ou supérieur installé.
- Clé API CodingPlanX.ai obtenue (commençant par
cr_).
2. Installer Aider
Il est recommandé d'utiliser pipx pour une installation isolée, afin d'éviter les conflits de dépendances avec d'autres paquets Python :
# Recommandé : Utiliser pipx (installation isolée globale)
pipx install aider-chat
# Alternative : Utiliser le pip traditionnel
pip install aider-chat
⚙️ Configurer CodingPlanX.ai
Étant donné que CodingPlanX.ai fournit une interface compatible avec le format OpenAI, nous pouvons utiliser directement les paramètres de configuration d'OpenAI pour nous connecter aux modèles Claude.
Méthode 1 : Configuration via les variables d'environnement (🌟 Recommandée)
C'est la méthode la plus pratique, vous n'aurez plus besoin de saisir la clé à chaque démarrage d'Aider.
Effet temporaire (fenêtre de terminal actuelle) :
export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_votre_cle_api"
Effet permanent (écriture dans le fichier de configuration) :
Si vous utilisez macOS ou Linux, veuillez ajouter le contenu suivant à votre ~/.zshrc ou ~/.bashrc :
echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_votre_cle_api"' >> ~/.zshrc
source ~/.zshrc
Méthode 2 : Configuration via les paramètres de ligne de commande
Si vous ne souhaitez pas définir de variables d'environnement, vous pouvez également les transmettre en tant que paramètres à chaque démarrage :
aider --openai-api-base "https://api.codingplanx.ai/v1" \
--openai-api-key "cr_votre_cle_api" \
--model openai/claude-sonnet-4-6
💻 Commencer à utiliser
Mode conversationnel de base
Allez dans le répertoire de votre projet et lancez Aider directement :
cd /chemin/vers/votre/projet
# Lancer Aider (Claude Sonnet est recommandé par défaut)
aider --model openai/claude-sonnet-4-6
# En cas de problème complexe, vous pouvez passer au puissant Claude Opus
aider --model openai/claude-opus-4-6
Mode Architect (🌟 Fortement recommandé)
Le mode Architect est la fonctionnalité phare d'Aider. Il permet à un modèle « intelligent » (comme Opus) de réfléchir et de planifier d'abord, puis confie le travail de modification de code spécifique à un modèle plus « exécutant » (comme Sonnet ou Haiku). Cela garantit la qualité du code tout en économisant sur les frais d'API.
# Plan A : Opus planifie + Sonnet exécute (Pour une qualité ultime)
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
# Plan B : Sonnet planifie + Haiku exécute (Équilibre entre qualité et faible coût)
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001
⌨️ Commandes rapides courantes d'Aider
Dans la session interactive après le démarrage d'Aider, vous pouvez saisir les commandes avec barre oblique suivantes :
| Commande | Description détaillée |
|---|---|
/add fichier.py | Ajoute le fichier spécifié au contexte de l'IA (l'IA ne peut modifier que les fichiers ajoutés via add) |
/drop fichier.py | Supprime le fichier spécifié du contexte pour économiser des Tokens |
/run pytest | Exécute une commande dans le terminal (comme des tests) et donne automatiquement la sortie d'erreur à l'IA pour qu'elle la corrige |
/diff | Affiche les codes modifiés par l'IA (similaire à git diff) |
/undo | Annule la dernière modification de code effectuée par l'IA |
/commit | Valide manuellement les modifications actuelles dans Git |
/help | Affiche l'aide pour toutes les commandes disponibles |
Liste des modèles pris en charge
| Positionnement du modèle | Nom du modèle à saisir dans Aider | Description |
|---|---|---|
| Recommandation principale | openai/claude-sonnet-4-6 | Équilibre parfait entre vitesse et intelligence, excellent rapport qualité-prix |
| Meilleur raisonnement | openai/claude-opus-4-6 | Adapté au traitement de logiques et de conceptions architecturales extrêmement complexes |
| Ultra-rapide et bas prix | openai/claude-haiku-4-5-20251001 | Réponse extrêmement rapide, idéal comme modèle d'exécution ou pour des tâches simples |
⚖️ Guide de sélection : Aider vs Claude Code CLI
Si vous hésitez entre utiliser Aider ou le Claude Code CLI officiel, vous pouvez vous référer au tableau suivant :
| Dimension de comparaison | 🤖 Aider | 💻 Claude Code CLI |
|---|---|---|
| Statut Open Source | Entièrement open source et gratuit | Logiciel commercial fermé |
| Intégration Git | Commit automatique (trace de chaque modification) | Nécessite de taper manuellement /commit |
| Flux de travail | Prise en charge de la collaboration multi-modèles (Mode Architect) | Conversation avec un modèle unique |
| Capacités des outils | Concentré sur l'édition de fichiers + l'exécution Shell | Plus riche (prend en charge LSP, recherche globale, navigateur, etc.) |
| Gestion du contexte | Repo Map (Indexation intelligente de l'arbre syntaxique AST) | S'appuie sur une fenêtre de contexte massive de 200K à 1M de Tokens |
💡 Notre recommandation :
- Utilisez Aider : Pour les modifications de code quotidiennes à haute fréquence, le refactoring, et pour un développement précis en utilisant le mode Architect.
- Utilisez Claude Code CLI : Lorsque vous avez besoin que l'IA analyse de manière autonome un vaste projet inconnu ou exécute des tâches d'automatisation complexes dans le Terminal.
❓ Foire aux questions (FAQ)
Q : Erreur "Model not found" au démarrage ?
R : Veuillez vérifier si le nom de votre modèle n'omet pas le préfixe openai/.
- ❌ Incorrect :
aider --model claude-sonnet-4-6 - ✅ Correct :
aider --model openai/claude-sonnet-4-6
Q : L'IA prend trop de temps à réfléchir et indique un délai d'attente de l'appel API ? R : Cela peut être dû à des fluctuations du réseau ou à une tâche complexe. Vous pouvez essayer de :
- Basculer vers le « nœud API de secours » mentionné ci-dessus.
- Augmenter le paramètre de délai d'attente au démarrage :
aider --model openai/claude-sonnet-4-6 --timeout 120