lumen — плагин для Claude Code: локальный семантический поиск по коду
Индексирует проект через Go AST и ищет нужный код по смыслу, не читая файлы целиком. Работает локально, без облака и API-ключей.
/plugin install lumen@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install ory-lumen@claude-community
/plugin marketplace add anthropics/claude-plugins-officialЧто делает lumen
Lumen — это MCP-сервер для семантического поиска по коду. Он разбирает файлы через Go AST, считает эмбеддинги на локальной модели и отдаёт агенту инструмент semantic_search. Вместо чтения целых файлов Claude получает только те фрагменты, которые подходят по смыслу запроса.
Перед установкой нужен запущенный Ollama и модель: ollama pull ordis/jina-embeddings-v2-base-code. Без работающего локального сервера эмбеддингов поиск не заработает, поэтому это первое, что стоит проверить. Дальше плагин сам скачивает бинарник из релизов на GitHub, индексирует проект в фоне и регистрирует MCP-инструмент. Индексация идёт через Merkle tree, так что повторные проходы затрагивают только изменённые файлы.
Помимо semantic_search доступны health_check и index_status, а также два скилла: doctor для проверки состояния и reindex для принудительной переиндексации. В Claude они вызываются как /lumen:doctor и /lumen:reindex. Поддерживаются Linux, macOS и Windows.
Какие задачи решает
- найти функцию по описанию, не открывая десятки файлов
- сократить расход токенов на чтение кодовой базы
- переиндексировать проект после крупного рефакторинга
- проверить, что MCP-сервер и модель эмбеддингов работают
- искать по коду без отправки исходников в облако
Примеры запросов агенту
- найди через semantic_search, где обрабатывается авторизация запроса
- запусти /lumen:doctor и покажи, всё ли в порядке с индексацией
- переиндексируй проект через /lumen:reindex
Как установить lumen
Через маркетплейс плагинов
/plugin install lumen@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-community/plugin install ory-lumen@claude-community/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о lumen
Как установить lumen в Claude?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-official, затем установите плагин: /plugin install lumen@claude-plugins-official. После этого запустите новую сессию и проверьте командой /lumen:doctor.
Что делает lumen?
Строит локальный семантический индекс проекта и отдаёт Claude MCP-инструмент semantic_search. Агент находит нужные участки кода по смыслу, а не перечитывает файлы целиком.
Что нужно для работы lumen?
Запущенный Ollama с моделью ordis/jina-embeddings-v2-base-code. Эмбеддинги считаются локально, внешняя база и API-ключи не нужны.
