clauditor

监控并优化Claude Code会话的Token消耗,节省API配额。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:clauditor。
它的用途是:监控并优化Claude Code会话的Token消耗,节省API配额。
完整的 Skill 内容见:https://321skill.com/skills/clauditor/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把这个React组件重构为使用Hooks。” 在进行了几十轮对话后,clauditor可能会弹出提示,告诉你当前会话消耗的Token已是初始的10倍,并已自动保存进度。你只需按照提示开启一个新会话,然后说“继续我上次的工作”,clauditor便会引导你恢复之前的上下文,让你在新的高效会话中继续编码。

介绍

Claude Code在每次对话轮次中都会重新发送整个会话历史,导致Token消耗随对话轮数线性增长,可能使API配额在短时间内耗尽。clauditor解决了这一问题,它通过注册钩子程序实时监控会话大小,当检测到会话因历史过长而浪费配额时,会主动中断当前会话并保存进度,提示用户开启新会话以恢复高效工作。

使用clauditor非常简单,只需通过包管理器安装并运行安装命令即可。它会自动在后台运行,无需额外配置或打开仪表盘。当会话变得“臃肿”时,它会以醒目的方式提示用户,并自动保存上下文。用户只需在新会话中输入“继续”或类似指令,clauditor便会列出保存的会话,指导用户如何无缝衔接工作。

这个工具非常适合频繁使用Claude Code进行长时间、多轮次编码对话的开发者。无论是进行复杂的代码重构、调试还是功能开发,只要会话可能持续较长时间,clauditor都能帮助用户有效管理成本,避免因配额意外耗尽而中断工作流。

需要注意的是,clauditor目前主要支持Claude Code CLI、VS Code和JetBrains扩展,不支持Web版Claude Code。在VS Code扩展中,由于Claude Code自身的已知问题,某些提示可能不会稳定触发,但核心的会话保存和恢复功能依然有效。

核心特点

与单纯记录或分析Token消耗的工具不同,clauditor的核心区别在于其主动干预机制:它能在浪费发生前直接中断低效会话,并通过内置的会话保存与恢复系统,确保用户在不损失上下文的前提下,强制切换到高效的新会话中,实现了成本控制与工作连续性的平衡。

注意事项

不支持Web版Claude Code,且在VS Code扩展中,由于上游依赖的Bug,部分提示信息的触发可能不稳定。

常见问题

clauditor会影响我的编码工作流吗?

不会,它在后台静默运行,仅在检测到严重配额浪费时才会弹出提示并保存进度,帮助你无缝切换到高效的新会话。

保存的会话历史安全吗?

会话历史默认保存在本地`~/.clauditor/sessions/`目录下,你可以自行管理这些文件。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/clauditor/raw/index.md 读取 clauditor 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。