Info:: aider: utilisation d'une LLM en mode CLI (comme Claude code)
KEYWORDS: AIDER, CLAUDE CODE
Le 03/06/2026:
Aider + Ollama — Assistant de développement CLI local
{{#if:Aider + Ollama|
| Aider + Ollama
{{#if:aider-chat (dernière stable), Ollama ≥ 0.3| | |
|---|---|
| Version | aider-chat (dernière stable), Ollama ≥ 0.3
}}{{#if:Debian 13 (Trixie)| |
| OS | Debian 13 (Trixie)
}}{{#if:NVIDIA RTX 3060 12 GB (srv18)| |
| Matériel | NVIDIA RTX 3060 12 GB (srv18)
}}{{#if:PCStreet| |
| Auteur | PCStreet
}}{{#if:Juin 2026| |
| Date | Juin 2026
}}{{#if:| |
| {{{description}}}
}} | |
}}
Présentation
Aider est un assistant de développement en ligne de commande (CLI) open-source, similaire à Claude Code, mais conçu pour fonctionner avec n'importe quel LLM, y compris les modèles locaux via Ollama.
Il permet d'éditer des fichiers sources directement depuis le terminal, avec :
- Lecture et modification multi-fichiers automatique (diff/apply)
- Intégration Git optionnelle (commits automatiques ou manuels)
- Exécution de commandes shell en cours de session
- Support natif d'Ollama via l'API REST locale
Dans la configuration PCStreet, Aider utilise le modèle qwen3:14b
déjà déployé pour Open-WebUI, sans conflit VRAM (un seul processus GPU partagé).
Architecture du système
┌─────────────────────────────────────────────────────┐ │ srv18 │ │ │ │ ┌──────────┐ HTTP ┌─────────────────────┐ │ │ │ Aider │────────────►│ Ollama :11434 │ │ │ │ (CLI) │ │ qwen3-aider (14b) │ │ │ └──────────┘ └──────────┬──────────┘ │ │ │ CUDA │ │ ┌──────────┐ HTTP ▼ │ │ │Open-WebUI│────────────► RTX 3060 12 GB VRAM │ │ └──────────┘ (modèle chargé une fois) │ └─────────────────────────────────────────────────────┘
Open-WebUI et Aider partagent le même modèle en VRAM. Ollama sérialise les requêtes : pas de conflit, pas de swap.
Installation
Prérequis
apt install python3-pip python3-venv git
Environnement Python isolé
python3 -m venv /opt/aider
source /opt/aider/bin/activate
pip install aider-chat
Exposer l'exécutable globalement :
ln -s /opt/aider/bin/aider /usr/local/bin/aider
Vérification :
aider --version
Configuration
Fichier de configuration global
Chemin : ~/.aider.conf.yml
# Modèle Ollama dédié Aider
model: ollama/qwen3-aider
# URL de l'API Ollama
ollama-api-base: http://127.0.0.1:11434
# Pas de commit automatique (contrôle manuel)
auto-commits: false
dirty-commits: false
# Éditeur de messages
vim: true
# Thème terminal sombre
dark-mode: true
# Limite la repo-map pour préserver la VRAM
map-tokens: 1024
# Désactiver la télémétrie
analytics: false
# Historique des sessions
chat-history-file: ~/.aider/.aider.chat.history.md
Modèle Ollama dédié
Un Modelfile spécifique optimise les paramètres pour l'usage Aider.
mkdir -p /root/Modelfiles
vim /root/Modelfiles/qwen3-aider.Modelfile
FROM qwen3:14b
# Contexte réduit pour préserver la VRAM résiduelle
PARAMETER num_ctx 8192
# Maintien en VRAM entre les requêtes (évite les rechargements)
PARAMETER keep_alive -1
# Mode thinking désactivé pour les tâches de code (plus rapide)
PARAMETER think false
Création du modèle :
ollama create qwen3-aider -f /root/Modelfiles/qwen3-aider.Modelfile
Vérification :
ollama list | grep qwen3-aider
Script de lancement
Chemin : /usr/local/bin/aider-start
#!/bin/bash
set -euo pipefail
# Vérifie qu'Ollama répond
if ! curl -sf http://127.0.0.1:11434/api/tags > /dev/null; then
echo "[ERR] Ollama ne répond pas sur :11434" >&2
exit 1
fi
# Active le venv
source /opt/aider/bin/activate
# Répertoire projet passé en argument, ou répertoire courant
PROJECT_DIR="${1:-$(pwd)}"
cd "$PROJECT_DIR"
echo "[INFO] Aider démarré dans : $PROJECT_DIR"
echo "[INFO] Modèle : qwen3-aider (Ollama local)"
aider
chmod +x /usr/local/bin/aider-start
Utilisation
Démarrage d'une session
# Démarrage dans le répertoire courant
cd /root/monprojet
aider-start
# Avec des fichiers préchargés en contexte
aider src/ClassDatabase.cpp include/ClassDatabase.h
# Question ponctuelle sans modifier de fichier (mode one-shot)
aider --message "Explique le rôle de ClassFileIndexer::sync()"
Commandes internes (dans la session)
| Commande | Description |
|---|---|
/add fichier.cpp |
Ajouter un fichier au contexte |
/drop fichier.cpp |
Retirer un fichier du contexte (libère le contexte) |
/files |
Lister les fichiers actuellement en contexte |
/run make -j4 |
Exécuter une commande shell sans quitter Aider |
/clear |
Vider l'historique de la session en cours |
/diff |
Afficher les modifications effectuées depuis le début |
/undo |
Annuler le dernier commit Aider (si auto-commits activé) |
/help |
Afficher l'aide complète |
/exit ou Ctrl+D |
Quitter la session |
Exemple de workflow C++
cd /root/pcFsWithPostgres
aider src/ClassDatabase.cpp include/ClassDatabase.h
Exemples de prompts dans la session :
> Ajoute une méthode getFileCount() qui retourne le nombre de fichiers indexés
> Écris la déclaration correspondante dans le header
> /run cmake --build build/ -j4
> Corrige l'erreur de compilation affichée ci-dessus
> /drop src/ClassAuditLogParser.cpp
Gestion de la VRAM (RTX 3060 12 GB)
| Composant | VRAM utilisée |
|---|---|
| qwen3:14b (ou qwen3-aider) | ~9–10 GB |
| Contexte Ollama (num_ctx 8192) | ~1–1.5 GB |
| Marge disponible | ~0.5–1.5 GB |
Points de vigilance :
- Ne pas charger un second modèle lourd simultanément
- Si la session Aider devient lente, réduire le contexte avec
/drop - Le paramètre
map-tokens: 1024dans la config limite la repo-map automatique keep_alive -1maintient le modèle en VRAM : ne pas oublier qu'il occupe
de la mémoire même quand Aider est fermé
Vérification de l'état VRAM :
nvidia-smi --query-gpu=memory.used,memory.free --format=csv
Pièges courants
- Contexte saturé
- Si les fichiers en contexte sont trop volumineux, le modèle tronque les réponses.
Utiliser /drop pour retirer les fichiers non nécessaires.
- Modèle non chargé au démarrage
- Aider démarre la requête avant qu'Ollama ait fini de charger le modèle.
Le script aider-start vérifie la disponibilité de l'API avant de lancer.
- Modifications non souhaitées
- Avec
auto-commits: false, Aider modifie les fichiers sur disque mais ne commite pas.
Toujours vérifier le diff avant d'accepter (/diff).
- keep_alive et consommation mémoire
keep_alive -1signifie que le modèle ne se décharge jamais automatiquement.
Pour le décharger manuellement :
curl -X POST http://127.0.0.1:11434/api/generate \
-d '{"model":"qwen3-aider","keep_alive":0}'