Claude Code y Home Assistant: controla tu domótica con IA

PCHardwarePro » Tutoriales » Claude Code y Home Assistant: controla tu domótica con IA

La domótica ha pasado de ser un puñado de aplicaciones y reglas rígidas a algo mucho más vivo. Home Assistant se ha convertido en el centro de operaciones de miles de hogares, pero su famoso YAML sigue siendo un muro para mucha gente. La llegada de Claude Code y del protocolo MCP ha cambiado las reglas: ahora puedes pedirle a una IA que entienda tu instalación, genere automatizaciones y hasta revise tus dashboards sin que tú tengas que pelearte con la sintaxis.

En este artículo vamos a desmenuzar cómo se integra Claude con Home Assistant de principio a fin: el add-on Claude Code Terminal Pro, la conexión mediante HA-MCP, las auditorías automáticas, el control por voz con LLMs, la seguridad con visión artificial y un montón de experiencias reales. La idea es que salgas con una visión completa, tanto si eres un manitas curioso como si te dedicas al desarrollo y quieres exprimir tu instalación.

Home Assistant, Claude Code y el cambio de paradigma

Home Assistant nació en 2013 de la mano de Paulus Schoutsen y hoy es mantenido por Nabu Casa. Es la plataforma de domótica open source más grande del mundo, con más de 2.800 integraciones para Zigbee, Z-Wave, Wi-Fi, Bluetooth o Matter. Funciona en Raspberry Pi, Intel NUC o servidores dedicados, y en marzo de 2026 superaba el millón de instalaciones activas, con una comunidad de más de 80.000 miembros en su foro. Su modelo se basa en integraciones gráficas o archivos YAML, y en automatizaciones que combinan disparadores, condiciones y acciones. La instalación media suele tener entre 5 y 8 add-ons activos, según los datos de analítica de la propia plataforma.

El mercado de la casa inteligente no para de crecer. Statista calcula que en 2028 alcanzará los 231.600 millones de dólares, con un crecimiento anual del 10,67%. Sin embargo, una encuesta de la comunidad de febrero de 2026 reveló que el 62% de los usuarios considera que la curva de aprendizaje de YAML es la principal barrera para crear automatizaciones avanzadas. Ahí es donde entra la IA generativa: McKinsey ya señalaba en febrero de 2026 que el 72% de las empresas usan IA en al menos una función de negocio, y esa misma ola está llegando al hogar.

Claude Code es la herramienta de línea de comandos de Anthropic, lanzada oficialmente el 24 de febrero de 2025. No es un chatbot al uso: es un agente autónomo que puede leer y escribir archivos, ejecutar comandos del sistema, navegar por una base de código y generar configuraciones. Según Anthropic, más de 500.000 desarrolladores lo utilizaban en marzo de 2026. Dentro de Home Assistant, puede leer tu configuration.yaml, modificar automations.yaml, ejecutar la CLI de HA y consultar el estado de tus dispositivos en tiempo real.

El protocolo MCP (Model Context Protocol) fue presentado por Anthropic el 25 de noviembre de 2024. Es un estándar abierto que conecta modelos de lenguaje con herramientas y fuentes de datos externas. En el contexto de Home Assistant, permite que Claude acceda de forma estructurada a sensores, historiales y servicios. Además, el Supervisor API de HA permite controlar el sistema operativo, add-ons, copias de seguridad y configuración; Claude Code accede a él mediante el token SUPERVISOR_TOKEN que se inyecta automáticamente en el contenedor del add-on.

Claude Code Terminal Pro: el add-on que lo pone todo patas arriba

Claude Code Terminal Pro es un add-on de Home Assistant que integra la CLI de Claude Code directamente en tu servidor domótico. Proporciona una terminal web accesible desde el panel lateral donde puedes hablar con Claude Code para gestionar toda tu casa inteligente. Es gratuito, open source y tiene licencia MIT. El repositorio es github.com/ESJavadex/claude-code-ha, con más de 24 estrellas, 93 commits y versión 2.0.10 lanzada el 23 de febrero de 2026.

¿Qué puedes hacer con él? Controlar luces, sensores, cámaras y cualquier dispositivo escribiendo en lenguaje natural, como «enciende la luz del salón al 50%». También puedes crear automatizaciones YAML complejas sin saber programar, porque Claude las genera por ti. El add-on tiene acceso completo a la API de Home Assistant, puede leer entidades, ejecutar servicios y modificar tu configuración en tiempo real. Además, incluye análisis de imágenes, entrada por voz, gestión de paquetes persistentes y soporte multi-arquitectura.

