一、Vibecraft 简介：核心特色速览

Vibecraft 是一款基于 Three.js 和 TypeScript 开发的 Claude Code 可视化管理工具，其核心优势在于保留 Claude 原有的功能，优化交互体验，并且所有数据都保存在本地，确保隐私安全。

以下是几个令人耳目一新的核心亮点：

3D 可视化工坊：Claude 变身为具体角色，在不同工作区中灵活移动，整个过程透明可见。

空间音频与动画效果：不同位置传递空间音效，操作有即时反馈，成功提交时会“庆祝”，出错时则会“摇头”。

多实例管理：可同时运行多个 Claude 会话，切换十分方便。

丰富交互：支持语音输入、绘图标注等，远比原生终端灵活。

二、前期准备：环境要求与依赖安装

在使用之前，需要确认你的环境是否符合要求，Vibecraft 目前有明确的系统限制：

支持系统

仅支持 macOS 或 Linux（暂不支持 Windows，钩子脚本依赖于 bash）。

必备依赖

需要安装 Node.js 18 及以上版本、jq（处理钩子脚本）和 tmux（会话管理），根据自己的系统选择合适的安装方式。如果尚未安装 Node.js，建议通过 nvm 安装 18 及以上版本，避免权限问题。

三、两种安装方式：快速启动与源码部署

Vibecraft 提供两种安装方式，建议新手选择快速启动：

方式一：快速启动（推荐）

无需下载源码，只需执行配置钩子命令（仅需一次），启动服务后打开浏览器访问指定地址即可进入 3D 工坊界面。

方式二：源码部署（适合有自定义需求的用户）

克隆仓库后进入目录安装依赖，启动开发模式，然后访问相应的地址即可（注意端口与快速启动方式不同）。

四、核心功能详解：3D 工坊中的 AI 编程之旅

启动后，你将看到一个科技感十足的 3D 工坊界面，左侧 60% 为 3D 场景，右侧 40% 为活动日志，核心功能如下：

1. 八大工作区：Claude 的“专属工位”

工坊预设了 8 个功能各异的工作区，Claude 会根据需要自动切换，每个工位配有对应的工具和动画：

书架（Bookshelf）：用于读取文件。

书桌（Desk）：用于编写内容。

工作台（Workbench）：用于编辑代码。

终端（Terminal）：用于执行 bash 命令。

扫描仪（Scanner）：用于执行搜索命令。

天线（Antenna）：用于网络相关操作。

传送门（Portal）：处理子任务（生成迷你 Claude 并行工作）。

任务板（Taskboard）：用于编写待办事项。

2. 多 Claude 实例：提升并行处理效率

可以同时运行多个独立的 Claude 会话，轻松新建和配置会话信息，并迅速切换，还能查看所有会话的状态（空闲/工作中/离线）。每个会话在独立进程中运行，关闭浏览器后仍可在后台工作，下次打开即可恢复。

3. 酷炫交互：超越编程的操作体验

Vibecraft 的交互设计令人惊艳，使编程变得更加生动：

语音输入：开启后支持实时转录（需 Deepgram API 密钥）。

绘图模式：可选择颜色、调整画笔大小，添加 3D 堆叠效果。

快捷操作：右键点击工作区可快速查看信息或输入命令。

状态反馈：工作区会脉冲提示需求，操作时伴有音效反馈。

分屏布局：左侧 3D 场景随 Claude 移动，右侧记录所有操作和响应。

五、卸载方法与注意事项

在不使用时，可以通过简单命令卸载，卸载仅会移除钩子脚本，不会删除数据。

确保依赖正确安装，否则可能导致会话创建失败或钩子失效。

语音输入需申请 Deepgram API 密钥，可以使用免费额度。

在多会话运行时要注意系统资源占用，避免实例过多。

可自定义端口启动。

六、总结：值得尝试的 AI 编程增强工具

Vibecraft 最令人印象深刻的是在不牺牲功能性的情况下，大幅提升了 AI 编程的趣味性和可视化程度。对于经常使用 Claude Code 的开发者而言，它不仅使操作更加直观，多实例管理和丰富的交互也能显著提升工作效率。

虽然当前在 Windows 系统上使用尚不可行，但未来有望实现这一功能。若您是 macOS 或 Linux 的用户，希望让 AI 编程更加炫酷和高效，绝对值得一试！

项目链接：https://github.com/Nearcyan/vibecraft