Appearance
Claude Context 除了 MCP 模式（给 Claude Code、Cursor 等 AI 编程助手用），还提供独立的 VSCode 扩展。安装后，你可以在 VSCode 侧边栏直接输入自然语言查询，搜索整个代码库里语义相关的代码片段，还可以选中一段代码做「上下文搜索」找相关实现。配置要求和 MCP 模式相同：Embedding Provider API Key + 向量数据库。
Claude Context VSCode 扩展：在编辑器里直接做语义代码搜索
如果你不用 Claude Code 或 Cursor，但仍然想对代码库做语义搜索，Claude Context 的 VSCode 扩展是独立的选择。它不依赖任何 AI 编程助手，直接在 VSCode 里索引和搜索代码。
安装
方式一：市场搜索
- 打开 VSCode 扩展面板（
Ctrl+Shift+X） - 搜索
Semantic Code Search - 点击 Install
方式二：直接安装
要求 VSCode 版本 ≥ 1.74.0。
配置
安装后第一次打开扩展，点击设置图标，需要配置两项：
Embedding Provider
| Provider | 必填项 | 推荐模型 |
|---|---|---|
| OpenAI | API Key | text-embedding-3-small |
| VoyageAI | API Key | voyage-code-3 |
| Gemini | API Key | gemini-embedding-001 |
| Ollama | 模型名 + Host | nomic-embed-text |
选择 OpenAI 最简单，只需填 API Key。如果选 Ollama，需要先本地运行 Ollama 并拉取模型。
向量数据库（Zilliz Cloud）
- 注册 Zilliz Cloud
- 创建集群，获取 Public Endpoint 和 API Key
- 在扩展设置里填入这两个值
代码切块策略
扩展提供两种切块方式：
| 策略 | 特点 | 适合场景 |
|---|---|---|
| AST Splitter | 按语法结构切块，函数/类不会断开 | 代码文件（推荐） |
| LangChain Splitter | 按字符数切块，速度更快 | 非代码文件，或追求速度 |
建议大部分情况下选 AST Splitter。
还可以配置：
Chunk Size：每个块的最大字符数（默认 1000）Chunk Overlap：相邻块的重叠字符数（默认 200）
使用方式
索引代码库
- 打开命令面板（
Ctrl+Shift+P） - 执行
Semantic Code Search: Index Codebase
等待索引完成（状态变为 indexed）。
语义搜索
打开侧边栏的 Semantic Code Search 面板，输入自然语言查询：
text
处理用户登录和 token 刷新的逻辑在哪里返回结果是语义相关的代码片段，不是关键词匹配。
上下文搜索
选中一段代码 → 右键 → Semantic Code Search，可以找到语义相关的其他代码。适合：
- 找某个函数的调用方
- 找相似实现的代码
- 找处理相同数据结构的代码
支持的命令
| 命令 | 作用 |
|---|---|
Semantic Code Search: Semantic Search | 执行语义搜索 |
Semantic Code Search: Index Codebase | 索引当前代码库 |
Semantic Code Search: Clear Index | 清除索引 |
MCP 模式 vs VSCode 扩展
| 维度 | MCP 模式 | VSCode 扩展 |
|---|---|---|
| 使用方式 | 配合 AI 编程助手 | 独立使用 |
| 搜索触发 | AI 自动调用，自然语言即可 | 手动输入查询 |
| 适合谁 | 用 Claude Code / Cursor 的开发者 | 用 VSCode 但不用 AI 助手的开发者 |
| 索引机制 | 相同 | 相同 |
| 配置方式 | MCP 配置文件 | VSCode 设置面板 |
如果你已经在用 Claude Code，MCP 模式更方便——AI 会自动调用搜索，不需要你手动操作。VSCode 扩展适合那些还没接入 AI 编程助手、或者想在 VSCode 里快速查代码的场景。
FAQ
Q: VSCode 扩展和 MCP 会互相影响吗？ A: 不会。它们各自独立索引，使用同一个向量数据库但可能建不同集合。如果你在同一个项目上同时用两种模式，会占用双倍存储空间。
Q: 支持 VSCode 的 Remote / SSH 模式吗？ A: 支持，但索引运行在远程机器上，Embedding API 调用也从远程发出。确保远程环境能访问 Embedding Provider 和 Zilliz Cloud。
Q: 搜索结果不够精准怎么办？ A: 试试调整查询方式——语义搜索对自然语言描述效果更好，对纯关键词效果一般。如果想精确找 refreshToken，直接用 VSCode 内置全局搜索更快；语义搜索更适合「找处理登录续期的代码」这类模糊查询。