Integración domótica Claude AI, gratuita y de código abierto
Haga funcionar el asistente de Gladys con Claude, la IA de Anthropic, y su clave de API.
Publicado por prohand
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.3.0
- ★ 0
Esta integración convierte a Claude, la IA de Anthropic, en el cerebro del asistente de Gladys. Una vez elegida, responde a todas las peticiones de IA de su Gladys: el chat (y los dispositivos que controla por usted), la clasificación de sus mensajes, la acción de escena Preguntar a la IA y el resumen semanal.
Es una integración de la comunidad: no la hace ni la mantiene Anthropic.
Antes de empezar
- Gladys 5.3 o posterior.
- Una clave de API de Anthropic. Cree una cuenta en
console.anthropic.com, añada crédito o un
medio de pago y luego cree una clave en Settings → API keys. Empieza por
sk-ant-. - El uso lo factura Anthropic, por token, al precio del modelo elegido. No hace falta Gladys Plus.
Claude funciona en la nube (api.anthropic.com): Gladys necesita acceso a
Internet.
Configuración
- Instale la integración desde el catálogo y abra su pestaña Configuración.
- Pegue su clave de API de Anthropic y guarde.
- Haga clic en Probar la conexión: cada modelo responde a una pregunta de una palabra y el tiempo empleado se muestra bajo el botón.
- Vaya a Ajustes → Inteligencia artificial y elija Claude AI como proveedor de IA.
El estado en la parte superior de la pantalla de configuración se pone en verde cuando la clave es aceptada y los modelos elegidos están abiertos para ella. En rojo, indica el motivo.
Los ajustes
| Ajuste | Qué hace |
|---|---|
| Clave de API de Anthropic | Su clave. Se queda en Gladys, nunca se vuelve a mostrar ni se escribe en los registros. |
| Modelo del chat | Responde al chat, crea las escenas, redacta el resumen semanal. Claude Opus 5.5 por defecto. Sonnet 5.5 es más rápido y barato, Fable 5.1 el más potente y el más caro. |
| Modelo del enrutador | Clasifica cada mensaje antes de la respuesta. Gladys lo espera 20 segundos como máximo: mantenga un modelo rápido, Claude Haiku 5.5 por defecto. |
| Esfuerzo de razonamiento | Cuánto piensa el modelo del chat antes de responder: bajo, medio (por defecto), alto, muy alto. Más esfuerzo ayuda en las peticiones difíciles (crear una escena), pero responde más despacio y cuesta más. |
| Longitud máxima de una respuesta (tokens) | El presupuesto de salida de una respuesta, razonamiento incluido. 16 000 por defecto. Auméntelo si los registros indican que una respuesta ha alcanzado max_tokens. |
Lo que ve Claude
Elegir un proveedor de IA es una decisión de privacidad. El proveedor recibe:
- cada mensaje del chat y el historial de la conversación;
- la descripción de las herramientas que Gladys le ofrece, y sus resultados — el estado de los dispositivos que consulta;
- las imágenes que envía en el chat.
Sus respuestas controlan sus dispositivos y crean sus escenas. Lea la política de privacidad de Anthropic antes de elegirlo.
Costes y velocidad
- El prompt del sistema y la lista de herramientas se repiten en cada mensaje: la integración pide a Anthropic que los guarde en caché, lo que los factura a una fracción del precio después del primer mensaje.
- El enrutador siempre funciona con esfuerzo bajo en el modelo del enrutador: es la petición que se envía con más frecuencia.
- Para gastar menos, elija Claude Sonnet 5.5 para el chat o baje el esfuerzo.
- Cuando Claude rechaza una petición por motivos de seguridad, Anthropic la repite con su modelo de respaldo por defecto en la misma llamada; si todos los modelos la rechazan, el asistente responde que no puede ayudar.
Solución de problemas
- «Anthropic ha rechazado la clave de API» — la clave es incorrecta, está revocada o pertenece a una organización sin crédito. Cree una nueva y péguela de nuevo.
- «… no está disponible para esta clave de API» — su organización de Anthropic no tiene acceso a ese modelo: elija otro.
- «Se ha alcanzado el límite de solicitudes» — demasiadas peticiones para su nivel de uso de Anthropic: espere un momento o suba de nivel en la consola de Anthropic.
- «No se puede acceder a api.anthropic.com» — Gladys no tiene acceso a Internet, o un cortafuegos bloquea esa dirección.
- El asistente dice que el proveedor de IA no está disponible — abra la pestaña Registros de la integración: cada petición escribe allí una línea (modelo, tiempo, tokens) y cada fallo su motivo.
Parámetros de configuración
Estos son los parámetros que Claude AI te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Claude responde a través de la API de Anthropic, en la nube: cree una clave de API en console.anthropic.com (Anthropic factura el uso), péguela abajo y luego elija esta integración en Ajustes, Inteligencia artificial. Claude ve entonces cada mensaje del chat, el historial, el estado de los dispositivos que consulta y las imágenes del chat. |
| Clave de API de Anthropic | secret | Sí | Creada en console.anthropic.com, empieza por sk-ant-. Se queda en Gladys y nunca se vuelve a mostrar ni se registra. |
| Modelo del chat | select | Sí | Responde al chat, crea las escenas y redacta el resumen semanal. Opus es el más capaz por su precio, Sonnet más rápido y barato, Fable el más potente y el más caro. |
| Modelo del enrutador | select | Sí | Clasifica cada mensaje del chat antes de la respuesta y debe contestar en menos de 20 segundos: lo mejor es un modelo rápido. |
| Esfuerzo de razonamiento | select | No | Cuánto piensa el modelo del chat antes de responder. Más esfuerzo: mejores respuestas a las peticiones difíciles, pero más lentas y con más tokens facturados. |
| Longitud máxima de una respuesta (tokens) | number | No | El razonamiento también cuenta. Auméntela si los registros indican que una respuesta ha alcanzado max_tokens. |
Cómo instalar Claude AI en Gladys
- En Gladys, abre Integraciones: Claude AI aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-ai-claude:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-ai-claude.
Claude AI requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Claude AI es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación