Hermes Agent: conexión a la API de Claude

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.

Usa la función de proveedor personalizado de Hermes Agent para conectarte a 1折AI. Primero crea una clave API y confirma los modelos disponibles actualmente; los ID de modelo que aparecen a continuación son ejemplos, ajústalos según los permisos de tu clave.

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 para la lista de modelos y precios.

Según Providers oficial: 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:

1
providers:
2
  onezhe:
3
    api: https://1zheai.com/v1
4
    key_env: ONEZHE_API_KEY
5
    transport: chat_completions
6
    default_model: claude-sonnet-4-6
7
model:
8
  provider: custom:onezhe
9
  default: claude-sonnet-4-6

Proporcionado localmente en ~/.hermes/.env:

1
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

Guarda y recarga la configuración, confirma que el proveedor seleccionado actualmente es onezhe o el modelo personalizado que añadiste.
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.
Abre el registro de llamadas 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.
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.

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 y las reglas de facturación. Si necesitas otros clientes, vuelve al directorio de integración de herramientas; si escribes tu propio programa, puedes usar la guía de SDK y desarrollo.