Hermes Agent con Claude a través de una pasarela: configuración de un proveedor personalizado, controles de costes y soluciones
Hermes Agent guarda los secretos en ~/.hermes/.env y todo lo demás en ~/.hermes/config.yaml. La forma fiable de ejecutarlo con Claude mediante una pasarela es un proveedor personalizado con nombre que utilice el formato Messages de Anthropic. El atajo, provider: anthropic con una URL base diferente, parece correcto, pero envía las solicitudes a Anthropic para cualquier host que no reconozca.
Instalación
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashiex (irm https://hermes-agent.nousresearch.com/install.ps1)hermes setup ejecuta el asistente completo; hermes model gestiona solo el proveedor y el modelo; hermes doctor comprueba una instalación existente.
Añade la pasarela como proveedor personalizado
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| Clave | Por qué |
|---|---|
transport: anthropic_messages | Usa el formato Messages de Anthropic. Sin él, Hermes recurre al formato Chat Completions de OpenAI |
key_env | El nombre de la variable en .env que contiene la clave |
catalog_provider: anthropic | Los modelos de Claude de la pasarela heredan los metadatos de contexto y visión de Anthropic |
provider: custom:aiprime | selecciona el proveedor con ese nombre; /model custom:aiprime:<model> cambia de proveedor dentro de un chat |
El asistente hace lo mismo: hermes model, luego **Endpoint personalizado** y después el modo de API **Anthropic Messages**. Si eliges Chat Completions, conserva /v1 en la URL.
Por qué provider: anthropic con una URL base no funciona
provider: anthropic y base_url: https://aiprimetech.io parece correcto, pero no tiene efecto: en el código fuente actual de Hermes, solo se acepta una URL base alternativa para el proveedor integrado de Anthropic si el host es de Anthropic, Claude o Azure, por lo que las solicitudes siguen enviándose a Anthropic. Usa el proveedor personalizado con nombre indicado arriba.ANTHROPIC_BASE_URL está documentado como una opción para sustituir la URL base de Anthropic, pero un error pendiente de resolver en Hermes hace que el selector de modelos lo ignore. El proveedor personalizado evita ambos problemas.
Qué genera el consumo de tokens y qué ajustes lo limitan
Hermes realiza tareas más allá de la conversación que ves, y todas se facturan a la misma clave a menos que las dirijas a otro destino.
| Origen del consumo | Configurar |
|---|---|
| Subagents (delegation) | delegation.max_concurrent_children (valor predeterminado: 10), delegation.max_iterations (valor predeterminado: 250), delegation.max_spawn_depth (valor predeterminado: 1); un delegation.model |
| Revisión de memoria y habilidades en segundo plano después de cada turno | auxiliary.background_review.enabled: false, o un valor inferior de max_input_tokens |
| Tareas auxiliares (compresión, títulos, visión) | auxiliary.<task>.provider y .model para enviarlas a un modelo más económico |
| Tareas programadas | cron.model para todas las tareas; hermes cron pause <id> o hermes pause |
| Pasarela de mensajería (Telegram, Discord y otros) | Listas de permitidos como TELEGRAM_ALLOWED_USERS; evita 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 muestra el coste fijo de cada llamada; /usage y /compress ayudan durante una sesión larga.
Inicio de sesión con Claude Pro o Max en lugar de una clave
Hermes puede iniciar sesión en una cuenta de Claude, pero su documentación indica que esa vía solo funciona con un plan Max con créditos de uso adicional comprados y que los suscriptores de Pro no pueden usarla. Con una clave API de una pasarela no hay un periodo de uso ligado a la suscripción; el consumo se factura por token y se descuenta de tu saldo.
Modelos
| ID del modelo | Úsalo para |
|---|---|
claude-sonnet-5 | Opción predeterminada para programación y trabajo con agentes: rápida, potente y de precio intermedio. |
claude-opus-5-5 | Razonamiento más complejo, refactorizaciones grandes y ejecuciones largas de agentes. |
claude-fable-5-1 | El más capaz y el más caro; resérvalo para las tareas más difíciles. |
claude-haiku-4-5 | Económico y rápido: títulos, resúmenes, clasificación y pasos pequeños. |
Hermes necesita una ventana de contexto de al menos 64K tokens; todos los modelos de la tabla cumplen ese requisito.
Resolución de problemas
| Lo que ves | Causa | Solución |
|---|---|---|
| HTTP 400 en la primera ejecución | El nombre del modelo no coincide con un ID de modelo de la pasarela | Usa un ID de la tabla anterior |
| Las solicitudes se envían a Anthropic o fallan con un error de autenticación de Anthropic | provider: anthropic con una URL base de terceros | Usa el proveedor personalizado con nombre |
| Respuestas incoherentes o vacías | Transporte incorrecto para la URL | transport: anthropic_messages para Claude |
| Longitud de contexto excedida | Sesión mayor que la ventana configurada | Configura model.context_length; /compress |
403 Your request was blocked | Un cortafuegos situado delante del endpoint rechaza al cliente | Añade extra_headers con un User-Agent similar al de un navegador |
| Faltan ajustes después de una actualización | El esquema de configuración ha cambiado | hermes config check, y después hermes config migrate |
| El bot no responde en Telegram o Discord | El gateway no está en ejecución o el remitente no está autorizado | hermes gateway status; comprueba ~/.hermes/logs/gateway.log |
¿Estás comparando frameworks de agentes? Consulta la guía de configuración de OpenClaw.
Preguntas frecuentes
¿Cómo uso Hermes Agent con un endpoint personalizado de Claude?
¿Por qué Hermes ignora mi base_url de Anthropic?
¿Cómo reduzco el consumo de tokens de Hermes Agent?
¿Puede Hermes Agent usar una suscripción a Claude Pro?
Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.
Obtén tu clave de APIAI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.