Vibecraft 是什么
一句话:给 Claude Code 装一个 3D 可视化工作台。Claude 在用哪些工具、在处理什么文件、当前在干嘛——全都能在屏幕上看到。
GitHub 上 1,400+ star,MIT 协议。作者 Nearcyan。
官网在这里:vibecraft.sh,可以直接在线体验,连接到你本地的 Claude Code 实例。
怎么玩的
启动 Vibecraft 后,你会看到一个 3D 小作坊。Claude 在里面像个小人一样走来走去:
- 在 Desk(书桌) 写代码
- 在 Terminal(终端) 跑命令
- 在 Workbench(工作台) 编辑文件
- 在 Scanner(扫描仪) 搜索代码
- 在 Antenna(天线) 联网搜索
- 在 Portal(传送门) 派发子任务
每个站台对应 Claude Code 的一种能力。Claude 用到什么工具,就会走到对应的工作站前面。你能看到他正在读哪个文件、跑什么命令、在想什么。
不只是好看
Vibecraft 不只是用 Three.js 做了个好看的界面,它还有一些实实在在好用的功能:
多实例管理。可以同时跑多个 Claude,每个在不同目录、不同任务。按 1-6 键切换会话,Alt+N 新建。每个会话有独立的状态追踪(空闲/工作中/离线)。
Browser Control。Claude 跑在 tmux 里,你可以在浏览器里给 Claude 发提示词。不用切回终端。
取消按钮。想中断 Claude 的当前操作?点一下取消就行,相当于发了 Ctrl+C。
注意力系统。某个会话需要你注意或者完成了任务,对应的区域会闪烁提醒。
Draw Mode。按 D 进入绘图模式,可以在 3D 场景的六边形格子上涂色、堆叠、加文字标签。
语音输入。支持语音输入提示词(需要 Deepgram API key),可以直接说话指挥 Claude。
Spatial Audio。空间音效——你能"听到"Claude 在哪个方位工作。
怎么装
安装非常简单:
# 1. 装依赖
brew install jq tmux # macOS
# sudo apt install jq tmux # Ubuntu
# 2. 配置 hooks
npx vibecraft setup
# 3. 启动
npx vibecraft
打开 http://localhost:4003 就能看到你的 Claude 小作坊了。
从源码启动也可以:git clone 后 npm install && npm run dev。
卸载也简单:npx vibecraft uninstall,只移除 hooks,不删你的数据。
注意事项
- 只支持 macOS 和 Linux,Windows 不支持(hooks 需要 bash)
- 需要 Node.js 18+
- Claude Code 还是要装 Anthropic 的官方 CLI 工具,Vibecraft 是可视化前端
- 所有操作都在本地,文件和提示词不会上传
我的看法
Vibecraft 解决的问题很微妙——Claude Code 跑起来的时候,你其实不知道它在干什么。终端在刷日志,但你很难直观感受到"哦,它现在在搜索代码,然后去编辑文件了"。
Vibecraft 把这种不可见的工作流变成了可视化的、甚至带点游戏感的体验。看着你的 AI 助理在小作坊里走来走去忙活,确实比盯着一堆终端日志舒服多了。
而且它的多实例管理是真的有用——不是噱头。同时跑几个 Claude 做不同任务,在浏览器里切换指挥,体验比开一堆终端窗口好太多。
如果你在用 Claude Code,值得装上试试。反正 npx vibecraft 跑起来也不费事。