Por dentro, el add-on ejecuta un contenedor Docker dentro de Home Assistant OS. El contenedor tiene hassio_role: manager, lo que le da acceso total al Supervisor. Tus credenciales, paquetes y configuración sobreviven a reinicios y actualizaciones porque se guardan en /data. La primera instalación tarda entre 2 y 5 minutos porque descarga una imagen Docker de unos 200 MB, dependiendo de tu arquitectura. También incorpora un entorno Python aislado para evitar conflictos entre librerías.

Los requisitos no son muy exigentes. Necesitas Home Assistant OS y al menos 256 MB de RAM libre, además de espacio en disco y conexión a los dominios claude.ai, ghcr.io y api.anthropic.com. Es compatible con Raspberry Pi 3B+ (armv7), Raspberry Pi 4 y 5 (aarch64), Intel NUC y servidores con amd64. Desde la versión 2.0.10, los procesadores sin AVX usan automáticamente un fallback de instalación vía npm.

Instalación paso a paso

El proceso es sencillo. Primero, añade el repositorio de add-ons desde Ajustes > Complementos > Tienda de complementos, pulsa el menú de tres puntos, selecciona Repositorios y pega la URL del proyecto. Luego busca «Claude Terminal Pro» en la tienda, instálalo y espera a que termine la descarga.

1. Configura las opciones: deja auto_launch_claude en true para que Claude arranque directamente; si necesitas depurar, ponlo en false para ver el menú de sesiones.
2. Inicia el add-on: la primera vez ejecuta un health check (RAM, disco, DNS, red), configura el entorno persistente en /data, instala herramientas como ttyd, jq y curl, despliega el menú de sesiones y arranca el servicio web.
3. Autentícate con Anthropic: abre la interfaz web, verás un enlace de autenticación OAuth. Abre el enlace, accede con tu cuenta y autoriza el acceso. Las credenciales se guardan en /data/.config/claude/ y persisten entre reinicios.
4. Verifica que funciona: escribe algo simple, como «lista mis entidades», y Claude usará el comando ha y la API del Supervisor para responderte con el número exacto de entidades, dominios y dispositivos.

Ojo, porque antes de la versión 1.2.0 las credenciales se guardaban en /config, que es efímero, y había que reautenticarse tras cada reinicio. Actualiza a 2.0.10 o posterior para evitar ese dolor de cabeza. Si aún tienes problemas, usa la opción 5 del menú de sesiones (Authentication Helper).

Tu primera automatización y comandos prácticos

Imagina que tienes un sensor de movimiento Zigbee en el pasillo y una bombilla inteligente. Quieres que la luz se encienda al detectar movimiento, pero solo de noche. Le dices a Claude: «Crea una automatización para que la luz del pasillo se encienda cuando el sensor detecte movimiento, pero solo entre las 22:00 y las 7:00». Claude genera el YAML, te explica cada sección, verifica que los entity_id coincidan con entidades reales y te dice dónde guardarlo, ya sea en automations.yaml o mediante la UI de HA.

Aquí tienes un montón de ejemplos reales que puedes copiar y pegar en la terminal. En iluminación: «enciende la luz del salón al 50%», «apaga todas las luces de la planta baja», «cambia el color de la tira LED a azul», «sube la intensidad del dormitorio al 80%». En sensores y clima: «dime la temperatura del salón», «pon el termostato a 22 grados», «baja la persiana del estudio», «consulta la humedad del baño». En cámaras y seguridad: «lista mis cámaras», «muestra la cámara de la entrada en la tele», «crea una automatización para que si se detecta movimiento en el jardín me llegue una foto al móvil», «activa el modo vigilancia». En automatizaciones avanzadas: «cuando la lavadora termine, avísame», «si no hay nadie en casa y se abre la puerta, enciende las luces y envía una notificación», «cada mañana a las 7 enciende la cafetera», «cuando baje el sol, cierra las persianas del salón».

Claude no solo genera el código: también puede ejecutar los servicios directamente. Por ejemplo, si le dices «enciende la luz del salón al 50%», ejecutará ha service call light.turn_on con los argumentos entity_id=light.salon y brightness_pct=50. Eso sí, revisa siempre el YAML antes de aplicarlo y pide explicaciones si algo no te cuadra.

Análisis de imágenes, voz y paquetes persistentes

Una de las funciones más potentes es el análisis de imágenes. Puedes pegar capturas de errores, dashboards o dispositivos para que Claude las interprete. Hay tres métodos: pegar desde el portapapeles con Ctrl+V (la imagen se sube a /data/images/ y se copia la ruta), arrastrar y soltar sobre la terminal web, o usar un monitor de portapapeles en macOS que sube automáticamente cualquier imagen nueva cada 500 ms. Los formatos soportados son JPEG, PNG, GIF, WebP y SVG, con un máximo de 10 MB por imagen.

