智能家居编码助手

克劳德家庭助理

HA-expert Claude Code插件，用于家庭助手，具有MCP API工具、自动搜索和深入的家庭助手知识。

Claude Code在Home Assistant中运行，但充分了解您的设置，通过API控制设备的能力，以及HA惯例的专家知识。

是什么让这与众不同

Home Assistant的大多数AI集成都会给你一个聊天机器人。这给了你 克劳德代码 --一个完整的AI编码代理——具有：

特性	描述
13 MCP API工具	Claude可以通过结构化工具调用查询实体、调用服务、控制设备、检查日志、呈现模板等
HA专家知识	预装了CLAUDE.md，其中包含HA YAML约定、自动化模式、Jinja2模板、服务调用语法和最佳实践
自动发现	启动时，扫描HA实例并生成有关特定实体、区域、设备、集成和自动化的上下文
完全文件访问权限	读/写访问 /config --编辑automations.yaml、scripts.yaml、configuration.yaml、自定义组件等
API密钥认证	使用您自己的Anthropic API密钥（不需要OAuth）

MCP工具

Claude可以通过以下工具直接访问您的家庭助理：

工具	它做什么
ha_get_entities	列出具有状态的实体，按域筛选
ha_get_entity_state	任何实体的详细状态+属性
ha_call_service	控制设备、触发自动、发送通知
ha_get_areas	列出所有具有实体计数的房间/区域
ha_get_devices	列出设备，按区域筛选
ha_get_automations	列出自动操作的状态和上次触发时间
ha_get_integrations	列出所有已安装的集成
ha_restart	重新启动家庭助理（确认后）
ha_reload_config	重新加载YAML域（自动化、脚本、场景等）
ha_get_logs	获取最近的调试日志
ha_get_history	实体状态历史记录
ha_fire_event	消防自定义事件
ha_render_template	在HA上下文中测试Jinja2模板

安装

1. 首选 设置>附加组件>附加组件商店
2. 单击三点菜单（右上角）> 仓库
3. 添加： https://github.com/DEADSEC-SECURITY/claude-home-assistant
4. 点击 添加，然后查找并安装 克劳德家庭助理
5. 在插件配置中，设置 anthropic_api_key （或使用OAuth）
6. 启动插件并打开web UI

配置

选项	默认值	描述
anthropic_api_key	""	您的Anthropic API密钥（在UI中隐藏）。为OAuth留空。
auto_discover	true	启动时自动扫描HA设置
auto_launch_claude	true	自动启动Claude或显示会话选择器
dangerously_skip_permissions	false	跳过所有权限提示
persistent_apk_packages	[]	要自动安装的系统包
persistent_pip_packages	[]	要自动安装的Python包

示例用法

问克劳德这样的问题：

• “创建一个自动化系统，在日落后检测到运动时打开走廊灯”
• “我的洗衣机的现状如何？”
• “显示过去24小时的浴室湿度历史记录”
• “3D打印机完成时添加通知”
• “调试为什么我的厨房排气自动化没有触发”

Claude将使用MCP工具检查您的设置，使用正确的实体ID编写正确的YAML，重新加载配置，并验证其是否正常工作。

建筑

• 基础：带ttyd web终端的Alpine Linux容器
• 克劳德代码CLI：通过npm预安装(@anthropic-ai/claude-code)
• MCP服务器：Node.js/TypeScript服务器提供13个HA API工具
• CLAUDE.md：Claude Code自动加载的专家知识库
• 自动发现：Bash脚本生成 /config/.claude/ha_context.md
• 应用程序编程接口：HA REST API+主管API通过 SUPERVISOR_TOKEN

学分

该项目建立在以下工作的基础上：

• 汤姆·卡萨迪 (@heytcass)--创建了原始 克劳德终端插件
• 哈维尔·桑托斯 (@ESJavadex)--具有持久包、图像粘贴和会话选择器的增强分叉(克劳德代码ha)

此插件通过MCP API工具、HA专家知识、自动查找和API密钥验证扩展了它们的基础。

许可证

MIT许可证——见 许可证 了解详情。