【免费下载链接】billion-contextA context-compression plugin for small context windows (a 100K context is enough), token savings (5x fewer tokens), and month-long single sessions (billions of tokens).上下文压缩插件兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。billion-context is all you need项目地址https://gitcode.com/gh_mirrors/bil/billion-context点击查看免费下载billion-context是一个上下文压缩插件,专为 Claude Code 等 AI 编程助手打造:它像一个透明的本地代理,自动把冗长的会话折叠成高保真摘要,让 100K 小窗口上下文也够用,官方实测可节省约 5 倍 Token,甚至支撑数月级别、数十亿 Token 的超长单会话。这篇教程手把手教你在 5 分钟内给 Claude Code 接上它。 为什么给 Claude Code 装上下文压缩用 Claude Code 做过长任务的人都遇到过这个痛点:会话越长,每次请求携带的历史越多,Token 费用滚雪球式上涨;一旦撑爆上下文窗口,会话质量骤降甚至直接死掉;客户端自带的自动压缩往往是一刀切截断,关键细节丢失。billion-context 的思路完全不同:它注入compress、decompress、search_context、acp_status四个上下文管理工具,由模型自己决定何时压缩、压缩什么,且压缩是增量、可逆、对前缀缓存友好的——历史压成摘要后,需要细节时还能按需解压缩。下图是它的分层压缩布局:左侧是逐层摘要块(tier-1/2/3,每块都可按需恢复),右侧是保留原文的最近区,新对话回合追加在这里: 第 1 步:安装 bili 命令billion-context 通过 npm 分发,安装一条命令搞定(Linux / macOS 推荐用户级前缀,无需 sudo):npm install -g billion-context --prefix~/.local安装后你会获得bili命令(位于~/.local/bin)。如果提示找不到命令,把export PATH$HOME/.local/bin:$PATH加进~/.bashrc或~/.zshrc即可。Windows 用户更简单,默认前缀就是用户可写目录,直接执行:npm install -g billion-context装好后可以用bili --version验证安装成功。 第 2 步:三种接法,任选其一方式 A:原生插件(推荐,最无感)bili plugin install claude这条命令会自动完成三件事(详见 commands/bili-setup.md):在 Claude Code 的settings.json中把ANTHROPIC_BASE_URL钉到本地代理(如果你已有自己的代理地址,它不会覆盖,只会提示你);设置DISABLE_AUTO_COMPACT1,把压缩权完全交给 billion-context,避免双重压缩;注册/acp-cache命令和 bili 的 MCP 工具,方便随时查看压缩状态。装完记得重启 Claude Code——新配置在下次启动时生效,之后每条消息都会自动流经本地代理,长会话自动压缩,无需再管。方式 B:启动器(零配置,不改任何文件)bili claude一条命令同时拉起代理和 Claude Code:代理跑在独立端口上,并把 Claude Code 指向它。全程不修改任何真实配置文件,关掉终端即恢复原样,适合先试用再决定的用户。方式 C:只改 baseURL(最通用)先手动启动代理:bili然后把 Claude Code 的模型 baseURL 加上http://localhost:8787/bili/前缀,上游地址直接写在路径里,代理就知道该转发到哪:改前:https://api.anthropic.com 改后:http://localhost:8787/bili/https://api.anthropic.com✅ 第 3 步:验证压缩真的在工作三条命令验证链路:# 1. 健康检查(代理是否启动、转发到哪个上游) curl -s http://localhost:8787/__bili/health # → {ok:true,upstream:https://api.anthropic.com} # 2. 实时会话统计(真实请求之后) curl -s http://localhost:8787/__bili/stats然后从 Claude Code 发一条消息,观察日志(~/.local/state/billion-context/bili.log)。正常的话,每个请求会出现一行processTurn,会话变长后还会看到:[acp-usage] round N inputX cachedY (cache hit Z%)以及compress压缩事件——说明上下文压缩已经生效。 盯着压缩效果看:/acp-cache 与 Web 面板配置完成后,在 Claude Code 里输入/acp-cache就能看到压缩统计报告:压缩省了多少 Token、缓存命中率多少、每次折叠的盈亏明细,全部一目了然。健康会话的前缀缓存命中率应保持在95%–97%,压缩本身的开销不超过 2%。下面这张生产数据图直观展示了这一点:两次调用间隔越短,缓存读占比越高,2 分钟的请求命中率高达 94.2%——省 Token 的关键就在于压缩不破坏缓存前缀:也可以打开 Web 面板 http://localhost:8787,里面有总览仪表盘、会话列表、缓存命中率折线图和配置编辑器。中文界面效果如下,顶部用量统计卡片直接给出缓存命中率和压缩节省量:而超长会话正是这个项目的立身之本:官方论文数据显示,生产环境中上万人次调用的马拉松会话,单次上下文始终平稳压在窗口内,从不越界:❓ 常见问题速查如何关闭/卸载?原生安装执行bili plugin remove claude;其他方式停掉命令或去掉/bili/前缀即可,流量立即恢复直连,全程可逆。配置文件在哪?~/.config/billion-context/billion-context.json(首次运行自动生成模板,所有字段可选)。压缩调优项在compress块里,完整参数参考 CONFIGURATION.md。为什么压缩不是马上触发?压缩是增量式 nudged 的:默认每增长约 50K Token 提示模型一次,首次压缩可能要等到 ~200K 才出现,可把compress.nudgeGrowthTokens调小让触发更早(见 CONFIGURATION.md FAQ 一节)。Windows 用户注意:请把%USERPROFILE%\.local\share\billion-context\加入杀毒软件排除项,否则长会话写状态时可能被 Defender 锁定。命中率偏低怎么办?按顺序排查:上游缓存 TTL 过期(会话闲置太久)→ 切换过模型 → bili 自身 bug(可反馈 issue)→ 其他原因。/acp-cache报告会自动归因到具体项。 延伸阅读项目总览与原理:README.md(含中文版本 README.zh-CN.md)各客户端接入细节:CLIENTS.md完整配置参考:CONFIGURATION.md会话身份与压缩机制设计:SESSION-IDENTITY.md压缩技术的完整论文:paper/ 目录下的《Model-Driven Incremental Hierarchical Compression》一句话总结:billion-context 就是给 Claude Code 装上的上下文压缩引擎——装一次,长会话自动瘦身,Token 账单肉眼可见地变轻。billion-context is all you need。赞分享【免费下载链接】billion-contextA context-compression plugin for small context windows (a 100K context is enough), token savings (5x fewer tokens), and month-long single sessions (billions of tokens).上下文压缩插件兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。billion-context is all you need项目地址https://gitcode.com/gh_mirrors/bil/billion-context点击查看免费下载相关推荐Ghostty Blackhole Token 模式完全配置教程把 Claude Code 上下文窗口接上黑洞Ghostty Blackhole Token 模式完全配置教程把 Claude Code 上下文窗口接上黑洞 Ghostty Blackhole 是一个把真SuperClaude 快速上手基于 Claude Code 的上下文工程Context Engineering配置框架实战指南SuperClaude 快速上手基于 Claude Code 的上下文工程Context Engineering配置框架实战指南 本文围绕 docs/ge开发工具CLIAI 技能/插件测试人工智能AI 评测Claude Code Router终极配置指南新手快速上手完整教程还在为AI模型切换繁琐而烦恼Claude Code Router让你的开发工作流更智能通过本文你将掌握如何快速配置多模型路由享受无缝的AI编程体验。 ?后端API网关LLM 网关大模型创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