Los casos de uso son muy variados: analizar una captura de un error en los logs y pedirle que te diga qué falla; enseñarle un screenshot de tu dashboard y solicitar mejoras de UX; o mandarle la foto de un dispositivo para preguntar si es compatible con HA. Esto ahorra muchísimo tiempo a la hora de depurar.

La entrada por voz usa la Web Speech API del navegador, sin servicios externos. Pulsas Espacio para grabar, dictas algo como «enciende las luces del jardín y pon el termostato a 22 grados», pulsas Enter y Claude ejecuta los comandos. Según Juniper Research, en 2027 habrá 8.400 millones de dispositivos con asistente de voz, más que la población mundial. Esta función te permite sumarte a esa tendencia sin hardware adicional.

Los contenedores Docker de HA son efímeros: cualquier paquete instalado con apk add desaparece al reiniciar. Claude Code Terminal Pro resuelve esto con persist-install. Los paquetes se guardan en /data/packages/ y se restauran automáticamente en cada inicio. También puedes configurar paquetes auto-instalables desde la UI del add-on. Claude está entrenado para usar siempre persist-install en lugar de apk add o pip install gracias a un skill integrado llamado persistent-package-manager. Si le dices «instala git», usará el método persistente.

Costes, ROI y comparativa con otras opciones

El add-on es 100% gratuito y open source. Lo único que pagas es la suscripción a Claude de Anthropic: 20 dólares al mes en el plan Pro o 100 dólares al mes en Max. Para domótica doméstica, el plan Pro es más que suficiente. Si dedicas 2 horas al mes a configurar automatizaciones manualmente y tu hora vale 30 euros, Claude te ahorra 1,5 horas al mes (una reducción del 75%). Eso son 45 euros de ahorro en tiempo por 20 euros de coste, un ROI de 2,25x desde el primer mes.

Además, un estudio de Parks Associates indica que el hogar inteligente medio con automatizaciones activas ahorra entre 80 y 200 euros al año en energía gracias a la gestión automatizada de calefacción, iluminación y electrodomésticos. Con Claude Code generando automatizaciones que de otra forma no crearías, el ahorro real puede ser aún mayor. Un usuario comentaba que configuró 15 automatizaciones en una tarde que le habrían llevado un fin de semana entero escribiendo YAML a mano. El ROI no es solo económico, es de calidad de vida.

Frente a alternativas como Alexa, Google Home o Siri, Claude Code rompe la barrera de los comandos predefinidos. Strategy Analytics señala que el 63% de los hogares inteligentes en Europa usan asistentes de voz como punto de entrada principal, pero están limitados a comandos cerrados y no pueden generar configuraciones nuevas. Claude entiende contexto, genera código y se adapta a tu instalación concreta.

HA-MCP: conexión directa, auditoría y control conversacional

El servidor HA-MCP permite a Claude y a otros agentes de IA controlar Home Assistant usando lenguaje natural. La configuración tarda unos 10 minutos y funciona con una cuenta gratuita de Claude, sin necesidad de suscripción de pago. Hay instaladores de un solo comando para Mac y Windows que te configuran con un servidor de demostración de Home Assistant. El proyecto está en github.com/homeassistant-ai/ha-mcp.

Con HA-MCP puedes pedir cosas como «crea una automatización que encienda la luz del porche al atardecer», «la automatización del sensor de movimiento no funciona, depúrala», «haz que mi rutina matutina también encienda la cafetera» o «crea un script que configure el modo cine: atenúa las luces, cierra las persianas y enciende la TV». Es una capa ligera que traduce intenciones a acciones reales.

Integración mediante HACS

Para montarlo necesitas acceso remoto a Home Assistant (Nabu Casa o tu propio acceso externo) y HACS instalado. Antes de tocar nada, haz una copia de seguridad completa desde Configuración > Sistema > Copia de seguridad > Realizar copia de seguridad ahora. Luego, en HACS, abre los tres puntos, selecciona Custom Repositories, añade la URL https://github.com/homeassistant-ai/ha-mcp-integration y elige Integration como tipo. Descarga HA-MCP Custom Component, reinicia Home Assistant y añade la integración desde Configuración > Dispositivos y Servicios > Agregar Integración > MCP.

