Anima 是一款面向 Claude Code 的原生 macOS 客户端,并在其基础上加入“小伙伴”(Buddies)系统。它将 Claude Code 作为子进程启动,通过 stream-json 管道传递消息,在自己的界面中渲染消息并管理会话,因此它本身就是界面而非从外部观察 Claude Code。
用途 Anima 旨在为使用 Claude Code 的开发者提供更集中、更直观的会话管理与监督体验。它解决了终端内基础“小伙伴”无法跨会话观察、无法记住历史、评论来自小模型且文本不可复制的局限。
主要能力
- 多会话仪表盘:在一个窗口内查看所有 Claude Code 会话,快速识别哪些正在工作、哪些已完成、哪些在等待用户操作。
- 跨会话监视器:Rust 守护进程同时监控所有活跃会话的工具调用模式,实时捕捉重试循环和大量读取的螺旋,并在发现时由小伙伴给出提醒。
- 持久化伙伴:每个项目拥有独立的 ASCII 生物,具有物种、稀有度和属性;每次会话自动累积 nim 代币(每 1000 代币获得 1 nim),消耗 nim 可重掷以获得新物种、稀有度和性格。同一项目始终生成相同的小伙伴。
- 预言家评论:小伙伴的观察通过完整 Claude 模型运行(而非 /buddy 使用的小模型),评论文本可选中并直接粘贴回会话。评论以短背景提示方式运行,最多并发 2 个调用,所有处理均在本地进行,除了你原本会进行的 API 调用外不离开你的机器。
- 会话历史:可回放过去的对话,无需翻找 JSONL 文件,数据由 JSONL 支持。
- 语音输入:支持蓝牙麦克风和按键通话,通过 WebSocket 桥接实现免手操作 Claude。
- 模型与努力级别覆盖:可在界面中按会话切换模型和努力级别。
- 收集式伙伴卡片:每个项目获得一张属性卡,包含物种、稀有度、能力评级和会话历史。
使用方式
- 安装并认证 Claude Code:npm install -g @anthropic-ai/claude-code 然后 claude login。
- 从源码构建(当前未发布签名的 .dmg): git clone https://github.com/btangonan/anima cd anima git lfs install && git lfs pull nvm use && npm install npm run tauri dev
- 将应用指向项目目录并开始会话。
- 首次会话生成小伙伴,nim 自动累积。
适用场景 适用于使用 Claude Code 进行开发、希望跨会话监控工具调用模式、避免陷入重复循环、并想要更丰富交互反馈的 macOS 用户。也适合喜欢收集和装饰性元素(ASCII 伙伴、属性卡、代币经济)的开发者。
限制与要求
- 系统要求:macOS 13 Ventura 或更高版本,Apple Silicon。
- 需要已认证的 Claude Code CLI:claude login。
- Node.js 20 LTS(由 .nvmrc 固定,克隆后运行 nvm use)。Node 22+ 会触发 vitest #8757;在这些版本上运行测试需使用 NODE_OPTIONS=--no-webstorage npm test。
- 需要 Git LFS:在克隆时必需,捆绑的语音 sidecar 二进制文件由 LFS 跟踪。
- 需要 Rust 工具链(rustup)和 Xcode Command Line Tools(xcode-select --install),用于 npm run tauri dev 和 npm run tauri build。
- 语音功能可选且默认关闭。未启用时指示器为灰色,其余功能(会话、伙伴、预言家、nim、历史、斜杠菜单)完全可用。捆绑的 anima-stt sidecar 通过 LFS 提供但默认禁用(缺少 mlx_whisper),待其可用后可通过 ANIMA_SKIP_BUNDLED_STT=0 启用。若要在当前使用实时语音,请在启动 Anima 前将外部 WebSocket STT 桥接指向 ws://127.0.0.1:9876。
- 当前为 alpha 软件,个人项目,可能发生破坏性变更。
- 生产构建目前未签名,macOS Gatekeeper 首次启动会警告。
- 技术架构:Tauri v2 桌面应用,前端为原生 JavaScript(无框架、无打包器),Rust 后端处理文件 I/O、路径安全、伙伴同步和跨会话监视器。监视器(daemon.rs)是一个 Tokio 异步循环,轮询 Claude Code 的会话流,跟踪所有活跃会话的工具序列,并在模式触发时通过 Tauri 事件发出伙伴评论。预言家(伙伴气泡背后的声音)是一个 claude -p 子进程,注入来自伙伴物种和属性的性格上下文。完整架构见 docs/architecture.md。
许可:MIT © Bradley Tangonan。