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

Cómo usar ChatGPT con Hermes sin una clave de API

Puedes ejecutar modelos GPT dentro de Hermes Agent usando únicamente tu suscripción de ChatGPT ya existente. Hermes se autentica mediante el OAuth de código de dispositivo de ChatGPT, guarda las credenciales en ~/.hermes/auth.json, y puede importar credenciales ya existentes de Codex CLI. Esto significa que no necesitas ninguna clave de API de desarrollador, ningún panel de facturación por token, ni tener que rotar claves. Ten en cuenta un límite importante: este flujo requiere un plan de pago, y el coste de ChatGPT Plus se ha mantenido en 20 $ desde su lanzamiento.

Esta guía explica el funcionamiento, repasa la instalación paso a paso y muestra el flujo exacto de inicio de sesión mediante OAuth. También aborda la forma más inteligente de pagar suscripciones de IA como ChatGPT, Claude y Gemini sin perder dinero por comisiones de transacciones en el extranjero. Calcula unos 10 minutos de lectura, y al final tendrás GPT funcionando 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 cobra comisiones de cambio de divisa en tus suscripciones en USD y te da un 20% de cashback fijo en Claude, ChatGPT y Gemini, con una Mastercard autocustodiada y sin ninguna suscripción propia. (El 20% de cashback se aplica solo a Claude, ChatGPT y Gemini.) Consigue 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 utiliza 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 clave API en el panel de desarrolladores de OpenAI, tu suscripción existente a ChatGPT actúa como credencial. El código fuente original de Hermes Agent utiliza un flujo OAuth de dispositivo 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 gestionar una clave API en bruto.

Esto hace que las solicitudes pasen por la infraestructura de suscripción para consumidores de ChatGPT en lugar de por el nivel de API de pago por token.

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

Una clave API implica una cuenta de desarrollador más facturación por token. El inicio de sesión con OAuth significa que tu suscripción mensual plana cubre el uso en su lugar. La ventaja práctica es real: sin facturas de API sorpresa, sin presupuesto de tokens que vigilar y sin claves que rotar. Una advertencia que conviene señalar desde el principio: qué niveles del plan de ChatGPT son elegibles y cómo cuenta el uso de Hermes dentro de los límites de Codex de tu plan son cuestiones que actualmente no están documentadas. Trata el acceso a los modelos como una instantánea puntual y 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 repartidos en cinco niveles: Free a 0 $, Go a 8 $, Plus a 20 $, y dos planes Pro a 100 $ y 200 $. El nivel gratuito no es compatible con este proceso.
• Una cuenta de OpenAI con una dirección de correo electrónico verificada.
• Una suscripción de pago es el requisito mínimo, ya que el flujo OAuth por dispositivo autentica tu suscripción, y las cuentas gratuitas no tienen el acceso a modelos que expone este método.

Software necesario y compatibilidad del sistema

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

Los usuarios de Windows deben ejecutar la instalación desde una sesión de PowerShell con permisos elevados. En Linux, comprueba que el perfil de tu shell carga 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 plataforma.

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

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

hermes --version

Método 2: instalación por terminal (recomendado para desarrolladores)

Si prefieres quedarte en la línea de comandos, 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 puede que necesites dar permisos de ejecución al script descargado y añadir el directorio del binario a tu PATH. Después, confirma la instalación con la misma comprobación:

hermes --version

Configuración posterior a la instalación

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

4. Ejecutar el comando de autenticación OAuth

El comando exacto de terminal para iniciar sesión

Inicia el proceso de inicio de sesión con código de dispositivo de ChatGPT con:

hermes auth add openai-codex

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

Qué ocurre 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. La terminal entra entonces en un estado de sondeo, esperando a que completes la aprobación desde el navegador. Durante esta fase, la salida de la terminal suele mostrar el código, la URL y una línea de "esperando autorización" que se actualiza mientras realiza el sondeo. La ventana de aprobación suele permanecer abierta durante varios minutos, así que no hay ninguna prisa por cambiar al navegador de inmediato.

