大家好，我是Java1234_小锋老师。
今天分享一个非常不错的开源中间件 - OpenWolf ，专门给 Claude Code 用的，能大大降低你的Token消耗量。

先说结论：它到底省在哪？

如果你经常用 Claude Code 写代码，账单可能比你想象的大。

官方 README 里有一组真实项目对比数据（同一套代码、同一批提示词）：

方案	大约 Token 消耗
OpenClaw + Claude	~340 万
裸 Claude CLI（无 OpenWolf）	~250 万
OpenWolf + Claude CLI	~42.5 万

也就是说，相比直接裸跑 Claude CLI，OpenWolf 大约能省 80% 的 Token。在 20 个项目、132+ 次会话的统计里，平均降幅也有 65.8%，重复读文件被拦截的比例约 71%。

当然，具体数字会因项目大小和使用习惯而不同，但方向是明确的：少读、少重复、有记忆。

---

OpenWolf 是什么？

OpenWolf 是一个开源中间件，专门给 Claude Code 用的。作者团队来自 Cytostack，他们在日常开发中发现：Claude 很强，但有点"盲"——不知道文件里写了什么就得打开看，同一份文件可能反复读好几遍，也没有项目地图和纠错记忆。

OpenWolf 的定位很直白：给 Claude 装一个"第二大脑"。

它不是什么 AI 套壳，也不是替代 Claude 的工具。核心就是 6 个 Hook 脚本 + 项目里的 .wolf/ 目录。你照样用 claude 命令，OpenWolf 在后台默默干活，零工作流改动。

目前在 GitHub 上已有 1700+ Star，开源协议为 AGPL-3.0。

---

为什么 Claude Code 会"烧钱"？

用过 AI 编程的人大概都有同感：

• 找一个小函数，可能扫半个目录
• 同一个配置文件，一轮对话里读了三四次
• 你上周纠正过的写法，这周它又犯
• 到底花了多少 Token？心里没数

Token 就是钱。读得越多、重复越多，账单就越难看。

OpenWolf 要解决的，就是这几件具体的事。

---

它是怎么做到的？

整体流程可以理解为一条"隐形流水线"：

你输入一句话
    ↓
Claude 想读某个文件
    ↓
OpenWolf：anatomy.md 里写着，这个文件大约 380 Token，内容是入口模块
    ↓
Claude 决定要不要真的打开
    ↓
OpenWolf：记录这次读取，如果重复读会提醒/拦截
    ↓
Claude 写代码
    ↓
OpenWolf：查 cerebrum.md，看有没有踩过的坑
    ↓
会话结束
    ↓
OpenWolf：更新项目地图、写日志、更新 Token 账本

几个关键机制：

1. 项目地图（anatomy.md）
每个文件都有简介和 Token 估算。Claude 先看摘要，够用了就不开文件，省一大笔。

2. 学习记忆（cerebrum.md）
你纠正它、表达偏好、做决策时，会沉淀下来。还有"不要再犯"清单，跨会话生效。

3. Token 账本（token-ledger.json）
每次会话读了什么、写了什么，都有记录。能直观看到 OpenWolf 到底帮你省了多少。

4. Bug 记忆（buglog.json）
修过的 Bug 存起来，下次遇到类似报错，先查有没有现成方案，避免重复踩坑。

5. 六个 Hook
挂在 Claude Code 生命周期上，读文件前、写文件前、写文件后都会触发，全程自动化。

---

三分钟上手

要求：Node.js 20+，已安装 Claude Code CLI。Windows / macOS / Linux 都支持。

npm install -g openwolf
cd your-project
openwolf init

就这三步。之后正常用 claude 即可，OpenWolf 已经在旁边看着了。

常用命令：

openwolf status      # 看健康状态和统计
openwolf scan        # 刷新项目结构地图
openwolf dashboard   # 打开 Web 仪表盘（默认 http://localhost:18791）
openwolf update      # 更新到最新版

---

.wolf 目录里有什么？

执行 openwolf init 后，项目根目录会出现 .wolf/，主要文件如下：

文件	作用
anatomy.md	项目文件地图，含描述和 Token 估算
cerebrum.md	学习记忆：偏好、纠错、决策记录
memory.md	按时间线的操作日志
buglog.json	Bug 修复记忆，可搜索
token-ledger.json	全生命周期 Token 统计
hooks/	6 个 Claude Code 生命周期 Hook
config.json	配置文件
OPENWOLF.md	每次会话 Claude 会遵循的指令

这些文件既是给 Claude 看的"外挂大脑"，也是给你自己查账、查历史的依据。

---

几个实用功能

Web 仪表盘
openwolf dashboard 可以打开实时面板，包括活动时间线、Token 对比图表、Bug 日志浏览、项目地图树形视图等，支持深色/浅色主题。

Design QC
自动截取开发中页面的全页截图，让 Claude 做 UI/UX 评审，适合前端同学。

Reframe
内置 12 套 UI 框架（shadcn/ui、Magic UI、DaisyUI 等）的迁移知识库，帮你选框架、写迁移提示词。

定时任务
支持 openwolf daemon 后台调度，比如每周自动生成项目改进建议。

---

适合谁用？有什么要注意的？

适合：

• 长期用 Claude Code 做项目开发的个人或团队
• 中大型代码库，文件多、Token 消耗明显
• 希望 Claude “越用越懂项目” 的人

需要注意：

• Claude Code 的 Hook 机制还比较新，极端情况下可能回退到 CLAUDE.md 指令模式
• Token 统计是估算值（字符换算），和 API 精确账单可能有 ~15% 偏差
• cerebrum.md 依赖 Claude 自觉更新，合规率大约 85–90%
• 当前版本 v1.0.4，生产环境建议先在小项目试水

---

写在最后

Claude Code 已经是很多开发者离不开的工具，但"会用"和"用得省"之间，差的就是一层上下文管理。

OpenWolf 做的事情并不花哨：让 AI 少做无用功，让项目知识留下来，让 Token 花得明明白白。

如果你也在为 Claude 账单发愁，不妨花三分钟 openwolf init 试一下。开源免费，Star 已经说明了不少人的认可。

👉 项目地址：https://github.com/cytostack/openwolf