Usa ChatGPT en Hermes sin clave API: guía completa de configuración

Cómo usar ChatGPT con Hermes sin una API key

Puedes correr modelos GPT dentro de Hermes Agent usando nada más tu suscripción de ChatGPT que ya tienes. Hermes se autentica mediante OAuth con código de dispositivo de ChatGPT, guarda las credenciales en ~/.hermes/auth.json, y puede importar credenciales existentes de Codex CLI. Esto significa que no necesitas una API key de desarrollador, ni un dashboard de facturación por token, ni tienes que estar rotando llaves. Eso sí, hay un límite importante: este flujo requiere un plan de pago, y el costo de ChatGPT Plus se ha mantenido en $20 desde su lanzamiento.

Esta guía te explica cómo funciona, te lleva paso a paso por la instalación, y te muestra exactamente el flujo de inicio de sesión con OAuth. También cubre la forma más inteligente de pagar suscripciones de IA como ChatGPT, Claude y Gemini sin perder dinero en comisiones por transacciones en el extranjero. Te va a tomar unos 10 minutos de lectura, y al final vas a tener GPT corriendo en un agente de terminal con tu suscripción haciendo todo el trabajo pesado.

¿Pagas ChatGPT, Claude o Gemini en dólares cada mes? Bleap no te cobra comisiones por conversión de divisas en tus suscripciones en USD y te da un cashback fijo del 20% en Claude, ChatGPT y Gemini, con una Mastercard autocustodiada y sin suscripción propia. (El cashback del 20% aplica solo para Claude, ChatGPT y Gemini.) Obtén la tarjeta Bleap →

1. Cómo funciona realmente la integración OAuth de OpenAI con Hermes

El mecanismo detrás del acceso basado en suscripción

Hermes usa el flujo de código de dispositivo OAuth de OpenAI, el mismo patrón de autenticación que hay detrás de herramientas como Slack y la CLI de GitHub. En lugar de generar una API key en el panel de desarrolladores de OpenAI, tu suscripción existente a ChatGPT funciona como credencial. El código fuente de Hermes Agent usa un flujo OAuth de OpenAI Codex para la autenticación con OpenAI, no una simple variable de entorno OPENAIAPIKEY, y este flujo de dispositivo está pensado para usuarios que tienen una suscripción a Codex y quieren autenticarse a través del sitio web de OpenAI en lugar de andar manejando una API key en crudo.

Esto hace que las solicitudes pasen por la infraestructura de suscripción de consumo de ChatGPT en vez de por el nivel de API con pago por token.

Por qué esto es diferente de la autenticación con API key

Una API key implica una cuenta de desarrollador más facturación por token. Iniciar sesión con OAuth significa que tu suscripción mensual fija cubre el uso en su lugar. La ventaja práctica es real: sin facturas sorpresa de la API, sin tener que vigilar un presupuesto de tokens y sin llaves que rotar. Vale la pena aclarar una advertencia desde ahora: todavía no está documentado qué niveles de plan de ChatGPT son elegibles, ni cómo cuenta el uso de Hermes contra los límites de Codex de tu plan. Trata el acceso al modelo como una foto del momento, no como una garantía fija.

2. Requisitos previos: qué necesitas antes de empezar

Cuentas y suscripciones necesarias

• Un plan de pago de ChatGPT activo. Los precios de ChatGPT van de $0 a $200 dólares al mes en cinco niveles distintos: Free en $0, Go en $8, Plus en $20, y dos planes Pro en $100 y $200. El nivel gratuito no es compatible con este flujo.
• Una cuenta de OpenAI con un correo electrónico verificado.
• Necesitas al menos una suscripción de pago porque el flujo OAuth de dispositivo autentica contra tu suscripción, y las cuentas gratuitas no tienen acceso al modelo que este método utiliza.

Software necesario y compatibilidad del sistema

• Tener instalado Hermes Agent (lo vemos en la siguiente sección).
• Un sistema operativo compatible: macOS, Linux o Windows.
• Un emulador de terminal moderno como bash, zsh o PowerShell.
• Una conexión a internet para la redirección del navegador en el proceso OAuth.

Si usas Windows, corre la instalación desde una sesión de PowerShell con permisos de administrador. En Linux, verifica que tu perfil de shell esté cargando correctamente la ruta del binario de Hermes.

3. Instalación del Agente Hermes: Dos Métodos

Método 1: Instalador de Escritorio (Recomendado para Principiantes)

Ve a la página oficial de descarga del instalador de escritorio de Hermes y consigue la versión para tu sistema.

