Skip to content

Claude Code Plugin RU

Pavel Erokhin edited this page Nov 20, 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

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

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

Строка и панель Loadout

Строка над полем ввода после каждого хода показывает, из чего состоит контекст: полосу со своим цветом для каждой доли, сумму, её долю от окна модели и самые крупные доли по именам. Кнопка Loadout или команда /ctxray-loadout открывает панель рядом с чатом.

Claude Code со строкой ctxray над полем ввода и панелью Loadout справа: в контексте 31k из 1M: встроенные инструменты 25k, системный промпт 3.1k, скиллы 2.2k, MCP-инструменты 279, файлы инструкций 273.

В панели четыре вкладки, клавиши 1–4 переключают их, пока панель в фокусе. Esc её закрывает.

  • Обзор: каждая доля с полоской, токенами и процентом от того, что сейчас в контексте.
  • Файлы: каждый CLAUDE.md и правило, которые загрузились, — путь от корня проекта или от ~ и уровень (проект, пользователь, локальный, организация). Файл, который принёс @-импорт, стоит под файлом, который его импортировал.
  • Инструменты: встроенные инструменты, каждый MCP-сервер со своими инструментами и то, что ждёт за поиском инструментов.
  • Скиллы: каждый скилл из списка с источником и токенами, а у сработавших — пометка «вызван».
Вкладка «Файлы»: CLAUDE.md, 104 токена, под ним docs/payments.md и docs/style.md, оба импортированы из CLAUDE.md.

Все числа здесь считает сам Claude Code, так же как /context, поэтому для этой сессии и модели они точные. Собственные подсчёты ctxray в других местах помечены ≈. Строке и панели нужен Claude Code 2.1.286 или новее. Более старая версия их пропускает, а остальной плагин работает. Они говорят по-английски и по-русски и выбирают язык так же, как CLI: CTXRAY_LANG, затем LC_ALL, LC_MESSAGES и LANG.

/ctxray

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

/ctxray в Claude Code: около 34 тысяч токенов в контексте, из них 27 тысяч — встроенные инструменты, CLAUDE.md с двумя импортами меньше 400, 13 встроенных скиллов в одной строке.

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

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

Скиллы, встроенные в Claude Code, занимают одну строку: изменить их нельзя, важна только сумма.

/ctxray-test

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

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

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

/ctxray-test: четыре проверки прошли, одна упала, потому что paths правила не захватывают src/checkout, и Claude предлагает добавить src/checkout/**/*.ts.

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

Скилл write-tests

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

В ответ на просьбу написать тест Claude загружает скилл write-tests, пишет tests/checkout.ctxray.ts, запускает его и объясняет дыру, которую нашёл упавший тест.

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. Для Cursor CLI или для Claude Code без плагина тот же вид хуков добавляет в ваши пользовательские файлы ctxray spectate install:

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

Для Claude Code команда пишет в ~/.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