告別手搓 YAML，我用 Claude Code 輕松使用 Home Assistant

作為一個 Home Assistant 的長期用戶，在新家實現盡可能所有設備的智能化一直以來都是我的夢想。之前我其實分享過部分方案，不得不說 HA 的是有一定上手門檻的，另外長期使用存在一些難題：

1. 使用 YAML 配置維護容易變得非常冗長，寫配置/維護服務的十分消耗時間和精力（盡管有點樂此不疲）；使用 UI 維護非常低效和不體面

2. 設備一多，維度難度也開始陡增，實體 id 變得眼花繚亂，得人工查各個文檔

3. 基本無法進行有效的版本管理

但是 Agentic 時代這些都不再是問題。搬新家的時候，我從零開始用 Claude Code 搓了一整套 Home Assitant 配置，包括場景、自動化、批量配置、前端界面美化……用極少的人工介入實現了我心目中理想「智能家」。

▍核心理念和使用

這套方案的核心是，用 Python 腳本通過 HA API 來控制部署的整個流程——有興趣的可以閱讀 Claude Code 自己寫的文檔。

這樣做的好處是不用修改冗長的 YAML 文件增添 Agent 上下文負擔，比如我要修改所有燈光的上電狀態為記憶，實際上是一個setup_power_on_state.py的腳本，用for循環遍歷了所有的燈光設置。而如果使用 YAML 文件，則需要閱讀、更改所有實體的配置。

你可以直接 clone 倉庫，之后使用 Claude Code 打開就可以，已經包含 skills 和項目的CLAUDE.md，直接開始對話說你的需求即可。比如：

連接到我的 HA 實例，列出所有設備和實體，輸出一份設備清單讓我確認。我的 HA 地址是 http://x.x.x.x:8123，token 是 xxx。

我主要使用 Claude Opus 4.6 實現，不過結合倉庫中已有知識，其他模型理論上來說也會有不錯的效果，另外倉庫中的還有home-assistant-manager（HA API 維護的基礎知識，不過由于hass-cli已經常年失修并且不可使用，已經移除）和interface-design（交互設計指南）兩個 skill 可以使用。

▍配置思路

在智能設備上，基本是能智能化的設備都選擇了智能化，并且提前調研了是否能順暢地接入 HA。后面我可能會準備一篇新的文章來分享選購思路和使用體驗，本文中會忽略這些細節。

差不多就這些了

首先要有光

由于無主燈，燈我就買了大概 60+ 設備。包括主要是射燈和燈帶。我主要選用了 Matter 和米家平臺的燈具。如果要我現在選的話，更推薦大家使用米家 Mesh 2.0 的燈具，連接和配置都更加簡單。

Matter 燈具需要額外配置局域網的 IPv6，通過 Apple Home 的控制器接入到 HA 中。而米家的燈具首先可以批量接入到米家中，不用手動掃碼一個個加入 Apple Home，然后直接通過小米官方集成就可以接入 HA。

另外米家的燈普遍價格要比 Matter 白牌的燈便宜一半左右。

接入到米家的時候需要手動設置房間名稱，然后到 HA 會帶上米家的房間信息。之后就是配置燈組（create_groups.py）。我的邏輯是：

1. 房間的燈成組，比如客廳燈光、主臥燈光

2. 主燈帶（24V，Matter 控制器）和氛圍燈帶（12V，米家控制器）成組，用來控制照明和氛圍

可以自行和 Claude Code 溝通成組邏輯，燈組可以有效簡化后續的綁定智能開關、語音控制。另外我取消了 Apple Home 和米家燈具所有的自適應照明（節律照明）功能，統一使用 Adaptive Lighting 配置（setup_adaptive_lighting.py）。其中衛生間會配置偏冷、公共區域中性、臥室偏暖的自適應照明方案。

最后我批量設置了上電狀態為記憶而不是開啟（setup_power_on_state.py）。

場景設置

除了區域燈光的自適應照明，另一個高頻需求就是照明的場景。我給家里配置了三個場景：

1. 會客模式：公共區域提高亮度和色溫，適合朋友聚會
2. 影音模式：背景墻燈帶調低亮度，關閉其他公共區域的燈光
3. 睡眠模式：關閉臥室的燈

同樣如果要設計其他模式，可以直接和 Claude Code 溝通，它根據你的情況會主動詢問你的具體需求，在使用一段時間之后，可以這樣對話：

查看我近期的日志，有什么合適的場景或者自動化可以推薦給我嗎？

我家全都買的小米智能開關，可靠、有無零線均適配、價格合適。搭配智能燈使用，需要全部設置成無線模式（setup_wireless_switches.py）。

因為是同品牌的開關，Claude Code 很容易過濾出設備列表并結合房間信息進行按鍵綁定。并且讓它設計了統一的綁定方案，比如左鍵單擊是切換對應區域的燈光等等。為了防止遺忘和客人使用，我同樣生成了一份 HTML 格式適合打印的使用文檔。

▍自動化和控制

自動化可以說是智能家居的核心，然而在這些 Agent 工具之前，我們得花很長時間構思、配置自動化，使用 YAML 配置要小心翼翼測試、使用 UI 配置非常繁瑣。而現在我可以像個真正的老板一樣，說出自己的需求，Claude Code 能夠生成可靠的自動化，甚至從設備列表、使用習慣推薦自動化方案。