1. Descarga el instalador adecuado para tu sistema operativo: .dmg para macOS, .exe para Windows, o un .AppImage o paquete para Linux.
2. Ejecuta el instalador y sigue las instrucciones de la interfaz gráfica.
3. Confirma que Hermes esté disponible en el PATH de tu sistema una vez que termine la instalación.

Verifica la instalación con una revisión rápida de la versión:

hermes --version

Método 2: Instalación por Terminal (Recomendado para Desarrolladores)

Si prefieres quedarte en la terminal, usa un gestor de paquetes o el script de instalación.

• macOS y Linux: ejecuta el script de instalación basado en curl, o usa brew install hermes-agent.
• Windows: winget install hermes-agent o el paquete equivalente.

En macOS y Linux quizás tengas que dar permisos de ejecución al script descargado y agregar el directorio del binario a tu PATH. Luego confirma con la misma revisión:

hermes --version

Configuración Después de la Instalación

En la primera ejecución, Hermes crea un archivo de configuración en ~/.hermes/config.toml (o el equivalente según tu plataforma). No hay campos de clave API que llenar para el flujo de suscripción. No existe una clave API estática; Hermes genera y renueva automáticamente el token por ti, incluyendo la regeneración si ocurre un error 401 a la mitad de la sesión. OAuth se encarga del resto.

4. Ejecutar el comando de autenticación OAuth

El comando exacto en la terminal para iniciar sesión

Inicia el login con código de dispositivo de ChatGPT con:

hermes auth add openai-codex

También puedes hacerlo de forma interactiva. Ejecuta hermes auth add openai-codex (o hermes model → ChatGPT o Codex Subscription) para iniciar un nuevo login con código de dispositivo; la cuarentena se elimina en el siguiente intercambio exitoso. El selector interactivo es útil si no estás seguro de qué etiqueta de proveedor elegir, ya que te va guiando en la elección.

Qué pasa justo después de ejecutar el comando

Hermes genera un código de dispositivo único y lo muestra en la terminal junto con una URL de verificación. Después, la terminal entra en un estado de espera (polling), aguardando a que completes la aprobación desde el navegador. Durante esta fase, lo normal es que la terminal muestre el código, la URL y una línea de "esperando autorización" que se va actualizando mientras espera. La ventana de aprobación suele quedarse abierta varios minutos, así que no hay ninguna prisa por cambiar al navegador de inmediato.

¿Quieres que tu gasto mensual en IA realmente te regrese algo? En ChatGPT, Claude y Gemini, Bleap te da un cashback fijo del 20% en USDC más 0% de comisión por cambio de divisa en el cargo en USD, sin cuota mensual de tarjeta. Consigue la tarjeta Bleap →

5. Aprobar la solicitud de OAuth y completar el inicio de sesión

Confirmación paso a paso en el navegador (Device Code Flow)

1. Abre la URL que se imprimió en cualquier navegador. No necesitas estar en el mismo dispositivo donde ejecutaste el comando.
2. Inicia sesión con las credenciales de tu cuenta de OpenAI si aún no lo has hecho.
3. Ingresa el código de dispositivo que aparece en tu terminal cuando se te pida.
4. Revisa los permisos que Hermes está solicitando, que incluyen acceso de lectura a tu sesión de ChatGPT.
5. Haz clic en Confirmar o Permitir para completar la autorización.

Cómo se ve un inicio de sesión exitoso

La terminal muestra un mensaje de éxito confirmando la cuenta autenticada, y el token se guarda localmente en el directorio de configuración de Hermes. A partir de ese momento, la actualización en segundo plano mantiene tu sesión activa. Esto funciona igual que el mismo modelo de OAuth en otros proveedores de Hermes, donde no se necesita una API key, inicias sesión una sola vez y Hermes actualiza tu sesión automáticamente en segundo plano. No tendrás que volver a iniciar sesión hasta que el token guardado sea revocado o expire por completo.

Solución de errores comunes al iniciar sesión

• Código expirado: los códigos de dispositivo duran poco tiempo, así que vuelve a ejecutar el comando de inicio de sesión para generar un código y una URL nuevos.
• Cuenta no elegible: una cuenta gratuita de ChatGPT no puede completar este flujo, y eso es normal.
• Problemas de redirección en el navegador: desactiva los bloqueadores de ventanas emergentes para el dominio de autenticación, y si un token parece estar desactualizado, es más confiable iniciar sesión de nuevo que intentarlo otra vez. Ten en cuenta el consejo general de que los proveedores respaldados por OAuth, como Nous Portal u OpenAI Codex, pueden necesitar un nuevo flujo de inicio de sesión en lugar de otra API key.

