案例 OpenWolf：为Claude Code打造第二大脑，节省80% Token消耗的开源神器

2026-05-09 07:18:49 +0800 CST views 9

炸裂！OpenWolf 开源终极省钱神器，为Claude Code打造第二大脑，节省80% Token消耗

GitHub: https://github.com/cytostack/openwolf
Stars: 1.4k stars
标签: Claude Code / Token优化 / 第二大脑 / 钩子脚本 / AI编程效率
作者: Farhan Palathinkal Afsal - Cytostack
协议: AGPL-3.0

引言

Claude Code 很强大，但它「盲目」工作。

它不知道一个文件包含什么，直到打开它。它分不清 50 Token 的配置文件和 2000 Token 的模块。它在同一次会话中反复读取同一个文件而不自知。它没有项目索引，没有你的偏好记忆，也没有对已尝试内容的感知。

OpenWolf 就是来解决这个问题的——给 Claude Code 打造一个「第二大脑」，通过 6 个钩子脚本，在零工作流改变的前提下，节省 80% 的 Token 消耗。

一、项目简介

是什么

OpenWolf — A second brain for Claude Code.

OpenWolf 是一个开源中间件，为 Claude Code 提供项目索引、Token 追踪和透明执行。

6 个钩子脚本，一切都是「隐形」的。

核心定位

不是 AI 包装器：不改变你的工作方式
不是另一个 AI 工具：它是 Claude Code 的增强层
是第二大脑：让 Claude Code 知道文件内容、记住偏好、追踪 Token

实际数据

在大型活跃项目上测试（相同代码库、相同提示词、不同设置）：

配置	Token 消耗
OpenClaw + Claude	~3.4M tokens
Claude CLI（无 OpenWolf）	~2.5M tokens
OpenWolf + Claude CLI	~425K tokens

OpenWolf 相比裸 Claude CLI 节省约 80% Token。

横跨 20 个项目、132+ 个会话的实测数据：

平均 Token 减少 65.8%
重复文件读取拦截率 71%
这些是真实使用数据，不是跑分。

二、快速上手

安装

npm install -g openwolf

初始化

cd your-project
openwolf init

完成。就是这么简单。

正常用 Claude 就好，OpenWolf 在后台监控一切。

三、核心功能

1. 六个隐形钩子脚本

OpenWolf 在 Claude Code 生命周期的每个关键时刻自动触发钩子：

你发了一条消息
    ↓
Claude 决定读取某个文件
    ↓
OpenWolf: "anatomy.md 显示这个文件约 380 token。描述：主入口文件。"
    ↓
Claude 读取文件
    ↓
OpenWolf: 记录读取、估算 Token、检查重复读取
    ↓
Claude 写代码
    ↓
OpenWolf: 检查 cerebrum.md — 没有已知错误匹配
    ↓
Claude 完成后
    ↓
OpenWolf: 更新 anatomy.md、追加到 memory.md、更新 Token 账本

全程透明，不打扰你的工作。

2. 智能文件索引（anatomy.md）

项目文件地图，包含：

每个文件的描述
Token 估算值
文件用途标注

Claude 在读取文件之前就知道它大概是什么内容。

3. 学习记忆系统（cerebrum.md）

累积你的偏好和过去的错误：

你的纠正记录
"不要重复"清单
偏好设置

Claude 每次写代码前都会检查，防止重蹈覆辙。

4. Token 账本（token-ledger.json）

全生命周期 Token 追踪：

每个会话的 Token 使用量
历史记录对比
异常预警

终于知道 Token 花哪儿去了。

5. Bug 记忆系统（buglog.json）

Bug 修复记忆，可搜索：

记录每次 Bug 修复
防止重复发现同一个 Bug
知识积累

6. 实时仪表盘

openwolf dashboard

浏览器打开实时 Web 仪表盘，看清楚每个会话的 Token 流向。

四、.wolf/ 目录结构

openwolf init 会在项目中创建 .wolf/ 目录：

文件	用途
`anatomy.md`	项目文件地图，含描述和 Token 估算
`cerebrum.md`	学到的偏好、纠正、"不要重复"清单
`memory.md`	按时间顺序的行动日志，含 Token 估算
`buglog.json`	Bug 修复记忆，可搜索，防止重复发现
`token-ledger.json`	生命周期 Token 追踪和会话历史
`hooks/`	6 个 Claude Code 生命周期钩子（纯 Node.js）
`config.json`	配置项，含合理默认值
`identity.md`	该项目的 Agent 角色设定
`OPENWOLF.md`	Claude 每个会话都会读取的指令

五、命令详解

核心命令

openwolf init              # 初始化 .wolf/ 并注册钩子
openwolf status            # 显示健康状态、统计、文件完整性
openwolf scan              # 刷新项目结构地图
openwolf scan --check      # 验证 anatomy 与文件系统是否一致（不一致则退出码 1）
openwolf dashboard         # 打开实时 Web 仪表盘

后台任务

openwolf daemon start      # 启动后台任务调度器
openwolf daemon stop       # 停止调度器
openwolf daemon restart    # 重启调度器
openwolf daemon logs       # 查看调度器日志

定时任务

