https://github.com/pujux/hass-claude-code
HomeAssistant Claude-Code integration
https://github.com/pujux/hass-claude-code
claude-code hassio-addon home-assistant
Last synced: about 19 hours ago
JSON representation
HomeAssistant Claude-Code integration
- Host: GitHub
- URL: https://github.com/pujux/hass-claude-code
- Owner: pujux
- Created: 2026-05-07T10:19:39.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-08T13:00:05.000Z (about 2 months ago)
- Last Synced: 2026-06-23T13:47:37.520Z (3 days ago)
- Topics: claude-code, hassio-addon, home-assistant
- Language: TypeScript
- Homepage:
- Size: 189 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Claude Code for Home Assistant
A Home Assistant add-on that runs [Claude Code](https://claude.ai/code) in a full-featured web terminal, directly inside your Home Assistant instance. Includes pre-configured Home Assistant MCP so Claude can read and control your smart home.
## Requirements
- An [Anthropic account](https://console.anthropic.com/) with an active Claude Pro subscription or API credits
- Home Assistant OS or Supervised installation
## Installation
1. In Home Assistant, go to **Settings → Apps → Install App**
2. Click the menu (⋮) in the top right and choose **Repositories**
3. Add the following URL and click **Add**:
```
https://github.com/pujux/hass-claude-code
```
4. Find **Claude Code** in the store and click **Install**
5. Start the add-on and open the web UI via the sidebar
## First run
After the add-on starts, open the web UI from the sidebar. You will be greeted with a bash terminal. Type `claude` and press Enter to launch Claude Code. On first launch it will prompt you to log in with your Anthropic account — follow the authentication flow in the terminal. Your credentials are stored in persistent add-on storage and survive restarts.
## Features
### Multiple sessions
Click `+` in the tab bar to open additional named sessions. Each session runs independently. Press `Ctrl+\`` to hide/show the tab bar.
### Image paste
Copy any screenshot or image to your clipboard and paste (`Ctrl+V` / `Cmd+V`) into the terminal. The image is saved locally and inserted as `[Image: /path]` — Claude reads and analyzes it automatically.
### Home Assistant MCP
The Home Assistant MCP is pre-configured on every start. Claude can query entity states, control devices, check automations, and more — no manual setup required.
To add additional MCP servers:
```sh
claude mcp add-json my-mcp '{"command": "my-mcp-server"}'
```
## Configuration
| Option | Default | Description |
|---|---|---|
| `terminal_font_size` | `14` | Font size in the terminal (10–24) |
| `terminal_theme` | `dark` | Color theme: `dark` or `light` |
| `auto_update_claude` | `true` | Auto-update Claude Code on add-on start |