Старт 23 ноябряЖивой Поток 3 интенсива «Вайбкодинг и ИИ-агенты»: 3 недели практики, 9 живых занятийПоток 3 (23.11) →
РелизКод / SDK · В работуOpenAI Blog→ оригинал

OpenAI показала, как песочница Codex ограничивает команды агента на вашем компьютере

Агент, который запускает команды на вашем ноутбуке, должен иметь границы, и OpenAI показала, как их задаёт песочница Codex. Вместо Docker она использует встроенные средства macOS, Linux и Windows, так что агент работает в привычном окружении. По умолчанию запись разрешена только в рабочей папке, а сеть выключена. Поэтому под каждую задачу стоит заводить свой профиль прав, а не выдавать полный доступ.

AI-обработка оригинала OpenAI Blog; редакция Hamidun News
OpenAI показала, как песочница Codex ограничивает команды агента на вашем компьютере
Источник: OpenAI Blog. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникOpenAI Blog ↗
Главный редактор
Профили прав в config.tomlread, write или deny для каждого пути
Ключевой факт #2Админы фиксируют разрешённые профили через requirements.toml
Ключевой факт #3Команда codex sandbox запускает любой процесс под тем же профилем

Самое рискованное, что делает кодинг-агент, — запускает команды у вас на компьютере. Один неудачный rm или тихая выгрузка файлов на чужой сервер, и последствия вы почувствуете сразу. Инженер OpenAI Майкл Болин разобрал, как устроена песочница Codex. Она ограничивает, к чему команды агента имеют доступ, и делает это без виртуальных машин.

Почему не Docker

Привычный способ изолировать программу — контейнер или виртуальная машина. OpenAI пошла другим путём: Codex использует средства песочницы самой операционной системы и ограничивает команды в вашем обычном окружении.

Аргумент у команды практичный. Ноутбук разработчика — это набор личных настроек и инструментов, и воспроизвести его в Docker не так просто. Пример из статьи: вы пишете iOS-приложение на Mac. Внутри контейнера Codex не запустит нативную сборку и симулятор iPhone. Можно отдать эти операции хосту, но тогда они выполнятся вне песочницы и им понадобятся собственные ограничения. Поэтому OpenAI вкладывается в системную изоляцию для каждой платформы. Для macOS, Linux и Windows есть единый программный интерфейс: ему передают команду и профиль прав, а если разрешён ограниченный доступ в сеть, ещё и сетевой прокси. Все дочерние процессы наследуют ограничения родителя, даже те, что живут дольше исходной команды.

Что разрешено по умолчанию

Встроенный профиль :workspace выбирает осторожные значения, при которых агент всё же может работать:

  • Запись разрешена только в рабочей папке проекта. Каталоги .git и .codex остаются только для чтения, так что агент не подменит хуки Git и конфиг Codex.
  • Чтение разрешено почти везде, в рамках обычных прав ОС. Компиляторам и сборщикам нужны библиотеки за пределами репозитория. Обратная сторона честно названа: файлы с API-ключами в других местах тоже могут оказаться читаемыми.
  • Сеть выключена. Это закрывает прямую выгрузку данных, но и мешает скачивать зависимости.

OpenAI прямо признаёт, что защита неполная. Агент теоретически может подсунуть вредный код в локальный пакет, например node_modules/prettier. Git такие папки обычно игнорирует, а если редактор запускает этот Prettier при сохранении файла, код выполнится уже вне песочницы. Поэтому компания называет подход «защитой в глубину»: песочница ограничивает доступ, а обучение и выравнивание модели отвечают за то, как она им распоряжается.

Как настраивать профили

Права описываются в config.toml именованными профилями. Для каждого пути указывается read, write или deny, а профиль можно унаследовать от встроенного. В примере профиль dev расширяет :workspace: даёт запись в ~/build-cache, делает .vscode и .devcontainer доступными только для чтения и полностью закрывает файлы .env и папку secrets.

С сетью три варианта: выключить совсем (по умолчанию), открыть полностью (профиль :danger-full-access) или пустить трафик через прокси с правилами по доменам. В правилах работают точные имена и маски, а явный deny важнее allow. Запросы к остальным доменам блокируются или требуют подтверждения.

Для компаний есть слоистая конфигурация. Таблицы из разных config.toml сливаются рекурсивно, а массивы заменяются целиком. Администратор через requirements.toml задаёт список допустимых профилей, например разрешает :read-only и запрещает :danger-full-access. Облачные требования приоритетнее локального файла /etc/codex/requirements.toml, и пользователь не может обойти запрет.

Модель тоже может попросить больше прав для отдельной команды: расширенный доступ внутри песочницы или запуск вне её. Решает не модель, а обвязка: она спросит пользователя или отправит запрос в автопроверку.

Песочница для ваших инструментов

Отдельно полезна команда codex sandbox. Она запускает любой процесс под профилем из конфига Codex, и ею удобно проверять свои правила. В примере попытка записать вредоносный .vscode/settings.json под профилем dev на macOS завершается ошибкой «Operation not permitted».

Вторая идея — изолировать MCP-серверы. Codex не пытается их ограничивать сам: он не знает, какие файлы и сети серверу нужны. Поэтому запуск через npx работает с полными правами пользователя. OpenAI предлагает обернуть команду в codex sandbox с профилем memory-mcp: запись только в ~/mcp-data и ~/.npm, сети нет, пакет зафиксирован по версии и запускается через npx --offline. Каталог данных и кэш npm нужно подготовить заранее.

Вывод для команд: не оставляйте агенту полный доступ. Заведите профиль под каждую задачу, закройте секреты через deny и проверьте правила на заведомо плохих командах. Если такая настройка кажется лишней, вспомните про Prettier: песочница снижает риск, но не убирает его полностью.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: почему не Docker?

Привычный способ изолировать программу — контейнер или виртуальная машина. OpenAI пошла другим путём: Codex использует средства песочницы самой операционной системы и ограничивает команды в вашем обычном окружении. Аргумент у команды практичный. Ноутбук разработчика — это набор личных настроек и инструментов, и воспроизвести его в Docker не так просто. Пример из статьи: вы пишете iOS-приложение на Mac. Внутри контейнера Codex не запустит нативную сборку и симулятор iPhone.

Что известно по теме: что разрешено по умолчанию?

Встроенный профиль :workspace выбирает осторожные значения, при которых агент всё же может работать: Запись разрешена только в рабочей папке проекта. Каталоги .git и .codex остаются только для чтения, так что агент не подменит хуки Git и конфиг Codex. Чтение разрешено почти везде, в рамках обычных прав ОС. Компиляторам и сборщикам нужны библиотеки за пределами репозитория. Обратная сторона честно названа: файлы с API-ключами в других местах тоже могут оказаться читаемыми. Сеть выключена.

Что известно по теме: как настраивать профили?

Права описываются в config.toml именованными профилями. Для каждого пути указывается read, write или deny, а профиль можно унаследовать от встроенного. В примере профиль dev расширяет :workspace: даёт запись в ~/build-cache, делает .vscode и .devcontainer доступными только для чтения и полностью закрывает файлы .env и папку secrets. С сетью три варианта: выключить совсем (по умолчанию), открыть полностью (профиль :danger-full-access) или пустить трафик через прокси с правилами по доменам.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…