AI news

10 分钟教会你制作专属「Claude Code 状态灯」

By AI Humanist by杉森楠0 viewsSource: AI Humanist by杉森楠
10 分钟教会你制作专属「Claude Code 状态灯」

昨天折腾了大半天,我终于把一个会发光的小硬件「烧」好了,给它起了个名字叫 Claude Code Light ,非常炫酷: 它能跟着 Claude Code 的 Hooks 自动换灯效。也就是说,Cl

The full text has not been translated yet. The Chinese original is shown below.

昨天折腾了大半天,我终于把一个会发光的小硬件「烧」好了,给它起了个名字叫Claude Code Light,非常炫酷:

文章配图

它能跟着 Claude Code 的 Hooks 自动换灯效。也就是说,Claude Code 干活干到哪一步,它就用对应的灯光提醒我现在到了哪一步。

做它的理由是因为 Claude Code 干起活来经常要好几分钟,中途还会停下来等我授权。我一般会切到别的窗口忙自己的,结果它早就停在那等我了,我往往还注意不到,经常耽误时间。

有了这盏灯,它现在是什么状态,我扫一眼桌面就知道,不用一直盯着屏幕。

文章配图

说起来,做它的起因是前两天刷抖音,老是看到下面这个 Claude 红绿灯,挺火的。它的功能很简单,当 Claude Code 执行任务、等你批准的时候,红绿灯上对应的那颗灯就会亮起来:我一看就觉得挺好玩。

我最近又正好迷上了硬件 DIY,而且我发现身边不少朋友、群里的群友,都说不太清楚这种灯到底怎么做出来,但都想玩,只是看着好像挺复杂。

我自己研究了一下,发现整套做下来并不难。

拿这种 Claude Code 红绿灯来说,要凑齐的零件大概有:一个红绿灯模块、一块 ESP32 开发板、几个电阻、几根飞线、一根数据线,再加一套焊接工具。

文章配图

这么一看还是挺麻烦,得手动焊接,一根线一根线接,太费事,不合我「能不找麻烦就不找麻烦」的做事原则。

于是我又上网搜了搜,看有没有更省事的做法。

还真给我找到了:

文章配图

淘宝上现在有一种成品灯板,从灯珠到 ESP32 开发板全都帮你焊好了。这样就简单多了,一根 Type C 线把灯板和电脑连起来,直接在电脑上用 Claude Code 给它写软件就行。

可能有朋友还没听过 ESP32,我先用一句话把它说清楚。

它就是一块很小、很便宜的微型电脑芯片,专业叫法是单片机,巴掌大小都不到,自己带着计算能力,还能连 Wi-Fi 和蓝牙。我们平时用的智能插座、小台灯、各种智能小硬件,里面用的很多就是它。

文章配图

你可以把它当成这块灯板的「大脑」。灯珠只管发光,ESP32 来指挥它们什么时候亮、亮成什么颜色、怎么切换。

整条逻辑串起来很好懂。

Mac 电脑是「总指挥」,ESP32 是灯板上的「小大脑」,灯珠是「手脚」。我们先用 Claude Code 在电脑上写好一段程序,再通过 Type C 线把它写进 ESP32 这个小大脑里,这一步叫烧录固件。

之后只要电脑和灯板还连着,电脑就能随时给小大脑发指令,比如「显示蓝色循环」「红色闪烁」,小大脑收到后就指挥灯珠照做。

文章配图

整个过程你不用懂电路,也不用会编程,剩下的活基本都交给 Claude Code。

等于说,焊接这些硬件活我们全省了。

我买的是一块一体化的环形灯板,上面是 ESP32-C3 加 24 颗 WS2812 幻彩灯珠。淘宝上卖这种板子的店铺很多,一块也就二三十块钱,USB-C 直插电脑,完全不用焊。

这里的 WS2812 是一种很常见的可编程灯珠,每一颗都能单独控制颜色和亮度,所以才能做出彗星旋转、呼吸这些花样。

24 颗排成一圈,点起来一整环都会亮,比单色灯好看不少。

文章配图

下面这个表格,对比了前面那套复杂红绿灯和我现在用的方案。我这个方案虽然没有红绿灯的三色切换,但灯效更酷。

话不多说,直接上流程。

灯板到手以后,拆开包装,用一根 Type C 线把它和 Mac 连起来就行。

接下来所有操作都在 Claude Code 里完成,硬件这边你基本不用再管。

真正上手以后,从插线到第一次看见灯亮起来,前后也就十来分钟,剩下的时间都花在慢慢调自己喜欢的灯效上。

第一件事,是给这块硬件写程序、烧录固件。这里有两种办法,先说手动的这种。

先下载一个Arduino IDE,它是专门给这类单片机写程序、烧录固件的工具,免费,装上就能用。

Arduino IDE 的下载地址在这里 ——

https://www.arduino.cc/en/software

文章配图

装好以后,还要给它加上 ESP32 开发板的支持。前面说过,ESP32 就是嵌在灯板正中间的那块开发板,Claude 写的所有程序,最后都要写进它里面。

打开 Arduino IDE,进菜单 → Settings(或 Preferences),在 「Additional boards manager URLs」这一栏里填入下面这串地址:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

文章配图

