---
title: "Hermes Agent: conexión a la API de Claude"
description: "Tutorial de configuración de Hermes Agent para conectar con la API de retransmisión de 1折AI Claude, incluyendo dirección, clave y modelo, con selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Verificación de la conexión y solución de problemas":"section-1","Costes y otras formas de conexión":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Usa la función de proveedor personalizado de Hermes Agent para conectarte a 1折AI. Primero [crea una clave API](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente](/es/docs/models/); los ID de modelo que aparecen a continuación son ejemplos, ajústalos según los permisos de tu clave.

<Note>
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; realiza primero una breve verificación de preguntas y respuestas y de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos](/es/docs/models/) para la lista de modelos y precios.
</Note>

Según [Providers oficial](https://hermes-agent.nousresearch.com/docs/integrations/providers): ejecuta en la terminal `hermes model` → Custom endpoint, selecciona explícitamente el modo de API `chat_completions`, introduce en Base URL `https://1zheai.com/v1`, e introduce la clave y el modelo. No selecciones el inicio de sesión de ChatGPT/Codex, es otra forma de conexión.

Configuración de proveedor con nombre reutilizable, fusionar en `~/.hermes/config.yaml`:

```yaml
providers:
  onezhe:
    api: https://1zheai.com/v1
    key_env: ONEZHE_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6
model:
  provider: custom:onezhe
  default: claude-sonnet-4-6
```

Proporcionado localmente en `~/.hermes/.env`:

```dotenv
ONEZHE_API_KEY=sk-替换为本站密钥
```

Una vez configurado, puedes cambiar de [`/model custom:onezhe:claude-sonnet-4-6` en la conversación. `/model` no puede sustituir a la creación de un nuevo proveedor desde la terminal `hermes model`. La transmisión oficial compatible es `anthropic_messages`, pero este tutorial usa Chat Completions para evitar que el protocolo se deduzca automáticamente según la URL. `OPENAI_BASE_URL` no es una configuración universal para todos los proveedores personalizados; debes usar la configuración explícita anterior.

## Verificación de la conexión y solución de problemas

1. Guarda y recarga la configuración, confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve y confirma que se puede obtener una respuesta; después intenta una pequeña tarea reversible y confirma por separado las llamadas a herramientas y la conversación de múltiples turnos.
3. Abre el [registro de llamadas](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades del Agente sean compatibles.
4. Si encuentras un 404, comprueba si la dirección y el protocolo de este artículo son compatibles; si encuentras un 401, comprueba el origen de la clave y si el proceso ha leído las variables de entorno; si encuentras un 429, revisa la información de limitación de tasa antes de reintentar. Para más casos consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).

Las claves solo se guardan en el entorno local o en el almacén de credenciales de la herramienta; no las envíes a repositorios de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno de la terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben comprobarse por separado.

## Costes y otras formas de conexión

Consulta los [precios en tiempo real de la API de Claude](https://1zheai.com/en/pricing/) y las [reglas de facturación](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo](/es/docs/guides/).