Codex — агентный ассистент от OpenAI: как и Claude Code, он читает проект, правит файлы и запускает команды. Он существует в нескольких вариантах — приложение, консольный клиент, расширение для редактора и облако. Этот урок помогает выбрать вариант, установить CLI и провести первую сессию. Документация Codex недавно переехала: адреса developers.openai.com/codex/... на 24.10.2026 перенаправляют на learn.chatgpt.com/docs/.... Команды ниже взяты оттуда; на нашей машине они не запускались.
После урока вы сможете
- Выбрать вариант Codex (CLI, IDE, приложение, облако) под свою задачу
- Установить Codex CLI по документации и начать сессию в папке проекта
- Пользоваться базовыми командами и откатывать изменения через git
Какой вариант выбрать
Приложение ChatGPT
- Что это
- Десктоп для macOS, Windows и Linux
- Когда уместен
- Проекты, локальные папки, длинные задачи
Веб-версия
- Что это
- chatgpt.com, без установки
- Когда уместен
- Сложные задачи в облаке без вашего участия
Codex CLI
- Что это
- Терминал
- Когда уместен
- Работа в репозитории, скрипты, наш основной вариант
Расширение для IDE
- Что это
- VS Code, Cursor, Windsurf; в Xcode и JetBrains — собственные интеграции
- Когда уместен
- Код рядом с открытыми файлами и выделением
Codex Cloud
- Что это
- Задачи в облачной среде, результат — набор правок
- Когда уместен
- Фоновая работа над репозиторием на GitHub
Основной способ входа — аккаунт ChatGPT; CLI допускает и «другие доступные способы входа», их список сверьте с документацией по аутентификации. Согласно странице быстрого старта, десктопное приложение можно использовать и с API-ключом, но часть функций тогда недоступна. Какие тарифы включают Codex и какие лимиты у них, смотрите на странице тарифов вендора (ссылка в уроке 9): мы цены не приводим.
Установка CLI
Документация описывает четыре способа. Команда с curl … | sh и PowerShell-команда выполняют скрипт с сайта, поэтому берите их со страницы документации.
# macOS и Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows (новое окно PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codexОбновление — та же команда установщика, а для Homebrew brew upgrade --cask codex. Расширение для редактора ставится из его магазина: для VS Code документация указывает расширение openai.chatgpt; после установки значок Codex открывает боковую панель (если его нет, в палитре команд есть пункт «Codex: Open Codex Sidebar»).
Первая сессия
Перейдите в папку проекта и запустите:
cd путь/к/проекту
codexПри первом запуске выберите «Sign in with ChatGPT» или другой доступный способ входа. Документация рекомендует сделать git-контрольные точки до и после задачи, чтобы изменения можно было отменить: закоммитьте чистое состояние до запуска. Первый запрос должен быть на чтение: пример из документации — «Tell me about this project».
Документация описывает пресеты. «Auto» (песочница workspace-write и подтверждения on-request) рекомендован для папок под git: агент правит файлы и запускает команды в рабочей папке, сеть для команд выключена, а за пределами папки он спрашивает. Для папок без контроля версий рекомендован пресет «Read-only». Какой пресет у вас сейчас, покажет /status или /permissions. Подробно об этом в уроке 6.
Базовые команды
codex
- Что делает
- Интерактивная сессия
codex exec
- Что делает
- Неинтерактивный запуск для скриптов
codex resume
- Что делает
- Открыть недавнюю беседу из этого репозитория
codex cloud
- Что делает
- Отправить работу в облачную среду
codex mcp
- Что делает
- Подключение внешних инструментов (урок 8)
/init
- Что делает
- Создать заготовку
AGENTS.mdв текущей папке
/status
- Что делает
- Конфигурация сессии и расход токенов
/permissions
- Что делает
- Что Codex может делать без вопросов
/model
- Что делает
- Выбор модели и уровня рассуждений
/plan
- Что делает
- Режим плана: сначала предложение, потом правки
/diff
- Что делает
- Git-дифф, включая неотслеживаемые файлы
/review
- Что делает
- Проверка изменений рабочей копии
/compact
- Что делает
- Сжать беседу, чтобы освободить токены
/new, /clear
- Что делает
- Новая беседа
/exit
- Что делает
- Выход (то же
/quit)
Во время работы Codex клавиша Tab ставит уточнение в очередь, а Enter вносит новые указания прямо в текущий ход. Как именно остановить текущее действие клавишей, страница команд не описывает (она называет Ctrl+C и /exit способами закрыть сессию), поэтому сверьте это с документацией для вашей версии и платформы.
Откат изменений
Здесь Codex и Claude Code отличаются. В документации команд, открытой 24.10.2026, отдельной команды отката файлов мы не нашли: откат опирается на git. Рабочий порядок такой: перед задачей чистая рабочая копия, после задачи /diff или git diff, ненужное убираем командой git restore (подробнее — в уроке 7 и в статье о git при работе с агентом). Если вы правите что-то сами или откатываете часть правок агента, скажите об этом Codex, иначе следующим запросом он может перезаписать вашу правку: на это прямо указывает страница о постановке задач.
В облачном варианте задачи идут иначе: вы выбираете среду с репозиториями GitHub, описываете задачу, смотрите изменённые файлы и результаты тестов, просите доработать и только потом создаёте коммит или pull request. Доступ в интернет и лимиты облака настраиваются в среде; значения по умолчанию в документации не названы, сверьте их перед использованием.
Что дальше
Дальше обоим ассистентам понадобится файл с правилами проекта — CLAUDE.md и AGENTS.md. Если вам нужен наставник для настройки процесса в команде, посмотрите техническое наставничество.