y83 code / справочник

Политики

Раздел «Политики» показывает, что именно разрешено агенту Codex: какие папки ему доверены, какие инструменты можно вызывать без спроса, где ограничена сеть и какие MCP-серверы подключены. Это зеркало настроек безопасности, разобранных из конфига, плюс кнопка удаления отдельного правила.

раздел
Подсистемы приложения
пунктов возможностей
17
источник
docs/about/policies.md

Возможности

  • Карточка «No permission prompts». Два главных параметра: спрашивает ли Codex разрешение перед запуском инструментов и как он ограничен песочницей.
  • Список правил по группам: доверенные проекты, разрешения, политика выполнения команд, MCP-серверы. Пустые группы не показываются.
  • Кнопка удаления у правила — везде, кроме MCP-серверов.
  • Окно подтверждения удаления. Показывает, что именно будет удалено: название правила, значение и, для проектов, путь. Кнопки Remove и Cancel.
  • Кнопка обновления в шапке. Перечитывает конфиг заново.
  • Карточка ошибки с текстом ошибки и кнопкой Retry — если конфиг не прочитался.
  • Пустое состояние с надписью «No saved permission rules» — если правил в конфиге нет.
  • В шапке видно три вещи: сколько правил найдено, текущий режим подтверждений и режим песочницы.

Технические данные

ПараметрЗначение
Групп правил4: проекты, разрешения, exec, MCP
Что читается из конфига~/.codex/config.toml
Секреты из списка убраныключи с token, authorization, secret, apikey
Права на конфиг после записи0o600
Системные параметрыapproval_policy, sandbox_mode
Правил на текущем устройстве6: 5 проектов и 1 MCP-сервер
Режим подтверждений сейчасnever
Режим песочницы сейчасdanger-full-access

Что означают два главных параметра

Approval policy — спрашивает ли агент разрешение перед тем, как что-то сделать. Текущее значение never означает, что Codex выполняет инструменты и MCP-серверы, не спрашивая.

Sandbox mode — насколько агент ограничен в файловой системе и запуске процессов. Текущее значение danger-full-access — ограничений нет.

Оба параметра показаны отдельной карточкой и удалить их отсюда нельзя: сервер отвечает отказом на попытку.

Что видно в каждой группе

Доверенные проекты. Появляются, только если в конфиге у папки проставлен признак доверия. Показывается путь к папке. Уровень доверия виден только в окне удаления, в самой карточке его нет.

Разрешения. Показывают, что можно вызывать всегда, что запрещено и есть ли доступ в сеть. Подпись берётся из самого ключа, поэтому читается сразу: «Allowed tools», «Denied tools», «Network access».

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

MCP-серверы. Видно только имя сервера и то, что он включён или выключен. Команду запуска на экране не видно: она хранится в конфиге, но карточка её не показывает, а окно удаления у этой группы не открывается.

Что происходит при удалении

Удаление убирает из конфига ровно одну строку — ту, что отвечает за нажатое правило. Заголовок секции остаётся: например, после удаления доверия к папке пустая секция этой папки пропадёт из списка, но в самом конфиге останется.

После любого удаления сервис Codex перезапускается, чтобы новые настройки вступили в силу. Это значит, что активные треды в этот момент прерываются. Если перезапуск не удался, удаление всё равно считается выполненным — ошибка перезапуска пишется в лог, а на экране её не видно.

Если правило уже удалено или значение в конфиге изменилось, сервер отвечает «политика не найдена», и экран показывает эту ошибку вместо списка.

Что агент умеет

Агент может открыть этот раздел через мост командой app_navigate на экран policies и прочитать список командой app_ui_tree — так видны названия правил, пути проектов и текущие значения параметров.

Отдельного инструмента для чтения или удаления политик нет. Удалять правила агент не может: это ломает настройки безопасности, и такую операцию должен подтвердить человек.

Ограничения

  • Экран только читает и удаляет. Создать правило или поменять его значение здесь нельзя — это делается на экране MCP или вручную в конфиге.
  • MCP-серверы удалить нельзя: у них нет кнопки. Настраиваются они на экране MCP.
  • Проекты без признака доверия в конфиге не показываются вообще. Секция может существовать в файле, но на экране её не будет — и удалить её отсюда тоже нельзя, потому что удалять нечего.
  • Серверы на сетевом адресе не попадают в группу MCP: там показываются только серверы, у которых в конфиге прописана команда запуска.
  • Правила без названия секции игнорируются: общие параметры показываются отдельной карточкой, а не списком.
  • Значения с секретами в списке не появляются — их ключи отфильтровываются, и увидеть, что секрет настроен, с этого экрана нельзя.
  • Счётчик в шапке и список не всегда совпадают: счётчик показывает, сколько строк распознано, а удалить можно не всё.
  • Перезапуск Codex после удаления необратим: активный тред придётся продолжать заново.
  • Все тексты на экране английские, а ошибки сервера приходят по-русски.

Источник: docs/about/policies.md. Страница собрана из документации проекта при сборке сайта — без пересказа.