Антон Ларичев

Безопасность Codex строится на двух независимых настройках. Песочница (sandbox_mode) определяет, что агенту разрешено технически: только чтение, запись в рабочей папке или полный доступ. Политика подтверждений (approval_policy) определяет, когда он должен спросить разрешение. Для повседневной работы подходит workspace-write с on-request, а --yolo стоит оставить для одноразового окружения.
Ниже — какие бывают режимы, как открыть сеть и какие настройки выбрать для CI.
Песочница и подтверждения — разные вещи
| Настройка | Вопрос, на который отвечает | Значения |
|---|---|---|
sandbox_mode | что технически можно сделать | read-only, workspace-write, danger-full-access |
approval_policy | когда спрашивать человека | on-request, never или детальные правила |
Настройки независимы. Например, read-only с never — безопасный режим для автоматического анализа: агент ничего не изменит и никого не спросит.
Значение approval_policy = "untrusted" больше не поддерживается. Если оно осталось в конфигурации, Codex может не запуститься.
Три режима песочницы
read-only. Агент может читать файлы, но не менять их. Подходит для анализа, ревью и знакомства с проектом.
codex --sandbox read-onlyМы проверили: на просьбу создать файл команда touch завершилась ошибкой Operation not permitted, и файл не появился.
workspace-write. Агент может читать и изменять файлы внутри рабочей папки. Основной режим разработки.
danger-full-access. Ограничений файловой системы нет. Такой режим уместен только в изолированном контейнере или одноразовой виртуальной машине.
Сеть закрыта отдельно
В режиме workspace-write сеть для запускаемых команд выключена. В нашем тесте curl к внешнему сайту завершился ошибкой соединения. После включения параметра тот же запрос вернул 200:
codex --sandbox workspace-write \
-c 'sandbox_workspace_write.network_access=true'То же самое в config.toml:
[sandbox_workspace_write]
network_access = trueНе включайте сеть без необходимости. Если агент прочитает вредную инструкцию в файле или на странице, сетевой доступ откроет путь для утечки данных. Именно поэтому сочетание недоверенного кода, секретов и интернета особенно опасно.
Политики подтверждений
on-request. Агент действует в пределах песочницы и спрашивает, когда нужно выйти за них. Основной вариант для работы рядом с компьютером.
never. Запросов нет, а сбои сразу возвращаются модели. Подходит для автоматизации, но важно ограничить песочницу.
Детальные правила позволяют сохранить интерактивность для одних категорий действий и автоматически отклонять другие. Это настройка approval_policy = { granular = { ... } }.
Подтверждение — не формальность. Прочитайте команду, прежде чем разрешить её, особенно если там есть rm, изменение зависимостей, доступ к секретам или сеть.
Что выбрать
| Сценарий | Настройка |
|---|---|
| Обычная разработка | --sandbox workspace-write --ask-for-approval on-request |
| Изучение чужого кода | --sandbox read-only --ask-for-approval on-request |
| Анализ в CI | --sandbox read-only --ask-for-approval never |
| Исправление в CI | workspace-write, отдельная ветка и проверка перед слиянием |
| Одноразовый контейнер | --dangerously-bypass-approvals-and-sandbox |
В codex exec запрашивать подтверждение некому, поэтому заранее подбирайте права. Это также касается MCP-инструментов: для них можно разрешить конкретный инструмент через approval_mode.
Настройки удобно хранить в config.toml или профилях, как описано в статье config.toml в Codex.
Что песочница не защищает
- Содержимое рабочей папки. Агент может изменить или удалить файлы внутри разрешённой области, поэтому перед задачей сделайте коммит.
- Секреты внутри проекта. Если
.envчитается, он может попасть в контекст. Держите рабочие ключи вне проекта. - Качество кода. Песочница не отвечает за логику изменений.
- Команды, которые вы одобрили. Подтверждённое действие выполняется за её пределами.
- Подсказки из внешних данных. Issues, логи и веб-страницы могут содержать вредные инструкции.
Инструкции в ролях субагентов не заменяют песочницу: «не редактируй файлы» — просьба, а не запрет. Настоящие ограничения задаются на уровне родительской сессии. Об этом подробнее в статье Субагенты в Codex.
Проект и доверие
Настройки из .codex/ в репозитории загружаются только для доверенных проектов. Открывая чужой код, не отмечайте его доверенным сразу и сначала запускайте read-only.
В организациях администраторы могут запрещать небезопасные значения через управляемую конфигурацию, например approval_policy = "never" или danger-full-access.
Как проверить настройки
Внутри сессии посмотрите текущие параметры:
/statusИзменить права можно командой:
/permissionsДля общей диагностики запустите codex doctor.
Частые вопросы
Зачем нужна песочница, если есть git? Git помогает откатить изменения в репозитории, но не защитит файлы за его пределами и не вернёт утёкшие данные.
Почему npm install не работает? В workspace-write сеть закрыта. Включите её для конкретного запуска или поставьте зависимости заранее.
Что такое --yolo? Это сокращение для отключения песочницы и подтверждений. Не используйте его на основном компьютере.
Наследуют ли субагенты права? Да, они получают настройки родительской сессии.
Итог
Выбирайте минимально достаточный доступ: чтение для анализа, запись в проекте для работы, полный доступ только в одноразовом окружении. Сеть включайте отдельно и только при необходимости. Настройку безопасности для готового проекта, включая sandbox, сеть и managed config, разбираем в курсе «Продвинутый Codex».






Комментарии
0