21 ноября 2026 г.
0 просмотров
9 мин на чтение
Обновлено только что

Как устроена песочница Codex: файлы, сеть и права

Разбираем, как Codex ограничивает команды через permission profiles: что можно читать и писать, как работает сетевой прокси и чем отличаются macOS, Linux и Windows.

Как устроена песочница Codex: файлы, сеть и права
Codex sandbox — это способ запускать команды агента на вашей машине, не отдавая ему всю файловую систему и сеть. Правила задаёт профиль разрешений, который определяет, что можно читать, куда писать и какие сетевые соединения разрешены.
OpenAI опубликовала разбор 18 ноября 2026 года. Автор — Michael Bolin, участник технического штата компании. Он показывает, какие компромиссы заложены в настройки по умолчанию, как harness применяет профиль к каждой команде и почему одна и та же политика по-разному исполняется на macOS, Linux и Windows.
Ниже — практический разбор: что именно разрешает встроенный профиль, где остаётся риск, как описать собственные правила и что проверить до того, как пускать агента в рабочий репозиторий. Отдельно — сетевой прокси и ограничения, которые нельзя закрыть одной настройкой.

1. Зачем агенту границы

Песочница ограничивает то, к чему программа может обратиться во время работы. Пример из статьи: для задачи с фотографиями можно разрешить чтение и изменение файлов в ~/Pictures, но закрыть сеть, чтобы снимки нельзя было выгрузить. Для проверки кода можно открыть доступ к онлайн-документации, а исходники оставить только для чтения. В обоих случаях набор прав описывается заранее, а не выясняется по ходу дела.
Профиль разрешений — именованный набор правил для файловой системы и сети, который действует в рамках сессии Codex. Он не заменяет обучение и выравнивание модели: OpenAI называет свой подход defense in depth, то есть несколько независимых слоёв защиты. Песочница ограничивает доступ, а модель должна использовать его в соответствии с намерением пользователя.
Песочница использует механизмы операционной системы и ограничивает процесс внутри привычного окружения. Codex не копирует окружение в изолированный угол, а полагается на штатные механизмы платформы. Причина практическая: ноутбук разработчика часто содержит уникальный набор инструментов. Собрать его копию в Docker бывает долго, а часть сценариев зависит от программ, которые работают только на хосте.
Пример с iOS показывает границу подхода. Если запустить Codex в Docker на Mac, контейнер не сможет выполнить нативную цепочку сборки и открыть симулятор iPhone. Можно делегировать сборку хосту, но тогда эти операции окажутся вне песочницы и потребуют собственных ограничений. Поэтому OpenAI вкладывается в платформенную изоляцию, а не в перенос вычислений.
Отсюда главный компромисс: агент работает там, где ему удобно, но каждое расширение прав должно быть осознанным. Песочница снижает класс рисков, а не отменяет их полностью. Разница между «агенту доверяют» и «агенту дают доступ» здесь принципиальная: доверие — свойство модели и обучения, доступ — свойство процесса, который можно измерить и ограничить. Тот же вопрос — сколько доступа стоит давать модели — разобран в личном эксперименте «Как я дал LLM доступ к своему ПК и… ничего не произошло».

2. Что разрешает профиль :workspace

Встроенный профиль :workspace рассчитан на Git-репозиторий в качестве корня. Он разрешает запись внутри рабочей папки, но оставляет .git и .codex только для чтения. Так Codex может править исходники, не спрашивая подтверждение на каждое изменение, но не способен напрямую переписать .codex/config.toml или хуки в .git/hooks.
Чтение при этом широкое — в пределах прав, которые уже есть у пользователя в операционной системе. Компиляторы, рантаймы и сборщики зависят от SDK, библиотек и конфигов за пределами репозитория; если закрыть всё, обычные сценарии сломаются. Обратная сторона: чувствительные файлы в других каталогах тоже остаются доступными. В статье прямо названы конфиги, в которых лежат API-ключи.
Сеть по умолчанию выключена. Это блокирует прямые выгрузки во внешние сервисы, включая попытки отправить прочитанные данные. Одновременно отказывают и легитимные операции: скачивание зависимостей требует отдельного разрешения.
Остаётся риск, который не ловится правами файловой системы. Агент может внедрить вредоносный код в локально установленный пакет, например в node_modules/prettier. Изменение не появится в git status, потому что node_modules обычно игнорируется. Если редактор запускает эту копию Prettier при сохранении, код выполнится уже вне песочницы Codex.
Этот сценарий объясняет, почему одних ограничений недостаточно. Песочница сужает доступ, но не проверяет намерения. Последний слой — человек, который смотрит на diff и понимает, какие инструменты запускаются автоматически при сохранении файла.

