Codex AGENTS.md: единые инструкции для агентов на VPS

Codex AGENTS.md: единые инструкции для агентов на VPS — Как настроить Codex AGENTS.md на VPS: порядок загрузки, переопределения и рабочий каталог, а затем проверка инструкций перед автономным запуском.
17 нояб. 2026 г.4 мин чтения
Share with

На ноутбуке задача Codex выполняется одним способом, а на VPS — другим. Репозиторий одинаковый, но агент стартует в другом каталоге и наследует другие инструкции учётной записи. Повторение запроса не исправляет окружение.

Мы рассматриваем Codex AGENTS.md как версионируемые рабочие инструкции, а не волшебную память. Ниже — способ сделать их область действия воспроизводимой перед автономной работой удалённого агента. Это ручной процесс Codex, а не новая функция настройки Office Claws.

Codex AGENTS.md: что загружает исполнитель

Официальное руководство описывает цепочку, которая собирается в начале запуска. Важен стартовый каталог: наличие файла где-то в репозитории не означает, что он попадёт в исходную цепочку.

УровеньПоискПрактическое следствие
Домашний каталог CodexAGENTS.override.md, иначе AGENTS.md; первый непустой файлУчётная запись VPS может добавлять правила, которых нет на ноутбуке
От корня проекта до рабочего каталогаОдин файл в каталоге: переопределение, обычный файл, затем настроенные запасные именаЗапуск внутри сервиса загружает другую цепочку, чем запуск из корня
Объединённые инструкцииОт корня вниз; более близкие инструкции приоритетнееЛокальное исключение может изменить общее правило

Стандартный лимит объединённых документов проекта — 32 KiB. Пишите кратко; при обрезке проверьте project_doc_max_bytes. Переопределение заменяет обычный файл в том же каталоге, а не стирает предыдущие уровни. По умолчанию домашний каталог — ~/.codex, но CODEX_HOME может его изменить.

Цепочка инструкций от настроек учётной записи к репозиторию и сервису

Запустите первого агента примерно за 3 минуты

Установите CLI Office Claws, подключите аккаунт Contabo и подписку Codex — агент получит собственный VPS и рабочее место в офисе.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/мес + ваш собственный VPS в Contabo · ключи остаются в вашей связке ключей

Пишите рабочий контракт, а не руководство по всему репозиторию

Стабильные общие правила мы храним в корне, а команды конкретного сервиса — рядом с ним. Не переносим всю архитектурную вики в контекст: достаточно назвать документ и решение, для которого он нужен.

Для репозитория, где тесты действительно запускаются командой npm test, подойдёт этот небольшой шаблон корневого файла. Перед коммитом адаптируйте команды к проекту. Пример не выдаёт разрешений и не настраивает автоматизацию.

# AGENTS.md
 
## Scope
- Work only on the assigned branch and requested change.
- Read docs/development.md before changing build configuration.
 
## Verification
- Run npm test after code changes; report the command and result.
- If a check cannot run, report the blocker instead of claiming success.
 
## Review boundary
- Do not deploy, publish packages, or rotate credentials.
- Flag authentication and migration changes for human review.

Версионируйте инструкции как код. Замена «предложить миграцию» на «выполнить миграцию» требует проверки даже без изменений приложения. Не включайте токены, пароли и личные данные: инструкции репозитория передаются модели и не являются хранилищем секретов.

Проверьте ту же область действия через SSH

На VPS используем ту же учётную запись Unix, рабочую копию, каталог и профиль Codex, что и для настоящей задачи. Администраторская оболочка ничего не доказывает о настройках сервисной учётной записи. Само подключение описано в руководстве по SSH.

Выполните эту проверку без записи из корня доверенного репозитория, заменив путь на свой. Она перечисляет кандидатов, но не доказывает загрузку всех файлов: сопоставьте список с правилами выше и ответом агента. Последняя команда обращается к модели и может расходовать лимит плана.

cd ~/work/product-api
pwd
git rev-parse HEAD
codex --version
printf 'CODEX_HOME=%s\n' "${CODEX_HOME:-$HOME/.codex}"
find . -type d -name .git -prune -o -type f \
  \( -name AGENTS.md -o -name AGENTS.override.md \) -print
codex exec --sandbox read-only \
  "Do not edit files or execute project commands. List the instruction sources you loaded and summarize the verification and review boundaries."

Файлы учётной записи проверяйте отдельно, не копируя их содержимое в общие журналы. Учитывайте запасные имена из конфигурации: find выше намеренно ищет только два стандартных имени. Пересказ модели полезен для быстрой проверки, но не заменяет формальный аудит и не гарантирует безопасность.

Если задача относится к вложенному сервису, повторите проверку из его каталога. После редактирования инструкций начните новый запуск: документированная цепочка собирается один раз за запуск, а не обновляется в уже открытой сессии.

Отделяйте инструкции от реальных ограничений

Фраза «не развёртывать» в AGENTS.md не управляет доступом. Ограничивайте учётные данные и инструменты отдельно, используя подходящие настройки песочницы и подтверждений. Не выдавайте ночному исполнителю доступ к продакшену только потому, что текст запрещает им пользоваться.

Перед автономной задачей фиксируем коммит, версию Codex, рабочий каталог и ревизию инструкций. Для параллельных агентов проверяем каждую рабочую копию, а не предполагаем, что локальная правка попала ко всем. При расхождениях сначала проверяйте домашний каталог, CODEX_HOME, переопределения, запасные имена и каталог запуска, а уже потом переписывайте запрос.

Office Claws запускает агентов Codex на вашем Contabo VPS и предоставляет CLI и пиксельный рабочий стол. Вы по-прежнему поддерживаете инструкции и проверяете результат. Office Claws стоит от $4.99/месяц за первого агента; VPS и поддерживаемый план ChatGPT оплачиваются отдельно, а лимиты использования сохраняются. Подробнее — в сравнении стоимости подписки Codex.

Наш совет: версионируйте короткий рабочий контракт, проверяйте его под настоящей учётной записью исполнителя и сохраняйте человеческую проверку. Постоянно работающий сервер должен делать процесс воспроизводимым, а не превращать текстовый файл в границу полномочий.

Автор

Office Claws Team

Создаём будущее управления ИИ-агентами в Office Claws. Делимся опытом в области инфраструктуры, безопасности и удобства разработки.

Запустите первого агента примерно за 3 минуты

Установите CLI Office Claws, подключите аккаунт Contabo и подписку Codex — агент получит собственный VPS и рабочее место в офисе.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/мес + ваш собственный VPS в Contabo · ключи остаются в вашей связке ключей