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
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashiex (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é
AIPRIME_API_KEY=your_gateway_keyproviders:
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:<model> 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
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.<task>.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 <id> ou hermes pause |
| Passerelle de messagerie (Telegram, Discord et autres) | Listes d’autorisation telles que TELEGRAM_ALLOWED_USERS ; évitez GATEWAY_ALLOW_ALL_USERS=true |
delegation:
max_concurrent_children: 3
model: claude-haiku-4-5
auxiliary:
background_review:
enabled: false
cron:
model: claude-haiku-4-5hermes 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.
Questions fréquentes
Comment utiliser Hermes Agent avec un point de terminaison Claude personnalisé ?
Pourquoi Hermes ignore-t-il mon base_url Anthropic ?
Comment réduire la consommation de tokens de Hermes Agent ?
Hermes Agent peut-il utiliser un abonnement Claude Pro ?
Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.
Obtenir votre clé APIAI 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.