Source: https://aiprimetech.io/fr/learn/run-hermes-agent-with-claude-api/ [Accueil](/fr/) / [Apprendre](/fr/learn/) / Hermes Agent avec Claude via une passerelle : configuration d’un fournisseur personnalisé, maîtrise des coûts et correctifs # Hermes Agent avec Claude via une passerelle : configuration d’un fournisseur personnalisé, maîtrise des coûts et correctifs Hermes Agent conserve les secrets dans ~/.hermes/.env et tout le reste dans ~/.hermes/config.yaml. La méthode fiable pour l’exécuter avec Claude via une passerelle consiste à utiliser un fournisseur personnalisé nommé qui communique au format Anthropic Messages. Le raccourci, provider: anthropic avec une URL de base différente, semble correct, mais envoie les requêtes à Anthropic pour tout hôte qu’il ne reconnaît pas. ## Installation Linux / macOS / WSL2Copier ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsCopier ``` iex (irm https://hermes-agent.nousresearch.com/install.ps1) ``` hermes setup lance l’assistant complet ; hermes model gère uniquement le fournisseur et le modèle ; hermes doctor vérifie une installation existante. ## Ajouter la passerelle comme fournisseur personnalisé ~/.hermes/.envCopier ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlCopier ``` providers: aiprime: api: https://aiprimetech.io/v1 key_env: AIPRIME_API_KEY transport: anthropic_messages catalog_provider: anthropic model: provider: custom:aiprime default: claude-sonnet-5 ``` | Clé | Pourquoi | transport: anthropic_messages | Communiquez au format Messages d’Anthropic. Sans ce paramètre, Hermes utilise par défaut le format OpenAI Chat Completions | key_env | Le nom de la variable dans .env qui contient la clé | catalog_provider: anthropic | Les modèles Claude de la passerelle héritent des métadonnées de contexte et de vision d’Anthropic | provider: custom:aiprime | Sélectionne le fournisseur nommé ; /model custom:aiprime: permet de changer de fournisseur dans un chat L’assistant fait la même chose : hermes model, puis **Endpoint personnalisé**, puis le mode API **Anthropic Messages**. Si vous choisissez plutôt Chat Completions, conservez /v1 dans l’URL. ## Pourquoi provider: anthropic avec une URL de base ne fonctionne pas Définir provider: anthropic et base_url: https://aiprimetech.io semble correct, mais n’a aucun effet : dans le code source actuel de Hermes, une URL de base de remplacement pour le fournisseur Anthropic intégré n’est acceptée que pour les hôtes Anthropic, Claude et Azure ; les requêtes continuent donc d’être envoyées à Anthropic. Utilisez le fournisseur personnalisé nommé ci-dessus. ANTHROPIC_BASE_URL est documenté comme un moyen de remplacer l’URL de base d’Anthropic, mais un bug non résolu de Hermes fait que le sélecteur de modèle l’ignore. Le fournisseur personnalisé évite ces deux problèmes. ## Ce qui détermine la consommation de tokens et les paramètres qui la limitent Hermes effectue des tâches au-delà de la conversation que vous voyez, et toutes sont facturées sur la même clé, sauf si vous les acheminez ailleurs. | Source de consommation | Définir | Subagents (delegation) | delegation.max_concurrent_children (par défaut 10), delegation.max_iterations (par défaut 250), delegation.max_spawn_depth (par défaut 1) ; un delegation.model | Révision de la mémoire et des compétences en arrière-plan après chaque tour | auxiliary.background_review.enabled: false, ou une valeur inférieure de max_input_tokens | Tâches auxiliaires (compression, titres, vision) | auxiliary..provider et .model pour les envoyer à un modèle moins cher | Tâches planifiées | cron.model pour toutes les tâches ; hermes cron pause ou hermes pause | Passerelle de messagerie (Telegram, Discord et autres) | Listes d’autorisation telles que TELEGRAM_ALLOWED_USERS ; évitez GATEWAY_ALLOW_ALL_USERS=true ~/.hermes/config.yaml (ajouts)Copier ``` delegation: max_concurrent_children: 3 model: claude-haiku-4-5 auxiliary: background_review: enabled: false cron: model: claude-haiku-4-5 ``` hermes prompt-size indique le coût fixe de chaque appel ; /usage et /compress sont utiles au cours d’une longue session. ## Connexion à Claude Pro ou Max à la place d’une clé Hermes peut se connecter à un compte Claude, mais sa documentation indique que cette méthode fonctionne uniquement avec un forfait Max et des crédits d’utilisation supplémentaire achetés, et que les abonnés Pro ne peuvent pas l’utiliser. Avec une clé API provenant d’une passerelle, il n’y a pas de fenêtre d’utilisation liée à un abonnement ; l’utilisation est facturée par token et déduite de votre solde. ## 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. Hermes nécessite une fenêtre de contexte d’au moins 64K tokens ; tous les modèles du tableau remplissent cette condition. ## Dépannage | Ce que vous voyez | Cause | Solution | HTTP 400 lors de la première exécution | Le nom du modèle ne correspond pas à un identifiant de modèle de la passerelle | Utilisez un identifiant du tableau ci-dessus | Les requêtes sont envoyées à Anthropic ou échouent avec une erreur d’authentification Anthropic | provider: anthropic avec une URL de base tierce | Utilisez le fournisseur personnalisé nommé | Réponses incohérentes ou vides | Transport inadapté à l’URL | transport: anthropic_messages pour Claude | Longueur du contexte dépassée | Session dépassant la fenêtre configurée | Définissez model.context_length; /compress | 403 Your request was blocked | Un pare-feu placé devant le point de terminaison rejette le client | Ajoutez extra_headers avec un User-Agent semblable à celui d’un navigateur | Paramètres manquants après une mise à jour | Le schéma de configuration a changé | hermes config check, puis hermes config migrate | Le bot reste silencieux sur Telegram ou Discord | La passerelle ne fonctionne pas ou l’expéditeur n’est pas autorisé | hermes gateway status ; vérifiez ~/.hermes/logs/gateway.log Vous comparez des frameworks d’agents ? Consultez le [guide de configuration d’OpenClaw](/fr/learn/run-openclaw-with-claude-api/). ## Questions fréquentes Comment utiliser Hermes Agent avec un point de terminaison Claude personnalisé ? Ajoutez un fournisseur nommé dans ~/.hermes/config.yaml avec api défini sur l’URL de la passerelle, key_env pointant vers une variable dans ~/.hermes/.env et transport: anthropic_messages, puis définissez model.provider: custom:. Pourquoi Hermes ignore-t-il mon base_url Anthropic ? Avec provider: anthropic, Hermes n’accepte une URL de base personnalisée que pour les hôtes Anthropic, Claude et Azure ; une URL tierce est donc ignorée. Utilisez plutôt un fournisseur personnalisé nommé. Comment réduire la consommation de tokens de Hermes Agent ? Limitez les sous-agents (paramètres de délégation), dirigez les tâches auxiliaires et les tâches cron vers un modèle moins coûteux, désactivez la révision en arrière-plan et vérifiez hermes prompt-size. Hermes Agent peut-il utiliser un abonnement Claude Pro ? Selon la documentation de Hermes, non : la connexion à Claude ne fonctionne qu’avec Max et des crédits d’utilisation supplémentaire. Une clé API permet d’éviter entièrement les limites de l’abonnement. 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/)[Aider avec Claude via une passerelle : ANTHROPIC_API_BASE, fichiers de configuration, mode architect et correctifs](/fr/learn/use-claude-api-with-aider/)[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/)[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/)