3. Как harness запускает команду

Harness выполняет вызовы инструментов, которые сгенерировала модель. Для кода основной инструмент — shell: он запускает команду так же, как пользователь запустил бы её в Bash. Внутри harness команда проходит через общий API, который принимает программу с аргументами, рабочий каталог, окружение, профиль разрешений и, если нужно, сетевой прокси.
Функция запускает процесс в песочнице и возвращает handle, с помощью которого harness ждёт завершения. Дочерние процессы наследуют ограничения родителя, поэтому они действуют на всё дерево, включая потомков, которые пережили исходный процесс. Запрет не заканчивается на первой команде — это важная деталь для сборочных скриптов, которые порождают новые процессы.
У инструмента exec_command есть отдельный механизм исключений. Модель может попросить другой уровень доступа для конкретной команды: использовать настройки по умолчанию, расширить права внутри песочницы или потребовать выполнения вне неё. Решение принимает harness, а не модель. В зависимости от настроек он может спросить пользователя или отправить запрос на автоматическое рассмотрение.
Если выполнение разрешено, Codex передаёт нужный профиль и прокси в ту же функцию запуска. Расширение прав не происходит молча: у запроса есть обоснование, а для повышенного уровня — отдельное поле, которое видит пользователь. Это не формальность, а точка, где человек может остановить опасную операцию.
Тот же механизм используют не только для shell. Чтение и изменение локальных файлов тоже проходят через инфраструктуру песочницы. Кроме того, её можно вызвать отдельно командой codex sandbox — она пригодится, чтобы проверить профиль без запуска агентской сессии. Похожие приёмы для другого агента собраны в материале «5 готовых сценариев Claude Code для маркетолога»: там видно, зачем агенту доступ к файлам и как быстро он разрастается.

4. Профили и слои конфигурации

Именованный профиль позволяет переиспользовать одни и те же правила в разных проектах. Свои профили описывают в config.toml в секции [permissions]. Профиль может наследоваться от встроенного: строки, начинающиеся с двоеточия, принадлежат Codex.
Запись, чтение и полный запрет — три уровня для путей. Таблица :workspace_roots задаёт правила относительно корней проекта. Codex CLI считает корнем текущий рабочий каталог, а десктопное приложение ChatGPT — исходные папки проекта. Каждое правило применяется ко всем корням, поэтому .vscode в профиле выше становится read-only в каждом из них.
Настройки собираются из нескольких config.toml. Таблицы сливаются рекурсивно, побеждает источник с более высоким приоритетом, а массивы заменяются целиком. Поэтому пути и домены описаны таблицами: команда может добавить одну запись и унаследовать остальные из базовой конфигурации организации.
Администратор может ограничить выбор профилей через requirements.toml. Такие требования приходят из системных файлов и облачной политики; облачные имеют приоритет над /etc/codex/requirements.toml. Профиль, у которого в итоговой таблице стоит false или которого там нет, пользователю недоступен. Так организация задаёт рамку, а сотрудник настраивает детали внутри неё.
Проверить профиль можно командой codex sandbox с флагом --permission-profile. В статье показан тест: запись в .vscode/settings.json должна быть заблокирована, потому что каталог открыт только для чтения. На macOS команда возвращает ошибку Operation not permitted. Это хороший способ убедиться, что правило работает, до того как доверить агенту реальные файлы.

5. Сеть и три платформы