¿Quieres que tu gasto mensual en IA realmente te compense? En ChatGPT, Claude y Gemini, Bleap te da un 20% de cashback fijo en USDC además de un 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 (flujo de código de dispositivo)

1. Abre la URL impresa 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. Introduce el código de dispositivo que aparece en tu terminal cuando se te solicite.
4. Revisa los permisos que solicita Hermes, que abarcan el 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

El 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 renovación en segundo plano mantiene tu sesión activa. Esto refleja cómo se comporta el mismo modelo de OAuth con otros proveedores de Hermes, donde no se necesita clave API: inicias sesión una vez y Hermes renueva automáticamente tu sesión en segundo plano. No tendrás que repetir el inicio de sesión hasta que el token guardado se revoque o caduque por completo.

Solución de errores comunes al iniciar sesión

• Código caducado: los códigos de dispositivo tienen una vida corta, 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 es un comportamiento esperado.
• Problemas de redirección del navegador: desactiva los bloqueadores de ventanas emergentes para el dominio de autenticación, y si un token parece estar caducado, es más fiable hacer un inicio de sesión nuevo que reintentarlo 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 clave API.

6. Seleccionar y cambiar de modelo GPT en Hermes

Configuración del modelo tras la autenticación

Una vez autenticado, Hermes utiliza un modelo predeterminado, pero puedes establecer explícitamente tu modelo GPT preferido:

hermes config set model <model-name>

Los modelos disponibles dependen de tu nivel de suscripción, y el catálogo de OpenAI cambia rápidamente, así que comprueba a cuáles puede acceder realmente tu cuenta antes de decidirte por uno.

Modelos GPT disponibles con la suscripción a ChatGPT

A partir de 2026, la familia insignia de OpenAI es GPT-5.6. Hermes Agent puede funcionar con la familia GPT de OpenAI, GPT-5.6 Sol, Terra, Luna y otros, siendo GPT-5.6 Sol el modelo insignia actual.

La disponibilidad de los modelos varía a medida que OpenAI actualiza sus niveles de suscripción. De hecho, GPT-5.6 ya está apareciendo en las suscripciones de pago de ChatGPT, incluidas las cuentas Plus y Pro, aunque el despliegue puede variar según la cuenta, la región y el plan. Consulta todo lo que tu cuenta puede usar con:

hermes models list

Cambiar de modelo en mitad de una sesión

Puedes cambiar de modelo sobre la marcha durante una sesión activa. Un patrón habitual es pasar a un modelo más ligero y rápido para consultas sencillas, y luego volver al modelo insignia para razonamientos complejos o tareas de programación largas. Así mantienes las respuestas ágiles sin sacrificar calidad cuando realmente importa.

7. Verificar que la configuración funciona correctamente

Ejecutar un prompt de prueba

Confirma que todo funciona con un único 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 clave API. La primera respuesta tras la autenticación 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

Comprueba el estado actual de tu autenticación con:

hermes auth status

El resultado confirma tu correo electrónico de inicio de sesión, el modelo activo y la validez del token. Como indica la documentación sobre la vista de proveedores, la sección de Proveedores de autenticación 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 caducado.
• Comprueba la conexión a internet y las reglas del cortafuegos.
• Revisa los registros más recientes con hermes logs --tail 50 para identificar en qué capa falla.

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 de forma constante a la mayoría de los modelos de pesos abiertos que se pueden ejecutar localmente en tareas de razonamiento, programación y lenguaje. Los modelos GPT destacan por su sólida capacidad de programación, su amplio conocimiento general y su fiable uso de herramientas, cualidades que los hacen muy eficaces para cargas de trabajo agénticas. Consigues resultados de alta calidad sin necesidad de recurrir a trucos de prompt engineering.

Ventana de contexto y memoria

Los modelos GPT alojados en la nube gestionan ventanas de contexto mucho más grandes de lo que puede manejar localmente la mayoría del hardware doméstico. Esto se traduce en bases de código más grandes, documentos más largos y conversaciones de varios turnos sin que se note una pérdida de calidad a mitad de la sesión.

