Skip to content

Capture Modes RU

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

English version

ctxray узнаёт, что загружает харнесс, одним из трёх способов. Он читает файлы, запускает харнесс и записывает его запросы или записывает сессию, которую ведёте вы сами. Каждый способ видит свою часть Loadout и стоит по-разному.

static читает файлы и предсказывает Loadout. capture запускает харнесс и записывает его запросы. observe записывает ваши собственные сессии через хуки харнесса.

Какой харнесс какой режим поддерживает

Харнесс static capture observe
Claude Code ✓ ✓ ✓
Codex ✓ ✓
Gemini CLI ✓ ✓
OpenCode ✓ ✓
Cursor CLI ✓ экспериментально ✓
Cursor (редактор) ✓ ✓
Claude Code Desktop ✓ ✓

Захват Cursor CLI работает через недокументированную локальную сборку Cursor, поэтому включается вручную:

export default defineConfig({
  harnesses: { "cursor-cli": { experimental: true } },
});

Тест, которому нужен захват, пропускает харнесс без него как неподдерживаемый, и отчёт называет, чего не хватает. Файлы и подробности запуска каждого харнесса описаны на странице Harnesses.

Что видно в каждом режиме

static capture observe
Правила предсказаны по файлам то, что дошло до модели то, что харнесс сообщил о загрузке
Скиллы в списке, предсказаны в списке и загруженные Claude Code с --session
MCP-серверы по именам из конфига ✓ Claude Code с --session
Схемы MCP-инструментов ✗ ✓, отложенные помечены Claude Code с --session
Системный промпт и встроенные инструменты ✗ ✓ Claude Code с --session
Токены локальная оценка файлов локальная оценка или точный счёт провайдера локальная оценка

Статический режим быстрый и бесплатный, но знает только ваши файлы. Он не видит ни собственный системный промпт харнесса, ни встроенные инструменты, ни инструменты MCP-сервера, поэтому их токены неизвестны, а не равны нулю. Вот почему inspect пишет для них «после запуска». Захват закрывает этот пробел: его числа — это настоящий запрос.

static: чтение файлов

ctxray повторяет, как каждый харнесс находит свои файлы: какие файлы инструкций он читает и в каких папках, как работают импорты и glob, какие скиллы и MCP-серверы попадают в список. Список файлов проекта ctxray берёт из git, включая новые неигнорируемые файлы, так что читает то же, что харнесс увидел бы в вашей рабочей копии. Ничего не запускается, и ничего не покидает вашу машину.

capture: запуск харнесса

Начиная с L4 ctxray запускает настоящий харнесс и записывает, что тот отправляет. В вашей рабочей копии и с вашей настоящей домашней папкой он этого не делает никогда:

ctxray копирует проект, ставит в каждый файл метку и даёт каждой сессии свою папку. Харнесс работает в песочнице: запросы к модели идут в прокси ctxray, MCP-серверы стоят за прослойкой ctxray, а любое другое соединение упирается в сторожа. Трейс без секретов режется на сегменты, из которых получается Loadout для вашего теста.

  • Копия проекта. ctxray копирует репозиторий во временную папку через git clone --shared и накладывает сверху ваши незакоммиченные изменения, включая игнорируемые файлы инструкций вроде CLAUDE.local.md. Каждая сессия потом получает свой copy-on-write клон этой копии.
  • Метки. В копии ctxray дописывает в каждый файл инструкций, скилла и команды метку вида ⟦ctx:CLAUDE.md⟧. Если метка вернулась в запросе, ctxray знает, что файл дошёл до модели, и в его происхождении стоит canary. Ваши собственные файлы меток не получают.
  • Изолированный HOME. Харнесс работает со свежими HOME, временной папкой и папками XDG внутри прогона. Ваши ~/.claude, ~/.codex, ~/.gemini, ~/.config/opencode и ~/.cursor ему недоступны. На macOS заглушка команды security не пускает харнесс в вашу связку ключей.
  • Прокси модели. ctxray указывает харнессу локальный прокси как провайдера модели, с фиктивным ключом. Прокси отвечает выбранным бэкендом и записывает каждый обмен, уже без секретов. MCP-серверы тоже идут через ctxray, так что он слышит tools/list каждого сервера и считает каждый инструмент.
  • Сторож исходящих соединений. Все остальные соединения уходят в прокси, который их отклоняет и запоминает хост. Если харнесс пытается достучаться куда-то в обход ctxray, тест падает и называет хост.
  • Песочница. На macOS ctxray запускает харнесс под sandbox-exec, который запрещает запись за пределами папки прогона. Codex ставит себе песочницу сам, а macOS не пускает песочницу внутрь песочницы, поэтому Codex работает без неё. На других системах песочницей служит контейнер CI.