6. Cómo elegir y cambiar de modelo GPT en Hermes

Configuración del modelo después de autenticarte

Una vez que te autenticas, Hermes usa un modelo base, pero puedes configurar el modelo GPT que prefieras de forma explícita:

hermes config set model <model-name>

Los modelos disponibles para ti dependen de tu plan de suscripción, y como el catálogo de OpenAI cambia rápido, te conviene revisar cuáles puede usar tu cuenta antes de decidirte por uno.

Modelos GPT disponibles con tu suscripción a ChatGPT

Para 2026, la familia insignia de OpenAI es GPT-5.6. El Agente Hermes puede funcionar con la familia GPT de OpenAI, incluyendo GPT-5.6 Sol, Terra, Luna y otros, y GPT-5.6 Sol es el modelo insignia actual.

La disponibilidad de los modelos cambia conforme OpenAI actualiza sus planes. De hecho, GPT-5.6 ya está apareciendo en las suscripciones de pago de ChatGPT, incluyendo cuentas Plus y Pro, pero el lanzamiento puede variar según la cuenta, la región y el plan. Puedes ver todo lo que tu cuenta puede usar con:

hermes models list

Cambiar de modelo a mitad de sesión

Puedes cambiar de modelo sobre la marcha durante una sesión activa. Un patrón muy común es bajar a un modelo más ligero y rápido para consultas sencillas, y luego regresar al modelo insignia cuando necesitas razonamiento complejo o tareas largas de programación. Así mantienes las respuestas ágiles sin sacrificar calidad donde realmente importa.

7. Verificar que la configuración funcione correctamente

Ejecutar un prompt de prueba

Confirma que todo funciona con un solo prompt:

hermes run "Explain OAuth device code flow in one paragraph"

Una ejecución exitosa muestra el nombre del modelo activo, devuelve una respuesta generada y no muestra errores de API key. La primera respuesta después de autenticarte puede tardar un poco más que las siguientes mientras la sesión se estabiliza.

Confirmar los detalles de la sesión y la suscripción

Revisa el estado actual de tu autenticación con:

hermes auth status

El resultado confirma tu correo con el que iniciaste sesión, el modelo activo y la validez del token. Como se menciona en la documentación sobre la vista de proveedores, la sección Auth Providers mostrará el estado actual de cada proveedor.

Qué hacer si la prueba falla

• Vuelve a ejecutar hermes auth add openai-codex si la sesión parece haber expirado.
• Revisa tu conexión a internet y las reglas del firewall.
• Consulta los registros recientes con hermes logs --tail 50 para identificar en qué capa está el problema.

8. Por qué usar GPT a través de Hermes en lugar de un modelo local

Calidad y capacidad de razonamiento

Los modelos GPT de gama alta superan constantemente a la mayoría de los modelos de peso abierto que puedes correr localmente en tareas de razonamiento, programación y lenguaje. Los modelos GPT son reconocidos por su sólida capacidad de codificación, su amplio conocimiento general y su confiable manejo de herramientas, cualidades que los hacen muy efectivos para cargas de trabajo con agentes. Obtienes resultados de alta calidad sin necesidad de trucos de prompt-engineering.

Ventana de contexto y memoria

Los modelos GPT alojados en la nube manejan ventanas de contexto mucho más grandes de lo que la mayoría del hardware de consumo puede procesar localmente. Esto significa bases de código más grandes, documentos más largos y conversaciones de varios turnos sin que se note una degradación a mitad de la sesión.

Requisitos de hardware (o la falta de ellos)

Los modelos locales como Llama y Mistral necesitan bastante VRAM, muchas veces un mínimo de 8 GB para modelos pequeños y 24 GB o más para los grandes. Con Hermes más el OAuth de ChatGPT, el procesamiento corre en la infraestructura de OpenAI en lugar de tu máquina. Esto hace que esta configuración sea ideal para gráficos integrados, laptops más viejas o equipos de trabajo con drivers de GPU bloqueados.

Confiabilidad y tiempo de actividad

No hay tiempos de carga de modelos, ni sacrificios por cuantización, ni throttling térmico. Obtienes disponibilidad constante en lugar de estar cuidando un servidor de inferencia local.

Cuándo un modelo local sigue siendo la mejor opción