Te dará dos opciones: permisos estándar (recomendado) o más privilegios. Elige la recomendada y, opcionalmente, asigna un área. Después, entra en la integración MCP, pulsa el icono de configuración y copia la primera ruta. Si contiene una IP local (192.168.x.x), reemplázala manualmente por tu dominio o URL de acceso externo. De lo contrario, Claude no podrá conectarse.

En Claude AI, ve a tu nombre de usuario > Configuración > Conectores > Agregar > Agregar conector personalizado. Ponle un nombre, como «Home Assistant», pega la URL del servidor MCP remoto y pulsa Agregar. Luego pulsa Conectar y verás una ventana con los permisos disponibles. Por defecto están todos desactivados. Puedes elegir entre herramientas de solo lectura o de escritura y eliminación. Mi recomendación: en producción, personaliza los permisos según lo que necesites y no lo dejes todo en «Permitir siempre».

Home Assistant incluye una capa extra de seguridad: el panel HA-MCP con modo de solo lectura. Si lo activas, Claude podrá listar y consultar información, pero no modificar nada. Después de cambiar el modo, reinicia Home Assistant. Para sincronizar los cambios, en Claude ve a Configuración > Conectores > selecciona el conector > tres puntos > Actualizar lista de herramientas.

Auditoría completa y generación de tareas

Un buen prompt de auditoría sería: «Realiza una auditoría completa de mi instalación de Home Assistant sin efectuar ningún cambio. Revisa entidades no disponibles o abandonadas, dispositivos sin área asignada, nombres duplicados o poco claros, integraciones con errores, reparaciones activas, errores recurrentes en los registros, automatizaciones con ejecuciones fallidas, helpers que no se utilicen, entidades duplicadas y dashboards con tarjetas rotas o referencias a entidades inexistentes. Analiza también las automatizaciones deshabilitadas y clasifícalas en probablemente útiles, requieren revisión o posiblemente abandonadas. Presenta los resultados en problemas importantes, limpieza recomendada, elementos que requieren mi decisión y mejoras opcionales. Para cada hallazgo, explica qué información usaste. No elimines, habilites, deshabilitess, renombres ni modifiques nada sin mi autorización previa». Claude tardará varios minutos y generará un informe detallado.

Luego puedes pedirle que convierta ese informe en un Excel con formato de lista de tareas, donde puedas ir marcando lo que ya está solucionado. Cada vez que le pidas implementar algo, que lo marque como completo en el Excel. Las categorías pueden ser: problemas importantes, limpieza recomendada, requieren decisión, automatizaciones desactivadas y mejoras opcionales. Así llevas un control ordenado de toda la auditoría.

Para implementar correcciones, desactiva el modo de solo lectura en el panel HA-MCP, reinicia Home Assistant, actualiza la lista de herramientas en Claude y pide la acción concreta. Por ejemplo: «Modo lectura desactivado. Elimina directamente la automatización [nombre]». Claude ejecutará la acción y actualizará el Excel marcando la tarea como resuelta, con una nota de lo que hizo. Trabaja primero los problemas más importantes, pide explicaciones antes de autorizar cambios, haz copias de seguridad adicionales y verifica cada cambio.

Solución de problemas y seguridad en HA-MCP

Si Claude no puede conectarse, verifica que la URL sea de acceso externo, no una IP local; confirma que Home Assistant sea accesible desde internet y revisa que el servidor MCP esté activo en el panel HA-MCP. Si los cambios no se reflejan, actualiza la lista de herramientas en Claude, reinicia Home Assistant después de cambiar el modo de lectura y comprueba que los permisos estén bien configurados en ambos lados. Si Claude reporta errores al ejecutar acciones, asegúrate de que el modo de solo lectura esté desactivado, que los permisos de escritura estén habilitados en Claude y que la integración MCP tenga los privilegios necesarios.

En cuanto a seguridad, otorga solo los permisos estrictamente necesarios. Usa el modo de solo lectura para auditorías iniciales. Desactiva permisos de escritura cuando no los necesites. Revisa periódicamente los permisos configurados. Crea copias de seguridad antes de iniciar el proceso y antes de cambios importantes. Verifica que las copias se completen correctamente. Mantén múltiples puntos de restauración. Revisa manualmente los cambios críticos, prueba las automatizaciones modificadas, verifica que los dispositivos sigan funcionando y monitorea los registros después de implementar cambios.

Experiencias reales: de un manitas a un desarrollador full stack

Un usuario no desarrollador, más bien manitas, contaba que no había sentido el «cambio de paradigma» de la IA hasta que probó HA-MCP + Claude Code en su instalación de Home Assistant de más de 5 años. En menos de una semana había hecho tareas laboriosas que antes le llevaban horas. Recomienda hacer copia de seguridad antes de nada y avisa de que a veces Claude sugiere cosas que no son posibles en las tarjetas, probablemente porque no puede verlas, pero en general su instalación nunca ha estado tan limpia y útil.

