Codex CLI: что это и как пользоваться — первый запуск и проверка кода

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

Если вы ищете «codex cli это» или «codex cli как пользоваться», начните с одной небольшой задачи. Не поручайте незнакомому инструменту сразу переделать весь проект.

Установка и вход

Выберите инструкцию для своей системы на официальной странице Codex CLI. После установки проверьте доступность команды:

codex --version
codex login
codex login status

Codex поддерживает вход через ChatGPT и через API-ключ. При использовании API-ключа действует отдельная тарификация API; это не тот же расход, что использование подписки ChatGPT. Способы входа описаны в документации аутентификации.

Первая задача: сначала понять проект

Перейдите в каталог своего проекта и проверьте состояние Git:

cd my-project
git status --short
codex

Для первого знакомства можно написать:

Объясни, где в этом проекте обрабатывается вход пользователя. Назови файлы, путь запроса и существующие тесты. Пока не меняй код.

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

Как поставить задачу на изменение

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

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

Вместо «сделай лучше» здесь есть наблюдаемый результат: пустое имя должно отклоняться, а интерфейс должен объяснять причину.

Разрешения: что проверить перед запуском

Команда /permissions показывает доступные настройки разрешений, а /status — состояние текущей сессии. Не исходите из предположения, что во всех установках агент работает только на чтение. Настройки среды и организации могут отличаться.

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

Как проверить результат

После задачи выйдите к обычному терминалу и просмотрите:

git status --short
git diff --stat
git diff

Сначала проверьте, что изменения относятся к задаче. Затем запустите существующие команды тестирования проекта и вручную воспроизведите исходный сбой. Фраза агента «тесты прошли» полезна только вместе с фактической командой и её результатом.

Для проверки без автоматического принятия всех решений попросите отдельно объяснить спорные изменения. Не смешивайте исправление ошибки с публикацией или удалением данных, если это не было частью задания.