Repository navigation
Capture Modes RU
ctxray узнаёт, что загружает харнесс, одним из трёх способов. Он читает файлы, запускает харнесс и записывает его запросы или записывает сессию, которую ведёте вы сами. Каждый способ видит свою часть Loadout и стоит по-разному.
| Харнесс | static |
capture |
observe |
|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | |
| Gemini CLI | ✓ | ✓ | |
| OpenCode | ✓ | ✓ | |
| Cursor CLI | ✓ | экспериментально |
Захват Cursor CLI работает через недокументированную локальную сборку Cursor, поэтому включается вручную:
export default defineConfig({
harnesses: { "cursor-cli": { experimental: true } },
});Тест, которому нужен захват, пропускает харнесс без него как неподдерживаемый, и отчёт называет, чего не хватает. Файлы и подробности запуска каждого харнесса описаны на странице Harnesses.
static |
capture |
observe |
|
|---|---|---|---|
| Правила | предсказаны по файлам | то, что дошло до модели | то, что дошло до модели |
| Скиллы | в списке, предсказаны | в списке и загруженные | в списке и загруженные |
| MCP-серверы | по именам из конфига | ✓ | ✓ |
| Схемы MCP-инструментов | ✗ | ✓, отложенные помечены | ✓, отложенные помечены |
| Системный промпт и встроенные инструменты | ✗ | ✓ | ✓ |
| Токены | локальная оценка файлов | локальная оценка или точный счёт провайдера | локальная оценка |
Статический режим быстрый и бесплатный, но знает только ваши файлы. Он не видит ни собственный системный промпт харнесса, ни встроенные инструменты, ни инструменты 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 в плагине ctxray для Claude Code показывает, что загрузила текущая сессия. Он восстанавливает последний запрос сессии из собственного транскрипта Claude Code: системный промпт, инструменты, правила и причину загрузки каждого, скиллы и MCP-серверы, нарезанные так же, как при захвате. Для этого ничего не пишется в журнал и ничего не ставится. Как это выглядит, показано на странице Claude Code Plugin. Остальные харнессы хранят о сессии слишком мало, чтобы её восстановить, поэтому колонка observe у них пустая.
Прогон тестов должен давать один ответ на вашем ноутбуке и в CI и не оставлять следов. Поэтому захват работает на копии, метки попадают только в копию, а харнесс пишет в домашнюю папку, которую ctxray потом выбрасывает. Настоящая домашняя папка остаётся в стороне ещё по одной причине: в ней ваши учётные данные и личная настройка, и ни то ни другое не место в результатах тестов.
Start
Use
Teams
Develop
По-русски
- Начало работы · Понятия · Loadout Stack · Режимы захвата
- Тесты · Конфигурация · Политики · Харнессы · Команды · Отчёты · Плагин Claude Code
- CI · Enterprise
- Архитектура · Локализация · Участие