Ir al contenido principal

Como Controlar tu Casa Inteligente con IA: Claude Code en Home Assistant [Tutorial 2026]

20 de marzo de 2026
22 min

Claude Code Terminal Pro convierte Home Assistant en una casa controlada por IA. Controla luces, crea automatizaciones y analiza camaras con lenguaje natural. Tutorial completo con instalacion y 15+ ejemplos reales.

Javier Santos

Especialista en IA & Machine Learning

📧¿Te gusta este contenido?

Únete a 547+ profesionales que reciben tips de IA cada semana. Sin spam, cancela cuando quieras.

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:

ComponenteTecnologiaFuncion
Terminal webttyd (puerto 7681)Interfaz de terminal en el navegador
Servicio de imagenesExpress.js + Multer (puerto 7680)Subida de capturas para analisis
Claude Code CLIAnthropic nativo / npm fallbackMotor de IA que procesa tus peticiones
HA CLIBinario oficial Home AssistantAcceso directo a la API del Supervisor
GitHub CLIgh oficialGestion 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

RequisitoMinimoRecomendado
RAM256 MB libres (el add-on advierte si hay menos)512 MB+ libres
Disco100 MB libres500 MB+ libres
Home AssistantOS o Supervised (NO Docker standalone)Home Assistant OS
HardwareRaspberry Pi 3B+Raspberry Pi 5 / Intel NUC
RedAcceso a internet (claude.ai, ghcr.io, api.anthropic.com)Ethernet estable
Cuenta AnthropicPlan 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:

code
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:

yaml
1auto_launch_claude: true # Inicia Claude automaticamente al abrir la terminal
2dangerously_skip_permissions: false # Mantener en false por seguridad
3persistent_apk_packages: [] # Paquetes Alpine a instalar automaticamente
4persistent_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:

  1. Ejecuta un health check (verifica RAM, disco, DNS, red)
  2. Configura el entorno persistente (/data como directorio raiz)
  3. Instala herramientas (ttyd, jq, curl)
  4. Despliega el menu de sesiones interactivo
  5. 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:

  1. Claude mostrara un enlace de autenticacion OAuth
  2. Abrelo en tu navegador y accede con tu cuenta de Anthropic
  3. Autoriza el acceso
  4. 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:

code
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:

code
1Crea una automatizacion que encienda la luz del pasillo al 70% cuando el sensor
2de 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:

yaml
1automation:
2 - alias: "Luz pasillo nocturna con movimiento"
3 description: "Enciende la luz del pasillo al detectar movimiento de noche"
4 trigger:
5 - platform: state
6 entity_id: binary_sensor.pasillo_movimiento
7 to: "on"
8 condition:
9 - condition: time
10 after: "22:00:00"
11 before: "07:00:00"
12 action:
13 - service: light.turn_on
14 target:
15 entity_id: light.pasillo
16 data:
17 brightness_pct: 70
18 - wait_for_trigger:
19 - platform: state
20 entity_id: binary_sensor.pasillo_movimiento
21 to: "off"
22 for:
23 minutes: 3
24 - service: light.turn_off
25 target:
26 entity_id: light.pasillo
27 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 naturalQue 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

ComandoResultado
"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

ComandoResultado
"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

ComandoResultado
"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)

  1. Haz una captura de pantalla de un error, un dashboard o un dispositivo
  2. En la terminal web del add-on, pulsa Ctrl+V
  3. La imagen se sube automaticamente a /data/images/
  4. La ruta del archivo se copia al portapapeles
  5. 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:

bash
1pip install Pillow requests pasteboard
2python 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:

AtajoFuncion
EspacioIniciar/detener grabacion
EnterCopiar transcripcion al terminal
EscapeCerrar modulo de voz

No necesita servicios externos -- todo funciona en el navegador. Combinado con Claude Code, puedes literalmente hablarle a tu casa:

  1. Pulsa Espacio para grabar
  2. Di: "Enciende las luces del jardin y pon la temperatura del termostato a 22 grados"
  3. Pulsa Enter para enviar
  4. 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:

bash
1# Instalar paquetes del sistema (persistentes)
2persist-install python3 py3-pip git vim htop
3 
4# Instalar paquetes Python (en virtualenv aislado)
5persist-install --python requests pandas numpy
6 
7# Ver paquetes instalados
8persist-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:

yaml
1persistent_apk_packages:
2 - git
3 - vim
4 - htop
5persistent_pip_packages:
6 - requests
7 - 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

CaracteristicaClaude Code Terminal ProGoogle Home + AssistantAlexa Smart HomeApple Home + Siri
Control por lenguaje naturalSi, sin limitesLimitado a comandos predefinidosLimitado a SkillsLimitado a Shortcuts
Genera automatizacionesSi, YAML completoNoNoNo
Depura erroresSi, analiza logs y configNoNoNo
Open sourceSi (MIT)NoNoNo
Funciona sin nubeParcial (necesita API Anthropic)NoNoNo
Analiza imagenesSiNoNoNo
Multi-dispositivo2.800+ integraciones HA~400 marcas~500 marcas~200 marcas
Precio del add-onGratisGratis (con hardware)Gratis (con hardware)Gratis (con hardware)
Coste IA$20/mes (Claude Pro)Incluido en ecosistemaIncluido en ecosistemaIncluido en ecosistema
PersonalizacionTotalMinimaMinimaMinima

Costes y ROI: Merece la Pena?