openwolf cron list         # 显示所有定时任务
openwolf cron run <id>     # 手动触发某个任务
openwolf cron retry <id>   # 重试失败的任务

设计质量检查

openwolf designqc          # 捕获设计截图让 Claude 评估

自动检测开发服务器，截取每个路由的全页截图，保存到 .wolf/designqc-captures/，然后让 Claude 读取截图并评估设计质量。

其他

openwolf bug search <term>  # 搜索 Bug 记忆中的已知修复
openwolf update             # 更新所有注册项目到最新版本
openwolf restore [backup]   # 从时间戳备份恢复 .wolf/

六、Design QC 功能详解

openwolf designqc 是 OpenWolf 的特色功能之一，专门解决 AI 编程中的设计评审痛点。

工作原理

openwolf designqc
    ↓
自动检测开发服务器
    ↓
逐路由捕获视口高度 JPEG 截图
    ↓
保存到 .wolf/designqc-captures/
    ↓
告诉 Claude 读取截图并评估设计

支持的 UI 框架知识库

OpenWolf 内置了 12 个主流框架的精选知识库：

shadcn/ui
Aceternity
Magic UI
DaisyUI
HeroUI
Chakra
Flowbite
Preline
Park UI
Origin UI
Headless UI
Cult UI

内置 battle-tested 迁移提示词，让 Claude 可以帮你选框架并执行迁移。

七、技术细节

工作原理

OpenWolf 的核心是 6 个 Claude Code 生命周期钩子：

钩子时机	作用
读取文件前	告诉 Claude 文件内容和 Token 估算
读取文件时	检测重复读取并警告
写代码前	检查 cerebrum.md 中的已知错误
写代码后	自动更新项目地图
会话结束时	更新记忆和 Token 账本
任意时刻	响应查询命令

依赖要求

Node.js 20+
Claude Code CLI
Windows / macOS / Linux
PM2（可选，后台任务持久化）
puppeteer-core（可选，Design QC 截图）

技术特点

纯 Node.js：无额外依赖，钩子脚本极简
零工作流改变：正常用 Claude，该干啥干啥
隐形执行：所有操作在后台发生，不打扰你
文件即存储：所有数据存在 .wolf/ 目录，可 Git 化管理

八、与传统方案对比

方案	Token 节省	工作流改变	学习成本	透明度
裸 Claude CLI	基准	无	无	无
OpenClaw	~25%	无	低	中
OpenWolf	~80%	无	极低	高
自建上下文管理	可变	大	高	高

OpenWolf 的核心优势：零工作流改变 + 极高透明度 + 极低学习成本。

九、适合人群

人群	OpenWolf 价值
Claude Code 重度用户	节省 65-80% Token，长期使用非常划算
长会话开发者	重复读取拦截让长会话 Token 消耗可控
多项目开发者	每个项目独立 `.wolf/`，统一管理
团队 Leader	Token 账本让团队 AI 使用成本可视化
追求效率的开发者	减少等待时间，提高 AI 响应速度

十、Origin Story

Cytostack 团队在用 Claude Code 构建产品时发现了一个问题：

会话的 Token 消耗比应有的速度快得多。深入分析后发现了问题：Claude 反复读取同一个文件、扫描整个目录只为找一个函数、在不打开文件的情况下无法知道文件包含什么。没有项目地图，没有读取感知，没有 Token 可见性。

于是他们造了自己一直想要的工具——

一个文件索引，让 Claude 少读
一个学习记忆，让它学得更快
一个账本，让你看清 Token 花在哪里

这就是 OpenWolf。

十一、总结

核心价值

价值	说明
80% Token 节省	实测数据，20 项目 132+ 会话平均 65.8%
零工作流改变	正常用 Claude，OpenWolf 在后台运行
隐形钩子	6 个钩子脚本，全自动执行
第二大脑	项目索引 + 偏好记忆 + Token 账本
即时上手	`npm install -g openwolf && openwolf init` 两步搞定
透明可查	所有数据在 `.wolf/` 目录，可 Git 管理

适用场景

长期 Claude Code 项目
Token 预算紧张的个人开发者
需要控制 AI 成本的团队
想搞清楚「Token 到底花哪儿了」的开发者

案例 OpenWolf：为Claude Code打造第二大脑，节省80% Token消耗的开源神器

炸裂！OpenWolf 开源终极省钱神器，为Claude Code打造第二大脑，节省80% Token消耗

引言

一、项目简介

是什么

核心定位

实际数据

二、快速上手

安装

初始化

三、核心功能

1. 六个隐形钩子脚本

2. 智能文件索引（anatomy.md）

3. 学习记忆系统（cerebrum.md）

4. Token 账本（token-ledger.json）

5. Bug 记忆系统（buglog.json）

6. 实时仪表盘

四、.wolf/ 目录结构

五、命令详解

核心命令

后台任务

定时任务

设计质量检查

其他

六、Design QC 功能详解

工作原理

支持的 UI 框架知识库

七、技术细节

工作原理

依赖要求

技术特点

八、与传统方案对比

九、适合人群

十、Origin Story

十一、总结

核心价值

适用场景

推荐理由

推荐文章