用 AI 帮忙写 Home Assistant（简称 HA）自动化，最烦的是来回折腾：复制 YAML 给它，解释设备和实体怎么连的，改完再回 HA 里测。这篇讲的是原作者发现的一个办法：装一个 HA Codex 插件，让 Codex 直接在 HA 里运行，并能访问配置文件。小编按原文梳理，也核对过相关社区资料，咱们一步步看。
原作者之前试过用 Codex 的“电脑操控”功能来查看 HA，但这种方式很费 token（可以理解成 AI 的用量额度）。插件这条路更省。
为什么 Codex 放进 HA 里更合适
它能直接读您现有的配置
HA 的自动化看着简单，背后常牵扯好几块：人体传感器控制灯，另一套根据人在不在家的规则，再加一个夜间改灯光行为的脚本。出了问题或想改的时候，得把这些一起考虑进去。
HA Codex 插件会在 HA 里提供一个终端，对配置目录有读写权限。Codex 可以翻您现有的 YAML 文件，查看自动化和脚本，理解您平时怎么组织这些东西。比如想优化一条灯光自动化，可以先让它读相关文件，看触发器、条件和动作，找出牵涉的其他脚本，再基于现有内容提修改建议。这比让 AI 凭空写一条新自动化，再想办法塞进现有系统要省心。
要注意两点：只有配置文件，拿不到设备的实时状态和自动化历史，需要时仍得由您补充；另外，把 Codex 装在别的电脑上，也能做到类似的文件访问，这并不是插件独有的能力。
怎么把 Codex 装进 Home Assistant
只要装一个插件（Add-on）
HA Codex 是社区开发的项目，托管在 GitHub，不在 HA 默认的应用商店里，需要手动添加仓库地址。原文这里的仓库链接没有保留下来，小编也不替您随便贴一个。建议在 GitHub 搜“HA Codex”，并对照 HA 社区论坛的介绍帖，确认来源后再添加。
- 打开 HA，进入设置 → 应用 → 应用商店（Settings -> Apps -> App Store）。
- 打开仓库管理菜单，添加插件的仓库地址。
- 添加后 HA Codex 会出现在商店里，安装并启动。
- 打开“Show in sidebar”（显示在侧边栏）选项，之后就能像其他应用一样从侧边栏进入 Codex。
第一次启动要登录认证。最简单的是选“Log in with a different device”，会给您一个网址和临时验证码，在另一台设备上打开网址，登录 ChatGPT 账号并授权就行。账号需要有 Codex 使用权限，插件也支持 API Key 登录（前提是您有这个条件）。
设置里可以选模型、调推理强度，还可以开会话保持，这样切到 HA 别的页面再回来，终端仍然在。小编建议别打开“Skip command approvals”（跳过命令确认），因为 Codex 有权修改您的配置文件，每一步让您点头更稳妥。
还有个可选设置叫“Allow Home Assistant control actions”。打开后，Codex 可以校验配置，并请求支持的重载操作，测试改动时不用每次手动重载。
让 Codex 干活：改自动化、查问题
优化已有的自动化
最值得先试的，是改一条已经存在的自动化。原作者有按“人在不在家 + 时间段”控制灯光的规则，他让 Codex 检查现有逻辑，找有没有互相冲突的条件，再提修改建议，而且在批准之前，Codex 会先把要改哪里列出来给他看。
改坏了怎么排查
改完自动化突然不灵了，Codex 可以检查 YAML 的语法，并查看相关脚本和配置。但光靠文件，能诊断的东西有限。像人体传感器没上报、自动化没触发这类问题，还是得去看 HA 的追踪（Traces）和设备历史。
打开控制操作后更方便：改完一处，Codex 能跑配置检查，并重载自动化、脚本等支持的组件，不必每次重启整套系统。原作者的态度是，这类操作仍然要自己批准，因为哪怕一个小失误，也可能牵连其他规则。
| 能做 | 做不到或需自己补 |
|---|---|
| 读写配置目录里的 YAML | 设备实时状态、自动化历史 |
| 检查语法、找条件冲突 | 传感器不上报等现场问题 |
| 校验配置、重载支持的组件 | Docker 版 HA 无法直接安装 |
使用前要注意的限制
这个插件要求 Home Assistant OS。如果您是用 Docker 跑 HA，就不能直接装，得换成 HA OS，比如放进虚拟机里。已经在专用设备上跑 HA OS 的话，就不需要虚拟机。
常见问题（FAQ）
Docker 安装的 Home Assistant 能用吗？
不能直接用。插件需要 Home Assistant OS，Docker 用户得改用 HA OS，比如装在虚拟机里。
必须有 ChatGPT 账号吗？
需要有 Codex 使用权限的账号。插件也支持 API Key 认证，前提是您能用这种方式。
要不要打开“跳过命令确认”？
建议不要。Codex 能改您的配置文件，保留确认步骤，出错时损失小得多。
它能直接看到设备当前开没开吗？
不能，它只有配置文件。设备状态和自动化历史需要您自己提供，或到 HA 的追踪和历史里查。
总结
把 Codex 装进 HA，最大的好处是少了复制粘贴和来回解释，它能直接对着您的真实配置提建议。但它不是万能的：看不到实时状态，需要 HA OS，改动也建议逐步确认。适合已经有一堆自动化、想理一理或优化的朋友试试。如果您更想改面板，也可以看看 让 Claude 一小时重做 Home Assistant 面板。