Source: https://aiprimetech.io/es/learn/run-hermes-agent-with-claude-api/ [Inicio](/es/) / [Aprende](/es/learn/) / Hermes Agent con Claude mediante una pasarela: configuración de proveedor personalizado, controles de costes y soluciones # 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 Linux / macOS / WSL2Copiar ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsCopiar ``` iex (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 ~/.hermes/.envCopiar ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlCopiar ``` providers: 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: 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 Configurar 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..provider y .model para enviarlas a un modelo más económico | Tareas programadas | cron.model para todas las tareas; hermes cron pause o hermes pause | Pasarela de mensajería (Telegram, Discord y otros) | Listas de permitidos como TELEGRAM_ALLOWED_USERS; evita GATEWAY_ALLOW_ALL_USERS=true ~/.hermes/config.yaml (adiciones)Copiar ``` delegation: max_concurrent_children: 3 model: claude-haiku-4-5 auxiliary: background_review: enabled: false cron: model: claude-haiku-4-5 ``` hermes 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](/es/learn/run-openclaw-with-claude-api/). ## Preguntas frecuentes ¿Cómo uso Hermes Agent con un endpoint personalizado de Claude? Añade un proveedor con nombre en ~/.hermes/config.yaml con api establecido en la URL del gateway, key_env apuntando a una variable de ~/.hermes/.env y transport: anthropic_messages; después, establece model.provider: custom:. ¿Por qué Hermes ignora mi base_url de Anthropic? Con provider: anthropic, Hermes solo acepta una URL base alternativa para hosts de Anthropic, Claude y Azure, por lo que descarta las URL de terceros. Usa en su lugar un proveedor personalizado con nombre. ¿Cómo reduzco el consumo de tokens de Hermes Agent? Limita los subagentes (ajustes de delegación), dirige las tareas auxiliares y las tareas cron a un modelo más económico, desactiva la revisión en segundo plano y consulta hermes prompt-size. ¿Puede Hermes Agent usar una suscripción a Claude Pro? Según la documentación de Hermes, no: la vía de inicio de sesión de Claude solo funciona con Max y créditos de uso adicional. Una clave API evita por completo los límites de la suscripción. Empieza a usar Claude en minutos Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.[Obtén tu clave de API](/register) AI 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. ## Más guías de la API de Claude [Cómo obtener una clave de API de Claude](/es/learn/how-to-get-a-claude-api-key/)[Precios de la API de Claude, explicados](/es/learn/claude-api-pricing-explained/)[La forma más económica de usar la API de Claude](/es/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado con la API de Claude](/learn/use-claude-api-with-cursor/)[Acceso ilimitado a Claude Code](/es/learn/use-claude-api-with-claude-code/)[Gateway de la API de Claude frente al acceso directo a Anthropic](/es/learn/claude-api-vs-anthropic-direct/)[Utiliza Claude con el SDK de OpenAI: endpoint compatible con OpenAI, streaming, herramientas y límites](/es/learn/openai-compatible-claude-api/)[Los modelos de Claude explicados: una comparación de Claude Opus, Sonnet, Haiku y Fable; todos los modelos de la API de Claude, nombres de modelos de Anthropic y precios (2026)](/es/learn/claude-api-models-compared/)[Pagar la API de Claude con criptomonedas](/es/learn/claude-api-with-crypto-payment/)[Acceso a la API de Claude sin lista de espera](/es/learn/claude-api-without-waitlist/)[Cómo reducir el uso de tokens de Claude](/es/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado con la API de Claude](/es/learn/use-claude-api-with-cline/)[Roo Code ilimitado con la API de Claude](/es/learn/use-claude-api-with-roo-code/)[Claude ilimitado en los IDE de JetBrains](/es/learn/use-claude-api-with-jetbrains/)[Aider con Claude a través de una pasarela: ANTHROPIC_API_BASE, archivos de configuración, modo arquitecto y soluciones](/es/learn/use-claude-api-with-aider/)[Claude ilimitado en VS Code](/es/learn/use-claude-api-with-vscode/)[Configuración de OpenCode para Claude: ajustes de opencode.json, modelos y errores comunes](/es/learn/use-claude-api-with-opencode/)[Ejecutar OpenClaw sin límites con Claude](/es/learn/run-openclaw-with-claude-api/)[Qué significa una API compatible con Anthropic](/es/learn/anthropic-compatible-api/)[Clave API de Claude Code — ANTHROPIC_API_KEY: cómo obtenerla, configurarla y cuándo usar claude setup-token en su lugar](/es/learn/claude-code-api-key-setup/)[Costes de la API de Claude Code: precios y cómo reducirlos](/es/learn/claude-code-api-costs/)[Explicación de los errores de la API de Claude: error del servidor 500, sobrecarga 529, límite de solicitudes 429, solicitud incorrecta 400 y la solución para cada uno](/es/learn/claude-api-errors-troubleshooting/)[Cómo comprar créditos para la API de Claude y por qué un crédito de Claude es mejor que cualquier oferta de «comprar una cuenta de Claude»](/es/learn/buy-claude-api-credits/)[API gratuita de Claude: ¿existe una clave API de Claude gratuita y qué es realmente gratis en 2026?](/es/learn/claude-api-free-trial/)[API de Claude frente a la suscripción Claude Pro/Max: cuál elegir](/es/learn/claude-api-vs-subscription/)[Codex CLI con un proveedor personalizado: config.toml, modelos GPT y Claude, extensión para IDE y soluciones](/es/learn/use-claude-api-with-codex/)[Conectar Claude a n8n](/es/learn/use-claude-api-with-n8n/)[Enrutar LiteLLM a Claude](/es/learn/use-claude-api-with-litellm/)[Usar Claude en Kilo Code](/es/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat con Claude a través de una pasarela: configuración de Custom Endpoint, modo agente y soluciones](/es/learn/use-claude-api-with-github-copilot/)[Conecta Zed a Claude a través de la pasarela](/es/learn/use-claude-api-with-zed/)[Conecta Cherry Studio a Claude](/es/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic en LangChain: importación, base_url, streaming, herramientas y errores](/es/learn/use-claude-api-with-langchain/)[SDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de errores](/es/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL de createAnthropic, streaming y soluciones](/es/learn/use-claude-api-with-vercel-ai-sdk/)[Ejecuta Factory Droid con Claude](/es/learn/use-claude-api-with-factory-droid/)[La API de Claude Code, explicada](/es/learn/claude-code-api/)[Integración de la API de Claude en tu aplicación](/es/learn/claude-api-integration/)[Cómo usar Claude sin límites y por qué no existe un «Claude Code crackeado»](/es/learn/get-unlimited-claude-usage/)