AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
把 AI 编程 Agent 的工具输出隔离到本地沙箱,减少上下文占用。
Context Mode 是一个面向 AI 编程 Agent 的本地插件,通过沙箱运行工具调用、把完整输出存入本地 SQLite 索引,只把 Agent 需要的那部分返回给上下文窗口。它支持 17 个平台,通过 MCP 和 hooks 接入,并声称在 10KB 以上原始输出的测试中,回复体积中位数减少 99.4%。
推荐指数
对长会话或工具输出量大的 Agent 用户有实际收益,但需注意许可证和平台限制。
近 7 天
+417
新增 Star
总 Star 排名
#191
雷达追踪的 3,931 个 AI 仓库中
创建于
2026
2026年2月23日
核心亮点
1大幅压缩输出
在 36 条 10KB 以上原始输出的测试中,回复体积中位数减少 99.4%。
2本地运行
沙箱、索引和搜索都在本机执行,数据存于 ~/.context-mode,无遥测。
3多平台支持
通过 MCP 和 hooks 接入 Claude Code、Codex、Gemini CLI 等 17 个平台。
4会话记忆持久化
完整工具输出存入 SQLite,Agent 可按需检索,压缩后仍能恢复上下文。
5Code Mode
Agent 写短脚本处理数据,只有脚本打印结果进入上下文。
适用场景
长调试会话
例如:一次调试产生 281KB 原始输出,进入上下文仅约 3.2KB(约 817 token)。
压缩后恢复上下文
例如:442KB 的会话记录压缩为 2KB 块,约 505 token,便于继续对话。
多 Agent 统一管理
例如:在 Claude Code 和 Codex 中安装同一插件,共享本地索引和路由规则。
它是怎么工作的
第 1 步
拦截工具调用
通过 hooks 或 MCP 捕获 Agent 的文件读取、命令执行和网页抓取。
第 2 步
沙箱执行
在本地沙箱中运行工具,完整输出不直接进入上下文窗口。
第 3 步
索引存储
输出写入项目对应的 SQLite 数据库(~/.context-mode/context.db)。
第 4 步
按需检索
Agent 通过 MCP 工具查询索引,只取回需要的片段。
第 5 步
Code Mode 可选
Agent 编写脚本处理数据,仅脚本输出进入上下文。
快速上手
- 1
安装 Claude Code 插件
在 Claude Code 中添加插件市场并安装。
claude plugin marketplace add mksglu/context-mode - 2
确认环境
需要 Node 24.15.0 或更高版本;Windows 还需 Git for Windows。
- 3
按平台安装
README 为 Codex、Gemini CLI、Qwen Code 等平台分别提供了安装命令。
适合谁
- 使用 Claude Code、Codex 等 AI 编程 Agent 的开发者
- 经常处理大量工具输出或长会话的用户
- 希望数据留在本机、不要遥测的团队
不太适合
- 不愿安装本地插件或额外运行时的用户
- 需要完全 OSI 开源许可证的项目
成熟度
- 活跃度2026 年 2 月创建,11 月仍有推送,star 数 3.4 万。
- 文档README 覆盖安装、用例、基准和隐私说明,细节较全。
- 社区有 Discord 和 Hacker News 讨论,fork 数 2352,开放 issue 仅 18 个。
- 上手难度需按平台分别安装,依赖 Node 24.15+,Windows 还需 Git Bash。
使用前注意
- · 许可证为 ELv2(源可用),不是 OSI 开源许可证,商用前需确认条款。
- · 需要 Node 24.15.0 或更高版本,Windows 还需安装 Git for Windows。
- · 插件免费,但 Context Mode Gateway 是独立付费托管服务,注意区分。
- · README 称支持 17 个平台,但安装说明只列出 11 个,以实际文档为准。
