раздел 03

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

Установили, вошли. Теперь самое важное - дать задачу так, чтобы агент сделал то, что нужно, и вы это проконтролировали.

Четыре шага

1
Откройте проект в терминале
Перейдите в корень репозитория и запустите codex. Агент видит файлы из этой папки и ниже.
2
Опишите задачу словами
Прямо в окне Codex напишите, что нужно сделать. Не код, а цель: что должно получиться.
3
Посмотрите план и дифф
Codex предложит план и покажет дифф - какие файлы и строки он меняет. Читайте, не пролистывайте.
4
Одобрите или поправьте
Согласны - подтверждаете, и Codex применяет изменения. Не согласны - пишете уточнение, он переделывает.

Запуск

терминал
cd ~/projects/my-app codex

Дальше в открывшемся окне Codex просто пишете задачу обычным текстом, например:

задача
Добавь на страницу профиля кнопку «Выйти». По клику - очистка сессии и редирект на /login. Стиль кнопки - как у остальных вторичных кнопок в проекте.

Codex прочитает нужные файлы, предложит план, покажет дифф и спросит разрешения применить изменения или запустить команды. Вы подтверждаете шаг за шагом.

Начинайте с атомарных задач

Первое правило для старта - давать маленькие, понятные задачи с проверяемым результатом. Так проще оценить, что агент действительно делает, и не получить кашу из правок в двадцати файлах.

Хорошая первая задача
Починить один баг, добавить одну кнопку, написать тест на одну функцию, переименовать переменную во всём файле.
Плохая первая задача
«Перепиши весь модуль авторизации и заодно почини всё, что найдёшь». Слишком широко - сложно проверить.

Как одобрять изменения

Когда Codex показывает дифф, вы видите зелёные (добавлено) и красные (удалено) строки - как в git diff. Прежде чем одобрить, задайте себе три вопроса:

  • Он правит те файлы, что я ожидал, или полез куда не просили?
  • Изменения соответствуют задаче или агент додумал лишнего?
  • Команды, которые он хочет запустить, безопасны (не удаляют данные, не лезут в сеть без нужды)?

Если всё ок - одобряете. Если нет - пишете уточнение прямо в чат, и Codex переделает с учётом замечания.

Продолжение сессии

Если закрыли терминал, а задача не доделана - сессию можно возобновить с сохранением истории, плана и контекста:

терминал
codex resume