為此，倉庫中維護了一個TODO.md來記錄和實現這些構思。其中比較重要的有：

1. 人在亮燈

   人在傳感器我主要有兩類，一個是領普的人在筒射燈，便宜、但是無人判定時間長、容易誤觸發；另一類是頂裝的獨立的人在傳感器。這些自動化我都通過 HA 實現，而不用米家中點按或者燈自帶。并且只在廚房、衛生間等非公共區域使用。

2. 浸水報警

   廚下有水浸傳感器，有警報之后會通知我的手機，并且家里有一盞特殊的裝飾燈，如果家里有人會閃紅光。

3. 完成通知

   洗衣機/烘干機/洗碗機運行結束之后會發通知，并用 HomePod 語音播報。

4. 寵物通知

   之前文章中廢了好大力氣設置的貓的如廁通知、喝水通知、缺貓砂通知、垃圾箱已滿通知都用 Claude Code 一次性完成，并且會列把購買貓砂和清理待辦列表中。

5. 回家模式

   這里比較特殊的是，是通過 HA 暴露了在家確認這個虛擬開關給 Apple Home，然后通過 iPhone 的離家、回家來觸發虛擬開關，并配合門鎖打開來實現，這樣可以不用在后臺運行 HA app，更省電和可靠。

6. 自動排氣

   坐上馬桶之后會自動開始浴霸排風，并且離開之后幾分鐘之后停止。

7. 自動除濕

   檢測到浴室濕度高于一定值之后，開啟排氣，一直到低于設定閾值之后停止。

其中可以參考如何和 Claude Code 溝通的迭代的方式，在這里不需要一步到位，可以在使用中讓 Claude Code 自動發現規律，比如這個除濕閾值的設置，是從我某次洗澡中自動獲取和配置的：

從日志中學習

語音控制上，我主要是通過 HomePod，所以把所有非 Matter 設備通過 Home Bridge 透給了 Apple Home（setup_homekit.py）。省去了大量篩選實體的時間。Apple Home 的區域分組也是和米家保持一致。如果想要通過小愛控制所有的 HA 設備也很簡單，大致就是：

我希望通過小愛同學控制所有的設備，設置自動化獲取小愛音箱的語音識別文本，匹配到設備控制并注意阻止小愛音箱自己的語音回復。

之前使用 HA 的一部分樂趣和痛點就是前端了，很想搞一個很好看的 Dashboard 但是又前端乏力。然而現在這些模型的前端能力都相當可靠，甚至審美超前。

經過一番迭代，我用 Material Design 3 風格構建了整個 Dashboard。整體迭代其實并沒有看起來簡單，尤其是我是用了 Gemini 3 Pro 生成風格、Opus 4.6 修改排版、Codex 3.5 繼續優化，以及哪個有用量就用哪個頂上，逐步迭代出自己想要的樣式。

完全的 Material You 愛好者

最常見的按鍵會放在首頁，方便直接在墻上的小米平板 5 作為 Wall Panel 進行控制。其余的按照功能分區到燈光、環境、寵物等等子 tab；卡片基本使用了 Mushroom，并且使用 Custom Card 來實現一些復雜的聚合類設備的狀態顯示和控制需求，比如洗碗機、洗衣機等。

端上效果

在各種交互中，還是感受到 Opus 4.6 是一個與眾不同的模型，有更好的理解能力和排版功底，可以減少返工次數。工具上的體驗基本是屬于Claude Code >= Codex >>> Gemini Cli。

▍其他亮點功能 每日寶可夢

為了增添 Dashboard 的趣味性，增加了一個每日寶可夢的展示，通過 PokeAPI 每天獲取一個隨機寶可夢進行展示。并且這個寶可夢的圖片會自動設置為Material You Base Color Source Image Path/URL進行 Material You 主題自動取色。

電子墨水屏

通過 ESPHome 接入了一塊電子墨水屏，進行 HA 數據的展示。特別的地方是會有一個 Claude Code 用量的展示，這部分是通過裝了 Claude Code 的機器通過 API push 用量信息到 HA（push_claude_usage.sh），再通過墨水屏進行展示。

這個墨水屏套件的價格還是有點貴，不過是一個非常適合用來做 demo 和學習的東西。殼子是商家提供的 3D 打印模型。

特意用了像素字體和初代寶可夢圖像

使用手冊

為了讓其他家人、客人了解無線開關的控制邏輯，同時生成了一個可打印的網頁。

▍感想：在全自動和可控性之間

從去年底到現在，可以說以 OpenClaw 代表的 Agent 席卷全球，甚至出現比較搞笑的「上門安裝」OpenClaw 需求熱潮。網上也有不少關于使用 LLM 來控制智能家居、接入 HA 的案例。

但是我們生活中，其實更多是重復的范式，但是挖掘和實現自動化需求在 Claude Code 出現之前對于一般人是比較困難的。通過 Claude Code 生成可復用的自動化腳本，讓我更體會到智能家居的樂趣。不用查文檔、更不用低效地拖節點，所想即所得。

所以在 2026 我將不再推薦諸如米家極客版、n8n 或者 Node-RED 的方案，Home Assistant 憑借其強大、豐富、開放的 API 工具，必將成為這個 Agentic 時代智能家居的第一選擇。

https://sspai.com/post/106992?utm_source=wechat&utm_medium=social

作者：yzlnew

責編：克萊德