Если тест с захватом упал, ctxray сохраняет трейс сессии без секретов в папке ctxray-traces-* во временной папке системы, чтобы вы видели, что отправил харнесс.

Ваша пользовательская настройка: userScope

По умолчанию запущенный харнесс не видит ничего из вашей пользовательской настройки, поэтому результат одинаков на любой машине и в CI. Чтобы проверить, как ваши собственные правила, скиллы и MCP-серверы сочетаются с проектными, впустите их:

export default defineConfig({
  harnesses: { "claude-code": { userScope: "inherit" } },
});

С inherit ctxray копирует ваши пользовательские инструкции, скиллы, агентов и команды в домашнюю папку прогона — копирует, а не ссылается. Ваши MCP-серверы тоже подключаются и идут через ctxray, как проектные. Файлы настроек остаются снаружи: они могли бы направить харнесс в обход ctxray. Из settings.json Claude Code переносятся только хуки. Какие папки берёт каждый харнесс, перечислено на странице Harnesses.

observe: запись ваших сессий

ctxray spectate показывает, что загрузили ваши собственные сессии Claude Code и Cursor, в том числе Claude Code Desktop и редактора Cursor. Он работает через хуки харнессов, поэтому поставьте их один раз:

ctxray spectate install

Команда добавляет хук ctxray в ~/.claude/settings.json (или $CLAUDE_CONFIG_DIR/settings.json) и в ~/.cursor/hooks.json рядом с вашими записями, никогда не заменяя их. С этого момента каждая сессия оставляет по строке на событие в папке состояния ctxray. Хук хранит длину вашего промпта, но никогда не его текст.

ctxray spectate                  # последние 5 сессий
ctxray spectate --last 10
ctxray spectate --session <id>   # одна сессия Claude Code, восстановленная по транскрипту
ctxray spectate uninstall

У Claude Code хуки сообщают о каждом загруженном файле инструкций и о причине. У Cursor они сообщают, какие файлы прочитал агент, а ctxray предсказывает, что те подтянут. Для Claude Code --session идёт дальше: восстанавливает последний запрос сессии по транскрипту, с системным промптом, скиллами и MCP-инструментами, как при захвате. У Codex, Gemini CLI и OpenCode нет хуков, которыми мог бы воспользоваться ctxray, поэтому режима observe у них нет. /ctxray из плагина использует --session, чтобы показать текущую сессию, см. Claude Code Plugin.

Почему ctxray не трогает вашу рабочую копию

Прогон тестов должен давать один ответ на вашем ноутбуке и в CI и не оставлять следов. Поэтому захват работает на копии, метки попадают только в копию, а харнесс пишет в домашнюю папку, которую ctxray потом выбрасывает. Настоящая домашняя папка остаётся в стороне ещё по одной причине: в ней ваши учётные данные и личная настройка, и ни то ни другое не место в результатах тестов. В домашнюю папку ctxray пишет только по команде ctxray spectate install и только потому, что вы об этом попросили.

Clone this wiki locally