Un abonnement Claude Pro, tous les outils : `hermes proxy` avec Aider, Cline et Codex CLI

v0.14.0 a sorti une commande en une ligne — hermes proxy — qui a avalé sans bruit toute une classe de questions d'intégration que la communauté posait depuis des mois. Tu lances hermes proxy et tu te retrouves avec un endpoint local http://localhost:port qui parle l'API OpenAI, adossé à n'importe quel provider OAuth sur lequel tu es connecté via Hermes — Claude Pro, ChatGPT Pro ou SuperGrok.

Conséquence pratique : les outils qui ne savent parler que l'API OpenAI — Aider, Cline, Codex CLI, Continue, et la longue traîne de plugins d'éditeur — peuvent désormais parler à Claude Pro, ChatGPT Pro et SuperGrok via ton abonnement existant, sans que tu génères la moindre API key.

C'est la partie qui compte : la plupart de ces outils exigent une relation de facturation par provider. Aider avec Claude → un compte Anthropic console avec moyen de paiement. Cline avec GPT-5 → un compte de facturation OpenAI. Codex CLI → pareil. hermes proxy réduit tout ça à un seul endpoint localhost qui s'authentifie avec la session OAuth que tu as déjà.

Voici le workflow exact.

0. Pré-requis

• •Hermes Agent v0.14.0 ou plus récent installé et configuré (hermes --version pour vérifier)
• •Au moins un abonnement OAuth lié via hermes model — Claude Pro, ChatGPT Pro ou SuperGrok

Si tu ne t'es jamais connecté à un provider OAuth, le premier lancement de hermes model te guide à travers le flow OAuth de chaque provider. Choisis l'abonnement que tu paies vraiment.

1. Démarrer le proxy

hermes proxy

Par défaut, il s'attache à un port libre sur localhost. Le log de démarrage affiche l'URL — copie-la. Pour fixer le port :

hermes proxy --port 11500

Tu le fais tourner comme un processus long — tu le gardes en vie tant que des outils en aval s'en servent. systemd, launchd, tmux ou simplement un onglet de terminal, tout marche.

2. Pointer un outil en aval vers le proxy

Aider

export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy  # n'importe quelle chaîne non vide marche
aider --model claude-sonnet-4-6

Le flag --model d'Aider référence le nom du modèle tel que le proxy le résout depuis ta config provider de Hermes. Si tu es connecté en Claude Pro, ton modèle Claude par défaut est disponible ; pareil pour ChatGPT Pro et SuperGrok.

Cline (VS Code)

Dans les réglages de Cline, choisis OpenAI Compatible comme provider. Mets :

• •Base URL : http://localhost:11500/v1
• •API Key : hermes-proxy (n'importe quelle valeur non vide)
• •Model ID : le nom du modèle dans ta config Hermes (par exemple claude-sonnet-4-6, gpt-5.1)

Enregistre. Cline route maintenant ses requêtes via Hermes ; ton auth d'abonnement s'occupe du reste.

Codex CLI

Codex CLI attend typiquement OPENAI_API_BASE et OPENAI_API_KEY. Même forme que pour Aider :

export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex

Si tu es connecté à ChatGPT Pro via Hermes, le modèle gpt-5-codex sort par le proxy et Codex CLI a un accès complet sans que tu aies jamais à ouvrir une relation de facturation avec OpenAI.

Continue (JetBrains / VS Code)

Édite ta config Continue (~/.continue/config.json ou depuis l'UI) :

{
  "models": [{
    "title": "Claude via Hermes",
    "provider": "openai",
    "model": "claude-sonnet-4-6",
    "apiBase": "http://localhost:11500/v1",
    "apiKey": "hermes-proxy"
  }]
}

Même schéma. Le "provider" reste openai parce que, du point de vue de Continue, il tape un endpoint OpenAI.

3. Vérifier que ça marche

Un curl rapide :

curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"

Tu devrais récupérer la liste des modèles que ta config provider Hermes expose. Si tu reçois un 401 ou une liste vide, le proxy tourne mais Hermes ne voit pas de session OAuth active — relance hermes model et choisis un provider pour lequel tu as un abonnement vivant.

4. Dépannage

• •« Connection refused » — le proxy ne tourne pas. Lance-le.
• •« 401 unauthorized » — le modèle que tu as demandé n'est pas couvert par ton abonnement lié. Lance hermes model et regarde quels providers sont actifs.
• •« Model not found » — le nom de modèle dans l'outil en aval ne correspond pas à ce que ton provider Hermes expose. Utilise les noms de hermes model list.
• •Rate-limité — tu tapes les limites de ton abonnement (Claude Pro fait dans les 50 messages par 5 h sur Sonnet ; ChatGPT Pro a son propre quota ; SuperGrok le sien). Le proxy n'ajoute pas de rate limiter ; il transmet le quota que ton provider te donne.

Pourquoi ça compte

L'API OpenAI est la lingua franca de l'écosystème des outils IA. Quasiment chaque plugin d'éditeur et chaque assistant de code supporte d'abord OpenAI, et en second « endpoints compatibles OpenAI ». Le piège, c'est qu'« endpoint compatible » veut presque toujours dire « il faut une API key, donc un compte de facturation, donc ton abonnement à 20 dollars par mois devient un compte pay-as-you-go sur le dashboard de quelqu'un d'autre ».

hermes proxy plie ce problème. Ton abonnement OAuth reste là où il vit. Le proxy parle OpenAI sur localhost. Aider, Cline, Codex CLI, Continue — ils ne savent pas qu'ils parlent à Claude ou à Grok. Ils voient juste un endpoint OpenAI qui marche.

Un abonnement, tous les outils, pas d'API key. C'est tout le pitch.

Pour aller plus loin

• •Notes de v0.14.0 — annonce de hermes proxy
• •Documentation Hermes Agent
• •Hermes Agent sur GitHub