Anthropic

Introduction

Hermes Agent supporte les modeles Claude d'Anthropic de deux facons: via l'API native Anthropic (cle API directe, facturation pay-per-token) ou via OAuth (abonnement Claude Max avec credits extra). Cette page detaille les deux methodes.

Methodes d'authentification

Methode 1: OAuth Claude Max (via hermes model)

Cette methode utilise votre abonnement Claude Max. Attention: seuls les credits extra (overage) sont consommes. L'allocation de base du plan Max n'est pas utilisee par Hermes Agent. Les abonnes Claude Pro ne peuvent pas utiliser ce chemin.

hermes model
# Selectionnez "Anthropic" dans la liste
# Le navigateur s'ouvre pour l'authentification OAuth

Ou en ligne de commande:

hermes auth add anthropic --type oauth

Prerequis: un abonnement Claude Max avec des credits extra actifs.

Methode 2: Cle API directe (pay-per-token)

Cette methode facture chaque token via votre cle API Anthropic, independamment de tout abonnement Claude.

export ANTHROPIC_API_KEY=sk-ant-...
hermes chat --provider anthropic --model claude-sonnet-4-6

Ou ajoutez la cle dans ~/.hermes/.env:

echo 'ANTHROPIC_API_KEY=sk-ant-...' >> ~/.hermes/.env

Puis:

hermes model    # choisir Anthropic

Methode 3: Setup-token manuel

Pour les environnements sans navigateur (serveurs, VPS), vous pouvez utiliser un setup-token manuel. Consultez la documentation officielle pour la procedure detaillee.

Choisir un modele

Les modeles Claude disponibles incluent:

• claude-sonnet-4-6 (recommande pour la plupart des taches)
• claude-opus-4-5 (taches complexes, raisonnement approfondi)
• claude-haiku-4-5 (rapide, economique)

Utilisez hermes model pour selectionner interactivement, ou /model en cours de session.

Configuration avancee

Prompt caching

Anthropic supporte le prompt caching pour reduire les couts sur les longs contextes. Hermes Agent l'active automatiquement quand c'est pertinent. Vous pouvez le configurer dans config.yaml:

prompt_caching:
  enabled: true

Contexte et limites

Les modeles Claude ont des fenetres de contexte allant jusqu'a 200K tokens. Hermes Agent detecte automatiquement la limite. Si vous rencontrez des erreurs de contexte, verifiez avec:

hermes prompt-size

Verifier la connexion

hermes status
hermes chat -q "Bonjour, quel modele es-tu ?"

Depannage

Erreur d'authentification OAuth

Si vous n'avez pas d'abonnement Claude Max avec credits extra, l'OAuth echouera. Passez a la cle API directe (ANTHROPIC_API_KEY).

Token refresh invalide

Si un refresh token OAuth est revoque, Hermes le met en quarantaine. Relancez l'authentification:

hermes auth add anthropic --type oauth

Erreur 429 (Rate limit)

Vous avez depasse votre limite de requetes. Pour l'API directe, verifiez votre console Anthropic. Pour OAuth, verifiez vos credits extra.

Erreur de contexte

Si le modele refuse un prompt trop long, verifiez la fenetre de contexte detectee et ajustez si necessaire:

model:
  default: "claude-sonnet-4-6"
  context_window: 200000

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• AI Providers (https://hermes-agent.nousresearch.com/docs/integrations/providers)
• CLI commands reference (https://hermes-agent.nousresearch.com/docs/reference/cli-commands)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Modeles et providers
• Configurer Hermes Agent
• OpenRouter
• Nous Portal
• Depannage