Même travail, deux fois la fenêtre : pourquoi votre quota Claude Max se vide plus vite sous Hermes


Quinze heures, et vous plissez les yeux sur le panneau d’usage de Claude : quelques modifications de fichiers dans le terminal et votre fenêtre de cinq heures est presque à moitié entamée. Pas de job batch, pas de seconde session. Alors où est passé le quota ?

Probablement pas dans la quantité de travail, mais dans le nom sous lequel vous l’avez fait. Claude Code inscrit l’identité de l’appelant dans l’en-tête de facturation de chaque requête, et les abonnements pondèrent le quota selon cette identité — claude -p et les autres appelants non interactifs prennent par défaut sdk-cli, qui se trouve justement dans la tranche surtaxée. Même travail, nom différent, facture à peu près divisée par deux.

Une variable d’environnement décide de votre tarif

Voici le mécanisme. Claude Code nomme son appelant à chaque requête — cc_entrypoint dans l’en-tête de facturation, et de nouveau dans le user agent. Quand vous lancez claude -p, ou que vous appelez via l’Agent SDK, ce nom prend par défaut la valeur sdk-cli. Dans le comptage des abonnements, les appelants sdk-* sont comptés à environ deux fois le poids par token — bien plus lourd que la CLI interactive, et plus lourd qu’un client qui tourne sous son propre nom. Le comportement a été signalé à plusieurs reprises dans le tracker d’Anthropic (anthropics/claude-code#97074) et n’a jamais été documenté officiellement.

Tout le problème est là : votre agent fait tourner le même modèle, sur le même contexte, que vous tapant claude dans un terminal — et il est facturé presque le double parce qu’il répond au nom sdk-cli.

Le correctif est modeste : lancer le processus enfant sous le nom hermes-agent, en écrasant tout nom hérité d’un hôte (sdk-py, claude-desktop). Ce n’est pas truquer le compteur — c’est se présenter sous l’identité propre du client, ce qui est le chemin normal qu’Anthropic prévoit pour les clients tiers.

Mesuré : les mêmes 2,19 $ coûtent 12 % contre 7 %

Ce n’est pas une estimation. C’est un test A/B sur un véritable abonnement Max, avec des conditions énoncées précisément :

  • offre Max, Opus 5.5, Claude Code 2.1.316 ;
  • chaque bras a envoyé quatre requêtes fraîches d’environ 43 000 tokens (écritures de cache, rien de lu depuis le cache), sortie figée à 16 tokens, soit environ 1,09 $ équivalent tarif catalogue par bras ;
  • les bras alternaient avant, après, avant, après ; l’utilisation de la fenêtre de cinq heures était lue avec une sonde Haiku 60 secondes après chaque bras ;
  • la fenêtre démarrait à 3 %, sans autre trafic sur le compte.

Le résultat :

Bras Nom sur les requêtes Delta sur cinq heures (deux tours) Total pour 2,19 $
Avant sdk-cli +6 % / +6 % 12 %
Après hermes-agent +4 % / +3 % 7 %

Le même travail a consommé environ 1,7 fois moins de fenêtre. Les mainteneurs du plugin ont mesuré cela le 31 octobre 2026 et l’ont consigné dans le README — une mesure officielle, pas une rumeur de communauté — et ils signalent eux-mêmes la réserve : Anthropic n’a pas documenté la pondération, donc l’avantage peut changer sans préavis.

Il y a un effet de bord, et un correctif

Renommer n’est pas sans conséquences. Quand Claude Code voit un appelant qui n’est pas un SDK, il active l’éligibilité native aux artefacts, ce qui ajoute une ligne Scratchpad directory: … au message d’environnement de chaque requête. Sur une fenêtre comptée au token, c’est du surcoût pur — répété à chaque appel.

Le plugin définit CLAUDE_CODE_DISABLE_ARTIFACT=1 pour garder cette ligne dehors. Le changement complet tient donc en deux choses à la fois : tourner sous hermes-agent, et désactiver la ligne d’artefact.

Comment obtenir le correctif

Il vit dans le plugin officiel claude-subscription-directsdk, pas dans le cœur. La version du plugin est toujours 0.3.3, mais l’épinglage du catalogue est passé de 20048e6 à 01fa168, ce qui correspond à la PR #245 du dépôt du plugin.

Si vous l’avez déjà installé, une commande réépingle :

hermes plugins update claude-subscription-directsdk

Les installations par catalogue ne font pas de git pull à la mise à jour — elles réinstallent au SHA revu, et c’est exactement ainsi que l’ancien commit est remplacé. Pour vérifier d’abord ce qui tourne :

hermes plugins info claude-subscription-directsdk

La sortie montre la version et le SHA épinglé. Pour une installation neuve :

hermes plugins install claude-subscription-directsdk

Il exige Hermes >=0.21.4 et une CLI claude connectée sur la machine. Le plugin la vérifie au chargement, dans les sélecteurs de modèle et avant chaque requête — si elle manque, il refuse proprement avec une indication d’installation au lieu de fonctionner à moitié.

Ne lisez pas cela comme « abonnement = gratuit »

Deux contresens méritent d’être écartés d’emblée.

Premièrement, ce fournisseur n’est pas pénalisé. Il consomme le quota exactement au tarif claude -p / Agent SDK, pas un point de plus. Le véritable écart se situe face à la TUI interactive : mesuré sur Sonnet 5 avec le contexte 1M, Claude Code interactif consomme environ 0,58 fois ce tarif. Autrement dit, le même travail tapé à la main dans le terminal étire davantage une fenêtre de cinq heures ; tout harnais de type -p/SDK doit être planifié à environ 60 % du débit de la TUI.

Deuxièmement, la pondération est côté serveur ; le plugin ne peut pas changer la règle. Ce que vous pouvez faire, c’est vous présenter sous la bonne identité. Ce que vous ne pouvez pas faire, c’est fabriquer du quota. Si Anthropic ajuste les poids, ce facteur 1,7 deviendra un autre nombre — ne le figez pas comme constante dans un modèle budgétaire.

Comment le mesurer vous-même

Ne vous fiez pas à l’impression. La méthode est aussi simple que l’A/B ci-dessus : fixez une tâche, exécutez-la deux fois, lisez l’utilisation une fois entre les tours, et comparez le delta en pourcentage à l’équivalent en prix catalogue. C’est ainsi que les chiffres du plugin ont été produits, et vous pouvez appliquer la même comparaison entre le /usage de Hermes et le /cost de Claude Code sur une seule tâche.

Si vous n’avez pas encore relié Hermes à votre abonnement, le guide du fournisseur d’abonnement Claude couvre l’installation et le choix du modèle. Pour voir l’usage et le coût côte à côte, fenêtres d’usage et offres et suivi des coûts sont les suites logiques.

Une dernière remarque honnête : un correctif comme celui-ci n’a pas de valeur parce que le chiffre est beau, mais parce qu’il a mis au jour un coût caché qui n’avait rien à voir avec la quantité de travail fournie. Vous payez un abonnement ; vous devriez être compté à un seul tarif.