Для сети есть три режима: полностью выключить доступ, разрешить прямой выход или поставить прокси, который решает, что пропускать. Первый вариант — настройка по умолчанию для :workspace, второй — для :danger-full-access. Третий включается в профиле и требует, чтобы прокси был активирован в конфигурации или управляемых требованиях.
Правила доменов поддерживают точные имена и маски, причём явный запрет важнее разрешения. Прокси может приостановить запрос к домену без правила и передать его harness на согласование. Порядок важен: даже DNS-запрос может привести к утечке информации в имени хоста, поэтому имя разрешается только после того, как запрос признан допустимым. Широкие маски и доступ к DNS-сервисам всё равно оставляют возможность для DNS-утечек.
Прокси поддерживает HTTP и SOCKS5, а адреса передаёт процессу через переменные окружения: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и профильные варианты вроде PIP_PROXY. Не все программы их слушают. Если приложение пытается соединиться напрямую, его останавливает уже песочница операционной системы.
На macOS используется Seatbelt — механизм изоляции на уровне ядра Apple. Политики пишут на Scheme-подобном языке SBPL, вызов идёт через /usr/bin/sandbox-exec. Утилита помечена как deprecated, но macOS продолжает поставлять профили, а Chrome и Chromium по-прежнему на неё опираются. OpenAI планирует использовать Seatbelt в обозримом будущем.
На Linux Codex собирает окружение из bubblewrap и seccomp-bpf. Вспомогательный процесс codex-linux-sandbox создаёт файловое представление в отдельном mount namespace, а затем применяет фильтры системных вызовов. При выключенной сети блокируются connect и bind; при включённом прокси разрешаются IP-сокеты, но по умолчанию запрещается создание Unix-сокетов. Механизм no_new_privs не даёт процессу получить дополнительные привилегии.
На Windows Codex переходит на MXC — библиотеку Microsoft для изолированного выполнения кода. Она должна убрать несколько ограничений прежней реализации: потребность в правах администратора, медленные операции с ACL и необходимость держать на хосте состояние настройки, включая ACL, правила фаервола, пользователей песочницы и файлы control plane.
MXC получает JSON-конфигурацию с командой, рабочим каталогом, окружением и правами. Codex разрешает чтение реестра и доступ к Win32k и рабочему столу, которые нужны PowerShell при старте, но выключает буфер обмена, инъекции ввода и изменение системных настроек. Запрещены и попытки MXC менять права файловой системы хоста.
Корни дисков выдаются только для чтения, потому что политика MXC по умолчанию всё запрещает. Права на запись в корень не наследуются рекурсивно, поэтому Codex расширяет их на существующие непосредственные дочерние элементы. Более конкретный путь перекрывает родительский: рабочая папка может быть доступна для записи внутри read-only диска, а .git в ней останется read-only. При конфликте вариантов написания путей и алиасов побеждает более строгое право.

6. Что сделать

Настройка песочницы — это не один переключатель, а несколько решений: какой профиль взять за основу, какие пути закрыть, нужен ли сети прокси и кто утверждает исключения. Чек-лист ниже помогает пройти эти решения в порядке, где ошибка стоит дешевле. Если какой-то пункт нельзя выполнить без широкого доступа, заведите отдельный профиль под эту задачу, а не ослабляйте основной.

Заключение

Песочница Codex полезна привязкой к реальному окружению: не нужно собирать копию ноутбука в контейнере, а ограничения применяются к процессу и его потомкам. Плата за это — зависимость от платформенных механизмов и необходимость описывать политику вручную. На Windows реализация ещё меняется, а на macOS опирается на инструмент, помеченный как deprecated.
Риски вроде подмены локального пакета остаются за пределами песочницы, поэтому diff и права редактора — часть той же системы защиты, а не отдельная гигиена. Правило, которое сегодня кажется лишним, завтра может закрывать реальный риск.

Что спрашивают перед внедрением

Вопросы ниже возникают при первом знакомстве с песочницей. Ответы опираются на инженерный разбор OpenAI и на описанные в нём профили, а не на предположения о том, как «должно быть». Если ваш сценарий не покрыт, проверьте его командой codex sandbox до запуска агента.

Первоисточники

Факты и формулировки сверены с инженерным разбором OpenAI и документацией проекта Codex; данные зафиксированы на 20 ноября 2026 года. Ссылки ведут на публикацию и официальные материалы, на которые она опирается. Команды и названия профилей стоит перепроверить в актуальной версии Codex: песочница для Windows ещё находится в переходе на MXC.