Los modelos locales siguen ganando en tres casos: datos sensibles a la privacidad que nunca deberían salir del dispositivo, uso genuinamente sin conexión y volúmenes de uso extremadamente altos donde la economía por solicitud se inclina a favor del autohospedaje. Como dato útil, Hermes soporta ambos caminos, así que no quedas atado a ninguna dirección.

Tu stack de IA te cuesta dinero real cada mes. Haz que te regrese algo. ChatGPT, Claude y Gemini cobran en dólares, y una tarjeta típica agrega entre 2-3% en cada renovación. Bleap cobra 0% de comisión por conversión de divisas y te da un cashback fijo del 20% en las tres. Consigue la tarjeta Bleap →

Preguntas frecuentes: cómo usar ChatGPT con Hermes sin una API key

¿Necesito una suscripción a ChatGPT Plus para usar Hermes con los modelos GPT?

Sí, necesitas una suscripción de pago a ChatGPT Plus o Pro. El flujo de autenticación OAuth por código de dispositivo valida tu suscripción, y las cuentas gratuitas no pueden completar este proceso. El costo de ChatGPT Plus se ha mantenido en $20 dólares desde su lanzamiento, y el costo anual equivale a $240 dólares, aunque solo se cobra de forma mensual.

¿Cuál es el comando de terminal en Hermes para iniciar el login OAuth de ChatGPT?

Ejecuta hermes auth add openai-codex, o usa hermes model y selecciona la opción de suscripción a ChatGPT o Codex. Esto inicia el flujo de código de dispositivo, que muestra una URL y un código único que debes confirmar en tu navegador para completar la autenticación.

¿A qué modelos GPT puedo acceder con mi suscripción de ChatGPT en Hermes?

Eso depende de tu plan y de la disponibilidad actual. En 2026, la familia insignia es GPT-5.6 Sol, Terra y Luna. Ejecuta hermes models list después de autenticarte para ver exactamente a qué modelos tiene acceso tu cuenta, ya que la disponibilidad puede variar según la cuenta, la región y el plan.

¿En qué se diferencia esto de usar una API key de OpenAI con Hermes?

Una API key te cobra por token a través de la plataforma para desarrolladores de OpenAI. En cambio, el login por OAuth con tu suscripción de ChatGPT usa tu plan mensual fijo. La API tiene una estructura de costos distinta a la de las suscripciones de ChatGPT; ahí pagas por millón de tokens procesados, no por mensaje ni por mes, y el acceso a la API no incluye una suscripción a ChatGPT, ni viceversa.

¿Qué debo hacer si el código de dispositivo expira antes de confirmarlo?

Los códigos de dispositivo duran poco tiempo. Simplemente vuelve a ejecutar hermes auth add openai-codex para generar un código y una URL nuevos, y completa la confirmación en el navegador lo antes posible.

¿Puedo usar Hermes con un modelo local y cambiar a GPT cuando lo necesite?

Sí. Hermes es agnóstico en cuanto a proveedores y es compatible tanto con backends locales como con modelos GPT en la nube. Hermes Agent no depende de un proveedor en particular; Nous Portal es una de las rutas compatibles, y también son compatibles OpenRouter, Ollama, proveedores directos, GitHub Copilot, Hugging Face y endpoints compatibles con OpenAI. Usa hermes config set model <model-name> para cambiar de modelo cuando quieras.

Conclusión: saca más provecho a tu suscripción de ChatGPT con Hermes

Si ya pagas por ChatGPT Plus o Pro, usarlo dentro de un agente de terminal como Hermes te permite aprovechar un valor que de otra forma estarías dejando pasar. El proceso son cuatro pasos: instalar Hermes, ejecutar el comando de autenticación, confirmar en tu navegador y elegir tu modelo GPT. El resultado es que no tienes que administrar claves API, no hay sorpresas de facturación por token y no necesitas hardware local potente. La única contra real es que una suscripción de paga es indispensable para este flujo de trabajo. A partir de ahí, puedes experimentar cambiando de modelo: uno más ligero para rapidez y el más avanzado para tareas pesadas.

Un último consejo práctico sobre el pago en sí. Tus suscripciones de IA se renuevan en dólares, y la mayoría de las tarjetas suman discretamente entre 2% y 3% en cada cargo en el extranjero. Con Bleap pagas al tipo de cambio real, sin comisiones por conversión de divisas, y en Claude, ChatGPT y Gemini obtienes un cashback fijo del 20% en USDC en cada renovación, sin ninguna suscripción mensual de tarjeta. Es una Mastercard autocustodiada que puedes usar en cualquier lugar donde acepten Mastercard, así que el dinero que ahorras con tu configuración rinde todavía más.