
claude-knock闹钟/码克助手
简介
将 Claude Code 的工具执行状态实时可视化为 ESP32 桌宠设备——通过 BLE 推送状态,转化为灯光闪烁、语音播报、屏幕动画,让代码执行过程触手可及。
简介:将 Claude Code 的工具执行状态实时可视化为 ESP32 桌宠设备——通过 BLE 推送状态,转化为灯光闪烁、语音播报、屏幕动画,让代码执行过程触手可及。开源协议
:MIT License
描述
MicroPython Claude Assistant(码克助手)
做开发的时候,你有没有这样的经历——Claude Code 正在跑一个长任务,你不确定它是在思考、在写代码、还是已经跑完了,于是你每隔十几秒就切回终端看一眼。有时它卡在一个审批上等你确认,而你还在另一篇文章里翻找,一转头十分钟过去了。如果跑的是 pytest,你甚至不敢离开座位太久,怕错过报错信息。
这些场景每天都会发生。码克助手的闹钟版(Clock) 就是来解决这个问题的——一个放在桌角的硬件小设备,通过灯光颜色和语音播报,让你不用盯着终端也知道 Claude Code 正在做什么。



它的工作方式很直接:设备通过 BLE 蓝牙和 PC 上的守护进程保持连接。Claude Code 每执行一个工具——无论是读取文件、运行命令还是搜索代码——状态都会实时推送到这个桌面设备上。蓝色灯光代表空闲待命,青色流水表示正在执行,黄色慢闪提醒你有审批待处理,绿色快闪告诉你任务完成,红色交替闪说明出了错误。每种状态变化都有对应的语音播报,用豆包 TTS 引擎合成,音色可选,语速语调可调。
这意味着什么?意味着你可以在 Claude Code 跑批量任务的时候安心做别的事。跑去倒杯咖啡,听到设备说"任务完成啦"就知道可以回来检查结果。工作到一半切出去查资料,黄灯闪起 + 语音"请查看终端"提醒你有审批需要处理。深夜写代码不想被灯光打扰,语音播报也能让你感知任务进度而不需要转头看屏幕。这其实就是把 Claude Code 的执行状态从屏幕上延伸到了物理空间里——用你的余光、用你的耳朵去感知,而不是用手指去点击切换窗口。

闹钟版的硬件本身非常简洁。ESP32-C3 芯片驱动两颗 WS2812B LED 灯珠和一个 MAX98357A 扬声器,装在一个小盒子里放桌上不占地方。整个设备只需要 USB 供电,烧录和配置走 GUI 工具,两步就能搞定。你也可以自己换语音音色(豆包两百多种音色可选),设备背后没有需要学习的管理页面,没有订阅服务,也没有远程服务器依赖——所有通信都在你的局域网和蓝牙链路内完成。


相关链接
项目链接:https://github.com/FreakStudioCN/MicroPython_Claude_Assistant_Public
介绍页面:https://claude.freakstudio.cn/
Github Pages:https://freakstudiocn.github.io/MicroPython_Claude_Assistant_Public/presentation.html
相关演示视频可看:https://www.bilibili.com/video/BV1SNEc6YEdV/?spm_id_from=333.1387.homepage.video_card.click

设计图
未生成预览图,请在编辑器重新保存一次BOM
暂无BOM
克隆工程知识产权声明&复刻说明
本项目为开源硬件项目,其相关的知识产权归创作者所有。创作者在本平台上传该硬件项目仅供平台用户用于学习交流及研究,不包括任何商业性使用,请勿用于商业售卖或其他盈利性的用途;如您认为本项目涉嫌侵犯了您的相关权益,请点击上方“侵权投诉”按钮,我们将按照嘉立创《侵权投诉与申诉规则》进行处理。
请在进行项目复刻时自行验证电路的可行性,并自行辨别该项目是否对您适用。您对复刻项目的任何后果负责,无论何种情况,本平台将不对您在复刻项目时,遇到的任何因开源项目电路设计问题所导致的直接、间接等损害负责。










