Skip to content

Claude Code Plugin RU

Pavel Erokhin edited this page Nov 16, 2026 · 6 revisions

English version

Плагин ctxray встраивает ctxray в ваши сессии Claude Code. /ctxray показывает, что загрузила текущая сессия, /ctxray-test запускает тесты, а сам Claude учится писать тесты ctxray и проверять свои правки на раздутый контекст.

Установка

Плагин запускает исполняемый файл ctxray, поэтому сначала установите ctxray (Getting Started) и убедитесь, что ctxray --version работает в вашей оболочке. Затем добавьте маркетплейс и плагин:

claude plugin marketplace add MairwunNx/ctxray
claude plugin install ctxray@ctxray

Маркетплейс — это сам репозиторий ctxray. Его .claude-plugin/marketplace.json описывает один плагин, ctxray, из packages/claude-plugin. Версия плагина совпадает с версией CLI.

Без доступа к сети

В каждом релизе плагин лежит отдельным файлом ctxray-claude-plugin.zip, и ещё одна копия есть в каждом архиве релиза. Claude Code загружает zip как есть:

claude --plugin-dir ctxray-claude-plugin.zip

Что вы получаете

Часть Вид Что делает
/ctxray слэш-команда Показывает, что загрузила эта сессия, по кускам и с токенами
/ctxray-test слэш-команда Запускает тесты ctxray проекта и объясняет, что упало
write-tests скилл Учит Claude писать и чинить тесты *.ctxray.ts
ctxray MCP-сервер Даёт Claude инструменты inspect, run и diff
хуки хуки Пишут журнал ваших сессий для ctxray spectate, только на этой машине

/ctxray

/ctxray запускает ctxray spectate --session <эта сессия> --plugin-root <папка плагина>. ctxray восстанавливает последний запрос сессии из транскрипта Claude Code и печатает его: системный промпт, встроенные инструменты, правила и причину загрузки каждого, скиллы и MCP-серверы, у каждого — токены. Claude показывает этот отчёт как есть и добавляет не больше двух предложений: что занимает больше всего места и как это конкретно уменьшить.

Собственные скиллы и MCP-сервер плагина перечислены отдельно и в итоги не входят, так что ctxray не считает сам себя. Локальные подсчёты помечены ≈, как везде в ctxray.

/ctxray читает запросы, которые Claude Code записывает в транскрипт сессии. ctxray проверяет это на Claude Code 2.1.311 и 2.1.325. Более старая версия может их не записывать, и тогда /ctxray так и скажет.

/ctxray-test

/ctxray-test запускает ctxray test из корня проекта и передаёт всё, что вы напишете после команды:

/ctxray-test --layer L1-L3
/ctxray-test --filter payments --harness claude-code

Если всё прошло, Claude скажет об этом одной строкой. Иначе он назовёт каждый упавший тест с его слоем и харнессом, что ожидалось и что получилось, и самую маленькую правку правил, скиллов или теста, которая это исправит. Файлы он не меняет, пока вы не попросите.

Обе команды запускаются, только когда вы их набираете: сам Claude их не выбирает.

Скилл write-tests

Когда вы просите Claude протестировать ваш CLAUDE.md, правила, скиллы или настройку MCP, загружается скилл write-tests. Он объясняет Claude API тестов от L3 до L7, матчеры, снапшоты, discover и corpus и учит выбирать самый низкий слой, который доказывает нужное. Writing Tests — тот же материал для людей.

MCP-сервер

Плагин запускает ctxray mcp --harness claude-code — MCP-сервер на stdin и stdout. Claude видит три инструмента:

Инструмент Входные данные Запускает
inspect cwd (папка, где стартует агент), files (файлы, с которыми он работает), harness ctxray inspect
run layer (например, L1,L2,L3), filter, harness ctxray test
diff base (обязательно, например main или HEAD~1), harness ctxray diff

Все входные данные, кроме base, необязательны. Вызов без harness смотрит на Claude Code — это собственный --harness сервера.

Каждый вызов запускает ctxray в папке проекта, где работает Claude Code, без цвета, и возвращает напечатанное, обрезанное до 40 000 символов. Упавший тест или сломанный конфиг помечают вызов как ошибку, так что Claude понимает, что проверка не прошла. Описания инструментов подсказывают Claude вызывать diff после правки правила, скилла или конфига MCP: так он видит, вырос ли контекст и насколько.

ctxray mcp работает с любым агентом, который говорит на MCP, а не только с Claude Code. Укажите харнессы, на которые он смотрит по умолчанию:

{
  "mcpServers": {
    "ctxray": { "command": "ctxray", "args": ["mcp", "--harness", "codex"] }
  }
}

Хуки

Плагин добавляет в Claude Code три хука: SessionStart, InstructionsLoaded и UserPromptSubmit. Каждый запускает хук spectate, который дописывает одну строку в журнал ctxray на этой машине. По этому журналу ctxray spectate показывает, что загрузили ваши последние сессии (режим observe описан на странице Capture Modes).

Хук сохраняет id сессии, рабочую папку, модель и каждый загруженный файл инструкций с причиной загрузки. От промпта он хранит только длину, но никогда не текст. Каждая строка проходит редактирование секретов до записи.

Хука SessionEnd нет. Плагин, загруженный из zip, к концу сессии уже выгружен, и Claude Code сообщил бы, что хук упал. ctxray spectate он и не нужен: остальные события сессии дают всё, что он показывает.

Claude Code Desktop и Cursor

Плагин — для Claude Code. Для вкладки Code в приложении Claude и для Cursor тот же вид хуков добавляет в ваши пользовательские файлы ctxray spectate install:

ctxray spectate install                        # Claude Code и Cursor
ctxray spectate install --harness cursor-ide   # только Cursor
ctxray spectate                                # что загрузили последние сессии
ctxray spectate uninstall                      # убрать хуки

Для Claude Code и приложения Claude команда пишет в ~/.claude/settings.json (или $CLAUDE_CONFIG_DIR/settings.json), заодно с хуком SessionEnd. Для Cursor (и CLI, и редактора) — в ~/.cursor/hooks.json. Она дополняет ваши хуки и никогда их не заменяет, а uninstall убирает только хуки ctxray. Для Claude Code выберите что-то одно — плагин или spectate install: с обоими каждое событие попадёт в журнал дважды, и ctxray spectate посчитает каждый промпт два раза.

Все параметры ctxray spectate и ctxray mcp перечислены на странице Commands.

Clone this wiki locally