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

Строка и панель 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 __session --id <эта сессия> --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"] }
  }
}

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

Clone this wiki locally