Claude Code en Home Assistant: Terminal IA para Automatizar tu Casa Paso a Paso [2026]

Claude Code en Home Assistant: Terminal IA para Automatizar tu Casa Paso a Paso en 2026

TL;DR - Resumen Rapido

• Claude Code Terminal Pro es un add-on gratuito que instala la CLI de Claude Code de Anthropic dentro de Home Assistant
• Automatiza con lenguaje natural: le dices que quieres y Claude genera el YAML, lo valida y lo instala
• Persistencia real: paquetes Python y del sistema sobreviven a reinicios del contenedor
• Soporte de imagenes: pega capturas y Claude las analiza directamente en el terminal
• Plugins disponibles: instala plugins especializados para Home Assistant con un solo comando
• Codigo abierto: github.com/ESJavadex/claude-code-ha

Que Es Claude Code Terminal Pro para Home Assistant?

Claude Code Terminal Pro es un add-on para Home Assistant que trae la potencia de la CLI de Claude Code de Anthropic directamente a tu entorno domotico. En terminos sencillos: es como tener un ingeniero de Home Assistant disponible 24/7 dentro de tu dashboard.

No es un simple chatbot. Claude Code tiene acceso directo al sistema de archivos de tu configuracion de Home Assistant, puede leer y modificar archivos YAML, ejecutar comandos, instalar paquetes y crear automatizaciones completas. Todo desde una interfaz de terminal web integrada en Home Assistant.

Segun un informe de Anthropic (enero 2026), Claude Code es utilizado por mas de 100.000 desarrolladores para tareas de desarrollo y automatizacion, con una tasa de satisfaccion del 94% en generacion de codigo.

Por Que Claude Code y No Otro Asistente de IA?

Requisitos Previos

Antes de instalar, asegurate de tener:

• Home Assistant OS o Supervised (los add-ons no funcionan en Home Assistant Core)
• Cuenta en Anthropic con API key (plan gratuito disponible con limites)
• Navegador web moderno (Chrome, Firefox, Safari)
• Conexion a internet (para comunicarse con la API de Claude)

Tutorial Paso a Paso: Instalacion Completa

Paso 1: Anadir el Repositorio

1. Abre Home Assistant y ve a Settings > Add-ons > Add-on Store
2. Haz clic en los tres puntos (⋮) en la esquina superior derecha
3. Selecciona Repositories
4. Pega la URL: https://github.com/ESJavadex/claude-code-ha
5. Haz clic en Add

Paso 2: Instalar el Add-on

1. Busca "Claude Terminal Pro" en la lista de add-ons disponibles
2. Haz clic en Install
3. Espera a que se descargue e instale (puede tardar 2-5 minutos)

Paso 3: Configurar Opciones

En la pestana Configuration del add-on, ajusta estas opciones:

1# Configuracion recomendada
2auto_launch_claude: true          # Lanza Claude automaticamente al abrir
3dangerously_skip_permissions: false # Mantener en false por seguridad
4 
5# Paquetes persistentes (opcional)
6persistent_apk_packages:
7  - git
8  - curl
9  - jq
10 
11persistent_pip_packages:
12  - pyyaml
13  - requests

Paso 4: Iniciar y Acceder

1. Haz clic en Start para iniciar el add-on
2. Ve a la pestana Web UI o accede desde el sidebar
3. Claude Code se inicia automaticamente y esta listo para usarse

Paso 5: Instalar Plugins de Home Assistant (Recomendado)

Dentro del terminal de Claude Code, ejecuta:

1npx claude-plugins install @ESJavadex/claude-homeassistant-plugins/homeassistant-config

Esto crea un archivo CLAUDE.md en tu directorio de configuracion con contexto especializado para Home Assistant, haciendo que Claude entienda mejor tu setup.

10 Cosas que Puedes Hacer con Claude Code en Home Assistant

1. Crear Automatizaciones Complejas

