以下是针对 Headroom 工具的整理与优化说明核心功能Headroom 是一个本地运行的 AI 上下文压缩工具能在数据输入大语言模型LLM前智能缩减 Token 数量节省 60-95% 的 Token 消耗同时保持回答质量。适用于代码搜索、事故调试等场景。安装方法环境要求Python 3.7 及以上版本支持 Windows/Linux/macOS。安装命令完整版安装推荐pip install headroom-ai[proxy,ml,code,mcp]0.20.15替代方案使用uv加速安装uv pip install headroom-ai[proxy,ml,code,mcp]0.20.15Windows 特殊处理若遇路径过长错误分步安装pip install headroom-ai0.20.15 --no-deps pip install click rich httpx openai uvicorn fastapi websockets watchdog pyyaml typer设置环境变量绕过 Rust 限制$env:HEADROOM_REQUIRE_RUST_CORE false配置与使用启动代理服务headroom proxy --port 8787 --openai-api-url https://api.feng.cx/v1修改 Codex 配置编辑~/.codex/config.toml[model_providers.custom] base_url http://localhost:8787/v1 # 指向本地代理验证连接执行以下命令检查代理状态curl http://localhost:8787/stats关注api_requests和avg_compression_pct字段确认压缩效果。桌面端集成修改config.toml后Codex 桌面端自动继承配置。需确保启动时代理服务已运行。效率提升脚本创建批处理文件start_headroom_codex.batecho off set HEADROOM_REQUIRE_RUST_COREfalse start Proxy /MIN cmd /c headroom proxy --port 8787 --openai-api-url https://api.feng.cx/v1 codex -c model_providers.custom.base_urlhttp://localhost:8787/v1 pause故障排查代理未启动检查端口占用或环境变量设置。Codex 报错添加--skip-git-repo-check参数跳过目录验证。恢复直连将base_url改回原始 API 地址。注意事项代理模式仅本地运行API Key 不会外传。平均压缩率可通过/stats接口实时监控。