克劳德家庭助理
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模板 |
安装
- 首选 设置>附加组件>附加组件商店
- 单击三点菜单（右上角）> 仓库
- 添加：
https://github.com/DEADSEC-SECURITY/claude-home-assistant - 点击 添加，然后查找并安装 克劳德家庭助理
- 在插件配置中，设置
anthropic_api_key（或使用OAuth） - 启动插件并打开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
学分
该项目建立在以下工作的基础上：
此插件通过MCP API工具、HA专家知识、自动查找和API密钥验证扩展了它们的基础。
许可证
MIT许可证——见 许可证 了解详情。