Unity и Codex: настройка проекта, тесты и безопасные правки

Codex может читать и менять C# скрипты, тесты, настройки и текстовые ассеты Unity, если открыть корень проекта как локальный проект. Отдельный официальный плагин Unity для этого не нужен. Безопасный процесс начинается с Git, сохранённых .meta файлов и небольшой задачи, которую можно проверить в Editor и тестами.

Что понадобится до запуска Codex

Для большинства пользователей основной способ это десктопное приложение ChatGPT с локальным проектом Codex. CLI или расширение IDE удобны, если вы уже работаете в терминале или редакторе. Документация проектов Codex указывает, что локальный проект получает доступ к выбранной папке, использует её для Git и автоматически ищет AGENTS.md в основном корне.

• Рабочий Unity проект открывается без ошибок до правки.
• Корень проекта содержит Assets, Packages и ProjectSettings.
• Проект добавлен в Git, исходное состояние закоммичено.
• Есть команда теста или короткий ручной сценарий проверки.
• Для задачи создана отдельная ветка или worktree.

Если Codex ещё не установлен, сначала используйте пошаговую установку Codex. Для Unity не требуется отдельная версия приложения.

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

Какую папку открыть

Открывайте корень Unity проекта, а не только папку Assets. Unity хранит исходники и ассеты в Assets, список пакетов в Packages, настройки в ProjectSettings, а локальный кэш импорта в Library.

Официальное руководство Unity по внешним системам контроля версий рекомендует хранить Assets, Packages и ProjectSettings, включая связанные .meta файлы, а Library исключать как восстанавливаемый локальный кэш.

• Разрешайте изменения в Assets/Scripts и тестах, если задача касается логики.
• Не просите вручную редактировать Library, Temp или импортированные кэши.
• При создании или перемещении ассета проверяйте соответствующий .meta файл.
• Сцены и prefab меняйте маленькими порциями: их текстовый diff труднее проверить, чем C# код.

Какие инструкции положить в проект

Создайте в корне короткий AGENTS.md. В нём укажите версию Unity, разрешённые каталоги, команду тестов, запрет на обновление пакетов без отдельной задачи и правило сохранять пары ассет плюс .meta. Codex обучен искать такие инструкции в репозитории; подробнее это поведение описано в официальном руководстве модели.

# Unity project rules
- Change only Assets/Scripts and Assets/Tests for this task.
- Do not edit Library, Temp, Logs or package versions.
- Keep every asset with its .meta file.
- Run EditMode tests before reporting completion.
- Report changed files and remaining manual checks.

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

По теме: Codex SSH: как подключить удалённый сервер в 2026

Первая задача для Codex

Выберите механику без сложного визуального ассета, например счётчик очков, ограничение здоровья или таймер. Укажите существующий компонент, ожидаемое поведение, крайний случай и способ проверки.

1. Откройте корень Unity проекта в Codex.
2. Попросите сначала найти связанные скрипты и предложить план без изменений.
3. Подтвердите точные файлы, которые можно менять.
4. Попросите добавить или обновить EditMode тест для чистой C# логики.
5. Разрешите реализацию только после согласования границ.
6. Проверьте diff, затем откройте проект в Unity и дождитесь окончания импорта.
7. Запустите тесты и короткий сценарий в Play Mode.

Безопасный пример: «В ScoreCounter.cs добавь метод увеличения счёта только на положительное значение. Ноль и отрицательное значение должны оставлять счёт без изменений. Не меняй сцену и пакеты. Добавь EditMode тесты на три случая».

Как запускать тесты

Unity Test Framework поддерживает Edit Mode и Play Mode тесты. Это подтверждает официальная документация Unity 6. EditMode подходит для чистой логики и редакторских функций, PlayMode для поведения объектов во время запуска сцены.

Unity также поддерживает аргументы командной строки -runTests, -testPlatform и -testResults. Точный путь к Editor зависит от системы и установленной версии, поэтому сначала получите рабочую команду вручную, затем запишите её в инструкции проекта.

Unity -batchmode -projectPath /path/to/project -runTests -testPlatform editmode -testResults /tmp/editmode-results.xml -quit
Unity -batchmode -projectPath /path/to/project -runTests -testPlatform playmode -testResults /tmp/playmode-results.xml -quit

Не считайте нулевой вывод доказательством успеха. Проверьте код завершения, XML с результатами и лог Unity. В CI указывайте точный исполняемый файл версии Editor, которой пользуется проект.

По теме: Codex и Antigravity: сравнение и совместная работа

Чек-лист приёмки правки

Второй практический элемент это трёхуровневая проверка: код, импорт и поведение. C# компиляция не доказывает, что ссылки сцены сохранились, а успешный запуск сцены не доказывает, что крайние случаи покрыты.

• Diff содержит только согласованные файлы.
• Новый ассет добавлен вместе с .meta.
• Unity завершила импорт без красных ошибок Console.
• EditMode тесты прошли.
• PlayMode тесты или ручной сценарий прошли.
• Ссылки в Inspector не стали Missing.
• Проект повторно открывается после закрытия Editor.

Перед коммитом попросите Codex провести независимое ревью. Официальная документация code review описывает команду /review для сравнения с базовой веткой или проверки незакоммиченных изменений без модификации рабочего дерева.

Диагностика частых проблем

• Unity показывает Missing Script: проверьте имя класса, имя файла, пространство имён и ошибки компиляции выше по Console.
• Пропали ссылки на ассет: найдите удалённый или изменённый .meta и восстановите пару из Git.
• Появился огромный diff в Library: остановитесь, исправьте ignore и удалите кэш из индекса Git.
• Тесты не запускаются из терминала: сверьте путь к Editor, версию проекта, кавычки в -projectPath и файл результатов.
• Сцена изменилась сильнее задачи: откатите сцену и перенесите логику в отдельный компонент с минимальной ручной привязкой.
• После обновления пакета появились ошибки: верните Packages/manifest.json и lock-файл к контрольному состоянию.

Если Codex внёс слишком широкие изменения, вернитесь к ветке до правки и сократите задачу. Не просите агента исправлять собственный большой diff без новой границы, иначе область изменения продолжит расти.

По теме: Codex Computer Use: как управлять приложениями в 2026

Когда Codex не заменяет Unity Editor

Codex не видит поведение сцены так же, как человек в Editor, если ему не переданы скриншоты, логи или автоматические тесты. Расстановка объектов, свет, физика, анимация и ощущения управления требуют запуска сцены. Бинарные ассеты также нельзя надёжно оценить по текстовому diff.

Для первой игры полезна отдельная схема из статьи вайбкодинг игр. Если нужен другой агент, есть смежный материал Unity и Claude Code, но одновременно править одну сцену двумя инструментами не следует.

Частые вопросы

Есть ли официальный плагин Codex для Unity?

Для базовой работы он не нужен. Codex открывает локальный корень проекта и редактирует файлы под контролем Git.

Можно ли поручить Codex создать сцену?

Можно подготовить скрипты и текстовые изменения, но сцену нужно открыть в Unity, проверить ссылки, импорт и поведение в Play Mode.

Нужно ли добавлять Library в Git?

Нет. Unity описывает Library как локальный кэш, который восстанавливается из исходных папок проекта.

Что проверять первым после правки?

Сначала diff и пары ассет плюс meta, затем импорт без ошибок, EditMode тесты и короткий Play Mode сценарий.