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
|
| хуки | хуки | Пишут журнал ваших сессий для ctxray spectate, только на этой машине |
Строка над полем ввода после каждого хода показывает, из чего состоит контекст: полосу со своим цветом для каждой доли, сумму, её долю от окна модели и самые крупные доли по именам. Кнопка 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 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 попросит сначала задать вопрос.
Скиллы, встроенные в 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. Укажите харнессы, на которые он смотрит по умолчанию:
Плагин добавляет в 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.
Start
Use
Teams
Develop
По-русски
- Начало работы · Понятия · Loadout Stack · Режимы захвата
- Тесты · Конфигурация · Политики · Харнессы · Команды · Отчёты · Плагин Claude Code
- CI · Enterprise
- Архитектура · Локализация · Участие
{ "mcpServers": { "ctxray": { "command": "ctxray", "args": ["mcp", "--harness", "codex"] } } }