claude-context -- 让AI 能深度理解和检索代码库

claude-context是Zilliz开发的开源MCP插件，为AI编程助手提供语义代码搜索能力。它通过将代码库转化为向量数据库索引，实现自然语言查询代码功能，解决AI处理大型代码库时的关键痛点：上下文窗口限制、手动传递低效、代码理解不全和跨模块协作难。核心技术包括代码AST解析、向量嵌入、混合搜索和智能分块。提供多个变体版本满足不同场景需求，适用于大型项目开发、代码重构、Bug调试等场景，显著

翔云123456

397人浏览 · 2026-04-26 11:34:03

翔云123456 · 2026-04-26 11:34:03 发布

一、核心定义

claude-context 是由 Zilliz 开发的开源 MCP（Model Context Protocol）插件，为 Claude Code 等 AI 编程助手提供语义代码搜索能力，让 AI 能深度理解并检索整个代码库的上下文信息，无需手动粘贴文件片段。它的核心思路是将代码库转化为向量数据库中的语义索引，让 AI 能通过自然语言查询找到相关代码，而非仅依赖字符串匹配。

二、核心用途（解决的关键痛点）

痛点	解决方案	价值
AI 上下文窗口限制	只将相关代码片段注入上下文，而非整个代码库	降低 40%+ Token 成本，支持百万行级代码库
手动传递上下文低效	自动语义搜索定位相关代码，无需人工筛选	减少多轮对话，提升开发效率
代码理解不全面	混合搜索（BM25 关键词 + 向量语义）覆盖代码含义与结构	回答更准确，减少因上下文缺失导致的错误
跨文件/模块协作难	建立全局代码索引，AI 可自主关联不同文件的依赖关系	支持大型项目重构、调试与新功能开发

三、关键功能与技术原理

1. 核心功能

语义代码搜索：通过自然语言查询找到相关函数、类、数据结构，不受命名方式限制
智能代码分块：自动处理大文件，保留代码结构与上下文关联
多项目支持：为不同代码库维护独立索引，自动识别当前工作目录
MCP 协议集成：兼容 Claude Code、Cursor、VS Code 等主流 AI 编程助手
低成本高效：仅加载相关代码片段，避免全量代码注入的高成本

2. 技术原理

代码索引：解析代码库生成抽象语法树（AST），提取结构信息
向量嵌入：使用 OpenAI Embeddings 或 EmbeddingGemma 将代码片段转化为向量
存储管理：将向量存储在 Milvus/Zilliz Cloud 向量数据库中
混合搜索：接收自然语言查询，同时进行关键词搜索与语义搜索
上下文注入：将最相关的代码片段整理后注入 AI 助手的上下文窗口

四、主要变体与衍生项目

项目	特点	适用场景
zilliztech/claude-context	官方版本，支持云向量数据库	团队协作、大型项目
claude-context-local	100% 本地运行，使用 EmbeddingGemma	隐私敏感、无网络环境、零成本需求
claude-context-system	连接 Claude Desktop 与 Notion，提供会话记忆	项目管理、跨会话上下文保持
claude-context-mode	优化工具输出压缩，节省上下文窗口	工具调用频繁的复杂任务