Repository navigation
Claude Code Plugin RU
Плагин 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 или команда /ctxray-loadout открывает панель рядом с чатом.
В панели четыре вкладки, клавиши 1–4 переключают их, пока панель в фокусе. Esc её закрывает.
- Обзор: каждая доля с полоской, токенами и процентом от того, что сейчас в контексте.
-
Файлы: каждый
CLAUDE.mdи правило, которые загрузились, — путь от корня проекта или от~и уровень (проект, пользователь, локальный, организация). Файл, который принёс@-импорт, стоит под файлом, который его импортировал. - Инструменты: встроенные инструменты, каждый MCP-сервер со своими инструментами и то, что ждёт за поиском инструментов.
- Скиллы: каждый скилл из списка с источником и токенами, а у сработавших — пометка «вызван».
Все числа здесь считает сам Claude Code, так же как /context, поэтому для этой сессии и модели они точные. Собственные подсчёты ctxray в других местах помечены ≈. Строке и панели нужен Claude Code 2.1.286 или новее. Более старая версия их пропускает, а остальной плагин работает. Они говорят по-английски и по-русски и выбирают язык так же, как CLI: CTXRAY_LANG, затем LC_ALL, LC_MESSAGES и LANG.
/ctxray запускает ctxray __session --id <эта сессия> --plugin-root <папка плагина> — команду, которой пользуется только плагин. ctxray восстанавливает последний запрос сессии из транскрипта Claude Code и печатает его: системный промпт, встроенные инструменты, правила и причину загрузки каждого, скиллы и MCP-серверы, у каждого — токены. Claude показывает этот отчёт как есть и добавляет не больше двух предложений: что занимает больше всего места и как это конкретно уменьшить.
Собственные скиллы и 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 --layer L1-L3
/ctxray-test --filter payments --harness claude-code
Если всё прошло, Claude скажет об этом одной строкой. Иначе он назовёт каждый упавший тест с его слоем и харнессом, что ожидалось и что получилось, и самую маленькую правку правил, скиллов или теста, которая это исправит. Файлы он не меняет, пока вы не попросите.
Обе команды запускаются, только когда вы их набираете: сам Claude их не выбирает.
Когда вы просите Claude протестировать ваш CLAUDE.md, правила, скиллы или настройку MCP, загружается скилл write-tests. Он объясняет Claude API тестов от L3 до L7, матчеры, снапшоты, discover и corpus и учит выбирать самый низкий слой, который доказывает нужное. Writing Tests — тот же материал для людей.
Плагин запускает 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. Укажите харнессы, на которые он смотрит по умолчанию:
Все параметры ctxray mcp перечислены на странице Commands.
Start
Use
Teams
Develop
По-русски
- Начало работы · Понятия · Loadout Stack · Режимы захвата
- Тесты · Конфигурация · Политики · Харнессы · Команды · Отчёты · Плагин Claude Code
- CI · Enterprise
- Архитектура · Локализация · Участие
{ "mcpServers": { "ctxray": { "command": "ctxray", "args": ["mcp", "--harness", "codex"] } } }