Aider avec Claude via une passerelle : ANTHROPIC_API_BASE, fichiers de configuration, mode architect et correctifs

Aider fait passer chaque appel de modèle par LiteLLM ; le diriger vers une passerelle relève donc d’un paramètre LiteLLM plutôt que d’un paramètre Aider. Pour Claude, cela signifie que ANTHROPIC_API_BASE doit être défini sur la racine de l’hôte de la passerelle, avec un nom de modèle portant le préfixe anthropic/ . Deux paramètres moins évidents sont tout aussi importants : les identifiants des modèles Claude récents nécessitent une entrée dans les paramètres de modèle, sinon Aider se rabat sur des modifications de fichiers entiers sans cartographie du dépôt.

Installer Aider

python -m pip install aider-install
aider-install

# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Si la commande aider est introuvable ensuite, ce qui est fréquent sous Windows, python -m aider exécute le même programme.

Se connecter à Claude via la passerelle

export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5

setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5

La documentation d’Aider ne traite pas des URL de base Anthropic personnalisées. La variable est lue par LiteLLM, qui vérifie ANTHROPIC_API_BASE en premier, puis ANTHROPIC_BASE_URL, la variable utilisée par Claude Code. Les deux fonctionnent ; si elles sont toutes deux définies, ANTHROPIC_API_BASE prend la priorité.

Conservez le préfixe anthropic/ dans le nom du modèle. Sans préfixe de fournisseur, LiteLLM ne sait pas où envoyer un nom qu’il ne reconnaît pas et échoue avec LLM Provider NOT provided.

Placez les paramètres dans des fichiers de configuration

Aider lit .aider.conf.yml et .env depuis votre répertoire personnel, la racine du dépôt git et le répertoire courant, dans cet ordre ; les fichiers lus ensuite sont prioritaires. Un fichier placé dans le répertoire personnel s’applique à tous les projets.

model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
  - ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.json

ANTHROPIC_API_KEY=your_gateway_key

weak-model gère les messages de commit et les résumés de l’historique du chat ; choisir un modèle peu coûteux pour ce paramètre permet donc de faire des économies à chaque session. set-env copie la variable dans l’environnement avant tout appel de modèle, ce qui évite de placer l’URL de base dans le profil de votre shell.

Conservez les modifications par diff et la cartographie du dépôt avec les modèles récents

Aider choisit son format de modification selon le nom du modèle. Les noms qu’il reconnaît, notamment ceux contenant sonnet-4-, opus-4- ou haiku-4-, bénéficient de modifications au format diff et de la cartographie du dépôt. Un nom qu’il ne reconnaît pas, tel que claude-sonnet-5, entraîne un repli sur la réécriture de fichiers entiers et la suppression de la cartographie du dépôt. Les modifications deviennent alors plus lentes et plus coûteuses. Une entrée dans les paramètres rétablit le comportement approprié :

- name: anthropic/claude-sonnet-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5

- name: anthropic/claude-opus-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5
  editor_model_name: anthropic/claude-sonnet-5
  editor_edit_format: editor-diff

Les modèles inconnus déclenchent également un avertissement : Unknown context window size and costs, using sane defaults. Il est sans gravité, mais Aider suppose alors une fenêtre de contexte illimitée et un prix nul. Le fichier de métadonnées lui fournit les valeurs réelles :

{
  "anthropic/claude-sonnet-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000002,
    "output_cost_per_token": 0.00001,
    "litellm_provider": "anthropic",
    "mode": "chat"
  },
  "anthropic/claude-opus-5-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000004,
    "output_cost_per_token": 0.00002,
    "litellm_provider": "anthropic",
    "mode": "chat"
  }
}

Les prix sont les tarifs catalogue d’Anthropic par token : l’affichage des coûts d’Aider indique donc le coût au tarif catalogue, tandis que la passerelle facture moins. Une limite d’entrée de 200K constitue un plafond de travail prudent, même lorsqu’un modèle accepte davantage.

Mode architecte : planifier avec un modèle, modifier avec un autre

aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5

En mode architecte, le modèle principal propose la modification et le modèle éditeur la transforme en modifications de fichiers. Utiliser un modèle plus puissant pour la planification et un modèle moins cher pour les modifications coûte généralement moins cher que d’utiliser le modèle puissant pour les deux. Au cours d’une session, /architect bascule vers ce mode pour un seul message et /chat-mode architect bascule pour le reste de la session.

La voie compatible avec OpenAI

La passerelle prend également en charge le format Chat Completions d’OpenAI, qui permet d’utiliser les modèles GPT sur le même compte. Pour cette voie, l’URL de base inclut bien /v1, et le nom du modèle prend le openai/ préfixe :

export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1

aider --model openai/claude-sonnet-5

Pour Claude, privilégiez la voie native décrite ci-dessus : les métadonnées du modèle et la mise en cache des prompts correspondent au format d’Anthropic. Si une variable OPENAI_BASE_URL est définie par inadvertance dans votre environnement, LiteLLM l’utilise en priorité par rapport à OPENAI_API_BASE.

Modèles

Les alias courts d’Aider (sonnet, opus, haiku) pointent vers des identifiants de modèles plus anciens ; indiquez donc explicitement le nom du modèle. Les anciens identifiants datés tels que claude-3-5-sonnet-20241022 ne sont pas disponibles.

Dépannage

Pour les erreurs provenant du modèle plutôt que d’Aider, consultez guide des erreurs de l’API Claude.

Questions fréquentes

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.