Un ejemplo: la memoria de escena del salón. Para reemplazar el scene.create de Home Assistant (que guarda color y brillo junto con el estado de encendido/apagado, causando conflictos con Adaptive Lighting) construyó un sistema basado en booleanos. Once input_boolean helpers, uno por luz, actúan como registro persistente de qué luces están encendidas. Dos scripts reemplazan el antiguo par Pausa/Reproducir: Pausa lee el estado actual de cada luz en su booleano y apaga todo; Reproducir lee esos booleanos y enciende solo las luces que estaban encendidas, sin datos de color o brillo, dejando a Adaptive Lighting libertad para manejarlos. La misma lógica se aplicó a la automatización del sensor de presencia, que antes usaba scene.create para tomar una instantánea de la habitación cuando se vaciaba y restaurarla al regresar. Poder escribir en lenguaje normal, o incluso usar voz a texto, y pedirle que cree once booleanos y los etiquete y categorice correctamente convirtió una tarea de una hora en una de 10 minutos.

Otro proyecto impresionante: hacer más inteligente un robot Eufy E28. Quería gestionar todas las configuraciones de la aspiradora directamente en Home Assistant en lugar de la app de Eufy, lo que habría llevado horas. Para cada una de las 7 habitaciones, Claude creó automáticamente un conjunto completo de helpers que cubren modo de limpieza, nivel de succión, intensidad de limpieza y nivel de agua. Cada habitación funciona con su propia configuración. Además, creó input_number helpers por habitación para establecer los días máximos permitidos entre limpiezas (por ejemplo, pasillo = 1 día, salón = 7 días), input_datetime helpers para rastrear cuándo se limpió cada habitación por última vez, y sensores de plantilla que muestran estados legibles: «Recientemente limpiado», «Limpiar pronto», «Vencido». Un sensor de resumen agrupa todos los estados en una sola línea, como «2 habitaciones vencidas, 1 vence pronto». Las automatizaciones basadas en presencia activan la escena de limpieza correcta con la configuración adecuada según quién esté en casa y lo lejos que estén. Una automatización de sellado registra la marca de tiempo exacta cada vez que se limpia una habitación, manteniendo los helpers de «última limpieza» precisos. Todo se muestra en una tarjeta del panel para que la configuración y el estado sean visibles y ajustables de un vistazo, sin YAML. En total, 67 helpers, con nombres correctos en automatizaciones y panel.

También hizo sesiones de feedback: le pidió a Claude que revisara cada automatización y script en busca de errores o sugerencias de mejora, que verificara automatizaciones no utilizadas y nombres de entidades incorrectos en las tarjetas, que reestructurara paneles y que categorizara automatizaciones, scripts, escenas y helpers. Además, revisó los ID de las entidades y renombró cosas sin romperlas, y pudo tener una visión general de qué dispositivos podrían estar en áreas incorrectas o con nombres antiguos que necesitaban actualizarse.

Un desarrollador full stack contaba que su puesto actual apenas le deja usar esa parte de su cerebro. Hace un año alguien le enseñó Home Assistant durante una visita, y después de actualizar su GPU le sobró una RTX 3090, así que montó una caja con LLM local. Eso se convirtió en una obsesión por Home Assistant. Últimamente usa Claude Code para crear dashboards, y al principio sentía que se volvía un poco loco: Claude no entiende bien los layouts normales de Lovelace/dashboard. Técnicamente todo funciona, pero el espaciado se vuelve raro, los layouts se desvían, la responsividad se vuelve torpe y las cosas acaban en sitios sin sentido visual.

Pero en el momento en que dejó de tratarlo como «hazme un dashboard de Home Assistant» y lo trató como un ingeniero frontend que puede usar Playwright, JS/CSS personalizado, animaciones y herramientas frontend de verdad, todo cambió. Ahora está creando cosas genuinamente salvajes: un dashboard de música que une Music Assistant, SyncLyrics, eliminación de vocales con IA para su biblioteca local, interfaz de vinilo animada, layouts responsivos para teléfono/escritorio/TV, y música local + streaming. Básicamente, intentando convertir Home Assistant en un centro multimedia completo en lugar de solo un lugar para controlar luces e interruptores. El gif que adjuntó muestra a Claude usando Playwright para hacer clic en los dashboards que creó, inspeccionar layouts y componentes, notar problemas e iterar en la propia interfaz. Una cosa que le encanta es que la habilidad de frontend y Playwright juntas le dan maquetas para elegir antes de la implementación.