1"Crea una automatizacion que detecte cuando la lavadora termina
2(consumo electrico <5W durante 5 minutos) y me envie una
3notificacion al movil con el tiempo total de lavado"

2. Depurar Errores de Configuracion

1"Lee mi configuration.yaml y dime si hay errores de sintaxis
2o configuraciones obsoletas"

3. Optimizar Automatizaciones Existentes

1"Revisa mis automatizaciones en automations.yaml y sugiere
2mejoras de rendimiento o simplificaciones"

4. Crear Dashboards Lovelace

1"Crea un dashboard Lovelace para el dormitorio principal con
2temperatura, humedad, luces y persianas en formato grid"

5. Analizar Consumo Energetico

1"Analiza los datos de consumo de mi sensor de energia de los
2ultimos 7 dias y dime patrones de uso"

6. Instalar y Configurar Integraciones

1"Ayudame a configurar la integracion de Spotify en Home
2Assistant paso a paso"

7. Crear Scripts Reutilizables

1"Crea un script que simule presencia en casa cuando estoy
2de vacaciones: enciende/apaga luces aleatoriamente"

8. Generar Templates Jinja2

1"Crea un template sensor que calcule la sensacion termica
2a partir de la temperatura y humedad exterior"

9. Analizar Imagenes de Camaras

Pega una captura de tu camara de seguridad y pregunta:

1"Analiza esta imagen de mi camara: hay algun paquete en la puerta?"

10. Migrar Configuraciones

1"Tengo estas automatizaciones en YAML antiguo. Migralas al
2nuevo formato de Home Assistant 2026"

Persistencia de Paquetes: La Caracteristica Estrella

Uno de los mayores problemas de los add-ons de Home Assistant es que al reiniciar el contenedor, todo lo que instalaste se pierde. Claude Code Terminal Pro resuelve esto con persistencia real de paquetes.

Como Funciona

1# Instalacion persistente con un solo comando
2persist-install apk git curl jq
3persist-install pip pandas matplotlib
4 
5# Estos paquetes se reinstalan automaticamente en cada inicio

Configuracion Automatica

Tambien puedes configurar paquetes en las opciones del add-on para que se instalen en cada arranque:

1persistent_apk_packages:
2  - git
3  - curl
4  - jq
5  - openssh-client
6 
7persistent_pip_packages:
8  - pyyaml
9  - requests
10  - pandas
11  - matplotlib

Esto es especialmente util si usas Claude para tareas de analisis de datos que requieren librerias Python especificas.

Seguridad: Permisos y Buenas Practicas

Modo Restringido (Recomendado)

Por defecto, dangerously_skip_permissions: false significa que Claude pedira confirmacion antes de ejecutar acciones potencialmente peligrosas como:

• Modificar archivos de configuracion
• Instalar paquetes
• Ejecutar scripts
• Acceder a directorios fuera de la configuracion de HA

Modo Sin Restricciones

Si confias plenamente en Claude y quieres maxima velocidad:

1dangerously_skip_permissions: true

Solo activar si sabes lo que haces. Claude tendra acceso completo al sistema de archivos del contenedor.

Buenas Practicas

1. Haz backup antes de dejar que Claude modifique tu configuracion
2. Revisa los cambios que Claude propone antes de aceptarlos
3. Usa modo restringido para tareas criticas
4. No compartas tu API key - cada usuario deberia tener la suya

Claude Code vs Alternativas para Home Assistant

Para Crear Automatizaciones

Ganador: Claude Code Terminal Pro

1Ranking para creacion de automatizaciones:
21. Claude Code Terminal Pro - Genera, valida e instala YAML completo
32. ChatGPT (web) - Solo genera texto que copias manualmente
43. Node-RED - Visual pero requiere conocimientos tecnicos
54. Editor YAML manual - Control total pero lento y propenso a errores

Para Depurar Errores

Ganador: Claude Code Terminal Pro

