headroom
SHA-256在 AI 代理读取前压缩工具输出、日志、RAG 块和文件，减少 60-95% Token 且答案不变。提供库、代理和 MCP 服务器。
给 AI 代理省 Token 的神器，压缩率惊人，答案不变。
核心功能
- 可逆压缩（CCR）：原始数据本地保存，LLM 可按需检索，不打折扣
- 6 种压缩算法自动适配：JSON 智能压缩、AST 代码压缩、文本压缩等
- 零代码集成：支持代理包装（Claude Code/Codex/Cursor 等一行命令）、库调用、透明代理
- 跨代理记忆：Claude、Codex、Gemini 等共享压缩上下文，自动去重
- 自动学习：分析失败会话，将修正写入 AGENTS.md / CLAUDE.md
避坑指南
- •仅支持 Python 3.10+ 和现代 Node.js 环境；适用于 AI 代理场景，对纯文本压缩效果一般；可逆压缩（CCR）需要本地存储空间，如果你完全依赖云端且无法保留文件，请关闭 CCR。
适用场景
- AI 编程代理日常使用（Claude Code、Cursor、Aider 等），大幅减少 API 费用
- 多代理协作工作流，通过共享记忆减少重复上下文传输
详细介绍
Headroom 是一个面向 AI 代理的上下文压缩层，可将 Token 用量减少 60-95%，同时保持答案准确率。它会在 LLM 读取前压缩工具输出、日志、RAG 片段、文件和对话历史。与 LLMLingua 或 Selective Context 等工具相比，Headroom 提供可逆压缩（CCR），原始内容永不丢失；并支持跨代理记忆（Claude、Codex、Cursor、Aider 等）。它完全本地运行，内置 6 种压缩算法（SmartCrusher、CodeCompressor、Kompress-base 等），可通过库调用、代理、MCP 服务器或代理包装器集成。
标签
快速上手
安装软件
打开下载的 dmg 文件，将应用拖入 Applications 文件夹
安装依赖：pip install "headroom-ai[all]" 或 npm install headroom-ai
选择集成方式：运行 headroom wrap claude 包装代理，或 headroom proxy --port 8787 启动透明代理
验证效果：运行 headroom stats 查看 Token 压缩统计
- 安装依赖：pip install "headroom-ai[all]" 或 npm install headroom-ai
- 选择集成方式：运行 headroom wrap claude 包装代理，或 headroom proxy --port 8787 启动透明代理
- 验证效果：运行 headroom stats 查看 Token 压缩统计
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
0942c5d45c6f94bb2cc7b094a323175bae262fdc3d38ab088e27aea6cc5186f3该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
直接卸载包：pip uninstall headroom-ai 或 npm uninstall headroom-ai；如果通过 wrap 创建了配置文件，手动删除 ~/.headroom 目录及代理自定义的环境变量。
无额外依赖
下载后即可直接使用，无需安装其他运行环境