加这一步是因为,Arduino IDE 默认只认它自家品牌的板子,而我用的灯板是 ESP 系列芯片,不在默认列表里。填上这串 URL,等于告诉 IDE 去这个地址下载 ESP32 系列芯片的编译工具和驱动。下载完,它才认得我这块 ESP32-C3。接着走菜单 → Tools → Board → Boards Manager,搜索 esp32,装上 「esp32 by Espressif Systems」,注意别选成 Arduino 那个:

文章配图

上面这套手动流程确实有点繁琐。好在还有一个全自动版本,我发现 Arduino 带命令行工具(CLI),可以直接交给 Claude Code 来配置。

做法很简单,用 Homebrew 装一下arduino-cli。

装好后,用 USB-C 数据线把灯板接到电脑上,再让 Claude 把固件代码和电脑这端的脚本都准备好。

我后面用的就是这种。

文章配图

【第一步】配置灯板

灯板插上电脑后,第一步就是配置它,让 Claude 拿到并掌控灯板的各项参数,这样我们才能在电脑上遥控它的灯效。

比如我在电脑上让它显示蓝色循环,它就得这么转 :

文章配图

这一步可能会有点麻烦。大家买到的 ESP32 和灯珠,型号、版本各不相同,对应的引脚也不一样。刷固件的时候就得多费点事,可能要一个一个去试,才能对上你这块灯板。

这是我买的这块板子的硬件参数 :

文章配图

其中最麻烦的是数据引脚。

GPIO 简单理解就是芯片上一个个小针脚,灯珠的数据线接在哪个针脚上,固件里就得填哪个编号,填错了灯要么不亮,要么乱闪。这也是前面说要一个一个去试的原因。

我这块灯板用的是GPIO 3,只要让 Claude Code 把这一步配置好,后面就轻松了。

等引脚和灯珠型号都确认无误,Claude 就把正式固件烧进去。到这一步,灯板就配置好了,变成一块特别「听话」的硬件。以后电脑这端发什么颜色、什么动画的指令,它就显示成什么样。

整个烧录固件的流程,并没有多复杂。

【第二步】把灯效接到 Claude Code 的状态上

灯板刷好、灯效也能随意控制以后,下一步就是把它和 Claude Code 的状态连起来。意思是,Claude Code 在思考、执行任务、等你回复、等你授权、完成或者出错,这些不同状态,都用不同的灯效在灯板上显示出来。

这一步比较简单,整体是一个三层架构,把 Claude Code 的 hooks 和灯板芯片连起来,全程交给 Claude Code 就行 :

文章配图

当然,灯效和对应的触发时机得你自己先设好。比如 Claude Code 在思考时,我设的是蓝色彗星旋转,执行工具时是脉冲效果,等待回复、完成、出错也各有各的灯效。

文章配图

整条链路是这样走的:

Claude

Code

hook → notify.sh(nc) → daemon → ESP32 → 灯环

全程异步,在后台执行,完全不拖慢 Claude。

【第三步】拔掉数据线,用蓝牙连

前面这条路线,灯板一直用 Type C 插在电脑上。玩通这条路之后,我发现这块灯板还能走蓝牙,也就是 BLE 通信。

文章配图

你可以直接让 Claude 帮忙跟灯板配对,它调用的是苹果的CoreBluetooth框架,再由系统的 bluetoothd 控制蓝牙硬件。

走蓝牙最大的好处是桌面能清爽一点,灯板不用再用线拴在电脑上,摆到显示器旁边、桌角都行,只要在蓝牙范围内就能正常变灯。

文章配图

【第四步】做一个自己的调色台

到这里,灯板就完全配置好、也能随心控制了。为了改灯效更方便,我还顺手做了一个控制台,一个手动调色台。

文章配图

这个控制台的主要功能,是给每一个状态单独配色。里面做了五种灯效模式,常亮、呼吸、脉冲、彗星旋转、闪烁,每一种都挺酷。

我自己会按习惯来配,思考用冷色让自己安心,等授权和出错用最扎眼的红、黄,余光一扫就能反应过来。配色这件事没有标准答案,调成你一眼能区分的就好。

文章配图

具体效果像下面这个黄色脉冲:

文章配图

文章配图

再比如出错的时候,它会亮起红色闪烁,提醒我出问题了:

文章配图

文章配图

颜色可以在调色板上随便选。不过受灯珠硬件限制,它能显示的颜色种类没那么多。我在电脑上随手拖一下颜色,灯板就跟着变化:上面是一步步的完整流程。我也清楚,不少朋友看下来还是会觉得有点复杂。所以我专门把这些步骤,连同自己总结出的避坑经验,都封装成了一个 Skill,名字就叫Claude Code Light。

它一共 8 步,从装工具链一直到做好控制台,全程都帮你做好:

文章配图

这个 Skill 已经开源到 GitHub,一行命令就能装好:

git clone https://github.com/cylqwe7855-alt/claude-code-light.git ~/.claude/skills/claude-code-light

文章配图

最后,祝大家玩得开心!😊

看到这里,辛苦啦。

感谢你的阅读和「在场」!

文章来自于微信公众号 “AI Humanist by杉森楠”,作者 “AI Humanist by杉森楠”

Related topics

After reading

Join the AINRK community

Read how to join the community and connect with people working in AI.

Community information (opens in a new tab)