Рабочая среда без секретов + настройки, которые запрещают чтение. Сначала объедините эти два шага.
Режим только для чтения, подтверждение и отключение обучения выполняют разные роли. Проверьте отдельно, можно ли действительно закрыть доступ к файлам с секретами.
Проверяйте чтение, запуск и отправку по отдельности
Уберите ненужные секреты из рабочей среды. Для целевых файлов рассмотрите настройку чтения с запретом deny.
Проверьте, кто их подтверждает. Не расширяйте границы через Full access или разрешение на запуск вне песочницы.
Отдельно проверьте сетевые обращения команд, отправку в модель, а также доступ браузера и MCP.
Содержание
- 1. Различия между настройками только для чтения, подтверждения и обучения
- 2. Сначала отделите секреты от рабочей среды
- 3. Пример настроек, запрещающих чтение
- 4. Шаблоны .env и часто упускаемая область
- 5. Что останавливает отключение сети команд и что нет
- 6. Различия в переменных окружения, ОС и облаке
- 7. Проверка с помощью тестовых файлов
- FAQ
1. Различия между настройками только для чтения, подтверждения и обучения
«Нельзя изменить файл» и «нельзя прочитать файл» — это разные вещи.
Режим, который ограничивает запись. Это не функция, которая блокирует чтение содержимого доступных файлов.
Указание, где можно редактировать. Область чтения не обязательно ограничивается тем же местом.
| Управление | В основном определяет | Что не гарантирует |
|---|---|---|
| Только чтение | Можно ли изменять файлы | Что доступные секретные файлы не будут прочитаны |
| Политика подтверждения | Кто проверяет операции, выходящие за границу | Что чтение в пределах разрешённой области будет каждый раз подтверждаться человеком |
| Запрет для файлов (deny) | Запрет чтения и записи по целевым путям | Удаление уже вставленного содержимого или доступ через другие инструменты |
| Ограничение сети команд | Адреса назначения для связи команд внутри песочницы | Остановку всех обращений модели, аутентификации, браузера, MCP и т. д. |
| Настройки обучения | Использовать ли обработанные данные для улучшения моделей | Остановку самой обработки или передачи |
on-request всё равно позволяет командам в разрешённой области выполняться без дополнительного подтверждения. Если вам нужно подтверждение человеком, проверьте и политику подтверждения, и то, кто проверяет.
Отличие от автоматической проверки ИИ
approvals_reviewer = "auto_review" передаёт проверку объектов ИИ. Это не подтверждение человеком и не настройка, которая добавляет проверку ко всем уже разрешённым операциям.
Источник: OpenAI: подтверждения и границы песочницы. По обучению см. отдельную статью Настройки обучения ChatGPT и Codex и конфиденциальная информация.
2. Сначала отделите секреты от рабочей среды
Для исправлений интерфейса может хватить исходного кода и тестовых данных. Боевые API-ключи, данные клиентов и семейные документы не обязательно должны находиться в той же среде.
Простого переноса файлов в другую папку недостаточно. Если сохраняются широкие права на чтение, перенесённые файлы могут оставаться доступными.
В рабочей копии — только необходимое
Вместо боевых данных используйте небольшой входной набор, на котором можно воспроизвести проблему.
В примерах конфигурации указывайте только имена параметров. Проверьте также логи, резервные копии и историю.
Выясните, нет ли доступа к другим папкам, домашнему каталогу, общим ресурсам или подключённым приложениям.
Могут ли настройки игнорирования Git остановить чтение?
.gitignore задаёт неотслеживаемые файлы, которые Git игнорирует. Это не механизм, который отнимает право чтения на уровне ОС. Даже если поисковый инструмент обычно их пропускает, это не гарантирует отказ в чтении при прямом указании пути. Правила игнорирования, добавленные позже, также не действуют на файлы, которые Git уже отслеживает. Документация Git: что относится к gitignore.
Разница между рабочей инструкцией и техническим запретом
Запись «не читай секреты» в AGENTS.md полезна как рабочая инструкция. Однако сама по себе она не создаёт ограничение доступа на уровне ОС. Основной подход — сочетать инструкции с техническим запретом. Конкретные примеры обезличивания входных данных см. также в статье Меры предосторожности при вводе данных в ИИ.
3. Пример настроек, запрещающих чтение
Permission profiles — бета-функция. Перед использованием проверьте поддерживаемую среду и настройки, которые выбраны для текущей сессии.
read: чтениеПраво читать объект
write: редактированиеРазрешает запись в объект
deny: запретЗапрещает чтение и запись объекта
Осторожно при сочетании со старыми настройками sandbox
Если старые настройки остаются, Permission profiles могут не использоваться.
Проверьте конфликтующие настройки и ограничения администратора
Не смешивайте со старыми настройками: default_permissions и [permissions] не предназначены для совместного использования со старыми sandbox_mode и [sandbox_workspace_write]. Обычно, если в загружаемых настройках есть sandbox_mode или при запуске передан --sandbox, используется старая схема. Управление через allowed_permission_profiles со стороны администратора — отдельное условие.
Ниже приведён пример конфигурации, который сочетает официальный пример ограничения рабочей области с запретом чтения секретных файлов и подтверждением человеком. Не заменяйте существующие настройки целиком. Проверьте поддерживаемую версию, ограничения организации и нужные пути выполнения, а затем протестируйте в тестовой среде.
Где задавать настройки: пользовательские и проектные
~/.codex/config.toml
.codex/config.toml
Области действия и условия загрузки различаются. Настройки проекта загружаются только для доверенных проектов.
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"
[permissions.project-private]
extends = ":workspace"
[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"
[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"
[permissions.project-private.network]
enabled = false
Какие файлы покрывает этот пример конфигурации?
Применяется к текущей рабочей области и к каждой добавленной
.envЗапрещённый объект.env.productionЗапрещённый объектsecrets/ и всё внутриЗапрещённый объектподпапка/.envВ этом примере проверяется отдельноТот же секрет под другим именем или копии в логахВ этом примере проверяется отдельноЧтение запрещено через :root. Однако :minimal, который нужен для выполнения, и временные каталоги, которые разрешает унаследованная база, — исключения.
Наследует :workspace, разрешая редактирование, и запрещает указанные выше конкретные пути. Это не пример, который перехватывает секреты, встроенные в вывод.
Пояснения: имя настройки, несколько областей и временные файлы
project-private — название, которое дано в этом примере. :workspace_roots применяется к текущей рабочей области и к добавленным областям и задаёт целевые пути непосредственно в каждой из них. secrets относится к файлу или поддереву с тем же именем.
Это не конфигурация, которая делает недоступным чтение всего за пределами рабочей области. Также нужна практика: не копировать секреты во временные области.
Источник: OpenAI: настройки Permission profiles, запрет и область действия.
4. Шаблоны .env и часто упускаемая область
Точное указание пути подходит для секретов, которые лежат в фиксированных местах. При использовании шаблонов учитывайте, что *.env и .env.* — разные вещи. Не ориентируйтесь только на официальный пример **/*.env и не думайте, что .env.production можно запретить на тех же условиях.
| Пример шаблона | Предполагаемый объект | Что проверить отдельно |
|---|---|---|
.env | Файл с таким именем непосредственно в корне рабочей области | Вложенные папки и файлы, к имени которых добавлен суффикс |
.env.production | Файл производственной конфигурации непосредственно в корне | Производственная конфигурация под другим именем или копии |
secrets | Путь с таким именем непосредственно в корне и ниже | Копии в других местах, например в логах или резервных копиях |
**/*.env | Файлы, имя которых оканчивается на .env, на нескольких уровнях вложенности | Имена с суффиксами; глубина поиска и изменения после запуска |
Проверьте глубину и добавления после запуска
В Linux, WSL и нативном Windows шаблоны запрета с неограниченным ** могут требовать развёртывания шаблона, ограниченного по области до запуска. Официальная документация описывает два способа: задать glob_scan_max_depth со значением 1 или больше либо явно указать глубину, например *.env, */*.env или */*/*.env. Если вы используете глубокие уровни, проверяйте до этой глубины.
Файлы, созданные позже, могут оставаться доступными для чтения. По официальному описанию, в Linux, WSL и Windows (MXC или elevated) файлы, которые соответствуют шаблонам запрета, перечисляются при запуске каждого процесса. Подходящие файлы, созданные, пока этот процесс работает, не попадают под запрет и могут быть прочитаны, если другие права это разрешают. Например, уже запущенная оболочка или сервер разработки может прочитать .env, созданный позже. Поскольку перечисление повторяется при запуске нового процесса, после создания файла с секретами перезапустите работающие процессы.
Что важнее, если права пересекаются?
Более конкретное указание пути может переопределить более широкое. Для одного и того же пути приоритет у deny, но внутри широкого запрета можно создать узкое разрешение. Также проверьте дополнительные уровни настроек и наследование от родительских профилей.
Источники: OpenAI: запрет чтения по точному пути или шаблону, порядок загрузки настроек. Проектный .codex/config.toml загружается только для доверенных проектов. Различайте то, что записано в файле, и то, что действует в текущей сессии.
5. Что останавливает отключение сети команд и что нет
Если отключить сеть команд, можно ограничить сетевое использование программами, запущенными в целевой песочнице. Однако запросы клиента Codex к модели и аутентификации отделены от управления сетью команд. Не считайте, что путь, по которому прочитанный код передаётся в контекст модели, закрыт только потому, что сеть команд отключена.
Диапазон, на который действует ограничение сети команд
Связь, которую выполняют команды, скрипты и их дочерние процессы.
Модель и аутентификация, веб-поиск, подключённые приложения, MCP, браузер и Computer Use, облачные задачи.
Чтобы разрешить сеть и ограничить адреса назначения, нужно включить сетевой прокси в дополнение к доменным правилам. Одного перечисления разрешённых доменов в профиле недостаточно — оно не вступает в силу.
| Сеть команд | Прокси | Результат |
|---|---|---|
| Выкл | Любой | Сетевые обращения команд не разрешены |
| Вкл | Выкл | Прямая связь возможна, доменные правила профиля не применяются |
| Вкл | Вкл | Прокси применяет доменные правила; внешние адреса отклоняются, если они не разрешены |
Даже разрешённый адрес назначения может получить секреты. Ограничение доменов — это не то же самое, что проверка отправляемого содержимого. При одобрении запуска вне песочницы не считайте, что текущие запреты по-прежнему защищают; проверьте, что именно расширяет одобрение. OpenAI: сетевые разрешения и условия прокси.
6. Различия в переменных окружения, ОС и облаке
Секреты находятся не только в файлах. Если API-ключ записан в оболочке, значение может использоваться из переменных окружения, переданных дочерним процессам, даже если файлы запрещены. Наследование переменных окружения управляется отдельно через shell_environment_policy.
Автоматическое исключение переменных окружения: true и false
true (по умолчанию)Не исключает автоматически переменные, в имени которых есть KEY, SECRET или TOKEN
falseПрименяет это автоматическое исключение
ignore_default_excludes. Это отдельное управление, не связанное с запретом файлов. Поскольку исключение идёт по имени переменной, это не механизм, который обнаруживает все секреты.Переменные с другими именами или значения, которые программа получает из другого места, таким способом не защитить. set применяется после обработки исключений и может вернуть исключённые переменные. OpenAI: наследование переменных окружения и приоритеты.
Windows: также проверьте режим песочницы
Локальные Permission profiles описаны для macOS, Linux, WSL и нативного Windows, но реализации в них не одинаковы. В Windows есть три режима.
Microsoft Execution Containers. Это рекомендуемый режим на поддерживаемых устройствах. Не требует настройки с одобрением администратора или отдельной учётной записи Windows и доступен на поддерживаемых сборках Windows 11 24H2 и 25H2.
Прежний режим, который используется в приоритете, когда MXC недоступен. Требует настройки с одобрением администратора.
Изоляция связи слабая, и он не поддерживает пути, для которых запрещено чтение. Настройки защиты секретных файлов из этой статьи с ним не работают.
Источник: OpenAI: песочница Windows. Политика, которую невозможно поддержать, отклоняется при выполнении. Это не значит, что при появлении ошибки можно переключиться на Full access. OpenAI: как применяются ограничения на каждой ОС.
Cloud: не переносите локальные настройки как есть
Codex Cloud проверяет настройки своей облачной среды отдельно. Локальный профиль не применяется автоматически ко всему облаку или к dot (постоянному ИИ-агенту ChatGPT) на стороне облака. Не используйте примеры локальных настроек из этой статьи как есть в качестве облачных настроек. Различия в месте выполнения описаны в статье Условия подключения Codex Remote, Cloud и ПК.
7. Проверка с помощью тестовых файлов
«Мы сказали не читать», «мы сохранили настройку» и «чтение действительно было запрещено» — это разные доказательства. Проверять на реальных секретах не нужно. Ниже — шаги, которые выполняет пользователь или администратор.
- Зафиксируйте объект проверки: версию Codex, ОС, место выполнения и выбранные права. В CLI рабочую область проверяйте через
/status, а выбранное состояние — через/permissions. - Проверьте конфликты настроек: пользовательские настройки, настройки доверенного проекта, выбранный профиль, флаги запуска и ограничения администратора. Не вставляйте в диалог файлы конфигурации целиком или значения секретов для диагностики.
- Подготовьте тестовые файлы: в отдельной рабочей области, не содержащей секретов, создайте файлы, которые нужно разрешить, и файлы, которые нужно запретить. В качестве содержимого используйте маркер-метку.
- Проверьте и разрешение, и запрет: убедитесь, что разрешённый объект читается по тому же пути выполнения, а чтение запрещённого объекта выдаёт ошибку. То, что Codex сам не стал читать файл, не является техническим доказательством запрета.
- Проверьте различия в расположении: тестовые файлы непосредственно в корне, во вложенных папках, с суффиксами и созданные после запуска. Не давайте подтверждения, которое обходит запрет. Если что-то неожиданно читается, прекратите использовать эту среду и выясните причину.
- Проверьте также путь вывода: не выводят ли тесты или сборка секреты в логи и не передаются ли те же данные другим MCP, браузерам или подключённым приложениям.
Поскольку то, что можно проверить, зависит от версии и отображения CLI, смотрите на реальный интерфейс, а не только на имя команды. В официальном CLI также есть способ проверки по ОС через codex sandbox. Однако прежде чем полагаться на настройки, проверенные вспомогательной командой, убедитесь, что они совпадают с настройками, действующими в вашей обычной сессии в десктопе или IDE. OpenAI: как проверить песочницу.
Уже прочитанное содержимое нельзя отменить, добавив запрет позже. Отдельно проверьте прошлые диалоги, логи, хранение файлов и настройки обучения. Не делайте вывод о том, что информация утекла третьим лицам, только потому, что файл был доступен для чтения. Решите отдельно, что было прочитано, куда это попало и нужно ли что-то делать с учётными данными.
Исключение секретных файлов запрашивали пользователи в публичном обращении (issue) Codex. Актуальное поведение проверяйте по официальной документации Permissions, которая указана выше.
Исходные данные статьи: написано 8 октября 2026 года, в основном для команд внутри локальной песочницы, на основе документов OpenAI по Permissions, Sandbox, подтверждениям и безопасности, а также настройкам (поведение с файлами, созданными позже, перепроверено по официальным документам 19 октября, режимы Windows — 16 октября). Пример конфигурации в реальной среде не применялся, поэтому перед использованием проверьте запрет на тестовых файлах по шагам выше.
Связанные статьи: если нужно остановить изменение исходного кода, см. Как использовать Codex и Claude Code в режиме только для чтения; если нужно продолжить работу в разрешённых пределах, см. Goal mode в Codex и сокращение ожиданий подтверждения.
FAQ
Если включён режим только для чтения, .env не отправится?
Может отправиться. Режим только для чтения лишь ограничивает изменения. Чтобы читаемые файлы .env не попадали в контекст модели, отдельно проверьте, что чтение целевого объекта запрещено и что рабочая среда не содержит секретов.
Достаточно ли одних .gitignore и AGENTS.md?
Они не заменяют технический запрет чтения. Настройки игнорирования Git, рабочие инструкции и права, которые применяет ОС, — разные механизмы. Проверьте на тестовых файлах, работает ли запрет в вашей текущей среде выполнения.
Если отключить сеть, Codex будет работать полностью на устройстве?
Нет. Ограничение сети команд — это не настройка, которая останавливает связь с моделью и аутентификацией. Настройки браузера, MCP, подключённых приложений и облака тоже отдельные.
С этим примером конфигурации секреты в Windows защищены полностью?
Одного этого примера недостаточно. Проверьте поддержку бета-функции, режим песочницы (unelevated не поддерживает запрет чтения), реальные уровни настроек, пути и инструменты, которые вы запускаете, и перед использованием убедитесь на тестовых файлах, что запрет работает.