Руководство Codex

Тема

Git для работы с Codex ​

Зачем это изучать

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

Git — программа, которая хранит историю изменений файлов. Она не обязательна для запуска Codex: агент умеет читать и менять обычную локальную папку. Но с Git работа становится заметно безопаснее и понятнее.

Попробуйте сейчас

Выполните git status в учебной папке. Пока ничего не исправляйте и не добавляйте: просто прочитайте, есть ли история, какая ветка открыта и какие файлы изменены.

На сервере этого учебного проекта Git уже установлен. Проверенная версия: git 2.53.0. Если вы работаете на этом сервере, устанавливать Git заново не нужно. Проверить доступность в любой среде:

bash
git --version

Почему Git выгоден при работе с Codex ​

Без Git вы видите только текущее содержимое файлов. С Git появляется исходная точка, относительно которой можно проверить работу агента:

  1. Видно каждую правку. Сравнение изменений показывает добавленные и удалённые строки.
  2. Можно сохранить хорошее состояние. Коммит создаёт именованную точку в истории.
  3. Можно отделить задачи. Ветка или отдельная рабочая копия не смешивает эксперимент с основной работой.
  4. Проще отменить ошибку. Сохранённая история помогает вернуть известное рабочее состояние. Несохранённые изменения всё равно требуют осторожности.
  5. Codex получает точную область проверки. Команды /diff, /review и codex review понимают, какие строки появились после выбранной точки.

Git не доказывает, что изменение правильное. Он даёт историю и удобное сравнение; правильность подтверждают тесты и ручная проверка.

Основной принцип ​

text
Файлы в рабочей папке
        ↓
Просмотр изменений
        ↓
Выбор нужных файлов или строк
        ↓
Коммит — сохранённая точка истории

Рабочее дерево — текущая папка с файлами. Изменения в ней могут быть:

Выбор для коммита называется подготовкой изменений. Это не публикация и не отправка на внешний сервер.

Узнать состояние папки ​

Выполните:

bash
git status

Команда показывает:

  • текущую ветку;
  • изменённые и новые файлы;
  • какие изменения выбраны для коммита;
  • какие изменения ещё не выбраны.

Посмотреть строки, которые ещё не выбраны:

bash
git diff

Посмотреть уже выбранные строки:

bash
git diff --staged

В диалоге Codex похожий обзор открывает /diff.

Превратить обычную папку в репозиторий ​

Если git status сообщает not a git repository, папка пока не хранит историю Git. После проверки правильного пути можно выполнить:

bash
git init

Команда создаёт скрытую служебную папку .git внутри текущей папки. Она не отправляет файлы в интернет. До первого коммита:

  1. Создайте или проверьте .gitignore — список файлов, которые нельзя добавлять в историю, например секретов, временных файлов и зависимостей.
  2. Выполните git status и внимательно прочитайте список.
  3. Не добавляйте .env, ключи, токены, журналы и личные данные.

Сохранить проверенное состояние ​

Выберите конкретный файл:

bash
git add path/to/file

Проверьте выбранные изменения:

bash
git diff --staged

Создайте коммит с кратким объяснением:

bash
git commit -m "docs: explain the first Codex session"

Коммит сохраняется локально. git push — отдельная операция, которая отправляет коммиты в удалённый репозиторий. Codex не должен выполнять её без прямой просьбы.

Ветки для независимых задач ​

Создать новую ветку и перейти в неё:

bash
git switch -c explain-codex-terms

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

Worktree создаёт ещё и отдельную папку для ветки. Так можно вести несколько задач параллельно, не смешивая незавершённые файлы. Эта возможность рассматривается на странице приложения ChatGPT.

Что нельзя отменять вслепую ​

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

text
git reset --hard
git clean -fd

Сначала выполните git status и git diff, определите владельца изменений и создайте безопасную копию, если история ещё не сохранена. Отмена изменения в графическом интерфейсе тоже может удалить несохранённые строки.

Git и проверка Codex ​

Рекомендуемый цикл:

  1. До задачи выполните git status.
  2. Попросите Codex не трогать посторонние изменения.
  3. После задачи откройте /diff или выполните git diff.
  4. Запустите тесты проекта.
  5. Проверьте каждый изменённый файл.
  6. Выберите только нужные изменения и создайте коммит.
  7. Отправляйте коммит во внешний репозиторий только отдельным осознанным шагом.

Куда дальше ​

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

Внешние источники ↗ ​