Repository navigation
Capture Modes RU
ctxray узнаёт, что загружает харнесс, одним из трёх способов. Он читает файлы, запускает харнесс и записывает его запросы или записывает сессию, которую ведёте вы сами. Каждый способ видит свою часть Loadout и стоит по-разному.
| Харнесс | 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 пишет для них «после запуска». Захват закрывает этот пробел: его числа — это настоящий запрос.
ctxray повторяет, как каждый харнесс находит свои файлы: какие файлы инструкций он читает и в каких папках, как работают импорты и glob, какие скиллы и MCP-серверы попадают в список. Список файлов проекта ctxray берёт из git, включая новые неигнорируемые файлы, так что читает то же, что харнесс увидел бы в вашей рабочей копии. Ничего не запускается, и ничего не покидает вашу машину.
Начиная с L4 ctxray запускает настоящий харнесс и записывает, что тот отправляет. В вашей рабочей копии и с вашей настоящей домашней папкой он этого не делает никогда:
-
Копия проекта. 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-* во временной папке системы, чтобы вы видели, что отправил харнесс.
По умолчанию запущенный харнесс не видит ничего из вашей пользовательской настройки, поэтому результат одинаков на любой машине и в CI. Чтобы проверить, как ваши собственные правила, скиллы и MCP-серверы сочетаются с проектными, впустите их:
export default defineConfig({
harnesses: { "claude-code": { userScope: "inherit" } },
});С inherit ctxray копирует ваши пользовательские инструкции, скиллы, агентов и команды в домашнюю папку прогона — копирует, а не ссылается. Ваши MCP-серверы тоже подключаются и идут через ctxray, как проектные. Файлы настроек остаются снаружи: они могли бы направить харнесс в обход ctxray. Из settings.json Claude Code переносятся только хуки. Какие папки берёт каждый харнесс, перечислено на странице Harnesses.
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.
Прогон тестов должен давать один ответ на вашем ноутбуке и в CI и не оставлять следов. Поэтому захват работает на копии, метки попадают только в копию, а харнесс пишет в домашнюю папку, которую ctxray потом выбрасывает. Настоящая домашняя папка остаётся в стороне ещё по одной причине: в ней ваши учётные данные и личная настройка, и ни то ни другое не место в результатах тестов. В домашнюю папку ctxray пишет только по команде ctxray spectate install и только потому, что вы об этом попросили.
Start
Use
Teams
Develop
По-русски
- Начало работы · Понятия · Loadout Stack · Режимы захвата
- Тесты · Конфигурация · Политики · Харнессы · Команды · Отчёты · Плагин Claude Code
- CI · Enterprise
- Архитектура · Локализация · Участие