你是否曾为 Claude Code 在复杂项目中“记不住上下文”而苦恼?它总在问“这个函数定义在哪?”“这个类继承自谁?”,却无法自动理解你本地百万行代码的结构与语义。Claude Context 正是为此而生——它不是另一个聊天插件,而是一套轻量、可嵌入、开箱即用的「代码语义搜索引擎」,能将你整个代码仓库实时构建成 Claude 的专属知识图谱,让 AI 真正像资深工程师一样“边读边写”。它不依赖云端索引,不上传代码,所有向量计算与检索均在本地完成,兼顾隐私、速度与准确性。
核心功能
- 全项目语义搜索:基于 Voyage-AI 或本地嵌入模型(支持 Node.js 原生调用),自动解析 TypeScript/JavaScript/Python/Go 等主流语言,构建带语法感知的代码向量索引,精准匹配函数用途、类关系、错误上下文等深层意图,而非简单关键词匹配。
- 无缝集成 Claude Code 工作流:作为官方 MCP(Model Control Protocol)标准实现,一键接入 Claude Code 客户端(包括 Cursor、VS Code + Claude 插件等),无需修改提示词,AI 即可主动调用“查代码”能力获取精准上下文片段。
- VS Code 原生扩展支持:已在 VS Code Marketplace 上线正式插件(Semantic Code Search),右键代码即可触发语义搜索,结果高亮显示相关文件、行号与相似度,支持双击跳转,开发体验丝滑如内置功能。
- 模块化架构,灵活复用:提供
@zilliz/claude-context-core(核心索引与检索引擎)和@zilliz/claude-context-mcp(MCP 服务层)两个 npm 包,开发者可轻松将其嵌入自研 Agent、IDE 插件或内部编码平台,打造专属智能编程助手。 - 增量索引与高效更新:采用 Merkle Tree 结构校验文件变更,仅对修改/新增文件重算嵌入,百万行级项目首次索引后,日常开发中秒级完成增量更新,告别“每次改代码都要等5分钟重建索引”的尴尬。
- Markdown 优先的长期记忆扩展:项目团队同步推出 memsearch Claude Code 插件,支持将代码摘要、设计文档、调试笔记以 Markdown 形式持久化存储,让 AI 跨会话记住你的项目“人设”与技术决策逻辑。
适合哪些人用
如果你是以下角色之一,Claude Context 将显著提升你的编码效率与 AI 协作质量:
• 使用 Claude Code / Cursor 的前端/全栈工程师:厌倦了反复粘贴文件路径、手动解释模块职责;
• 大型遗留系统维护者:面对无文档、高耦合的老项目,急需一个“懂代码的向导”快速定位影响范围;
• AI 编程工具链开发者:希望为自家 IDE 插件或低代码平台注入企业级代码理解能力;
• 重视代码隐私的安全敏感型团队:拒绝将源码上传至第三方云服务,坚持本地化、可控的 RAG 架构。
快速上手
✅ VS Code 用户:打开扩展市场,搜索 “Semantic Code Search”,安装由 Zilliz 发布的官方插件,重启 VS Code 后右键任意代码即可启动语义搜索。
✅ 命令行集成:运行 npm install -g @zilliz/claude-context-mcp,再执行 claude-context-mcp --port 3000 启动本地 MCP 服务,配置 Claude Code 指向该地址即可。
✅ 开发者嵌入:在项目中安装 @zilliz/claude-context-core,调用 buildIndex() 和 search() API,10 行代码即可接入自有 Agent。
项目信息
Code search MCP for Claude Code. Make entire codebase the context for any coding agent.
6.5k
今日 +259 stars today
Stars
566
Forks
TypeScript
MIT
TypeScript|GitHub Star 数:6534|开源协议:MIT|GitHub 项目地址
这是一款由国内顶尖向量数据库公司 Zilliz 开源、已获全球开发者广泛验证的高质量工程实践,虽托管于 GitHub,但其设计理念高度契合中文开发者对“本地化、高性能、强隐私”的硬性需求——它不是概念玩具,而是真正跑在你笔记本上的生产力引擎。
如果你希望 AI 编程助手不再“装懂”,而是真正理解你的代码脉络,Claude Context 是目前最成熟、最易落地的语义上下文增强方案。





