Claude, mon assistant IA pour Home Assistant
Salut la communauté HACF ! 
Je partage aujourd’hui mon retour d’expérience sur l’utilisation de Claude (l’IA d’Anthropic) comme assistant permanent pour gérer mon installation Home Assistant. Après plusieurs mois d’utilisation intensive, je pense que ça peut vous donner des idées pour vos propres installations.
Mon contexte
Pour situer le niveau de complexité :
- 5 495 entités (3 525 actives)
- 489 devices (Zigbee, Hue, Shelly, etc.)
- 186 intégrations (Core + HACS)
- 151 automatisations
- 47 scripts
- 3 coordinateurs Zigbee (ZHA + 2x Zigbee2MQTT)
Équipements principaux :
- 14 volets Profalux (ZHA)
- 9 caméras Frigate
- 11 zones climatisation Airzone
- Installation solaire (6kWc + 2 batteries : Luna 15kWh + Zendure 8.64kWh)
- Piscine 55m³ automatisée (filtration, chimie, chauffage)
- 2 véhicules électriques (MG4 + Citroën Ami)
Bref, une installation « chargée » qui nécessite pas mal de maintenance et d’optimisation ! 
Pourquoi Claude ?
J’utilise deux outils complémentaires :
1. Claude (chat web/app mobile)
- Conception d’automatisations
- Débogage de YAML
- Conseils architecture
- Explications techniques
2. Claude Code (accès ordinateur)
- Analyse de mes fichiers de config (via Samba)
- Génération de rapports exhaustifs
- Modifications de fichiers YAML
- Scripts Python pour maintenance
- Accès API Home Assistant
La différence avec ChatGPT ? Claude Code peut accéder à mes fichiers HA en prod (lecture/écriture), appeler l’API HA, et donc faire des actions concrètes, pas juste donner des conseils.
Exemples concrets d’utilisation
Exemple 1 : Audit complet automatisé
Contexte : J’avais perdu la vue d’ensemble de mon installation (trop d’entités, trop d’automatisations).
Demande à Claude Code :
« Fais un audit complet de mon HA : toutes les intégrations, tous les devices Zigbee avec leur LQI, toutes les automatisations groupées par thème, helpers, templates, etc. »
Résultat :
- Rapport Markdown de 150 pages généré en 20 minutes
- Inventaire exhaustif : 5495 entités documentées
- Architecture Zigbee complète (3 coordinateurs, 112 devices avec IEEE/LQI)
- 151 automatisations catégorisées par thème
- Liste de tous les helpers avec leur usage
- Identification des pires LQI Zigbee pour optimisation réseau
Ce que ça m’a apporté :
- Vision claire de mon installation
- Détection de 3 devices Zigbee avec LQI critique (<40)
- Identification de 12 automatisations Tempo obsolètes à migrer
- Documentation permanente pour futures modifications
Exemple 2 : Migration EDF Tempo → Gaz de Bordeaux HC/HP
Contexte : Changement de fournisseur électrique, passage de 6 tiers Tempo à 2 tiers HC/HP simples.
Impact :
- 17 automatisations chauffage à adapter
- 8 scripts à simplifier
- 6 helpers tarifs à remplacer
- 4 templates prix à modifier
- 1 intégration RTE Tempo à désinstaller
Workflow avec Claude :
Étape 1 - Inventaire pré-migration (Claude Code)
"Lance un inventaire complet des entités Tempo + état ZLinky + baseline consommation 24h"
→ Rapport généré en 5 min avec :
- 35 entités Tempo identifiées
- 19 automatisations concernées
- Consommation actuelle : 49 kWh/jour (6.93€ Tempo Bleu)
- Projection coût GdB : 9.53€/jour (+38% mais uniquement sur jours Bleu)
Étape 2 - Plan d’action (Claude chat)
"Génère une checklist de migration en 10 phases avec backups, tests, et rollback"
→ Checklist de 75 actions détaillées, durée estimée 2h30
Étape 3 - Exécution le jour J (Claude Code)
- Validation sync fichiers Git vs Prod
- Génération code YAML à la demande (action par action)
- Validation syntaxe avant application
- Documentation automatique de chaque changement
Ce que ça m’a évité :
- ~4-6h de travail manuel
- Risque d’oubli d’entités
- Casse de la prod (backups automatiques avant chaque modif)
- Perte de temps à chercher toutes les références Tempo
Exemple 3 : Optimisation réseau Zigbee
Problème : Perte de connexion aléatoire de certains capteurs Zigbee.
Demande à Claude Code :
« Analyse le réseau ZHA, identifie les devices avec LQI faible, et génère un rapport avec recommandations »
Résultat :
Top 3 pires LQI :
1. Prise Salon Ouest : LQI 29 → CRITIQUE - Ajouter routeur Zigbee
2. Prise Ch Parents : LQI 36 → MAUVAIS - Vérifier position
3. Prise Lanna : LQI 40 → MOYEN - Acceptable mais limite
Recommandation : Ajouter 1 prise Sonoff routeur entre coordinateur et Salon Ouest
Action : Ajout d’une prise routeur → LQI salon passé de 29 à 85 → Plus de déconnexions ! 
Exemple 4 : Création d’automatisations complexes
Besoin : Automatisation piscine « si température < 10°C en hiver ET filtration active, alors alerter + passer en mode protection gel ».
Workflow :
Moi :
« Crée une automation alerte gel piscine avec passage automatique en L3 si T° < 10°C pendant hivernage »
Claude (avec mon prompt master du projet) :
-
Me demande confirmation des entités :
sensor.temperature_piscine_temperature_2(OFIX VP)input_boolean.hivernage_piscineinput_select.piscine_vitesse_ciblenotify.mobile_app_s24+notify.home_assistant_bot(Discord)
-
M’explique la logique :
Trigger : numeric_state < 10°C Condition : hivernage actif Actions : 1. Passer vitesse en L3 (protection gel) 2. Notif mobile prioritaire 3. Notif Discord channel piscine -
Me génère le YAML complet prêt à copier :
alias: "Piscine - Protection Gel Automatique" mode: single trigger: - platform: numeric_state entity_id: sensor.temperature_piscine_temperature_2 below: 10 condition: - condition: state entity_id: input_boolean.hivernage_piscine state: "on" action: - service: input_select.select_option target: entity_id: input_select.piscine_vitesse_cible data: option: "L3" - service: notify.mobile_app_s24 data: title: "🥶 Alerte Gel Piscine" message: "T° {{ states('sensor.temperature_piscine_temperature_2') }}°C - Protection gel activée (L3)" data: priority: high - service: notify.home_assistant_bot data: message: "⚠️ Piscine {{ states('sensor.temperature_piscine_temperature_2') }}°C - Gel imminent, passage L3"
Temps total : 2 minutes vs 15-20 minutes manuellement (recherche doc, syntaxe, tests)
Exemple 5 : Debugging rapide
Problème : Automation chauffage ne se déclenche plus.
Moi :
« Mon automation
chauffage_bleu_blanc_hpne se déclenche plus, pourquoi ? »
Claude :
- Me demande de lui montrer le YAML
- Identifie immédiatement :
binary_sensor.rte_tempo_heures_creusesestunavailable(intégration RTE Tempo en erreur) - Me propose :
- Fix immédiat : Remplacer par
sensor.periode(ZLinky) - Fix temporaire : Désactiver condition Tempo
- Alternative : Utiliser horaires fixes 22h-6h
- Fix immédiat : Remplacer par
Temps de résolution : 5 min vs potentiellement 1h+ de recherche
Mon workflow quotidien
1. Prompt Master de projet
J’ai créé un « prompt master » stocké dans un projet Claude dédié « Mon Home Assistant » qui contient :
- Vue d’ensemble de mon installation (5495 entités, 489 devices)
- Architecture Zigbee (3 coordinateurs, canaux, IP)
- Liste de toutes mes intégrations actives
- Helpers principaux (input_boolean, input_number, etc.)
- Templates existants
- Automatisations par catégorie (151 automations)
- Exemples de nommage et format YAML
- Philosophie d’architecture
- Notes importantes (migration Tempo en cours)
Avantage : Claude connaît TOUTE mon installation → Ses suggestions sont toujours adaptées à MON contexte, pas génériques.
2. Documentation vivante
Claude Code maintient automatiquement :
- Audit complet : Régénéré mensuellement ou après changements majeurs
- Historique des modifications : Journal chronologique daté
- Rapports spécifiques : Énergie, Zigbee, automatisations par thème
- Backups automatiques : Avant chaque modification de fichier
3. Création d’automatisations
Workflow type :
- Moi : « Crée une automation qui… » (en français naturel)
- Claude : M’explique la logique, identifie les entités
- Moi : Je valide ou demande des ajustements
- Claude : Génère le YAML complet prêt à l’emploi
- Moi : Copie dans HA, teste, valide
Gain de temps : ~70% vs écriture manuelle + recherche doc
4. Optimisation continue
Exemple de questions posées :
- « Analyse mes automatisations chauffage et propose des optimisations »
- « Quelles sont mes entités avec le plus de déclenchements inutiles ? »
- « Identifie les automatisations redondantes ou qui se marchent dessus »
- « Génère un rapport de consommation énergétique des 7 derniers jours »
Claude Code peut :
- Lire mes fichiers YAML
- Appeler l’API HA pour avoir les états en temps réel
- Générer des rapports basés sur historique
- Proposer des améliorations concrètes
Configuration technique
Accès API Home Assistant
Étape 1 - Créer un token :
- HA → Profil → Sécurité
- Créer « Long-Lived Access Token »
- Nom : « Claude Code »
- Expiration : 90 jours (renouvelable)
- Permissions : Lecture états + Appel services
Étape 2 - Donner le token à Claude Code :
"Utilise ce token API pour accéder à mon HA : eyJ..."
Sécurité :
- Token révocable instantanément dans HA
- Limiter aux permissions strictement nécessaires
- Ne JAMAIS partager le token publiquement
- Expiration courte (30-90 jours max)
Accès fichiers Samba (optionnel mais puissant)
Configuration :
- Add-on Samba Share installé dans HA
- Partage réseau :
\\192.168.1.124\config - Claude Code se connecte en lecture seule pour analyser
- Modifications faites dans Git local → Validation → Copie manuelle vers prod
Avantage : Claude Code peut lire mes 4000+ lignes d’automatisations et faire des analyses exhaustives
Résultats obtenus
Gains de temps mesurés
| Tâche | Temps avant Claude | Avec Claude | Gain |
|---|---|---|---|
| Audit complet installation | 6-8h (si fait manuellement) | 20 min | -95% |
| Création automation complexe | 15-20 min | 2-3 min | -85% |
| Debugging YAML | 30-60 min | 5 min | -90% |
| Migration Tempo → HC/HP | 4-6h | 2h30 | -60% |
| Optimisation réseau Zigbee | 2-3h | 15 min | -90% |
| Documentation mise à jour | 1-2h/mois | 5 min (auto) | -95% |
Estimation totale : Économie de 10-15h/mois de maintenance HA
Qualité améliorée
- Moins d’erreurs YAML : Syntaxe validée avant application
- Automatisations mieux structurées : Format cohérent, nommage clair
- Documentation à jour : Toujours synchronisée avec la prod
- Backups systématiques : Avant chaque modification
- Résolution problèmes plus rapide : Debugging assisté
Nouvelles possibilités
- Projets plus ambitieux : Je me lance dans des trucs que je n’aurais pas tentés avant (trop chronophage)
Meilleure compréhension : Claude m’explique le « pourquoi » de ses choix
Optimisation continue : Analyses régulières → Détection opportunités d’amélioration
Fiabilité accrue : Tests, validations, rollback facile
Limites et précautions
Ce que Claude NE fait PAS (encore)
Modifier le dashboard Lovelace : Format JSON trop fragile, risque de corruption
Diagnostiquer problèmes matériels : Peut analyser logs mais pas toucher hardware
Prendre des décisions stratégiques seul : Il conseille, TU décides
Avoir une mémoire parfaite entre sessions : D’où l’importance du « prompt master » de projet
Règles de sécurité à respecter
TOUJOURS :
- Backup avant TOUTE modification critique
- Valider le code généré avant de l’appliquer en prod
- Tester progressivement : Une automation à la fois
- Monitorer les logs 24h après changement
- Garder un rollback facile (backup Git)
JAMAIS :
- Donner accès root SSH à Claude Code
- Autoriser modifications automatiques sans validation
- Partager token API publiquement
- Faire confiance aveuglément (toujours vérifier)
Coût
Claude Pro : 20€/mois (abonnement obligatoire pour Claude Code)
Alternative gratuite : Claude gratuit (chat uniquement, sans accès fichiers/API) reste très utile pour :
- Conception d’automatisations
- Debugging YAML
- Conseils architecture
- Explications techniques
Conseils pour démarrer
Niveau 1 - Débutant (gratuit)
- Créer un compte Claude (gratuit)
- Poser des questions basiques :
- « Comment créer une automation qui allume lumière sur détection mouvement ? »
- « Explique-moi ce code YAML [coller ton YAML] »
- « Pourquoi mon automation ne se déclenche pas ? »
Avantage : Apprendre HA plus vite, moins de frustration
Niveau 2 - Intermédiaire (20€/mois)
- Abonnement Claude Pro
- Créer un projet « Mon Home Assistant »
- Rédiger un prompt master avec :
- Tes intégrations principales
- Tes équipements clés
- Format YAML préféré
- Utiliser Claude Code pour :
- Générer des rapports d’audit
- Valider syntaxe YAML
- Créer des scripts Python
Avantage : Gain de temps significatif, meilleure organisation
Niveau 3 - Avancé (20€/mois + config)
- Activer API Home Assistant (token)
- Configurer accès Samba (lecture seule)
- Mettre en place workflow Git :
- Modifications dans Git local
- Validation
- Copie vers prod
- Automatiser la documentation :
- Audit mensuel automatique
- Historique des changements
- Rapports personnalisés
Avantage : Claude devient un vrai « co-pilote » pour ton HA
Exemples de prompts utiles
Pour conception
"Crée une automation qui ferme tous les volets si température extérieure > 28°C et soleil direct"
"Propose une logique de chauffage optimisée pour 3 zones (salon, chambres, SDB) avec gestion présence et mode éco"
"Comment détecter qu'une fenêtre est restée ouverte > 10 min et le chauffage est actif ?"
Pour debugging
"Mon automation [alias] ne se déclenche plus, voici le YAML : [coller]"
"J'ai cette erreur dans les logs : [coller erreur], comment la corriger ?"
"Pourquoi mon template sensor affiche 'unknown' ?"
Pour optimisation
"Analyse mes automatisations lumières et détecte les redondances"
"Quelles sont mes entités avec le plus de changements d'état inutiles ?"
"Comment réduire la charge CPU de mes templates ?"
Pour documentation
"Génère un inventaire de tous mes devices Zigbee avec leur LQI"
"Liste toutes mes automatisations qui utilisent sensor.temperature_salon"
"Crée un rapport de consommation énergétique hebdomadaire"
Vision future : Claude Code « co-pilote permanent »
Après la migration Tempo, je vais configurer Claude Code comme co-pilote permanent avec :
1. Rapports quotidiens automatiques
📊 Rapport HA - 26 janvier 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ SYSTÈME : Uptime 16 jours, CPU 28%, RAM OK
⚠️ ENTITÉS : 3 unavailable (sensor.garage, binary_sensor.cave, light.jardin_4)
⚡ ÉNERGIE : 46 kWh (-5% vs moyenne), coût 8.94€
🏊 PISCINE : T° 15.8°C, pH 7.3, filtration 4h20 ✅
💡 RECOMMANDATIONS : Remplacer pile porte cave (15%)
2. Détection d’anomalies proactive
🚨 Alerte détectée !
Consommation électrique anormale :
- Moyenne 7j : 22 kWh/jour
- Aujourd'hui (16h) : 45 kWh déjà consommés
- Projection : 67 kWh/jour (+204% !)
Causes possibles :
1. Chauffage coincé mode confort ?
2. Chauffe-eau en marche continue ?
3. Équipement défectueux ?
Action : Vérifier consommation par circuit Shelly
3. Optimisation continue
🌡️ Analyse Automatisations Chauffage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 OPTIMISATIONS PROPOSÉES
1. 🔴 CRITIQUE - Économie : 4€/jour
Problème : Salon chauffe fenêtres ouvertes
Solution : Ajouter condition contact fenêtre
Code : [YAML généré]
2. 🟠 IMPORTANT - Économie : 2€/jour
Problème : Préchauffage trop tôt le matin
Suggestion : Décaler 6h → 6h30
Workflow envisagé :
- Claude Code surveille quotidiennement
- Génère rapport + alertes si anomalie
- Propose optimisations concrètes
- JE valide avant application
- Documentation automatique
Conclusion
Claude est devenu mon « assistant IA permanent » pour Home Assistant.
Ce qu’il m’apporte au quotidien :
Gain de temps massif : -70% sur création/maintenance- Montée en compétences : J’apprends en faisant
- Projets plus ambitieux : Je me lance dans des trucs complexes
- Vision claire : Documentation toujours à jour
- Sécurité accrue : Backups, validations, rollback facile
Ce n’est PAS :
- Une solution « magique » qui fait tout tout seul
- Un remplacement de la doc officielle HA
- Une excuse pour ne pas comprendre ce qu’on fait
C’est plutôt :
- Un accélérateur pour les tâches répétitives
- Un formateur patient qui explique sans juger
- Un assistant de code qui valide et optimise
- Un documentaliste qui maintient l’ordre
Mon conseil : Commencez simple (gratuit, questions basiques), et montez en puissance si ça vous plaît. L’investissement (20€/mois) vaut largement le coup si vous passez >2h/mois sur HA.
Ressources
- Claude (gratuit) : https://claude.ai
- Claude Pro : 20€/mois (nécessaire pour Claude Code)
- Documentation Claude : https://docs.anthropic.com
- Mon prompt master : Dispo sur demande (à adapter à votre install)
Et vous, vous utilisez déjà des IA pour gérer votre HA ?
Partagez vos retours, astuces, ou questions ! 
