cocoindex-io/cocoindex-code

这是什么？

核心功能

• 01支持用自然语言描述进行语义搜索，弥补 grep 精确匹配的不足。
• 02基于 tree-sitter 解析 Python、TypeScript、Rust、Go、Java、C/C++ 等多种语言。
• 03仅对变更文件增量重建索引，更新速度快。
• 04以 MCP 工具形式提供搜索，可接入 Claude Code、Codex 等编码代理。
• 05既支持本地向量模型，也可通过 LiteLLM 调用云端嵌入服务。
• 06提供 ccc grep 命令，无需索引即可按代码示例进行结构化搜索。

适用场景

• 帮助编码代理在大型陌生代码库中定位相关代码。
• 在不知道确切函数或变量名时，通过描述行为来查找实现。
• 只检索相关代码片段，降低编码代理的 token 消耗。
• 使用本地向量模型在本机完成私有代码搜索，无需 API Key。

快速上手

1. 1

   使用 pipx 安装命令行工具（含本地嵌入）

   pipx install 'cocoindex-code[full]'
2. 2

   为你的编码助手安装 ccc 技能

   npx skills add cocoindex-io/cocoindex-code
3. 3

   或在项目中手动构建索引

   ccc index
4. 4

   按语义搜索代码库

   ccc search "authentication logic"

使用前须知

• !完整版安装会引入约 1 GB 的 torch 和 transformers 以支持本地嵌入。
• !精简版需要云端嵌入服务提供商和 API 密钥。

收录于专题

标签

常见问题

cocoindex-code 是什么？

基于 AST 的语义代码搜索 CLI 与 MCP 服务，为编码代理按语义查找代码。 cocoindex-code 是一个面向本地代码库的轻量语义代码搜索工具。它使用 tree-sitter 将源码按 AST 切分成代码块并生成向量，索引保存在本地，开发者可以用自然语言描述来查找代码，而不必依赖精确的文本匹配。底层基于 CocoIndex 的 Rust 数据转换引擎，只会重新索引发生变化的文件。

cocoindex-code 可以免费使用吗？用的什么许可证？

cocoindex-code 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

cocoindex-code 还在维护吗？

活跃维护中。cocoindex-code 最近一次提交是在 2026年11月5日。

cocoindex-code 适合用来做什么？

帮助编码代理在大型陌生代码库中定位相关代码。 在不知道确切函数或变量名时，通过描述行为来查找实现。 只检索相关代码片段，降低编码代理的 token 消耗。 使用本地向量模型在本机完成私有代码搜索，无需 API Key。

cocoindex-code 怎么安装和运行？

使用 pipx 安装命令行工具（含本地嵌入）: pipx install 'cocoindex-code[full]' 为你的编码助手安装 ccc 技能: npx skills add cocoindex-io/cocoindex-code 或在项目中手动构建索引: ccc index 按语义搜索代码库: ccc search "authentication logic"

在哪里获取 cocoindex-code？

源代码和安装说明在 GitHub 上：https://github.com/cocoindex-io/cocoindex-code