Source: https://aiprimetech.io/fr/learn/use-claude-api-with-aider/ [Accueil](/fr/) / [Apprendre](/fr/learn/) / Aider avec Claude via une passerelle : ANTHROPIC_API_BASE, fichiers de configuration, mode architecte et correctifs # 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 macOS / LinuxCopier ``` 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 ``` WindowsCopier ``` 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 terminalCopier ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsCopier ``` 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 ``` Utilisez la racine de l’hôte : sans /v1 ni barre oblique finale. LiteLLM ajoute /v1/messages lui-même, donc https://aiprimetech.io/v1 devient /v1/v1/messages et renvoie 404, tandis qu’une barre oblique finale produit une double barre oblique dans le chemin. 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. ~/.aider.conf.ymlCopier ``` 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 ``` ~/.envCopier ``` 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é : ~/.aider.model.settings.ymlCopier ``` - 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 : ~/.aider.model.metadata.jsonCopier ``` { "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 terminalCopier ``` 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 : terminalCopier ``` 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 | Identifiant du modèle | À utiliser pour | claude-sonnet-5 | Choix par défaut pour le développement et les tâches d’agents : rapide, performant, à prix intermédiaire. | claude-opus-5-5 | Raisonnement plus difficile, refactorisations importantes, longues exécutions d’agents. | claude-fable-5-1 | Le plus performant et le plus cher ; réservez-le aux tâches les plus difficiles. | claude-haiku-4-5 | Économique et rapide : titres, résumés, classification, petites étapes. 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 | Ce que vous voyez | Cause | Solution | 404 / NotFoundError | /v1 dans ANTHROPIC_API_BASE, le chemin devient donc /v1/v1/messages | Définissez la racine de l’hôte, https://aiprimetech.io, sans barre oblique finale | LLM Provider NOT provided | Nom du modèle sans préfixe de fournisseur | Utilisez anthropic/claude-sonnet-5 | AuthenticationError : impossible de vous authentifier | Clé absente de l’environnement shell dans lequel Aider s’exécute, ou clé destinée à un autre endpoint | echo $ANTHROPIC_API_KEY ; sous Windows, ouvrez un nouveau terminal après setx | Réécriture complète des fichiers, sans cartographie du dépôt | Aider ne reconnaît pas le nom du modèle | Ajoutez l’entrée .aider.model.settings.yml ci-dessus | Unknown context window size and costs | Aucune métadonnée pour le modèle | Ajoutez le fichier de métadonnées ou ignorez l’avertissement | Erreurs de limite de tokens | Trop de fichiers dans la conversation, ou fichiers trop volumineux | /tokens pour voir l’utilisation, /drop les fichiers, /clear l’historique | RateLimitError | Limite de requêtes simultanées ou de débit atteinte | Aider réessaie avec un délai croissant ; évitez d’exécuter plusieurs sessions avec la même clé | Modèle non pris en charge | Un identifiant de modèle ancien ou mal orthographié | Utilisez un identifiant du tableau ci-dessus Pour les erreurs provenant du modèle plutôt que d’Aider, consultez [guide des erreurs de l’API Claude](/fr/learn/claude-api-errors-troubleshooting/). ## Questions fréquentes Comment utiliser Aider avec une URL de base Anthropic personnalisée ? Définissez ANTHROPIC_API_BASE sur la racine de l’hôte de la passerelle, par exemple https://aiprimetech.io, sans /v1 ni barre oblique finale, définissez ANTHROPIC_API_KEY, puis exécutez aider --model anthropic/claude-sonnet-5. LiteLLM ajoute /v1/messages. Aider lit-il ANTHROPIC_BASE_URL ? Oui, via LiteLLM, comme solution de repli. LiteLLM vérifie d’abord ANTHROPIC_API_BASE, puis ANTHROPIC_BASE_URL. Pourquoi Aider réécrit-il des fichiers entiers avec un nouveau modèle Claude ? Aider ne reconnaît pas le nom du modèle et utilise par défaut le format de modification whole, sans cartographie du dépôt. Ajoutez une entrée avec edit_format: diff et use_repo_map: true dans .aider.model.settings.yml. Aider peut-il utiliser un endpoint compatible avec OpenAI ? Oui : définissez OPENAI_API_BASE sur l’endpoint en incluant /v1, ainsi que OPENAI_API_KEY, puis utilisez le préfixe openai/, par exemple aider --model openai/claude-sonnet-5. Commencez à utiliser Claude en quelques minutes Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.[Obtenir votre clé API](/register) 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. ## Autres guides sur l’API Claude [Comment obtenir une clé API Claude](/fr/learn/how-to-get-a-claude-api-key/)[Comprendre la tarification de l’API Claude](/fr/learn/claude-api-pricing-explained/)[La façon la moins chère d’utiliser l’API Claude](/fr/learn/cheapest-way-to-use-claude-api/)[Cursor illimité avec l’API Claude](/learn/use-claude-api-with-cursor/)[Accès illimité à Claude Code](/fr/learn/use-claude-api-with-claude-code/)[Passerelle API Claude ou accès direct à Anthropic](/fr/learn/claude-api-vs-anthropic-direct/)[Utiliser Claude avec le SDK OpenAI : endpoint compatible OpenAI, streaming, outils et limites](/fr/learn/openai-compatible-claude-api/)[Comprendre les modèles Claude : comparaison de Claude Opus, Sonnet, Haiku et Fable — tous les modèles de l’API Claude, noms des modèles Anthropic et prix (2026)](/fr/learn/claude-api-models-compared/)[Payer l’API Claude en cryptomonnaies](/fr/learn/claude-api-with-crypto-payment/)[Accéder à l’API Claude sans liste d’attente](/fr/learn/claude-api-without-waitlist/)[Comment réduire la consommation de tokens de Claude](/fr/learn/how-to-reduce-claude-token-usage/)[Cline illimité avec l’API Claude](/fr/learn/use-claude-api-with-cline/)[Roo Code illimité avec l’API Claude](/fr/learn/use-claude-api-with-roo-code/)[Claude illimité dans les IDE JetBrains](/fr/learn/use-claude-api-with-jetbrains/)[Claude illimité dans VS Code](/fr/learn/use-claude-api-with-vscode/)[Configuration d’OpenCode pour Claude : paramètres d’opencode.json, modèles et erreurs courantes](/fr/learn/use-claude-api-with-opencode/)[Hermes Agent avec Claude via une passerelle : configuration d’un fournisseur personnalisé, maîtrise des coûts et correctifs](/fr/learn/run-hermes-agent-with-claude-api/)[Utiliser OpenClaw sans limites avec Claude](/fr/learn/run-openclaw-with-claude-api/)[Ce que signifie une API compatible avec Anthropic](/fr/learn/anthropic-compatible-api/)[Clé API Claude Code — ANTHROPIC_API_KEY : comment l’obtenir, la configurer et quand utiliser claude setup-token à la place](/fr/learn/claude-code-api-key-setup/)[Coûts de l’API Claude Code — Tarifs et moyens de les réduire](/fr/learn/claude-code-api-costs/)[Les erreurs de l’API Claude expliquées : erreur serveur 500, surcharge 529, limite de débit 429, requête incorrecte 400 — et le correctif pour chacune](/fr/learn/claude-api-errors-troubleshooting/)[Comment acheter des crédits pour l’API Claude — et pourquoi un crédit Claude vaut mieux que toute offre d’« achat de compte Claude »](/fr/learn/buy-claude-api-credits/)[API Claude gratuite : existe-t-il une clé API Claude gratuite, et qu’est-ce qui est réellement gratuit en 2026 ?](/fr/learn/claude-api-free-trial/)[API Claude ou abonnement Claude Pro/Max — Que choisir](/fr/learn/claude-api-vs-subscription/)[Codex CLI avec un fournisseur personnalisé : config.toml, modèles GPT et Claude, extension IDE et correctifs](/fr/learn/use-claude-api-with-codex/)[Connecter Claude à n8n](/fr/learn/use-claude-api-with-n8n/)[Router LiteLLM vers Claude](/fr/learn/use-claude-api-with-litellm/)[Utiliser Claude dans Kilo Code](/fr/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat avec Claude via une passerelle : configuration de Custom Endpoint, mode agent et correctifs](/fr/learn/use-claude-api-with-github-copilot/)[Connecter Zed à Claude via la passerelle](/fr/learn/use-claude-api-with-zed/)[Connecter Cherry Studio à Claude](/fr/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic dans LangChain : importation, base_url, streaming, outils et erreurs](/fr/learn/use-claude-api-with-langchain/)[SDK Python Anthropic : installation, configuration de base_url, streaming et gestion des erreurs](/fr/learn/anthropic-python-sdk/)[Claude avec Vercel AI SDK : baseURL de createAnthropic, streaming et corrections](/fr/learn/use-claude-api-with-vercel-ai-sdk/)[Utiliser Factory Droid avec Claude](/fr/learn/use-claude-api-with-factory-droid/)[L’API de Claude Code expliquée](/fr/learn/claude-code-api/)[Intégrer l’API Claude à votre application](/fr/learn/claude-api-integration/)[Comment utiliser Claude sans limites — et pourquoi il n’existe pas de « Claude Code piraté »](/fr/learn/get-unlimited-claude-usage/)