Codex работает лучше, когда знает правила проекта: где тесты, как запускать сборку, какой стиль кода. Эти правила задаются файлом инструкций в репозитории и настройками клиента. Настройка занимает 15 минут и экономит их на каждой задаче.
Файл инструкций проекта
В корне репозитория создайте файл с инструкциями для агента: как установить зависимости, как запускать тесты и линтер, какие папки не трогать, соглашения по именованию и коммитам. Codex читает его перед каждой задачей. Держите файл коротким и конкретным — команды, а не пожелания.
Режимы прав
- только предложения — агент показывает изменения, вы применяете вручную
- авто-правки — меняет файлы, но команды запускает с подтверждением
- полная автономия — правки и команды без вопросов; только в песочнице или контейнере
Модель и точка доступа
Модель задаётся в конфигурации клиента: старшая — для сложных задач, младшая — для рутинных правок. Там же указываются адрес точки доступа и ключ; для российской точки — её адрес и ключ из личного кабинета.
Ограничения
Отключите сетевой доступ агента, если задача не требует загрузок; ограничьте список разрешённых команд; работайте в отдельной ветке и проверяйте diff перед слиянием. Секреты храните в переменных окружения, а не в файлах репозитория.
Короткие ответы
Где лежит конфигурация Codex?
В домашней папке пользователя, в каталоге настроек клиента; проектные инструкции — в корне репозитория.
Можно ли задать разные правила для разных папок?
Да, файл инструкций в подпапке дополняет корневой.
Как проверить, что агент читает инструкции?
Попросите его перечислить правила проекта — ответ должен совпадать с файлом.