ConceptoCosteNotas
Add-on Claude Terminal Pro$0/mesOpen source, gratuito
Home Assistant OS$0/mesOpen source, gratuito
Hardware (Raspberry Pi 5)~75 EUR (unico)8 GB RAM recomendado
Claude Pro$20/mesNecesario para la API
Total primer ano~315 EUR75 EUR hardware + 240 EUR Claude
Total desde segundo ano240 EUR/anoSolo 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.

PerfilAhorro estimado/mesCoste ClaudeROI
Hobbyist con 20+ dispositivos45 EUR (1.5h)20 EUR2.25x
Power user con 100+ entidades120 EUR (4h)20 EUR6x
Instalador profesional300 EUR (10h en 5 clientes)20 EUR15x

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

code
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:

OpcionDescripcionCuando usarla
1. Nueva sesionInicia claude desde ceroTareas nuevas sin contexto previo
2. Continuar recienteEjecuta claude -cRetomar la ultima conversacion
3. Lista de conversacionesEjecuta claude -rElegir entre conversaciones pasadas
4. Comando personalizadoEscribes los flags manualmenteUso avanzado con opciones especificas
5. AutenticacionHelper de login OAuthResolver problemas de credenciales
6. GitHub CLI LoginAutenticacion de ghGestionar repositorios
7. Shell BashTerminal pura sin ClaudeDepurar el contenedor directamente
8. SalirCierra 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

  1. Usa siempre persist-install para cualquier paquete: Claude ya lo sabe, pero si usas la shell Bash directamente, recuerdalo
  2. Revisa el YAML antes de aplicarlo: pide a Claude que te explique cada seccion antes de guardarlo en automations.yaml
  3. Haz backups antes de cambios grandes: Claude tiene acceso de escritura a /config, asi que un error podria romper tu configuracion
  4. Usa sesiones continuas (claude -c) cuando estes trabajando en algo complejo -- asi Claude recuerda el contexto
  5. 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

CuandoAccionResultado
Ahora mismo (5 min)Anadir repositorio e instalar add-onClaude Terminal Pro funcionando
Hoy (15 min)Autenticarte y probar 3 comandos basicosControl de luces y lectura de sensores
Esta semanaCrear 3 automatizaciones con lenguaje naturalRutinas matutinas, nocturnas y de seguridad
Semana 2Configurar entrada por voz y analisis de imagenesControl hands-free y depuracion visual
Semana 3Instalar paquetes persistentes y personalizarEntorno de desarrollo completo en HA
Semana 4Crear dashboards y escenas complejas con ClaudeCasa inteligente totalmente automatizada

Recursos para Seguir Aprendiendo

Documentacion Oficial

Comunidad

Plugins Complementarios


Fuentes


Glosario de Terminos

TerminoDefinicion
Add-onExtension instalable en Home Assistant OS que ejecuta servicios adicionales en contenedores Docker
AutomatizacionRegla de Home Assistant con trigger, condicion y accion que ejecuta tareas automaticamente
Claude Code CLIHerramienta de linea de comandos de Anthropic para interactuar con Claude como agente de IA
Entity IDIdentificador unico de cada dispositivo/sensor en Home Assistant (ej. light.salon)
Health CheckVerificacion automatica de recursos del sistema (RAM, disco, red) al iniciar el add-on
IngressSistema de proxy de Home Assistant que permite acceder a la UI de un add-on desde el panel lateral
persist-installComando personalizado del add-on que instala paquetes de forma persistente entre reinicios
ServicioAccion ejecutable en Home Assistant (ej. light.turn_on, climate.set_temperature)
SupervisorComponente de HA OS que gestiona add-ons, backups y el sistema operativo
ttydTerminal web que permite acceso a una shell desde el navegador
YAMLFormato de configuracion usado por Home Assistant para automatizaciones, scripts y entidades
Zigbee/Z-WaveProtocolos 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):

  1. Raspberry Pi 5 (8 GB) con Home Assistant OS -- 75 EUR
  2. Claude Terminal Pro add-on gratuito -- 0 EUR/mes
  3. Claude Pro suscripcion Anthropic -- 20 EUR/mes
  4. Conbee III coordinador Zigbee -- 35 EUR (unico)
  5. 20+ dispositivos Zigbee (IKEA, Aqara, Sonoff) -- 15-25 EUR cada uno
Coste mensual total: 20 EUR/mes (solo Claude Pro, el resto es hardware)


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


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

Formación y consultoría en IA para empresas

Formo a equipos técnicos y de negocio para adoptar Claude Code, programación agéntica e IA aplicada con resultados desde la primera semana.

  • Claude Code para developers senior (presencial)
  • IA para perfiles de negocio (presencial)
  • 100% personalizado al stack de tu equipo
  • Sesión de diagnóstico gratuita (30 min)
Ver programas de formaciónjavier.santos@aihackers.es
📬

¿Te ha gustado? Hay más cada semana

Únete a "IA Sin Humo" — la newsletter donde comparto lo que realmente funciona en inteligencia artificial. Sin teoría innecesaria, sin postureo.

📚

1 Tutorial

Paso a paso, práctico

🛠️

3 Herramientas

Probadas y útiles

💡

0 Bullshit

Solo lo que importa

+547 suscriptores • Cada martes • Cancela cuando quieras

Javier Santos - Especialista en IA & Machine Learning

Javier Santos

Consultor de IA para empresas. Comparto contenido sobre inteligencia artificial, automatización y desarrollo cada semana.