The Solution
码克助手 — 放在桌上的 Claude 状态灯
闹钟版 · 灯光状态
面板版 · 屏幕动画
Claude-Buddy 硬件实物
通过 Claude Code Hook 实时捕获工具执行事件，经 BLE 推送到 ESP32 设备，转化为直观的灯光颜色和语音播报。
💡
闹钟版（Clock）
WS2812B 双灯珠 + 豆包 TTS 语音
空闲蓝 → 工作青 → 完成绿 → 出错红
空闲蓝 → 工作青 → 完成绿 → 出错红
📺
面板版（Panel）
2.4" TFT 屏幕 + LVGL 动画角色
8 种预设角色，支持自定义
8 种预设角色，支持自定义
✓ 延迟 <5ms，不阻塞 Claude Code 执行
✓ Fail-Open，断连不影响工具运行
✓ 支持多 Claude Code 实例并发追踪
✓ Fail-Open，断连不影响工具运行
✓ 支持多 Claude Code 实例并发追踪
✦面板角色 / 语音音色均可自定义，一行配置烧录生效
Hardware Gallery
实物展示
CLOCK FORM · ESP32-C3 闹钟版
外观
灯光效果
使用场景
PANEL FORM · ESP32-S3 面板版
外观
屏幕显示
桌面场景
USE SCENARIOS · 使用场景实拍
使用场景 01
使用场景 02
使用场景 03
使用场景 04
Hardware Specs
四形态 硬件规格
PANEL FORM · ESP32-S3
面板版外观
屏幕展示
芯片ESP32-S3
屏幕ST7789 2.4" 320×240
触摸CST816S I2C
UI 框架LVGL
角色形象CAT / ROBOT / DUCK
DSHELL FORM · ESP32-S3
芯片ESP32-S3
屏幕ST7789 2.4" 320×240
触摸GT911 I2C
灯带WS2812×8 彩虹流水
UI 框架LVGL
角色选择CAT / ROBOT / DUCK
CLOCK FORM · ESP32-C3
闹钟版外观
灯光效果
芯片ESP32-C3
LEDWS2812B × 2 (ISR 驱动)
功放MAX98357A I2S
语音引擎豆包 TTS 200+ 音色
PCM 格式8kHz 单声道 16-bit
Quick Start
快速 上手安装
推荐方式
claude plugin install claude-buddy
一行命令，自动注册所有 Hook
离线：git clone …/claude-buddy-plugin → claude . | GitHub
方式一 · CLI 手动安装
安装 PC 依赖
pip install bleak websockets pyserial mpremote
生成 TTS 语音（clock 形态）
python scripts/gen_voice_assets.py
烧录固件到 ESP32
python scripts/flash_device.py --variant clock
烧录固件到 RP2040（WiFi 版）
python scripts/flash_device.py --variant wizfi360
BLE 配对 + 启动守护进程
python daemon/pair_device.py
python daemon/ble_daemon.py
python daemon/ble_daemon.py
注册 Hook + 验证
写入 settings.json · python daemon/smoke.py
方式二 · GUI 一键工具
推荐
setup_tool · 5 步完成烧录与配对
选硬件 → 连接 → 调参 → 烧录 → 配对
python -m setup_tool
# 或双击 dist/Claude_Assistant_Setup.exe
# 1. 给 ESP32 通电
# 2. 启动守护进程
$ python daemon/ble_daemon.py
# 3. 正常使用 Claude Code
设备自动跟随工具状态变化 ✨
Dev Tool
PC 端 设备模拟器
sim_device 实时状态监控 · 无需 ESP32 硬件即可调试
开发利器 — 无需硬件即可验证完整设备逻辑
3 终端启动（顺序不可错）
① python -m scripts.sim_device
启动模拟设备，循环重连 daemon:57321
② python daemon/ble_daemon.py --tcp-device
daemon 以 TCP 模式连接模拟设备
③ python scripts/sim_hooks_v5.py --no-daemon --skip-ble-check
发送测试事件，观察实时状态变化
4 种日志调试
per-dot sticky — 单槽位 C/P 粘滞
empty-slot hold — 空槽保持 dominant
sticky broken — W/E 打破粘滞
sticky dominant — global C/P 抗 I
python scripts/read_sim_log.py
# 4 文件 × 150 行循环轮转，自动排序
// 用户自定义
个性化配置 · /create-character
Skill · 创建面板角色
在 Claude Code 对话中输入 /create-character，AI 会引导你完成角色创建全流程。
描述需求
告诉 AI 想要什么形象（参考图/文字描述/像素图）
AI 生成代码
自动创建 device/char_<name>.py，含动画 + 5状态配色
自动注册
写入 device/config.py 的 CHARACTER 字段
重新烧录
运行 setup_tool 或 flash_device.py 即可看到新角色
# 在 Claude Code 中输入
/create-character
已内置 7 种角色 + 无限自定义
cat 猫robot 机器人
ghost 幽灵among_us
creeperkirby
pikachu
+ 自定义
其他自定义入口
语音音色
scripts/gen_voice_assets.py
scripts/gen_voice_assets.py
设备 Logo
scripts/logo_converter.py
scripts/logo_converter.py
行为参数
device/config.py
device/config.py
面板角色
/create-character
/create-character
预设角色预览 · 8 角色 × 5 状态（I/W/P/C/E）
# 无需设备，生成预览图
python scripts/preview_character.py
码克助手
让每一行代码，都有触感
让每一行代码，都有触感
Claude Buddy · MicroPython Claude Assistant
闹钟版 · 青色流水 Working
面板版 · 屏幕动画
v0.10.1
claude plugin install claude-buddy →