ESP32+OLED打造Claude Code状态监控桌面摆件

再也不让Claude Code默默等你十分钟

用Claude Code写代码时，最让人抓狂的场景之一就是：它弹出了授权确认框，你却浑然不知，等回过神来发现它已经静静等了你十分钟。Claude Code在执行可能影响文件系统、运行shell命令或访问网络等敏感操作时，会弹出授权确认框要求用户明确同意——这是一种安全设计，防止AI在无人监督的情况下执行破坏性操作。但在实际使用中，频繁的授权请求会打断工作流，尤其是当用户切换到其他任务时，Claude Code可能在后台静默等待数分钟甚至更久。

现在，一位B站UP主用一块ESP32C3加0.96寸OLED小屏幕，做出了一个桌面时钟摆件，能实时显示Claude Code的工作状态——关键是，当Claude Code需要授权时，屏幕会闪烁提醒，眼角余光就能捕捉到。

硬件方案：极简但实用

整个项目的硬件成本极低，只需要两个核心组件：

• ESP32C3开发板：一款基于RISC-V架构的低功耗WiFi/蓝牙微控制器，由乐鑫科技（Espressif）推出，价格通常在十几元。相比传统ESP32采用的Xtensa架构，RISC-V是一种开源指令集，近年来在物联网领域快速普及。ESP32C3集成了2.4GHz WiFi和蓝牙5.0（LE），拥有400KB SRAM和4MB Flash，主频160MHz，足以胜任网络通信和显示驱动任务，深度睡眠功耗仅5μA，非常适合需要长期运行的桌面设备。
• 0.96寸OLED屏幕：经典的小尺寸显示屏，分辨率128x64，通常采用SSD1306驱动芯片，通过I2C或SPI协议与微控制器通信。OLED（有机发光二极管）与传统LCD的最大区别在于它是自发光的，不需要背光层，因此在显示黑色时完全不耗电，对比度极高。由于自发光特性，屏幕闪烁时的视觉冲击力远强于LCD，这也是它特别适合用作状态提醒的原因。

这套组合是嵌入式爱好者的经典搭配，体积小巧，放在桌面上不占空间，同时功耗极低可以长期运行。开发者通常使用Arduino框架或ESP-IDF（乐鑫官方SDK）进行编程，生态成熟，社区资源丰富。屏幕虽小，但显示时间、工作状态和简短提示词绰绰有余。

安装流程：让Claude Code自己装自己

这个项目最巧妙的设计在于安装方式——作者把整个安装流程写成了一个skill文件，让Claude Code读取后自行完成安装。

Skill文件是Claude Code的一种配置机制，本质上是一个Markdown格式的指令文档，存放在项目的.claude/目录下。当Claude Code启动或被要求执行特定任务时，它会读取这些skill文件作为上下文指引，理解应该如何完成某类操作。这种设计将复杂的安装流程（如依赖安装、固件编译、串口烧录等）编码为自然语言描述的步骤，Claude Code据此自主执行命令行操作。这实际上是一种"基础设施即文档"的思路——把运维流程变成AI可以理解和执行的指令集。

整个过程只需要一句话：

"帮我安装一下"

Claude Code会根据skill文件的指引，自动完成以下步骤：

软件烧录

1. Claude Code读取skill文件，理解安装流程
2. 安装期间的询问选择让它全部自动完成
3. 等待1-2分钟完成固件烧录

WiFi配置

烧录完成后，OLED屏幕会显示一个IP地址：

1. 用浏览器打开该IP地址
2. 进入WiFi连接配置页面
3. 输入WiFi名称和密码
4. 选择时区（中国为东八区，选择8）
5. 点击保存，设备开始连接WiFi

连接成功后，屏幕会正常显示当前时间，此时桌面时钟的基础功能已经就绪。

核心功能：实时状态监控

工作状态显示

当你向Claude Code输入提示词后，OLED屏幕会实时切换显示：

• Working：表示Claude Code正在处理任务
• 提示词内容：显示你当前发送的指令摘要
• 时间显示：空闲时作为普通桌面时钟使用

授权闪烁提醒

这是整个项目最核心的痛点解决方案。当Claude Code弹出授权确认框、停下来等待用户操作时，OLED屏幕会开始闪烁。即使你在看其他屏幕、翻手机，眼角余光也能注意到闪烁的光，及时回来处理授权请求。

用户虽然可以选择逐次授权、对某类操作批量授权，或在启动时使用--dangerously-skip-permissions标志跳过所有确认，但出于安全考虑，大多数开发者仍然选择保留授权机制。这就使得物理提醒设备成为一个兼顾安全与效率的折中方案。

扩展功能

除了Claude Code状态监控，这个小摆件还支持：

• 显示股票价格
• 显示加密货币代币价格
• 其他自定义功能（代码已开源）

技术思考：物理反馈的价值

这个项目虽然简单，但它解决了一个真实的效率问题。在使用AI编程助手时，我们经常需要在多个窗口间切换，而AI助手的等待状态很容易被忽略。软件层面的通知（如系统弹窗、声音提醒）在专注工作时往往会被忽略或关闭，而一个持续闪烁的物理设备，提供的是一种"环境感知"级别的提醒——你不需要主动去看，它就在你的视野边缘。

这种设计理念与"环境感知计算"（Ambient Computing）一脉相承，其核心思想最早可追溯到Mark Weiser在1991年提出的"普适计算"（Ubiquitous Computing）：信息应该融入环境，而非要求用户主动查看屏幕。类似的商业产品包括Luxafor的USB状态灯、LaMetric智能时钟，以及开发团队常用的CI/CD构建状态灯。认知心理学研究表明，物理设备提供的"外周注意力"（Peripheral Attention）反馈，比软件通知更不容易导致注意力中断，同时又能有效传递状态信息。

这种思路也可以延伸到其他场景：CI/CD构建状态、服务器监控告警、长时间任务完成通知等，都可以通过类似的物理设备来提供非侵入式的状态反馈。

动手尝试

项目代码已经开源，硬件成本不到30元，安装过程甚至可以让Claude Code自己完成。如果你是Claude Code的重度用户，这个小摆件值得一试。当然，你也完全可以基于开源代码，开发自己想要的功能——毕竟，让AI编程助手帮你写一个监控AI编程助手的工具，本身就很有趣。