Otro caso: Alexa falla mucho en casa. Comandos en hindi, retransmisión de CCTV, controlar dispositivos no inteligentes… todo «lo siento, no sé eso». Así que construyó una capa ligera donde Claude recoge cada comando fallido de Alexa y realmente lo hace. Alexa sigue siendo el micrófono y el altavoz. Claude es el cerebro. Lee la documentación de los dispositivos, averigua la intención y ejecuta el script correcto: WebSocket para la tele, DLNA para el descodificador, RTSP→HLS para CCTV. Añadir un nuevo dispositivo es solo un archivo markdown y un script de shell. «Muestra CCTV en la tele de papá» funciona. «TV band karo» (hindi) funciona.

Integrar LLMs y seguridad local: el ecosistema completo

Hay tres formas principales de integrar IA en Home Assistant: Claude Code Terminal Pro para automatización asistida por IA, LLM HomeAssistant para control por lenguaje natural con GPT-4 y Security HA Addon para detección de movimiento con visión artificial. Las tres son open source y gratuitas (aunque LLM HomeAssistant requiere una API de OpenAI o compatible).

LLM HomeAssistant es un componente personalizado que extiende la funcionalidad del asistente de voz de Home Assistant. Donde la integración oficial de OpenAI se limita a conversaciones básicas, LLM HomeAssistant permite ejecutar servicios, crear automatizaciones y consultar APIs externas usando lenguaje natural. La clave es el function calling: cuando le dices «enciende las luces del salón», el LLM no responde con texto, ejecuta la acción directamente en Home Assistant.

Con LLM HomeAssistant puedes hacer cosas como: «Pon Netflix en la tele del salón» (llama al servicio correspondiente de tu Smart TV), «Añade leche a la lista de la compra» (integra con shopping_list), «Crea una automatización para que la aspiradora pase todos los martes a las 10» (genera el YAML y lo registra), «¿Qué eventos tengo en el calendario esta semana?» (consulta calendar.get_events). Soporta cualquier modelo compatible con la API de OpenAI: GPT-4, GPT-4o, GPT-3.5 Turbo, Azure OpenAI, LocalAI o LM Studio. Esto significa que puedes usar modelos locales si la privacidad es tu prioridad.

Security HA Addon es un complemento para detección de movimiento y grabación automática desde cámaras con streaming HLS (m3u8). Usa OpenCV con sustracción de fondo MOG2 para detectar movimiento de forma inteligente, filtrando falsos positivos. Funciona 100% en local, sin enviar vídeo a ningún servidor externo. Puedes limitar la detección a una zona específica del frame (ROI) para evitar falsos positivos por timestamps, logos de cámara o cambios de iluminación. Las grabaciones siempre capturan el frame completo; el ROI solo afecta a la detección. Consume solo ~100 MB de RAM y ~5-10% de CPU. No es ideal si necesitas reconocimiento facial (para eso usa Frigate) o si tus cámaras no soportan HLS/RTSP.

Un caso de uso completo: por la mañana, LLM HomeAssistant escucha «Buenos días», enciende luces al 30%, sube persianas, pone la radio y dice la agenda del día. Security HA Addon detecta movimiento en la puerta principal; si no estás en casa, envía una notificación con foto. Claude Code Terminal Pro te ayuda a crear una nueva automatización: «Cuando la lavadora termine (consumo <5W durante 5 min), avísame al móvil». El resultado: 0 líneas de YAML escritas manualmente, alertas de seguridad en menos de 2 segundos desde la detección y control por voz completo sin depender de Alexa ni Google.

Los conceptos clave: Claude Code CLI es la interfaz de línea de comandos de Anthropic que permite interactuar con modelos Claude para tareas de desarrollo; en Home Assistant funciona como un terminal inteligente que entiende tu configuración y puede modificarla. Function calling es una técnica de los LLMs que les permite ejecutar acciones reales en lugar de solo generar texto. MOG2 es un algoritmo de sustracción de fondo usado en visión artificial: crea un modelo estadístico del fondo y detecta cambios significativos, ideal para detectar personas o vehículos.

Errores comunes, buenas prácticas y seguridad

Error 1: autenticación que se pierde tras reiniciar. Ocurría en versiones anteriores a la 1.2.0 porque las credenciales se guardaban en /config, que es efímero. Solución: actualiza a 2.0.10 o posterior; ahora se guardan en /data/.config/claude/. Si aún falla, usa la opción 5 del menú de sesiones (Authentication Helper).

