AI 编程约 7 分钟

Context Mode 是什么？给 AI 编程省 98% 上下文

AI 指南·更新于 2026-09-09·◉ 0 浏览

如果你的 AI 编程助手聊到一半开始失忆、反复重读同一个文件，问题多半不在模型，而在上下文窗口被工具输出塞满了。Context Mode 是一个开源的 MCP 服务器，专门在工具层把原始数据挡在窗口外，官方实测能把 315KB 的工具输出压缩到 5.4KB，缩减约 98%。项目在 GitHub 上已有 2.1 万多颗 star，还在持续更新。

Context Mode 是什么：一个 MCP 服务器，专治上下文被塞爆

Context Mode 由开发者 mksglu 开源，定位是 AI 编程助手的上下文窗口优化层。它不是又一个代码编辑器，也不是新模型，而是插在 Claude Code、Gemini CLI、VS Code Copilot 这类编程助手和它们调用的工具之间的一个中间层，支持 17 个客户端。

它解决的问题非常具体：每次 MCP 工具调用都会把原始数据整个倒进上下文窗口。项目 README 里算过一笔账，一次 Playwright 页面快照要 56KB，抓 20 个 GitHub issue 要 59KB，读一份访问日志要 45KB。30 分钟的会话下来，上下文可能有四成被这些原始数据吃掉，模型可用的思考空间越来越少。

四种省法：沙箱、记忆、写脚本干活、不改说话风格

Context Mode 的省钱思路分四层，每一层都值得单独说。

第一层是上下文沙箱。它提供一组 ctx 开头的沙箱工具，让命令输出、网页抓取结果先落进沙箱里，窗口里只留摘要和索引，需要哪段再精准取回。

第二层是会话记忆。每一次文件编辑、git 操作、报错和你的决定，都会记录进本地的 SQLite 数据库。当对话被压缩（compact）时，它不会把历史一股脑倒回去，而是用全文索引（FTS5）加 BM25 检索，只把当下相关的记忆取回来，模型能接着上次的地方继续干。

第三层是它最有趣的理念：让模型写代码去算，而不是把数据读进来自己算。比如统计 50 个文件的行数，传统做法是读 50 个文件进窗口，官方例子中这要消耗约 700KB；换成让模型写一个脚本直接输出结果，只占 3.6KB，省了差不多 100 倍。

${{ctx_execute 写脚本统计行数前后的上下文占用对比数据图表，700KB 对 3.6KB}}$

第四层常被误解，需要澄清：Context Mode 只拦截数据流向，不强制要求模型用短句回答。项目在 README 里明确说明，激进的简短提示词反而会拉低模型的编程和推理能力，所以它把「怎么说话」的决定权留给你自己的 AGENTS.md 或 CLAUDE.md。

为什么值得装：一笔 30 分钟会话的上下文账

很多省 token 的技巧停留在提示词层面，这个项目的价值是把优化做进了工具调用层，省的是真金白银的输入 token。对按量付费的用户来说，同样的任务跑完，账单上的输入消耗会明显下降；对订阅制用户来说，省下的上下文意味着单次会话能装下更多有效信息，模型失忆和重复读文件的次数会减少。

它甚至提供了 ctx-stats 这样的统计命令，能查看每个工具的节省明细。这个「看得见的账单」是同类提示词技巧给不了的。

和 AGENTS.md、手工省 token 技巧是什么关系

三者不冲突，分工不同。AGENTS.md 是你写给模型看的行为约定，管的是风格和规则；省 token 技巧大多在提示词和习惯层面，比如少贴大段日志；Context Mode 则在基础设施层面自动拦截数据。如果你已经在做前两件事，把它加上是自然补位。

想系统了解手工层面的省法，可以看我们整理的AI 编程省钱指南，以及AGENTS.md 完全指南。它和 MCP、Skill 这类扩展机制也不在一个层面，一个是拦数据，一个是加能力，详细分工见MCP 和 Skill 的区别。

5 分钟上手路径：以 Claude Code 为例

装起来不复杂，三步：

确认 Claude Code 版本在 1.0.33 以上。
在 Claude Code 里执行 /plugin marketplace add mksglu/context-mode，再执行 /plugin install context-mode@context-mode。
重启后运行 /context-mode:ctx-doctor 自检，全部打勾即装好。

其他平台走 npm 全局安装（Node.js 22.5 以上），再按官方 README 里的配置片段注册 MCP 服务器和钩子。装好后建议先用 ctx-stats 看几天数据，感受一下哪类工具最吃上下文。

谁适合用，谁先别装

适合装的三类人：每天高强度用 Claude Code 或 Copilot 写代码的重度用户；按 token 付费、对账单敏感的团队；跑长任务、经常被上下文压缩打断工作流的 Agent 使用者。

可以先观望的也有三类：偶尔用 AI 写几行代码的轻度用户，收益撑不起安装和维护成本；使用小众编程助手的用户，需要确认官方是否覆盖你的客户端；对在本地落盘会话数据有合规顾虑的团队，需要先评估 SQLite 记录的内容边界。

最后更新于 2026 年 9 月，作者 AI345。

常见问题

Context Mode 是免费的吗？

答：是。项目开源在 GitHub，npm 包免费安装，采用 Elastic License 2.0 协议，个人和团队使用都不收费。

它支持哪些编程助手？

答：官方支持 17 个客户端，包括 Claude Code、Gemini CLI、VS Code Copilot、JetBrains Copilot、GitHub Copilot CLI 等。支持钩子机制的平台可以自动路由，其余平台需要手动复制一次路由说明文件。

它会让 AI 回答变得简短敷衍吗？

答：不会。它只拦截工具数据的流向，不约束模型的表达方式。官方还特意说明，强制简短的提示词会损害编程和推理表现，所以说话风格完全由你自己的配置文件决定。

会话数据存在哪里，安全吗？

答：存在你本地的 SQLite 数据库里，不上传服务器。如果你开启新会话时没有使用 --continue，上一次的会话数据会立即删除。

不用 Claude Code 还能装吗？

答：能。用 npm install -g context-mode 全局安装后，按官方 README 里对应平台的配置片段注册 MCP 服务器即可，只是没有 Claude Code 插件版的自动路由和斜杠命令。