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

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

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

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

3. 基本無法進(jìn)行有效的版本管理

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

▍核心理念和使用

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

這樣做的好處是不用修改冗長(zhǎng)的 YAML 文件增添 Agent 上下文負(fù)擔(dān)，比如我要修改所有燈光的上電狀態(tài)為記憶，實(shí)際上是一個(gè)setup_power_on_state.py的腳本，用for循環(huán)遍歷了所有的燈光設(shè)置。而如果使用 YAML 文件，則需要閱讀、更改所有實(shí)體的配置。

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

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

我主要使用 Claude Opus 4.6 實(shí)現(xiàn)，不過結(jié)合倉庫中已有知識(shí)，其他模型理論上來說也會(huì)有不錯(cuò)的效果，另外倉庫中的還有home-assistant-manager（HA API 維護(hù)的基礎(chǔ)知識(shí)，不過由于hass-cli已經(jīng)常年失修并且不可使用，已經(jīng)移除）和interface-design（交互設(shè)計(jì)指南）兩個(gè) skill 可以使用。

▍配置思路

在智能設(shè)備上，基本是能智能化的設(shè)備都選擇了智能化，并且提前調(diào)研了是否能順暢地接入 HA。后面我可能會(huì)準(zhǔn)備一篇新的文章來分享選購思路和使用體驗(yàn)，本文中會(huì)忽略這些細(xì)節(jié)。

差不多就這些了

首先要有光

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

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

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

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

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

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

可以自行和 Claude Code 溝通成組邏輯，燈組可以有效簡(jiǎn)化后續(xù)的綁定智能開關(guān)、語音控制。另外我取消了 Apple Home 和米家燈具所有的自適應(yīng)照明（節(jié)律照明）功能，統(tǒng)一使用 Adaptive Lighting 配置（setup_adaptive_lighting.py）。其中衛(wèi)生間會(huì)配置偏冷、公共區(qū)域中性、臥室偏暖的自適應(yīng)照明方案。

最后我批量設(shè)置了上電狀態(tài)為記憶而不是開啟（setup_power_on_state.py）。

場(chǎng)景設(shè)置

除了區(qū)域燈光的自適應(yīng)照明，另一個(gè)高頻需求就是照明的場(chǎng)景。我給家里配置了三個(gè)場(chǎng)景：

1. 會(huì)客模式：公共區(qū)域提高亮度和色溫，適合朋友聚會(huì)
2. 影音模式：背景墻燈帶調(diào)低亮度，關(guān)閉其他公共區(qū)域的燈光
3. 睡眠模式：關(guān)閉臥室的燈

同樣如果要設(shè)計(jì)其他模式，可以直接和 Claude Code 溝通，它根據(jù)你的情況會(huì)主動(dòng)詢問你的具體需求，在使用一段時(shí)間之后，可以這樣對(duì)話：

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

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

因?yàn)槭峭放频拈_關(guān)，Claude Code 很容易過濾出設(shè)備列表并結(jié)合房間信息進(jìn)行按鍵綁定。并且讓它設(shè)計(jì)了統(tǒng)一的綁定方案，比如左鍵單擊是切換對(duì)應(yīng)區(qū)域的燈光等等。為了防止遺忘和客人使用，我同樣生成了一份 HTML 格式適合打印的使用文檔。

▍自動(dòng)化和控制

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

為此，倉庫中維護(hù)了一個(gè)TODO.md來記錄和實(shí)現(xiàn)這些構(gòu)思。其中比較重要的有：

1. 人在亮燈

   人在傳感器我主要有兩類，一個(gè)是領(lǐng)普的人在筒射燈，便宜、但是無人判定時(shí)間長(zhǎng)、容易誤觸發(fā)；另一類是頂裝的獨(dú)立的人在傳感器。這些自動(dòng)化我都通過 HA 實(shí)現(xiàn)，而不用米家中點(diǎn)按或者燈自帶。并且只在廚房、衛(wèi)生間等非公共區(qū)域使用。

2. 浸水報(bào)警

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

3. 完成通知

   洗衣機(jī)/烘干機(jī)/洗碗機(jī)運(yùn)行結(jié)束之后會(huì)發(fā)通知，并用 HomePod 語音播報(bào)。

4. 寵物通知

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

5. 回家模式

   這里比較特殊的是，是通過 HA 暴露了在家確認(rèn)這個(gè)虛擬開關(guān)給 Apple Home，然后通過 iPhone 的離家、回家來觸發(fā)虛擬開關(guān)，并配合門鎖打開來實(shí)現(xiàn)，這樣可以不用在后臺(tái)運(yùn)行 HA app，更省電和可靠。

6. 自動(dòng)排氣

   坐上馬桶之后會(huì)自動(dòng)開始浴霸排風(fēng)，并且離開之后幾分鐘之后停止。

7. 自動(dòng)除濕

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

其中可以參考如何和 Claude Code 溝通的迭代的方式，在這里不需要一步到位，可以在使用中讓 Claude Code 自動(dòng)發(fā)現(xiàn)規(guī)律，比如這個(gè)除濕閾值的設(shè)置，是從我某次洗澡中自動(dòng)獲取和配置的：

從日志中學(xué)習(xí)

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

我希望通過小愛同學(xué)控制所有的設(shè)備，設(shè)置自動(dòng)化獲取小愛音箱的語音識(shí)別文本，匹配到設(shè)備控制并注意阻止小愛音箱自己的語音回復(fù)。

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

經(jīng)過一番迭代，我用 Material Design 3 風(fēng)格構(gòu)建了整個(gè) Dashboard。整體迭代其實(shí)并沒有看起來簡(jiǎn)單，尤其是我是用了 Gemini 3 Pro 生成風(fēng)格、Opus 4.6 修改排版、Codex 3.5 繼續(xù)優(yōu)化，以及哪個(gè)有用量就用哪個(gè)頂上，逐步迭代出自己想要的樣式。

完全的 Material You 愛好者

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

端上效果

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

▍其他亮點(diǎn)功能 每日寶可夢(mèng)

為了增添 Dashboard 的趣味性，增加了一個(gè)每日寶可夢(mèng)的展示，通過 PokeAPI 每天獲取一個(gè)隨機(jī)寶可夢(mèng)進(jìn)行展示。并且這個(gè)寶可夢(mèng)的圖片會(huì)自動(dòng)設(shè)置為Material You Base Color Source Image Path/URL進(jìn)行 Material You 主題自動(dòng)取色。

電子墨水屏

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

這個(gè)墨水屏套件的價(jià)格還是有點(diǎn)貴，不過是一個(gè)非常適合用來做 demo 和學(xué)習(xí)的東西。殼子是商家提供的 3D 打印模型。

特意用了像素字體和初代寶可夢(mèng)圖像

使用手冊(cè)

為了讓其他家人、客人了解無線開關(guān)的控制邏輯，同時(shí)生成了一個(gè)可打印的網(wǎng)頁。

▍感想：在全自動(dòng)和可控性之間

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

但是我們生活中，其實(shí)更多是重復(fù)的范式，但是挖掘和實(shí)現(xiàn)自動(dòng)化需求在 Claude Code 出現(xiàn)之前對(duì)于一般人是比較困難的。通過 Claude Code 生成可復(fù)用的自動(dòng)化腳本，讓我更體會(huì)到智能家居的樂趣。不用查文檔、更不用低效地拖節(jié)點(diǎn)，所想即所得。

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

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

作者：yzlnew

責(zé)編：克萊德