Error 2: Claude no puede acceder a las entidades. Verifica que el add-on tiene hassio_api: true y homeassistant_api: true. El token SUPERVISOR_TOKEN se inyecta automáticamente; si no funciona, reinicia el add-on.

Error 3: instalación falla en Raspberry Pi 3 o hardware antiguo. El instalador nativo de Claude Code requiere soporte AVX, que no tienen los procesadores ARM antiguos ni los Intel Atom/Celeron. Desde la versión 2.0.10, el add-on detecta esto automáticamente y usa el fallback de npm (npm install -g @anthropic-ai/claude-code). Asegúrate de tener al menos 256 MB de RAM libre.

Error 4: los paquetes desaparecen al reiniciar. Usa siempre persist-install en lugar de apk add. Los paquetes se guardan en /data/packages/ y se restauran automáticamente. Puedes listar los paquetes configurados con persist-install –list.

Error 5: la terminal web no carga. Verifica que el add-on está iniciado, no solo instalado. Comprueba los logs para ver si el health check falló. Causas comunes: falta de RAM (<256 MB libre), disco lleno (<100 MB libre) o problemas de DNS (el add-on necesita resolver claude.ai, ghcr.io y api.anthropic.com).

Otras incidencias: si el health check muestra advertencias de red, añade los dominios a la lista blanca de tu firewall o Pi-hole. Si Claude genera entity_id que no existen, pídele que primero liste tus entidades reales con ha state list antes de crear automatizaciones. Si el add-on consume demasiada RAM, ten en cuenta que el servidor de imágenes consume ~10-15 MB y el total ronda los 100-150 MB con Claude activo; si tu Raspberry Pi tiene poca memoria, desactiva auto_launch_claude y usa la opción 7 (Bash) cuando no necesites IA. Si aparece «command not found» para herramientas instaladas, usa /install o cierra y reabre la sesión de Claude para que cargue las nuevas rutas del PATH.

Buenas prácticas: usa siempre persist-install para cualquier paquete; revisa el YAML antes de aplicarlo y pide a Claude que te explique cada sección; haz backups antes de cambios grandes, porque Claude tiene acceso de escritura a /config y un error podría romper tu configuración; usa sesiones continuas (claude -c) cuando estés trabajando en algo complejo para que Claude recuerde el contexto; aprovecha el análisis de imágenes para depurar en lugar de copiar logs a mano.

El add-on NO tiene la opción dangerously_skip_permissions activada por defecto, lo que añade una capa de seguridad. Aun así, Claude puede romper Home Assistant, aunque es poco probable. Antes de aplicar cambios grandes, haz un backup desde Ajustes > Sistema > Copias de seguridad. El menú de sesiones tiene 8 opciones cuando auto_launch_claude está en false; entre ellas, arrancar Claude, abrir Bash, el asistente de autenticación, la gestión de paquetes y otras utilidades. El health check revisa RAM, disco, DNS y red, y da orientación específica para VirtualBox o Proxmox.

Preguntas frecuentes

¿Cómo controlo las luces de mi casa con Claude Code? Abre la terminal de Claude Terminal Pro y escribe en lenguaje natural lo que quieres. Por ejemplo: «Enciende la luz del salón al 50%». Claude ejecutará ha service call light.turn_on con los argumentos entity_id=light.salon y brightness_pct=50. También puedes crear automatizaciones permanentes pidiéndole que genere el YAML.

¿Claude Code Terminal Pro es gratis? Sí, el add-on es 100% gratuito y open source (licencia MIT). Lo único que pagas es la suscripción a Claude de Anthropic: 20 dólares/mes en el plan Pro o 100 dólares/mes en Max. Para domótica doméstica, el plan Pro es suficiente.

¿Funciona en Raspberry Pi? Sí, soporta Raspberry Pi 3B+ (armv7), Raspberry Pi 4 (aarch64) y Raspberry Pi 5 (aarch64). Desde la versión 2.0.10, los procesadores sin AVX usan automáticamente la instalación vía npm como fallback. Se recomiendan al menos 256 MB de RAM libres.

¿Puedo usar Claude Code sin saber programar? Sí, ese es precisamente el objetivo del add-on. Le dices a Claude en español (o cualquier idioma) lo que quieres y él genera el código YAML, ejecuta los comandos y configura las automatizaciones por ti. No necesitas saber YAML, Python ni ningún lenguaje de programación.

¿Claude Code puede romper mi Home Assistant? Es poco probable, pero posible. Claude tiene acceso de escritura a /config, lo que incluye configuration.yaml y automations.yaml. Antes de aplicar cambios grandes, haz un backup desde Ajustes > Sistema > Copias de seguridad. El add-on NO tiene la opción dangerously_skip_permissions activada por defecto, lo que añade una capa de seguridad.

