ARTICLE · 1381460
AI编程工具太费Token?这个开源插件帮你省99%
AI 编程工具跑一个调试会话就能消耗几万 Token,跑到后半段 Agent 开始变笨——忘了开头说了什么,重复犯错,回答质量明显下降。Context Mode 这个开源插件的解法是:不塞上下文,存到本地索引,按需精确取回。实测一个 18 万字符的日志文件,索引后查询只返回 553 字符,节省 99.7%。
为什么 AI 编程工具越来越贵
用过 Claude Code、Codex 这类工具的人都有体感:Token 消耗蹭蹭往上涨,长会话后半段质量明显下滑。
原因很直接:AI Agent 每次读文件、跑命令、抓网页,产生的输出全部进入上下文窗口。一个调试会话可能产生 28 万字符的原始输出,按 4 字符约 1 个 Token 算,就是 7 万 Token。大多数模型的上下文窗口有限,塞满后要么被截断(Agent 看不到早期内容),要么触发压缩(压缩后信息丢失)。
这个问题不是个例。Context Mode 在 GitHub 拿了 34K 星,npm 下载量 85 万次,登上过 Hacker News 首页(570+ 分),说明大量开发者被同一个问题困扰。

原始输出 182890 字符,Context Mode 查询后只返回 553 字符
Context Mode 的解法:不塞,存起来按需取
思路不复杂,执行得很干净。
第一层是本地沙箱执行。工具命令在本地沙箱里跑,完整输出不进上下文,而是写到本地 SQLite 索引里,每个项目一个 context.db,存在 ~/.context-mode/ 目录。
第二层是按需精确取回。Agent 需要某段信息时,通过全文搜索 FTS5 精确查那一段,只把匹配的内容返回,不是把整个文件再读一遍。
第三层是 Code Mode。对结构化数据(JSON、日志),Agent 不是直接读原始数据,而是写一小段脚本去处理,只有脚本的 print 结果进上下文。这一步把读数据变成了读结论。
整个方案零遥测、完全本地、离线可用。所有数据留在本机不联网,装好之后沙箱执行、索引、搜索全部走本地。
实测:一个 18 万字符的日志文件
在 Codex 里装了 Context Mode v2.2.1,用随机生成的日志文件做了对比测试。
测试对象是 2000 行、182890 字符的随机日志,约 45000 Token。不装 Context Mode 时,Agent 直接读这个文件,18 万字符全部进上下文,一次性吃掉约 4.5 万 Token 预算。装了 Context Mode 后,先索引这个文件(耗时 0.06 秒),然后通过 context-mode search 查询特定内容,返回结果只有 553 字符,约 140 Token,包含匹配段落和来源路径。

索引耗时 0.06 秒,查询返回 553 字符
节省比例 99.7%,和 Context Mode 官方 Benchmarks 的中位数(99.4%,基于 36 组超过 10KB 的原始输出)基本吻合。在实际调试场景里,Agent 反复读同一个大文件、跑同一段输出很多的命令时,效果更明显——索引是持久的,第二次查询不用重新读。
怎么装到 Codex
四步,大概两分钟。
# 1. 添加插件市场 codex plugin marketplace add mksglu/context-mode # 2. 安装插件 codex plugin add context-mode@context-mode # 3. 全局安装 CLI npm i -g context-mode # 4. 配置 Codex hooks context-mode setup --agents codex 装完用 context-mode doctor 检查,应该看到这些全部 PASS:
MCP 服务(codex mcp list 里出现 context-mode,status enabled) 6 个 Hook(PreToolUse / PostToolUse / SessionStart / PreCompact / UserPromptSubmit / Stop) FTS5 / SQLite native module 存储目录(~/.codex/context-mode/)
有个加分项:如果机器上有 Bun,JS/TS 的沙箱执行会自动走 Bun,速度比 Node 快不少。doctor 会显示 Performance: FAST。
它不做什么
Context Mode 不是万能的,有几个边界要知道。
它只管工具输出,不管对话本身——Agent 的回复、你的提问不在管辖范围。它需要 Agent 主动配合——提供 MCP 工具和 hooks,但 Agent 要意识到先索引再查询,而不是直接读文件。对小文件(几 KB)有额外开销——直接读反而更简单。跨会话记忆、长会话检索这些进阶能力是单独的托管服务(Gateway),免费版只有本地部分。
适合谁用
日常用 Codex / Claude Code 做长会话调试、重构,值得装,能显著省 Token。经常让 Agent 读大文件、大日志,值得装,效果最明显。上下文经常满、Agent 后半段变笨,值得装,就是在解决这个。只是偶尔跑跑小脚本,意义不大。在意数据隐私、不想联网,值得装,完全本地零遥测。
一句话总结:如果你日常重度使用 AI 编程工具,Context Mode 是那种装一次就忘了它存在,但 Token 账单会感谢你的工具。














































































