v0.14.0 trajo un comando de una línea — hermes proxy — que se tragó en silencio una clase entera de preguntas de integración que la comunidad llevaba meses haciendo. Lanzas hermes proxy y te queda un endpoint local http://localhost:port que habla la API de OpenAI, respaldado por el provider OAuth con el que estés autenticado en Hermes — Claude Pro, ChatGPT Pro o SuperGrok.
La consecuencia práctica: las herramientas que solo saben hablar la API de OpenAI — Aider, Cline, Codex CLI, Continue y la cola larga de plugins de editor — pueden ahora hablar con Claude Pro, ChatGPT Pro y SuperGrok a través de tu suscripción actual, sin que tengas que generar nunca una API key.
Esta es la parte que importa: la mayoría de estas herramientas exige una relación de facturación por provider. Aider con Claude → cuenta de Anthropic console con método de pago. Cline con GPT-5 → cuenta de facturación con OpenAI. Codex CLI → igual. hermes proxy colapsa todo eso en un único endpoint localhost que se autentica con la sesión OAuth que ya tienes.
Vamos al detalle.
0. Prerrequisitos
- •Hermes Agent v0.14.0 o más nuevo instalado y configurado (
hermes --versionpara comprobar) - •Al menos una suscripción OAuth vinculada vía
hermes model— Claude Pro, ChatGPT Pro o SuperGrok
Si nunca has iniciado sesión en un provider OAuth, la primera vez que ejecutes hermes model te lleva por el flujo OAuth de cada uno. Elige la suscripción que pagas de verdad.
1. Levanta el proxy
hermes proxy
Por defecto se enlaza a un puerto libre en localhost. El log de arranque muestra la URL — cópiala. Para fijar el puerto:
hermes proxy --port 11500
Déjalo corriendo como un proceso de larga duración — manténlo vivo mientras las herramientas aguas abajo lo estén usando. systemd, launchd, tmux o simplemente una pestaña de terminal — todo vale.
2. Apunta una herramienta aguas abajo al proxy
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # cualquier cadena no vacía funciona
aider --model claude-sonnet-4-6
El flag --model de Aider referencia el nombre del modelo tal como lo resuelve el proxy desde tu config de provider en Hermes. Si entraste vía Claude Pro, tu modelo Claude por defecto está disponible; lo mismo para ChatGPT Pro y SuperGrok.
Cline (VS Code)
En la configuración de Cline, elige OpenAI Compatible como provider. Pon:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(cualquier valor no vacío) - •Model ID: el nombre del modelo desde tu config de Hermes (por ejemplo
claude-sonnet-4-6,gpt-5.1)
Guarda. Cline enruta ahora sus requests a través de Hermes; la autenticación de la suscripción se encarga del resto.
Codex CLI
Codex CLI normalmente espera OPENAI_API_BASE y OPENAI_API_KEY. Misma forma que Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Si estás autenticado en ChatGPT Pro vía Hermes, el modelo gpt-5-codex aparece a través del proxy y Codex CLI obtiene acceso completo sin que tengas que abrir nunca una relación de facturación con OpenAI.
Continue (JetBrains / VS Code)
Edita tu config de Continue (~/.continue/config.json o desde la UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Mismo patrón. El "provider" se queda en openai porque, en lo que respecta a Continue, está golpeando un endpoint OpenAI.
3. Verifica que funciona
Un curl rápido:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Deberías recibir de vuelta la lista de modelos que tu config de provider de Hermes expone. Si te llega un 401 o una lista vacía, el proxy está corriendo pero Hermes no ve sesión OAuth activa — vuelve a ejecutar hermes model y elige un provider para el que tengas suscripción viva.
4. Resolución de problemas
- •"Connection refused" — el proxy no está corriendo. Lánzalo.
- •"401 unauthorized" — el modelo que pediste no está cubierto por tu suscripción vinculada. Ejecuta
hermes modely mira qué providers están activos. - •"Model not found" — el nombre del modelo en la herramienta aguas abajo no coincide con lo que tu provider de Hermes expone. Usa los nombres de
hermes model list. - •Rate-limited — estás chocando contra los límites de tasa de la suscripción (Claude Pro va por unos 50 mensajes cada 5 h en Sonnet; ChatGPT Pro tiene su propia cuota; SuperGrok la suya). El proxy no añade rate limiter propio; reenvía la cuota que te dé tu provider.
Por qué esto importa
La API de OpenAI es la lingua franca del ecosistema de herramientas de IA. Casi cualquier plugin de editor y asistente de código soporta primero OpenAI y, en segundo lugar, "endpoints OpenAI-compatibles". El truco es que "endpoint compatible" casi siempre significa "necesitas API key, que es una cuenta de facturación, que es tu suscripción de $20/mes convertida en una cuenta de pago por uso en el dashboard de alguien".
hermes proxy colapsa ese problema. Tu suscripción OAuth se queda donde vive. El proxy habla OpenAI en localhost. Aider, Cline, Codex CLI, Continue — no saben que están hablando con Claude o Grok. Solo ven un endpoint OpenAI que funciona.
Una suscripción, todas las herramientas, sin API key. Ese es el discurso entero.