¿Qué diferencia hay entre Claude Code Terminal Pro y el add-on original? Claude Code Terminal Pro es un fork mejorado del add-on original de Tom Cassady (heytcass). Las mejoras principales incluyen: sistema de paquetes persistentes (persist-install), subida de imágenes para análisis visual, entrada por voz, health check completo, fallback de instalación para CPUs sin AVX y 93 commits de desarrollo activo. El add-on original se mantiene como base, pero el fork Pro añade funcionalidad significativa.

¿Puedo usar Claude Code para gestionar mis cámaras de seguridad? Sí. Claude puede listar tus cámaras, crear automatizaciones de detección de movimiento con envío de fotos al móvil, configurar grabación programada y analizar capturas de las cámaras. Si usas integraciones como EZVIZ o Frigate, Claude puede ayudarte a configurarlas.

¿Merece la pena pagar 20 dólares/mes por Claude Pro solo para domótica? Si ganas 30 euros/hora y Claude te ahorra 1,5 horas al mes en configuración de HA, el retorno es de 45 euros por 20 euros de inversión. ROI de 2,25x. Y eso sin contar que Claude Pro también te sirve para programar, escribir, analizar datos y cualquier otra tarea fuera de la domótica.

¿Cómo integrar inteligencia artificial en Home Assistant en 2026? Hay tres formas principales: Claude Code Terminal Pro para automatización asistida por IA, LLM HomeAssistant para control por lenguaje natural con GPT-4, y Security HA Addon para detección de movimiento con visión artificial. Las tres son open source y gratuitas.

¿Se puede usar Claude Code en Home Assistant? Sí, con el add-on Claude Code Terminal Pro puedes instalar la CLI de Claude Code directamente en Home Assistant. Funciona como un terminal web integrado en tu dashboard desde el que puedes crear automatizaciones, depurar configuraciones y analizar logs usando lenguaje natural. Requisito: API key de Anthropic o suscripción.

¿Qué LLM puedo usar para controlar Home Assistant? LLM HomeAssistant soporta cualquier modelo compatible con la API de OpenAI: GPT-4, GPT-4o, GPT-3.5 Turbo, y también servidores compatibles como Azure OpenAI, LocalAI o LM Studio. Esto significa que puedes usar modelos locales si la privacidad es tu prioridad.

¿Cuánto cuesta poner IA en Home Assistant? El add-on Claude Code Terminal Pro es gratis; solo pagas la suscripción de Claude (20 o 100 dólares/mes). LLM HomeAssistant es gratis, pero la API de OpenAI se paga por uso. Security HA Addon es gratis. Si usas modelos locales, el coste es el hardware.

¿La IA en Home Assistant necesita internet? Depende de la herramienta. Security HA Addon funciona 100% en local sin internet. Claude Code y LLM HomeAssistant necesitan conexión para acceder a las APIs de Anthropic y OpenAI respectivamente. Si quieres todo local, puedes usar LLM HomeAssistant con LocalAI u Ollama como backend.

¿Qué hardware necesito para IA en Home Assistant? Un Raspberry Pi 4 con 4 GB de RAM es suficiente para las tres herramientas. Security HA Addon consume solo ~100 MB de RAM y ~5-10% de CPU. Claude Code y LLM HomeAssistant delegan el procesamiento a las APIs en la nube, así que el hardware local apenas importa.

¿Es seguro dar acceso de IA a Home Assistant? Las tres herramientas están diseñadas con seguridad en mente. LLM HomeAssistant solo puede acceder a entidades que tú expongas manualmente. Claude Code Terminal Pro tiene un modo de permisos restringidos por defecto. Security HA Addon no tiene acceso a internet ni a tu red local más allá de la cámara configurada.

Merece la pena probarlo. Si ya tienes Home Assistant y una suscripción a Claude, instalar Claude Code Terminal Pro te llevará unos 5 minutos y el impacto será inmediato. Si tienes HA pero no Claude, el plan Pro de 20 dólares/mes se paga solo con el tiempo que ahorras. Si no tienes HA, una Raspberry Pi 5 con HA OS y este add-on es una combinación potentísima para 2026. Y si además te animas con HA-MCP, LLM HomeAssistant o Security HA Addon, tendrás un ecosistema completo: control conversacional, auditorías automáticas, visión artificial local y dashboards que parecen de otro nivel. Eso sí, no te olvides de las copias de seguridad, del modo de solo lectura y de revisar cada cambio antes de aplicarlo. La IA es una herramienta fantástica, pero el control final sigue siendo tuyo.