Requisitos de hardware (o la falta de ellos)

Los modelos locales como Llama y Mistral necesitan bastante VRAM, normalmente un mínimo de 8 GB para los modelos pequeños y 24 GB o más para los grandes. Con Hermes junto con ChatGPT OAuth, la computación se ejecuta en la infraestructura de OpenAI en su lugar. Eso hace que esta configuración sea ideal para gráficos integrados, portátiles antiguos o equipos de trabajo con drivers de GPU bloqueados.

Fiabilidad y disponibilidad

No hay tiempos de carga de modelos, ni compromisos por cuantización, ni limitaciones por sobrecalentamiento. Obtienes una disponibilidad constante en lugar de tener que estar pendiente de 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 que nunca deberían salir del dispositivo, uso realmente offline y volúmenes de uso extremadamente altos, donde la economía por solicitud se inclina a favor del autoalojamiento. Como dato útil, Hermes es compatible con ambas vías, así que no te quedas atado a ninguna de las dos.

Tu stack de IA te cuesta dinero de verdad cada mes. Haz que te devuelva algo. ChatGPT, Claude y Gemini facturan en dólares, y una tarjeta normal añade un 2-3% en cada renovación. Bleap no cobra comisiones de cambio de divisa y te da un 20% de cashback fijo en las tres. Consigue la tarjeta Bleap →

Preguntas frecuentes: usar ChatGPT con Hermes sin clave API

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

Sí, hace falta una suscripción de pago a ChatGPT Plus o Pro. El flujo de autenticación OAuth por código de dispositivo se valida contra tu suscripción, y las cuentas gratuitas no pueden completar este proceso. El precio de ChatGPT Plus se ha mantenido en 20 $ desde su lanzamiento, y el coste anual de ChatGPT Plus es de 240 $, solo con facturación mensual.

¿Cuál es el comando de terminal de Hermes para iniciar sesión con ChatGPT mediante OAuth?

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 el navegador para completar la autenticación.

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

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

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

Con una clave API se te cobra por token a través de la plataforma para desarrolladores de OpenAI. En cambio, iniciar sesión mediante OAuth con tu suscripción a ChatGPT utiliza tu plan mensual fijo. La API tiene una estructura de costes independiente de las suscripciones a ChatGPT; pagas por cada 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 caduca antes de confirmarlo?

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

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

Sí. Hermes es agnóstico en cuanto a proveedores y admite tanto backends locales como modelos GPT en la nube. Hermes Agent es agnóstico respecto al proveedor; Nous Portal es una de las rutas compatibles, y también se admiten OpenRouter, Ollama, proveedores directos, GitHub Copilot, Hugging Face y endpoints compatibles con OpenAI. Usa hermes config set model <model-name> para cambiar en cualquier momento.

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

Si ya pagas ChatGPT Plus o Pro, usarlo dentro de un agente de terminal como Hermes desbloquea un valor que de otro modo estás dejando pasar. El proceso son cuatro pasos: instalar Hermes, ejecutar el comando de autenticación, confirmar en tu navegador y elegir tu modelo GPT. La recompensa es no tener que gestionar claves API, no llevarse sorpresas de facturación por token y no necesitar hardware local potente. La única contrapartida real es que una suscripción de pago es imprescindible para este flujo de trabajo. A partir de ahí, experimenta cambiando de modelo: usa uno más ligero para tareas rápidas y el modelo insignia para las tareas pesadas.

Un último consejo práctico sobre la factura en sí. Tus suscripciones de IA se renuevan en USD, y la mayoría de las tarjetas añaden discretamente un 2-3% en cada cargo en el extranjero. Con Bleap pagas al tipo de cambio real con un 0% de comisiones de cambio de divisa, y en Claude, ChatGPT y Gemini recibes un cashback fijo del 20% en USDC en cada renovación, sin ninguna cuota mensual de tarjeta. Es una Mastercard autocustodiada que puedes usar en cualquier sitio donde se acepte Mastercard, así que el dinero que ahorras con tu configuración llega aún más lejos.