На ноутбуке задача Codex выполняется одним способом, а на VPS — другим. Репозиторий одинаковый, но агент стартует в другом каталоге и наследует другие инструкции учётной записи. Повторение запроса не исправляет окружение.
Мы рассматриваем Codex AGENTS.md как версионируемые рабочие инструкции, а не волшебную память. Ниже — способ сделать их область действия воспроизводимой перед автономной работой удалённого агента. Это ручной процесс Codex, а не новая функция настройки Office Claws.
Codex AGENTS.md: что загружает исполнитель
Официальное руководство описывает цепочку, которая собирается в начале запуска. Важен стартовый каталог: наличие файла где-то в репозитории не означает, что он попадёт в исходную цепочку.
| Уровень | Поиск | Практическое следствие |
|---|---|---|
| Домашний каталог Codex | AGENTS.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.
Наш совет: версионируйте короткий рабочий контракт, проверяйте его под настоящей учётной записью исполнителя и сохраняйте человеческую проверку. Постоянно работающий сервер должен делать процесс воспроизводимым, а не превращать текстовый файл в границу полномочий.