1Ranking para depuracion:
21. Claude Code Terminal Pro - Lee logs, entiende contexto, propone fixes
32. Home Assistant Logs (UI) - Muestra errores pero sin solucion
43. Google/Stack Overflow - Requiere buscar manualmente

Para Dashboards

Ganador: Empate Claude Code / UI visual

1Ranking para dashboards:
21. Claude Code + YAML directo - Rapido si sabes lo que quieres
31. Editor visual de HA - Intuitivo para dashboards simples
43. HACS themes/cards - Mas opciones pero manual

Problemas Comunes y Soluciones

Error: "Claude no arranca"

1# Verificar que la API key de Anthropic es valida
2# Settings > Add-ons > Claude Terminal Pro > Configuration
3# Revisar logs: Settings > Add-ons > Claude Terminal Pro > Log

Error: "Paquetes no persisten tras reinicio"

1# Usar el comando persist-install en lugar de apk add / pip install
2persist-install apk nombre-paquete
3persist-install pip nombre-paquete

Claude no entiende mi configuracion de HA

1# Instalar los plugins de HA para dar contexto a Claude
2npx claude-plugins install @ESJavadex/claude-homeassistant-plugins/homeassistant-config

Preguntas Frecuentes (FAQ)

Como instalar Claude Code en Home Assistant?

Anade el repositorio https://github.com/ESJavadex/claude-code-ha en Settings > Add-ons > Add-on Store > Repositories, instala "Claude Terminal Pro" y configuralo con tu API key de Anthropic. En menos de 5 minutos tienes Claude Code funcionando dentro de Home Assistant.

Claude Code en Home Assistant es gratis?

El add-on es gratuito y open source (licencia MIT). Sin embargo, necesitas una API key de Anthropic para que Claude funcione. Anthropic ofrece un tier gratuito con limites, y el uso tipico en Home Assistant cuesta entre 5-15€ al mes dependiendo de la frecuencia de uso.

Se puede usar Claude Code en Raspberry Pi?

Si, Claude Code Terminal Pro funciona en Raspberry Pi 4 y 5 con Home Assistant OS. El procesamiento lo hace la API de Anthropic en la nube, asi que el hardware local solo necesita ejecutar el terminal web, que consume muy pocos recursos.

Claude Code puede romper mi configuracion de Home Assistant?

Por defecto, Claude pide confirmacion antes de modificar archivos (modo restringido). Ademas, es buena practica hacer un backup antes de sesiones de configuracion intensivas. Si activas dangerously_skip_permissions, Claude tendra acceso completo, asi que usalo con precaucion.

Cual es la diferencia entre Claude Code Terminal Pro y el Claude Code original?

Claude Code Terminal Pro es una version mejorada del add-on original creado por Tom Cassady. Las mejoras incluyen: soporte para pegar imagenes, persistencia de paquetes, auto-instalacion en arranque, mejor manejo de credenciales y documentacion ampliada. El fork es mantenido por Javier Santos.

Se puede usar Claude Code con modelos locales?

Claude Code Terminal Pro esta disenado especificamente para Claude de Anthropic y no soporta modelos locales. Si quieres IA local en Home Assistant, mira LLM HomeAssistant con Ollama o LocalAI como backend.

Recursos Adicionales

• Claude Code Terminal Pro - GitHub - Codigo fuente y documentacion
• Claude HomeAssistant Plugins - Plugins especializados
• Anthropic API - Obtener API key
• Home Assistant Add-ons - Documentacion oficial de add-ons
• La Escuela de IA - Comunidad gratuita

Posts Relacionados

• Guia Completa: Integrar IA en Home Assistant - Las 3 formas de poner IA en tu casa
• Marketplace de Plugins Claude Code para HA - Plugins disponibles
• Como Integrar OpenAI en Home Assistant - Alternativa con GPT-4
• Adiós a la Nube: Ollama en Raspberry Pi 5 - IA 100% local
• Como Crear un Asistente de Voz con Home Assistant - Control por voz