Documentation

Aider

Aider lit OPENAI_API_BASE et OPENAI_API_KEY. Configurez-les pour Kunavo, faites précéder l’identifiant du modèle de openai/, et Claude et GPT ne seront séparés que par un argument --model.

Deux variables d’environnement et un préfixe. Définissez OPENAI_API_BASE sur https://api.kunavo.com/v1, OPENAI_API_KEY sur votre clé sk-kn-…, puis lancez Aider avec --model openai/<id>. Le dépôt et l’installation d’Aider restent inchangés.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

Le préfixe openai/ est obligatoire et le suffixe /v1 doit figurer dans l’URL de base. Sans le préfixe, Aider recherche l’identifiant dans sa propre table de fournisseurs — ce qui provoque l’erreur « modèle inconnu » ; sans /v1, la requête n’atteint pas du tout la route.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Exportez OPENAI_API_BASE et OPENAI_API_KEY dans le shell depuis lequel vous lancez Aider, ou placez-les dans ~/.aider.conf.yml comme indiqué ci-dessous.
Lancez Aider dans votre dépôt avec aider --model openai/claude-sonnet-5.
Au démarrage, Aider affiche le modèle qu’il a résolu. Si cette ligne indique l’identifiant demandé, le point de terminaison est correctement configuré.

La référence d’Aider à ce sujet se trouve sur la page des API compatibles avec OpenAI.

Éviter de placer la clé dans votre profil shell

Les mêmes deux valeurs peuvent être placées dans le fichier de configuration d’Aider, ce qui est préférable si vous changez de point de terminaison selon le projet.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Vérifiez avant de déboguer Aider

Une requête suffit à déterminer si l’échec vient du point de terminaison, de la clé ou de la résolution du modèle par Aider. Si elle renvoie une liste JSON d’identifiants de modèles, la même URL de base et la même clé fonctionneront dans Aider — toute erreur restante concernera le préfixe openai/.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quels modèles choisir ?

Tous les modèles de texte sur Kunavo sont accessibles sous la forme openai/<id> — la liste complète se trouve sur la page des modèles et est renvoyée en temps réel par GET /v1/models. Les tarifs sont en USD par million de jetons, entrée / sortie.

Identifiant du modèle	Entrée / sortie sur Kunavo	Utilisation conseillée
`claude-haiku-4-5`	$0.70 / $3.50	Claude le moins cher — adapté aux appels d’Aider pour la cartographie du dépôt et les messages de commit
`claude-sonnet-5`	$1.40 / $7.00	Le meilleur équilibre par défaut entre qualité et prix pour la modification
`claude-opus-5`	$3.50 / $17.50	Niveau Claude de la meilleure qualité — modifications d’architecture
`gpt-5-6-terra`	$0.70 / $4.20	Même clé, autre famille — utile pour obtenir un second avis sur une modification complexe

Aider renvoie la cartographie du dépôt et les fichiers modifiés à chaque échange ; la consommation de jetons dépend donc de la taille du contexte plutôt que de celle des modifications. Le cache de prompts est donc le principal levier, et --model associé à --weak-model openai/claude-haiku-4-5 constitue la combinaison la moins coûteuse : le modèle puissant effectue les modifications, tandis que le modèle léger rédige les messages de commit et les résumés. La facturation se fait par jeton à partir d’un solde prépayé, sans frais mensuels — détails dans la section facturation.

Questions fréquentes

Comment utiliser Aider avec une API compatible avec OpenAI ?

Définissez OPENAI_API_BASE sur l’URL de base du point de terminaison et OPENAI_API_KEY sur votre clé, puis lancez Aider avec l’identifiant du modèle précédé de openai/ — par exemple `aider --model openai/claude-sonnet-5`. Pour Kunavo, l’URL de base est https://api.kunavo.com/v1. Le préfixe est obligatoire : sans lui, Aider tente de rechercher l’identifiant dans sa propre table de fournisseurs au lieu de l’envoyer à votre point de terminaison.

Aider peut-il utiliser des modèles Claude via un point de terminaison compatible avec OpenAI ?

Oui. Aider communique avec l’adresse définie par OPENAI_API_BASE en utilisant le protocole OpenAI ; un modèle Claude fourni dans ce format est donc accessible sans identifiants Anthropic — son identifiant est simplement une autre chaîne dans la liste /v1/models. Sur Kunavo, les identifiants Claude et GPT utilisent tous la même clé ; pour passer de l’un à l’autre, il suffit donc de modifier l’argument --model, sans changer de configuration.

Pourquoi Aider indique-t-il que le modèle est inconnu ?

La cause est presque toujours l’absence du préfixe openai/. Aider considère qu’un identifiant sans préfixe correspond à un modèle qu’il devrait reconnaître et échoue dans le cas contraire ; `openai/<id>` lui indique de transmettre directement l’identifiant à OPENAI_API_BASE. La deuxième cause la plus fréquente est une URL de base sans le suffixe /v1, ce qui entraîne une erreur de connexion ou 404 plutôt qu’une erreur de modèle inconnu.

Aider indique-t-il le coût d’une session ?

Aider affiche le nombre de jetons et un coût estimé pour chaque échange, calculé à partir de ses propres métadonnées de modèle — cette estimation peut être erronée avec un point de terminaison personnalisé, car Aider ne connaît pas ses tarifs. Fiez-vous au nombre de jetons et consultez le montant réellement facturé par votre fournisseur. Sur Kunavo, le coût de chaque requête figure dans la vue d’utilisation ; il est déduit d’un solde prépayé, sans frais mensuels.