Headroom 是一个 AI agent 上下文压缩工具，能把 LLM 看到的 token 量压缩 60–95%，同时保留答案质量。6 月 4 日发布的 v0.23.0 新增了对 GitHub Copilot 订阅模式的支持，并修复了跨项目数据隔离、Codex 配置等多项问题。

一套配置，统一管住 Copilot + Claude Code + Codex

此前 Headroom 已经支持 Claude Code、Codex、Cursor、Aider、Pi 等主流 AI 编程工具，作为统一的上下文压缩层。v0.23.0 将 GitHub Copilot 订阅模式也纳入了这套体系——用户可以在同一个 Headroom 配置下统一管理 Copilot 与其他 Agent 的 token 消耗和上下文压缩策略，而不必为每个工具单独配置。

这对于团队场景尤其有用：多人共用一台开发机时，Headroom 可以作为共享的压缩中间层，避免不同 Agent 之间抢占 token 预算，也方便统一监控使用情况。

修复了跨项目数据泄露 bug

v0.23.0 还修复了 CCR（上下文压缩恢复）模块在 v0.22.4 中存在的一个安全漏洞：跨 project 的 prompt expansion 会错误地包含其他项目的内容，可能导致代码片段或上下文在不同项目之间串台。这个 bug 在多人协作或同时处理多个项目时容易触发，v0.23.0 已将 expansion 范围严格限定在当前 workspace。

其他修复和改进

• Codex init 修复：修复了初始化时 model_provider 配置被错误放置的问题，让 Codex 与 Headroom 的配合更稳定
• tiktoken 编码修正：修复了对未知 GPT-4 模型快照的 token 编码问题，减少压缩时的潜在错误
• Docker 基础镜像升级：镜像升级到 Python 3.13 / Debian 13，并移除了 digest pinning，降低维护成本

适用场景

• 团队多人共用机器：Headroom 作为统一的压缩层，减少 token 浪费
• 企业 Copilot 用户：想统一管理订阅凭证，同时保留上下文压缩能力
• 开发者关注 Agent 输出质量：CCR 模块可以恢复压缩前的原始内容，方便调试和审计

当前局限

v0.23.0 是快速迭代版本，Copilot 订阅模式为新增功能，企业用户在生产环境中使用前建议先做小范围验证。

如何获取

```bash

pip install headroom-ai

headroom --version # 确认升级到 0.23.0

```

或者使用 npm：npm install headroom-ai

GitHub：https://github.com/chopratejas/headroom

文档：https://headroom-docs.vercel.app/docs

参考来源

• https://github.com/chopratejas/headroom/releases/tag/v0.23.0

说明：该页面由基础模板稳定生成，后续可继续局部润色样式或补充模块，再进入发布检查。