Claude Context Chrome 扩展实战指南在 GitHub 上直接构建代码语义搜索引擎【免费下载链接】claude-contextCode search MCP for Claude Code. Make entire codebase the context for any coding agent.项目地址: https://gitcode.com/GitHub_Trending/co/claude-context本指南围绕 Claude Context 仓库中的 GitHub Code Vector Search Chrome 扩展位于 packages/chrome-extension展开讲解如何在浏览器中安装、配置并运行这套浏览即索引、提问即搜索的代码语义检索方案。读完本文你将掌握扩展的构建加载流程、Milvus 向量库与嵌入模型的核心配置方式以及底层索引、切分、检索的实现原理能够基于真实源码为任意 GitHub 仓库搭建可用的语义代码搜索环境。扩展概述与核心能力GitHub Code Vector Search 是 Claude Context项目代码搜索 MCP目标是为任意编码 Agent 提供整个代码库上下文在浏览器端的延伸它把 packages/core 的索引引擎能力搬进 Chrome 扩展让你在浏览 GitHub 仓库页面时即可完成代码的向量化索引与语义检索。扩展的核心能力包括语义搜索基于语义理解检索 GitHub 仓库代码而非简单字符串匹配仓库索引自动拉取 GitHub 仓库文件构建语义向量数据库上下文搜索在 GitHub 上直接选中代码片段检索仓库内语义相近的相关代码多平台嵌入支持 OpenAI 与 VoyageAI 两类嵌入模型供应商向量存储集成 Milvus 向量数据库提供高效存储与召回GitHub 深度集成UI 直接嵌入 GitHub 仓库页面侧边栏跨仓库搜索可对多个已索引仓库统一检索实时性边浏览边索引与搜索。从工程形态看这是一个 Manifest V3 的现代扩展见 packages/chrome-extension/src/manifest.json依赖zilliz/claude-context-core工作区包作为语义搜索引擎见 packages/chrome-extension/package.json。安装与加载应用商店安装扩展计划上架 Chrome Web StoreREADME 标注为 Coming Soon。在当前仓库快照中该入口尚未开放因此实际使用以手动加载开发版为主。手动加载开发模式构建扩展在仓库根目录执行cd packages/chrome-extension pnpm build构建脚本实际调用webpack --modeproduction见 packages/chrome-extension/package.json产物输出到dist目录。开发时可使用pnpm devwebpack --modedevelopment --watch开启监听式增量构建也可用pnpm typechecktsc --noEmit做类型检查。在 Chrome 中加载打开 Chrome 并访问chrome://extensions/开启右上角开发者模式点击加载已解压的扩展程序选择上一步生成的dist文件夹扩展随即出现在扩展列表中。Webpack 配置packages/chrome-extension/webpack.config.js会生成三个入口文件background.js、content.js、options.js并通过 CopyWebpackPlugin 将src/manifest.json、src/options.html、src/styles.css及src/icons一并拷贝到dist保证加载目录自洽。快速上手索引一个仓库并开始搜索配置设置点击 Chrome 工具栏中的扩展图标进入 Options/设置页配置嵌入模型供应商与 API Key填写 Milvus 连接信息。索引仓库导航到任意 GitHub 仓库页面点击页面侧边栏中出现的 Index Repository 按钮等待索引完成索引过程会实时显示进度。开始搜索使用 GitHub 仓库页面上出现的搜索框输入自然语言查询例如 function that handles authentication点击结果即可跳转到对应代码位置。扩展的 UI 由 packages/chrome-extension/src/content.ts 注入它优先挂载到 GitHub 的.Layout-sidebarAbout 区域找不到时回退到仓库导航栏nav.UnderlineNav之后并通过 MutationObserver 监听 URL 变化以适配 GitHub 的 SPA 页面跳转。搜索框对不足 3 个字符的查询直接忽略结果按相似度降序渲染命中 80% 以上标为高相关、60% 以上标为中相关每项展示文件路径、扩展名、行号区间、匹配百分比与前 300 字符预览点击结果链接可直接定位到对应文件的起始行。配置项详解扩展的配置页options.html逻辑见 packages/chrome-extension/src/options.ts通过chrome.storage.sync持久化以下字段配置项存储键说明嵌入模型供应商-可选 OpenAI 或 VoyageAI当前实现默认走 OpenAI 接口嵌入模型openaiToken固定默认模型text-embedding-3-small见 milvusConfig.tsAPI KeyopenaiToken嵌入提供商 API Key用于https://api.openai.com/v1/embeddings调用GitHub TokengithubToken个人访问令牌用于拉取仓库文件与私有仓库访问可选Milvus 地址milvusAddress例如http://localhost:19530保存时会校验 URL 格式Milvus TokenmilvusToken服务端认证令牌可选Milvus 用户名/密码milvusUsername/milvusPassword用户名密码认证可选Milvus 数据库milvusDatabase默认defaultMilvus 配置由 packages/chrome-extension/src/config/milvusConfig.ts 中的MilvusConfigManager统一读写getMilvusConfig()要求必须存在milvusAddress认证字段token 或用户名密码对本地实例可留空validateMilvusConfig()只做最基础的地址非空校验。地址未带协议前缀时浏览器端适配器会自动补上http://见 packages/chrome-extension/src/stubs/milvus-vectordb-stub.ts。设置页还提供Test Milvus Connection按钮它会先将表单值暂存到 storage再向后台脚本发送testMilvusConnection消息由后台用ChromeMilvusAdapter.testConnection()尝试一次集合探测请求并针对网络不通、CORS 拦截、401 未授权、404 地址错误等常见故障返回可读的排错提示见 background.ts。页面底部内置调试面板可展开查看设置保存/恢复的实时日志方便排查问题。权限清单扩展声明的权限与用途见 packages/chrome-extension/src/manifest.jsonstorage保存配置与索引元数据scripting向 GitHub 页面注入搜索 UIunlimitedStorage本地存储向量嵌入等较大数据Host Permissionshttps://github.com/*、https://api.openai.com/*以及http://*/*、https://*/*供 Milvus REST 服务端与嵌入 API 调用。Content Script 仅匹配https://github.com/*/*仓库级路径并注入styles.cssManifest 同时声明了wasm-unsafe-eval的扩展页 CSP 以及ort-wasm-simd-threaded.wasm等 web 可访问资源为浏览器端 WASM 推理预留能力。底层实现原理索引流水线点击 Index Repository 后content script 向后台发送indexRepo消息后台的完整链路如下核心逻辑在 packages/chrome-extension/src/background.tscheckRepositoryAccess()用 GitHub Token 探测仓库区分 404仓库不存在或无权限、403限流/权限不足等错误fetchRepoFiles()调用 GitHub Git Trees API/git/trees/{default_branch}?recursive1获取全量文件树并按扩展名白名单过滤支持的代码类型包括ts/tsx/js/jsx/py/java/cpp/c/h/hpp/cs/go/rs/php/rb/swift/kt/scala/m/mm/mdfetchFileContent()通过 Contents API 拉取每个文件内容base64 解码splitCode()对文件内容做行级切块默认chunkSize1000、chunkOverlap200与 VSCode 扩展默认值保持一致见 background.ts采用带重叠滑窗的字符切分保留startLine/endLine行号信息EmbeddingModel.embedBatch()以每批 100 个 chunkEMBEDDING_BATCH_SIZE调用 OpenAI embeddings 接口生成 1536 维向量EMBEDDING_DIMMilvusVectorDB.addChunks()批量写入 Milvuscollection 命名为chrome_repo_${owner}_${repo}非字母数字替换为下划线。索引期间后台会通过indexProgress消息向页面推送Indexed X/Y files (N chunks)的实时进度单文件 chunk 数超过 50 或内容超过 100KB 会给出告警日志。索引完成后调用IndexedRepoManager.addIndexedRepo()记录元数据并通知页面显示完成状态。向量数据库适配层扩展没有直接依赖 Node 版 Milvus SDK而是通过 packages/chrome-extension/src/stubs/milvus-vectordb-stub.ts 提供了一份面向浏览器的轻量 Milvus RESTful 实现基于核心包MilvusRestfulVectorDatabase的接口形态重写请求走{address}/v2/vectordbREST 端点认证支持Bearer token或Bearer username:password两种形式。封装层 packages/chrome-extension/src/milvus/chromeMilvusAdapter.ts 的ChromeMilvusAdapter提供了索引与检索的全部原语createCollection(dimension1536)建集合并写入描述信息insertChunks()将CodeChunkid、content、relativePath、startLine、endLine、fileExtension、metadata、vector转换为向量文档批量插入searchSimilar(queryVector, limit10, threshold0.3)以余弦相似度检索默认 topK 10、阈值 0.3结果按分数降序排序并附调试日志展示前 5 条命中路径、分数与行号区间clearCollection()删除集合后重建实现一键清空索引getCollectionStats()返回集合实体数用于索引状态展示。后台脚本中还内置了cosSim()余弦相似度实现与批量向量求均值逻辑为后续排序与多查询合并提供基础。搜索流程搜索时 content script 发送searchCode消息后台执行见 background.ts初始化对应仓库的MilvusVectorDB必要时自动建集合用查询文本调用embedSingle()得到查询向量调用searchSimilar()取回最多 20 条相似 chunk含 score更新该仓库的最近搜索时间IndexedRepoManager.updateLastSearchTime并返回结果。索引元数据管理packages/chrome-extension/src/storage/indexedRepoManager.ts 负责在chrome.storage.local中以indexedRepositories键维护已索引仓库记录id、owner、repo、indexedAt、totalFiles、totalChunks、lastSearchAt、collectionName新增仓库时去重后插入队首最多保留 5 条isRepoIndexed()供页面加载时自动查询索引状态getRecentlyIndexedRepos()按索引时间倒序返回供 Recent Repos 面板展示每条显示文件数、chunk 数、索引日期与最近搜索日期cleanupOldRepos()支持按天数默认 30 天清理过期记录。浏览器兼容策略Node 生态的模块在浏览器中不可直接用webpack.config.js 通过resolve.fallback将crypto、stream、buffer、path、util、process、os、http、https、zlib、url、assert等替换为 browserify 系 polyfill同时将fs、tls、net、dns、child_process、http2、module、worker_threads置为false不打包并用NormalModuleReplacementPlugin把vm模块替换为仓库自带的 packages/chrome-extension/src/vm-stub.js。ProvidePlugin全局注入process与BufferDefinePlugin固定NODE_ENVproduction并把global指向globalThis。生产构建经 Terser 压缩保留 console 便于排查剔除 debugger。典型使用场景基础语义搜索打开任意已索引的 GitHub 仓库在侧边栏搜索框输入自然语言查询如 error handling middleware浏览按语义相关度排序的检索结果点击跳转到对应代码行。上下文/相关代码搜索在 GitHub 页面上选中一段代码通过右键菜单扩展注入的入口触发搜索相似代码查看该仓库内语义相近的相关代码块。多仓库搜索依次为多个仓库建立索引通过扩展的 Recent Repos 面板或统一搜索入口跨仓库检索可按仓库或文件类型过滤结果。技术栈与文件结构技术栈TypeScript类型安全、Chrome Manifest V3现代扩展架构、Webpack模块打包与优化、Claude Context Core语义搜索引擎、Milvus 向量数据库向量存储与召回、OpenAI/VoyageAI Embeddings文本向量化。核心源码布局均在packages/chrome-extension下src/content.ts向 GitHub 页面注入搜索 UI 的内容脚本src/background.ts后台 Service Worker承载索引、嵌入、检索与 GitHub API 调用src/options.ts配置页逻辑GitHub Token、OpenAI Key、Milvus 连接src/config/milvusConfig.tsMilvus 连接配置的读写与校验src/milvus/chromeMilvusAdapter.ts浏览器兼容的 Milvus 适配层src/storage/indexedRepoManager.ts已索引仓库元数据管理src/stubs/面向浏览器环境的 Node 模块兼容 stubsrc/vm-stub.js、src/manifest.json、src/options.html、src/styles.css扩展清单、选项页与样式浏览器支持Chrome 88其他 Chromium 内核浏览器Edge、Brave 等扩展生态与相关包该扩展是 Claude Context monorepo 的一员仓库根目录 README.md 提供项目整体概览与安装说明CONTRIBUTING.md 为通用贡献指南扩展专属开发说明见 packages/chrome-extension/CONTRIBUTING.md。相关的姊妹包包括packages/core本扩展使用的核心索引引擎packages/vscode-extensionVSCode 集成packages/mcpMCP 服务器集成供 Claude Code 等编码 Agent 消费整个代码库上下文。许可证为 MIT见 LICENSE。如果你想为任何编码 Agent 补齐整个代码库作为上下文的能力可以先在 VSCode 或 MCP 端体验再借助本扩展在浏览器侧完成同样的语义检索闭环。【免费下载链接】claude-contextCode search MCP for Claude Code. Make entire codebase the context for any coding agent.项目地址: https://gitcode.com/GitHub_Trending/co/claude-context创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考