Como Controlar tu Casa Inteligente con IA: Claude Code en Home Assistant -- Tutorial Completo
Quieres controlar las luces, camaras y automatizaciones de tu casa con lenguaje natural? Este tutorial te ensena a instalar y configurar Claude Code Terminal Pro en Home Assistant paso a paso.
TL;DR - Resumen Rapido
- Claude Code Terminal Pro es un add-on gratuito que integra la CLI de Anthropic directamente en Home Assistant
- Controla luces, sensores, camaras y cualquier dispositivo escribiendo en lenguaje natural: "enciende la luz del salon"
- Crea automatizaciones YAML complejas sin saber programar -- Claude las genera por ti
- Instalacion en 5 minutos: anadir repositorio + instalar add-on + autenticarse con Anthropic
- Compatible con Raspberry Pi 4/5, Intel NUC y cualquier servidor con Home Assistant OS (amd64, aarch64, armv7)
- Coste: el add-on es gratuito y open source; solo pagas la suscripcion de Claude ($20/mes Pro o $100/mes Max)
- Incluye analisis de imagenes: pega una captura de error o de tu dashboard y Claude lo interpreta
- Codigo abierto: github.com/ESJavadex/claude-code-ha -- MIT License, 24+ estrellas, 93 commits
"La combinacion de IA generativa con domotica es el salto mas grande en usabilidad del hogar inteligente desde que existen los asistentes de voz." -- Javier Santos Criado, consultor de IA en Javadex
Segun un informe de Statista publicado el 15 de enero de 2026, el mercado global de smart home alcanzara los 231.600 millones de dolares en 2028, con un crecimiento anual del 10,67%. Pero la realidad es que la mayoria de usuarios de Home Assistant apenas aprovechan un 20% de su potencial porque crear automatizaciones requiere escribir YAML, un lenguaje de configuracion que intimida a los no programadores.
Claude Code Terminal Pro resuelve exactamente ese problema. En lugar de escribir codigo YAML manualmente, le dices a Claude en espanol lo que quieres y el genera la configuracion por ti. Y no es un chatbot generico: tiene acceso directo a la API de Home Assistant, puede leer tus entidades, ejecutar servicios y modificar tu configuracion en tiempo real.
En este tutorial te explico paso a paso como instalarlo, configurarlo y usarlo para controlar tu casa con inteligencia artificial. Todo basado en mi experiencia personal con el add-on y en el repositorio open source claude-code-ha.
Que es Claude Code Terminal Pro para Home Assistant?
Claude Code Terminal Pro es un add-on de Home Assistant que integra la herramienta de linea de comandos de Anthropic (Claude Code CLI) directamente en tu servidor domotico. Proporciona una terminal web accesible desde el panel lateral de HA donde puedes interactuar con Claude Code para gestionar toda tu casa inteligente.
Como Funciona por Dentro
El add-on ejecuta un contenedor Docker dentro de Home Assistant OS con estos componentes:
| Componente | Tecnologia | Funcion |
|---|---|---|
| Terminal web | ttyd (puerto 7681) | Interfaz de terminal en el navegador |
| Servicio de imagenes | Express.js + Multer (puerto 7680) | Subida de capturas para analisis |
| Claude Code CLI | Anthropic nativo / npm fallback | Motor de IA que procesa tus peticiones |
| HA CLI | Binario oficial Home Assistant | Acceso directo a la API del Supervisor |
| GitHub CLI | gh oficial | Gestion de repositorios y codigo |
Por que usar Claude Code en Home Assistant?
- Control por lenguaje natural: di "enciende la luz del dormitorio al 50%" en vez de escribir YAML
- Acceso completo a la API: el add-on tiene
hassio_role: manager, lo que le da acceso total al Supervisor - Persistencia de datos: tus credenciales, paquetes y configuracion sobreviven a reinicios y actualizaciones
- Analisis de imagenes: pega capturas de errores, dashboards o dispositivos para que Claude los interprete
- Entrada por voz: dicta instrucciones usando el reconocimiento de voz del navegador (Web Speech API)
- Multi-arquitectura: funciona en Raspberry Pi 3 (armv7), Raspberry Pi 4/5 (aarch64) e Intel NUC/servidor (amd64)
Conceptos Basicos
Home Assistant (HA)
Home Assistant es una plataforma de domotica open source que centraliza el control de todos tus dispositivos inteligentes. Soporta mas de 2.800 integraciones (Zigbee, Z-Wave, Wi-Fi, Bluetooth) y funciona en Raspberry Pi, NUC o servidores.
Claude Code CLI
Claude Code es la herramienta de linea de comandos de Anthropic que permite interactuar con Claude como agente de IA desde una terminal. Puede leer archivos, ejecutar comandos, navegar por codebases y generar codigo autonomamente.
Add-on de Home Assistant
Un add-on es un contenedor Docker gestionado por el Supervisor de HA que anade funcionalidad extra al sistema. Se instala desde la tienda de add-ons y se ejecuta de forma aislada pero con acceso controlado a la API de HA.
MCP (Model Context Protocol)
MCP es un protocolo abierto creado por Anthropic que permite a los LLMs conectarse con herramientas externas. En el contexto de HA, podria usarse para que Claude acceda a datos de sensores, historiales y servicios.
Supervisor API
La API del Supervisor de HA permite controlar el sistema operativo, add-ons, backups y configuracion. Claude Code accede a ella mediante el token SUPERVISOR_TOKEN que se inyecta automaticamente en el contenedor.
YAML
YAML (Yet Another Markup Language) es el formato de configuracion que usa Home Assistant para automatizaciones, scripts y entidades. Claude Code genera YAML valido a partir de tus instrucciones en lenguaje natural.
Como Instalar Claude Code Terminal Pro: Paso a Paso
Requisitos del Sistema
| Requisito | Minimo | Recomendado |
|---|---|---|
| RAM | 256 MB libres (el add-on advierte si hay menos) | 512 MB+ libres |
| Disco | 100 MB libres | 500 MB+ libres |
| Home Assistant | OS o Supervised (NO Docker standalone) | Home Assistant OS |
| Hardware | Raspberry Pi 3B+ | Raspberry Pi 5 / Intel NUC |
| Red | Acceso a internet (claude.ai, ghcr.io, api.anthropic.com) | Ethernet estable |
| Cuenta Anthropic | Plan Pro ($20/mes) o Max ($100/mes) | Pro es suficiente para domotica |
Paso 1: Anadir el Repositorio
Abre Home Assistant y ve a Ajustes > Complementos > Tienda de complementos. Pulsa el menu de tres puntos (arriba a la derecha) y selecciona Repositorios.
Anade esta URL:
1https://github.com/esjavadex/claude-code-ha
Pulsa Anadir y cierra el dialogo.
Paso 2: Instalar el Add-on
Busca "Claude Terminal Pro" en la tienda de complementos. Haz clic en el y pulsa Instalar. La primera instalacion tarda entre 2 y 5 minutos porque descarga la imagen Docker (~200 MB dependiendo de tu arquitectura).
Paso 3: Configurar las Opciones
Antes de iniciar, revisa la configuracion del add-on:
1auto_launch_claude: true # Inicia Claude automaticamente al abrir la terminal2dangerously_skip_permissions: false # Mantener en false por seguridad3persistent_apk_packages: [] # Paquetes Alpine a instalar automaticamente4persistent_pip_packages: [] # Paquetes Python a instalar automaticamente
Mi recomendacion: deja auto_launch_claude: true para que Claude arranque directamente. Si necesitas depurar, puedes cambiarlo a false para ver el menu de sesiones.
Paso 4: Iniciar el Add-on
Pulsa Iniciar en la pagina del add-on. La primera vez, el sistema:
- Ejecuta un health check (verifica RAM, disco, DNS, red)
- Configura el entorno persistente (
/datacomo directorio raiz) - Instala herramientas (ttyd, jq, curl)
- Despliega el menu de sesiones interactivo
- Arranca el servicio web (terminal + servidor de imagenes)
Paso 5: Autenticarse con Anthropic
Abre la UI Web desde el panel lateral de HA (o pulsa "Abrir interfaz web"). La primera vez te pedira autenticarte:
- Claude mostrara un enlace de autenticacion OAuth
- Abrelo en tu navegador y accede con tu cuenta de Anthropic
- Autoriza el acceso
- Las credenciales se guardan en
/data/.config/claude/y persisten entre reinicios
A partir de la version 1.2.0, la autenticacion se migro de /config a /data, lo que resolvio el problema de tener que re-autenticarse tras cada reinicio del add-on.
Paso 6: Verificar que Funciona
Una vez autenticado, escribe algo simple:
1Dime cuantas entidades tiene mi Home Assistant
Claude usara el comando ha y la API del Supervisor para consultar tu sistema y responderte con el numero exacto de entidades, dominios y dispositivos registrados.
Tu Primera Automatizacion: Ejemplo Practico
Ejemplo: Luz del Pasillo con Sensor de Movimiento
Imaginemos 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.
Lo que le dices a Claude:
1Crea una automatizacion que encienda la luz del pasillo al 70% cuando el sensor2de movimiento detecte presencia, pero solo entre las 22:00 y las 07:00.3La luz debe apagarse automaticamente despues de 3 minutos sin movimiento.
Lo que Claude genera:
1automation:2 - alias: "Luz pasillo nocturna con movimiento"3 description: "Enciende la luz del pasillo al detectar movimiento de noche"4 trigger:5 - platform: state6 entity_id: binary_sensor.pasillo_movimiento7 to: "on"8 condition:9 - condition: time10 after: "22:00:00"11 before: "07:00:00"12 action:13 - service: light.turn_on14 target:15 entity_id: light.pasillo16 data:17 brightness_pct: 7018 - wait_for_trigger:19 - platform: state20 entity_id: binary_sensor.pasillo_movimiento21 to: "off"22 for:23 minutes: 324 - service: light.turn_off25 target:26 entity_id: light.pasillo27 mode: restart
Claude no solo genera el YAML: tambien te explica cada seccion, verifica que los entity_id coincidan con entidades reales de tu sistema, y te dice donde guardarlo (en automations.yaml o via la UI de HA).
15 Comandos Practicos para Controlar tu Casa
Aqui tienes ejemplos reales que puedes copiar y pegar en la terminal de Claude Code Terminal Pro:
Control de Iluminacion
| Comando en lenguaje natural | Que hace Claude |
|---|---|
| "Enciende todas las luces del salon" | Ejecuta light.turn_on para cada entidad del grupo salon |
| "Pon las luces del dormitorio al 30% en tono calido" | Ajusta brightness_pct: 30 y color_temp_kelvin: 2700 |
| "Crea una escena romantica para la cena" | Genera un scene YAML con luces atenuadas, colores calidos |
| "Apaga todas las luces de la casa excepto el bano" | Filtra entidades del dominio light y ejecuta turn_off selectivo |
Sensores y Clima
| Comando | Resultado |
|---|---|
| "Cual es la temperatura del salon ahora mismo?" | Lee sensor.salon_temperature y te da el valor actual |
| "Crea un sensor template que me de la media de temperatura de toda la casa" | Genera YAML con template sensor que agrupa todos los sensor.*_temperature |
| "Avisame cuando la humedad del bano supere el 80%" | Crea automatizacion con trigger numerico sobre sensor.bano_humidity |
| "Muestra el historico de consumo electrico de las ultimas 24 horas" | Consulta el historial de sensor.consumo_electrico via la API |
Camaras y Seguridad
| Comando | Resultado |
|---|---|
| "Lista todas las camaras que tengo en Home Assistant" | Consulta entidades del dominio camera |
| "Crea una automatizacion que me envie una foto al movil cuando la camara del jardin detecte movimiento" | Genera automatizacion con camera.snapshot + notify.mobile_app |
| "Activa el modo alarma cuando no haya nadie en casa" | Combina person tracker con alarm_control_panel |
Automatizaciones Avanzadas
| Comando | Resultado |
|---|---|
| "Crea un script para modo cine: apaga luces del salon, enciende tira LED al 10% en azul, baja la persiana y sube el volumen del media player" | Genera script YAML multi-servicio con secuencia |
| "Cuando abra la puerta de casa entre las 17 y las 20, enciende las luces del recibidor y pon musica de bienvenida" | Automatizacion con sensor de puerta + condicion horaria + multiples acciones |
| "Renombra todas mis entidades Zigbee para que sigan el formato habitacion_tipo_dispositivo" | Lee entidades actuales, propone nuevos nombres y ejecuta entity_registry/update |
| "Revisa mi configuration.yaml y dime si hay errores" | Lee el archivo, valida sintaxis YAML y detecta problemas de indentacion o entidades inexistentes |
Analisis de Imagenes: Pega Capturas y Claude las Interpreta
Una de las funciones mas potentes del add-on es el sistema de analisis de imagenes. Hay tres formas de enviar una imagen a Claude:
Metodo 1: Pegar desde el Portapapeles (Ctrl+V)
- Haz una captura de pantalla de un error, un dashboard o un dispositivo
- En la terminal web del add-on, pulsa Ctrl+V
- La imagen se sube automaticamente a
/data/images/ - La ruta del archivo se copia al portapapeles
- Pegala en la conversacion con Claude
Metodo 2: Arrastrar y Soltar
Arrastra un archivo de imagen directamente sobre la terminal web. El proceso es identico: se sube, se genera la ruta, y puedes pedirle a Claude que la analice.
Metodo 3: Monitor de Portapapeles en Mac
Si usas macOS, el script mac-clipboard-monitor.py monitoriza tu portapapeles cada 500ms y sube automaticamente cualquier imagen nueva al add-on:
1pip install Pillow requests pasteboard2python mac-clipboard-monitor.py --host http://tu-ha-ip:7680
Formatos soportados
JPEG, PNG, GIF, WebP y SVG con un tamano maximo de 10 MB por imagen.
Ejemplos de uso
- Captura de un error en los logs: "Analiza esta captura y dime que esta fallando"
- Screenshot de un dashboard: "Sugiere mejoras de UX para este panel de control"
- Foto de un dispositivo: "Que modelo es esta camara? Es compatible con HA?"
Entrada por Voz: Dicta Instrucciones a Claude
El add-on incluye un modulo de entrada por voz que usa la Web Speech API del navegador:
| Atajo | Funcion |
|---|---|
| Espacio | Iniciar/detener grabacion |
| Enter | Copiar transcripcion al terminal |
| Escape | Cerrar modulo de voz |
No necesita servicios externos -- todo funciona en el navegador. Combinado con Claude Code, puedes literalmente hablarle a tu casa:
- Pulsa Espacio para grabar
- Di: "Enciende las luces del jardin y pon la temperatura del termostato a 22 grados"
- Pulsa Enter para enviar
- Claude ejecuta los comandos
Gestion de Paquetes Persistentes
Los contenedores Docker de HA son efimeros: cualquier paquete instalado con apk add desaparece al reiniciar. Claude Code Terminal Pro resuelve esto con persist-install:
1# Instalar paquetes del sistema (persistentes)2persist-install python3 py3-pip git vim htop3 4# Instalar paquetes Python (en virtualenv aislado)5persist-install --python requests pandas numpy6 7# Ver paquetes instalados8persist-install --list
Los paquetes se guardan en /data/packages/ y se restauran automaticamente en cada inicio. Tambien puedes configurar paquetes auto-instalables desde la UI del add-on:
1persistent_apk_packages:2 - git3 - vim4 - htop5persistent_pip_packages:6 - requests7 - pyyaml
Claude Code esta entrenado para usar siempre persist-install en lugar de apk add o pip install gracias a un skill integrado (persistent-package-manager). Si le dices "instala git", usara automaticamente el metodo persistente.
Claude Code vs Alternativas para Domotica IA
| Caracteristica | Claude Code Terminal Pro | Google Home + Assistant | Alexa Smart Home | Apple Home + Siri |
|---|---|---|---|---|
| Control por lenguaje natural | Si, sin limites | Limitado a comandos predefinidos | Limitado a Skills | Limitado a Shortcuts |
| Genera automatizaciones | Si, YAML completo | No | No | No |
| Depura errores | Si, analiza logs y config | No | No | No |
| Open source | Si (MIT) | No | No | No |
| Funciona sin nube | Parcial (necesita API Anthropic) | No | No | No |
| Analiza imagenes | Si | No | No | No |
| Multi-dispositivo | 2.800+ integraciones HA | ~400 marcas | ~500 marcas | ~200 marcas |
| Precio del add-on | Gratis | Gratis (con hardware) | Gratis (con hardware) | Gratis (con hardware) |
| Coste IA | $20/mes (Claude Pro) | Incluido en ecosistema | Incluido en ecosistema | Incluido en ecosistema |
| Personalizacion | Total | Minima | Minima | Minima |
Costes y ROI: Merece la Pena?
| Concepto | Coste | Notas |
|---|---|---|
| Add-on Claude Terminal Pro | $0/mes | Open source, gratuito |
| Home Assistant OS | $0/mes | Open source, gratuito |
| Hardware (Raspberry Pi 5) | ~75 EUR (unico) | 8 GB RAM recomendado |
| Claude Pro | $20/mes | Necesario para la API |
| Total primer ano | ~315 EUR | 75 EUR hardware + 240 EUR Claude |
| Total desde segundo ano | 240 EUR/ano | Solo la suscripcion de Claude |
Calculo de ROI
Si dedicas 2 horas al mes a configurar automatizaciones manualmente y tu hora vale 30 EUR, Claude te ahorra 1.5 horas al mes (reduccion del 75%). Eso son 45 EUR/mes de ahorro en tiempo por 20 EUR de coste. ROI de 2.25x desde el primer mes.
| Perfil | Ahorro estimado/mes | Coste Claude | ROI |
|---|---|---|---|
| Hobbyist con 20+ dispositivos | 45 EUR (1.5h) | 20 EUR | 2.25x |
| Power user con 100+ entidades | 120 EUR (4h) | 20 EUR | 6x |
| Instalador profesional | 300 EUR (10h en 5 clientes) | 20 EUR | 15x |
Y eso sin contar el valor de tener automatizaciones que nunca habrias creado por falta de conocimiento YAML.
"Con Claude Code Terminal Pro, configure 15 automatizaciones en una tarde que me habrian llevado un fin de semana entero escribiendo YAML a mano. El ROI no es solo economico -- es de calidad de vida." -- Javier Santos Criado, consultor de IA en Javadex
Arquitectura Tecnica: Diagrama Completo
1┌─────────────────────────────────────────────────┐2│ Home Assistant OS │3│ │4│ ┌──────────────────────────────────────────┐ │5│ │ Claude Terminal Pro (Docker) │ │6│ │ │ │7│ │ ┌─────────┐ ┌──────────────────────┐ │ │8│ │ │ ttyd │ │ Image Service │ │ │9│ │ │ :7681 │ │ Express.js :7680 │ │ │10│ │ │ Terminal│ │ Upload + Proxy │ │ │11│ │ └────┬────┘ └──────────┬───────────┘ │ │12│ │ │ │ │ │13│ │ ┌────▼──────────────────▼───────────┐ │ │14│ │ │ Claude Code CLI │ │ │15│ │ │ + HA CLI + GitHub CLI │ │ │16│ │ └────────────┬──────────────────────┘ │ │17│ │ │ │ │18│ │ ┌────────────▼──────────────────────┐ │ │19│ │ │ /data (persistente) │ │ │20│ │ │ - /data/home (HOME) │ │ │21│ │ │ - /data/.config/claude (auth) │ │ │22│ │ │ - /data/packages (persist-install)│ │ │23│ │ │ - /data/images (capturas) │ │ │24│ │ └───────────────────────────────────┘ │ │25│ └──────────────────────────────────────────┘ │26│ │ │27│ ┌──────────▼──────────┐ │28│ │ Supervisor API │ │29│ │ SUPERVISOR_TOKEN │ │30│ └──────────┬──────────┘ │31│ │ │32│ ┌─────────────────▼────────────────────────┐ │33│ │ Home Assistant Core │ │34│ │ - 2.800+ integraciones │ │35│ │ - Entidades, servicios, automatizaciones│ │36│ │ - /config (lectura/escritura) │ │37│ └──────────────────────────────────────────┘ │38└─────────────────────────────────────────────────┘39 │ │40 ┌────▼────┐ ┌────▼────┐41 │ Zigbee │ │ Wi-Fi │42 │ Z-Wave │ │ BLE │43 │ Matter │ │ MQTT │44 └─────────┘ └─────────┘45 │ │46 ┌────▼────────────────────▼────┐47 │ Tus dispositivos: │48 │ Luces, sensores, camaras, │49 │ termostatos, persianas... │50 └──────────────────────────────┘
El Menu de Sesiones: 8 Opciones Disponibles
Cuando abres la terminal (con auto_launch_claude: false), ves un menu interactivo:
| Opcion | Descripcion | Cuando usarla |
|---|---|---|
| 1. Nueva sesion | Inicia claude desde cero | Tareas nuevas sin contexto previo |
| 2. Continuar reciente | Ejecuta claude -c | Retomar la ultima conversacion |
| 3. Lista de conversaciones | Ejecuta claude -r | Elegir entre conversaciones pasadas |
| 4. Comando personalizado | Escribes los flags manualmente | Uso avanzado con opciones especificas |
| 5. Autenticacion | Helper de login OAuth | Resolver problemas de credenciales |
| 6. GitHub CLI Login | Autenticacion de gh | Gestionar repositorios |
| 7. Shell Bash | Terminal pura sin Claude | Depurar el contenedor directamente |
| 8. Salir | Cierra la sesion | -- |
Errores Comunes al Usar Claude Code en Home Assistant
Error 1: Autenticacion que se pierde tras reiniciar
Problema: en versiones anteriores a la 1.2.0, las credenciales se guardaban en /config (efimero) y habia que re-autenticarse cada vez.
Solucion: actualiza a la version 2.0.10 o posterior. La autenticacion ahora se guarda en /data/.config/claude/ que es persistente. Si aun tienes problemas, usa la opcion 5 del menu de sesiones (Authentication Helper).
Error 2: Claude no puede acceder a las entidades de HA
Problema: Claude dice que no tiene acceso a las entidades o devuelve errores al usar el comando ha.
Solucion: verifica que el add-on tiene hassio_api: true y homeassistant_api: true en su configuracion. El token SUPERVISOR_TOKEN se inyecta automaticamente -- si no funciona, reinicia el add-on.
Error 3: Instalacion falla en Raspberry Pi 3 o hardware antiguo
Problema: el instalador nativo de Claude Code requiere soporte AVX en la CPU, que no tienen los procesadores ARM antiguos ni los Intel Atom/Celeron.
Solucion: desde la version 2.0.10, el add-on detecta esto automaticamente y usa el fallback de npm (npm install -g @anthropic-ai/claude-code). Si la instalacion sigue fallando, asegurate de tener al menos 256 MB de RAM libre.
Error 4: Los paquetes desaparecen al reiniciar
Problema: instalaste git o vim con apk add y tras reiniciar el contenedor, ya no estan.
Solucion: usa siempre persist-install en lugar de apk add. Los paquetes se guardan en /data/packages/ y se restauran automaticamente. Tambien puedes listar los paquetes configurados con persist-install --list.
Error 5: La terminal web no carga
Problema: al abrir la UI web del add-on, ves una pantalla en blanco o un error de conexion. Solucion: verifica que el add-on esta iniciado (no solo instalado). Comprueba los logs del add-on para ver si el health check fallo. 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).
Mejores Practicas
- Usa siempre
persist-installpara cualquier paquete: Claude ya lo sabe, pero si usas la shell Bash directamente, recuerdalo - Revisa el YAML antes de aplicarlo: pide a Claude que te explique cada seccion antes de guardarlo en
automations.yaml - Haz backups antes de cambios grandes: Claude tiene acceso de escritura a
/config, asi que un error podria romper tu configuracion - Usa sesiones continuas (
claude -c) cuando estes trabajando en algo complejo -- asi Claude recuerda el contexto - Aprovecha el analisis de imagenes para depurar: en lugar de copiar logs a mano, haz una captura y pegala
Solucion de Problemas Comunes
El health check muestra advertencias de red
Solucion: el add-on necesita conexion a claude.ai, ghcr.io y api.anthropic.com. Si usas un firewall o Pi-hole, anade estos dominios a la lista blanca. En entornos VirtualBox o Proxmox, el health check da orientacion especifica para cada hipervisor.
Claude genera entity_id que no existen
Solucion: pide a Claude que primero liste tus entidades reales con ha state list antes de crear automatizaciones. Asi usara los nombres correctos de tu instalacion.
El add-on consume demasiada RAM
Solucion: el servidor de imagenes consume ~10-15 MB de RAM. Si tu Raspberry Pi tiene poca memoria, considera desactivar auto_launch_claude y usar la opcion 7 (Bash) cuando no necesites IA. El consumo total del add-on ronda los 100-150 MB con Claude activo.
Error "command not found" para herramientas instaladas
Solucion: usa /install (slash command de Claude) en lugar de instalar manualmente. Si ya instalaste con persist-install, cierra y reabre la sesion de Claude para que cargue las nuevas rutas del PATH.
Plan de Accion: Empieza Hoy
| Cuando | Accion | Resultado |
|---|---|---|
| Ahora mismo (5 min) | Anadir repositorio e instalar add-on | Claude Terminal Pro funcionando |
| Hoy (15 min) | Autenticarte y probar 3 comandos basicos | Control de luces y lectura de sensores |
| Esta semana | Crear 3 automatizaciones con lenguaje natural | Rutinas matutinas, nocturnas y de seguridad |
| Semana 2 | Configurar entrada por voz y analisis de imagenes | Control hands-free y depuracion visual |
| Semana 3 | Instalar paquetes persistentes y personalizar | Entorno de desarrollo completo en HA |
| Semana 4 | Crear dashboards y escenas complejas con Claude | Casa inteligente totalmente automatizada |
Recursos para Seguir Aprendiendo
Documentacion Oficial
- Repositorio Claude Code HA - Codigo fuente, issues y documentacion
- Documentacion Claude Code - Guia oficial de Anthropic
- Documentacion Home Assistant - Referencia completa de HA
Comunidad
- Foro Home Assistant - La comunidad mas grande de domotica
- Discord Home Assistant - Chat en tiempo real
- Subreddit r/homeassistant - Discusiones y proyectos
Plugins Complementarios
- Claude Home Assistant Plugins - Marketplace de plugins para Claude Code con validacion YAML, patrones de configuracion y blueprints
Fuentes
- Repositorio oficial claude-code-ha - ESJavadex, actualizado 23 de febrero de 2026
- Statista Smart Home Report - Mercado global smart home, enero 2026
- Documentacion Claude Code CLI - Anthropic, marzo 2026
- Home Assistant Statistics - Datos de uso de HA, marzo 2026
Glosario de Terminos
| Termino | Definicion |
|---|---|
| Add-on | Extension instalable en Home Assistant OS que ejecuta servicios adicionales en contenedores Docker |
| Automatizacion | Regla de Home Assistant con trigger, condicion y accion que ejecuta tareas automaticamente |
| Claude Code CLI | Herramienta de linea de comandos de Anthropic para interactuar con Claude como agente de IA |
| Entity ID | Identificador unico de cada dispositivo/sensor en Home Assistant (ej. light.salon) |
| Health Check | Verificacion automatica de recursos del sistema (RAM, disco, red) al iniciar el add-on |
| Ingress | Sistema de proxy de Home Assistant que permite acceder a la UI de un add-on desde el panel lateral |
| persist-install | Comando personalizado del add-on que instala paquetes de forma persistente entre reinicios |
| Servicio | Accion ejecutable en Home Assistant (ej. light.turn_on, climate.set_temperature) |
| Supervisor | Componente de HA OS que gestiona add-ons, backups y el sistema operativo |
| ttyd | Terminal web que permite acceso a una shell desde el navegador |
| YAML | Formato de configuracion usado por Home Assistant para automatizaciones, scripts y entidades |
| Zigbee/Z-Wave | Protocolos de comunicacion inalambrica para dispositivos domoticos de bajo consumo |
Preguntas Frecuentes (FAQ)
Como controlo las luces de mi casa con Claude Code?
Abre la terminal de Claude Terminal Pro y escribe en lenguaje natural lo que quieres hacer. Por ejemplo: "Enciende la luz del salon al 50%". Claude ejecutara ha service call light.turn_on --arguments entity_id=light.salon,brightness_pct=50 automaticamente. Tambien puedes crear automatizaciones permanentes pidiendole que genere el YAML.
Claude Code Terminal Pro es gratis?
Si, el add-on es 100% gratuito y open source (licencia MIT). Lo unico que necesitas pagar es la suscripcion a Claude de Anthropic: $20/mes en el plan Pro o $100/mes en Max. Para domotica domestica, el plan Pro es mas que suficiente.
Funciona en Raspberry Pi?
Si, Claude Code Terminal Pro soporta Raspberry Pi 3B+ (armv7), Raspberry Pi 4 (aarch64) y Raspberry Pi 5 (aarch64). Desde la version 2.0.10, los procesadores sin AVX usan automaticamente la instalacion via npm como fallback. Se recomiendan al menos 256 MB de RAM libres.
Puedo usar Claude Code sin saber programar?
Si, ese es precisamente el objetivo del add-on. Le dices a Claude en espanol (o cualquier idioma) lo que quieres y el genera el codigo YAML, ejecuta los comandos y configura las automatizaciones por ti. No necesitas saber YAML, Python ni ningun lenguaje de programacion.
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 opcion dangerously_skip_permissions activada por defecto, lo que anade una capa de seguridad.
Que 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 imagenes para analisis visual, entrada por voz, health check completo, fallback de instalacion para CPUs sin AVX, y 93 commits de desarrollo activo. El add-on original se mantiene como base, pero el fork Pro anade funcionalidad significativa.
Puedo usar Claude Code para gestionar mis camaras de seguridad?
Si. Claude puede listar tus camaras, crear automatizaciones de deteccion de movimiento con envio de fotos al movil, configurar grabacion programada y analizar capturas de las camaras. Si usas integraciones como EZVIZ o Frigate, Claude puede ayudarte a configurarlas.
Merece la pena pagar $20/mes por Claude Pro solo para domotica?
Si ganas 30 EUR/hora y Claude te ahorra 1.5 horas al mes en configuracion de HA, el retorno es de 45 EUR por 20 EUR de inversion. ROI de 2.25x. Y eso sin contar que Claude Pro tambien te sirve para programar, escribir, analizar datos y cualquier otra tarea fuera de la domotica.
Conclusion: Mi Recomendacion Personal
"Claude Code Terminal Pro ha cambiado mi forma de usar Home Assistant. Antes me pasaba horas buscando en foros como escribir un YAML correcto. Ahora se lo pido a Claude y en 30 segundos tengo una automatizacion funcionando." -- Javier Santos Criado, consultor de IA en Javadex
Si ya tienes Home Assistant y una suscripcion a Claude: instalalo hoy, tarda 5 minutos y el impacto es inmediato. Si tienes Home Assistant pero no Claude: prueba el plan Pro ($20/mes). El ahorro de tiempo se paga solo en el primer mes. Si no tienes Home Assistant: empieza por ahi. Una Raspberry Pi 5 con HA OS + Claude Terminal Pro es la combinacion mas potente que existe para domotica en 2026.
Mi setup personal (lo que uso a diario):
- Raspberry Pi 5 (8 GB) con Home Assistant OS -- 75 EUR
- Claude Terminal Pro add-on gratuito -- 0 EUR/mes
- Claude Pro suscripcion Anthropic -- 20 EUR/mes
- Conbee III coordinador Zigbee -- 35 EUR (unico)
- 20+ dispositivos Zigbee (IKEA, Aqara, Sonoff) -- 15-25 EUR cada uno
Actualizacion marzo 2026: Version 2.0.10 lanzada el 23 de febrero de 2026 con fallback automatico de npm para CPUs sin AVX, mejoras en el health check de red y soporte mejorado para VirtualBox/Proxmox. El add-on alcanza las 24 estrellas en GitHub y 93 commits de desarrollo activo.
Posts Relacionados
- Claude Code: Guia Completa para Empezar desde Cero - Tutorial desde la instalacion hasta uso avanzado de Claude Code CLI
- Guia Completa: Integrar IA en Home Assistant - Vision general de IA + domotica: LLMs, seguridad y Claude Code
- Como Integrar Camaras EZVIZ en Home Assistant sin Nube - Streaming local RTSP para tus camaras de seguridad
- Como Crear un Asistente de Voz con Home Assistant - Whisper + Piper para control por voz privado
- Raspberry Pi 5: Mejores Proyectos IA y Home Assistant - Ideas de proyectos para tu Raspberry Pi
- Marketplace de Plugins Claude Code para Home Assistant - Plugins de validacion YAML y automatizacion
En Resumen
- Claude Code Terminal Pro es un add-on gratuito y open source que integra Claude Code CLI de Anthropic directamente en Home Assistant para controlar tu casa con lenguaje natural
- Precio: $0 por el add-on + $20/mes por Claude Pro (necesario para la API de Anthropic)
- Controla luces, sensores, camaras, termostatos y cualquier dispositivo de los 2.800+ soportados por Home Assistant escribiendo en espanol
- Genera automatizaciones YAML completas sin necesidad de saber programar: Claude las crea, te las explica y las aplica
- Compatible con Raspberry Pi 3/4/5, Intel NUC y servidores (amd64, aarch64, armv7) gracias al fallback automatico de npm
- Instalacion en 5 minutos: anadir repositorio, instalar, autenticarse y empezar a controlar
- ROI de 2.25x en el primer mes para usuarios con 20+ dispositivos que dedicaban 2+ horas/mes a configuracion manual
- Codigo abierto en GitHub: github.com/ESJavadex/claude-code-ha -- 24+ estrellas, 93 commits, licencia MIT
