【OpenContextEngine】一个高效的代码上下文引擎，附 ACE 对比评测

本帖使用社区开源推广，符合推广要求。我声明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

安装 OpenContextEngine：

npm install -g open-context-engine

open-context-engine setup

按提示填写向量和重排服务的地址、API Key、模型名及向量维度。向导会安装 Python 依赖并保存配置，重排默认使用 /rerank 接口。

接入 Codex：

codex mcp add open-context-engine -- open-context-engine mcp

codex mcp get open-context-engine

第二条命令可以查看刚保存的配置。完成后重启 Codex。

进入你要搜索的项目：

cd /path/to/your-project

codex

然后直接提问：

用 open-context-engine 的 search_code 看看这个项目是做什么的，找出主要入口，附上文件路径和行号。

首次搜索需要建立索引。如果还没完成，让 Codex 用 index_status 查看进度，完成后再搜。之后会复用索引，代码保存后自动更新。

如果 Codex 找不到 open-context-engine，请参考客户端配置说明，改用绝对路径。桌面端和源码安装也可以用这种方式。

安装 OpenContextEngine：

npm install -g open-context-engine

open-context-engine setup

按提示填写向量和重排服务的地址、API Key、模型名及向量维度。向导会安装 Python 依赖并保存配置。如果已经给 Codex 配置过，这两步可以跳过。

接入 Claude Code：

claude mcp add --transport stdio --scope user open-context-engine -- open-context-engine mcp

这里的 --scope user 表示所有项目都能用。要把配置放进项目供团队共用，就在项目目录执行，并改成 --scope project。

重启 Claude Code，进入你要搜索的项目：

cd /path/to/your-project

claude

输入 /mcp 查看连接状态，然后提问：

用 open-context-engine 的 search_code 看看这个项目是做什么的，找出主要入口，附上文件路径和行号。

首次搜索需要建立索引。如果还没完成，让 Claude 用 index_status 查看进度，完成后再搜。之后会复用索引，代码保存后自动更新。

如果 Claude Code 找不到 open-context-engine，请参考客户端配置说明，改用绝对路径。

安装并完成 setup 后，运行：

open-context-engine mcp-config

按客户端要求填写输出的配置。如果客户端支持 mcpServers JSON，可以使用：

{

  "mcpServers": {

    "open-context-engine": {

      "command": "open-context-engine",

      "args": ["mcp"]

    }

  }

}

客户端需要能通过 PATH 找到 open-context-engine，否则将 command 改为命令的绝对路径。

搜索时，助手通过 directory_path 指定项目的绝对路径。只想搜索一个固定项目，也可以直接写在配置里：

"args": ["mcp", "--root", "/absolute/path/to/your-repository"]

git clone https://github.com/AnnaSuSu/OpenContextEngine.git

cd OpenContextEngine

npm ci

node bin/opencontextengine.mjs setup

接入客户端时，使用安装向导输出的 Node 和 CLI 绝对路径。

需要打包供内测安装，运行：

npm pack