Codex CLI от OpenAI: как установить и использовать

Codex CLI — официальный терминальный AI-агент OpenAI: читает код, правит файлы, запускает команды и сам проверяет результат. Установка — одна команда (curl … | sh или npm install -g @openai/codex), вход — через подписку ChatGPT (бесплатный план включён) или API-ключ, модели — семейство GPT-5.6 (Sol/Terra/Luna). Ниже — что это такое, как установить, войти и начать работать, сколько это стоит по планам и что из этого доступно из России.

Что такое Codex CLI

Codex CLI — открытый (Apache-2.0) агент OpenAI для терминала. Репозиторий openai/codex на GitHub — 104,6 тыс. звёзд и 15,8 тыс. форков (на момент публикации). Агент запускается локально, в директории проекта, и умеет:

читать файлы проекта и объяснять код, искать по кодовой базе;
вносить правки в несколько файлов, делать git-коммиты, создавать чекпоинты до и после задачи;
выполнять shell-команды: тесты, линтеры, сборку — и исправлять то, что сломалось;
работать интерактивно (полноэкранный TUI в терминале) и неинтерактивно (codex exec) — для скриптов и CI;
подключать внешние инструменты через MCP-серверы, искать в вебе по команде codex --search;
делегировать подзадачи субагентам и переносить работу в облако (codex cloud).

Скриншот официального репозитория openai/codex на GitHub: описание, лицензия Apache-2.0, 104,6 тыс. звёзд, последний релиз 0.147.0 — Официальный репозиторий openai/codex: «Lightweight coding agent that runs in your terminal», лицензия Apache-2.0, на момент публикации — 104,6 тыс. звёзд и актуальный релиз 0.147.0.

Codex — не единственный интерфейс: тот же агент живёт в IDE-расширении (VS Code и его форки), десктоп-приложении и веб-версии на chatgpt.com/codex. CLI — самый лёгкий из них: не привязан к редактору, вписывается в любой терминальный воркфлоу.

Модели на момент публикации — семейство GPT-5.6: Sol (максимальное качество и глубина рассуждений), Terra (повседневный баланс «цена/качество») и Luna (быстрая и дешёвая, с более высокими лимитами). По умолчанию CLI стартует на gpt-5.6-sol со средним уровнем рассуждений (документация, скриншот на момент публикации). Старые GPT-5.4 и GPT-5.4 mini при входе через ChatGPT-аккаунт будут отключены 31 августа 2026 — их заменяют Terra и Luna (help-центр OpenAI). Контекст — порядка 256 тыс. токенов: в августовском сравнении CLI-агентов у Codex указано 258 400 токенов против 1 млн у Claude Code и Kimi (Habr).

Актуальная версия на момент публикации — 0.147.0 (релиз 7 августа 2026): переносимые плагины, флаг --approve-for-me и импорт скиллов из Cursor (TerminalBlog).

Кейс: миграция на 549 коммитов через Codex CLI

Разработчик Ли Нэйв (Lee Nave) в начале августа 2026 опубликовал разбор того, как он гонял Codex CLI на обновлении фронтенда с Ember.js v3 до v5 на работе (neal: coordinating different models on complex coding projects). Оценка ручной работы — «over 300 engineering hours». Первая попытка в 2025-м с Claude Sonnet 4 провалилась: агент бесконечно чинил и ломал одни и те же баги. В 2026-м он снова попробовал — теперь с Codex и детальным планом миграции:

I typed that into Codex during a large frontend framework upgrade at work. GPT-5.4 was the current model at the time. I wanted to hand it several months of tedious work, check in periodically, and otherwise let it keep moving.

«Я ввёл это в Codex во время крупного обновления фронтенд-фреймворка на работе. Тогда актуальной моделью была GPT-5.4. Я хотел сдать ему несколько месяцев утомительной работы, периодически проверять и в остальном позволить ему двигаться самому.»

План был файлом: ссылки на гайды по миграции, команды для запуска тестов, инструкция работать батчами по 10–20 файлов и список того, что ещё не мигрировано, — чтобы Codex мог продолжить после перезапуска. Поначалу работало: агент сам правил файлы часами. Потом вскрылись две проблемы, которые Нэйв назвал сам:

Over a long session, old instructions and decisions lose influence as the context grows or is compacted.

«За длинную сессию старые инструкции и решения теряют влияние по мере роста или сжатия контекста.»

Первую он назвал «context rot»: Codex постепенно отклонялся от инструкций плана, иногда просто останавливался без причины — «I didn’t» в ответ на вопрос «почему ты перестал работать». Решение: скилл work-autonomously с маркерами завершения батчей и принудительный сброс контекста через /new перед каждой порцией файлов. Второе — качество кода: он заставил Codex писать, а Claude — ревьюить каждую порцию коммитов, и повторял цикл, пока обе модели не сходились. Итог:

миграция закрылась 549 коммитами, затронувшими более 3 000 файлов;
добавлено около 13 000 строк тестов;
в продакшен ушло через ~месяц (большую часть времени заняла сборка самого оркестратора, а не миграции).

Отдельно Нэйв прогнал связку Codex+Claude по 105 задачам SWE-bench Pro, которые Codex не решал сам: с ревьюером-Claude прошло 15 задач против 8 у чистого Codex. Вывод автора — не «агенты заменяют разработчика», а «план + ревью второй моделью + свежий контекст на каждый батч» превращают агента в инструмент, которому можно отдать месячную рутину.

Как работает Codex CLI

Цикл агента тот же, что у других инструментов серии «агентный кодинг» (подробный разбор — в статье «Что такое агентный кодинг»): промпт → план → правки → проверка → ревью → подтверждение.

Схема цикла работы Codex CLI: промпт → агент (модель GPT-5.6 + файлы/терминал/git/MCP) → правки → проверка → /review → подтверждение пользователя — Цикл Codex CLI: агент планирует, правит файлы, запускает проверки и ревьюит свои изменения; каждое действие с файлами и командами проходит через разрешения пользователя.

Ключевое отличие от простого чат-бота — доступ к инструментам и цикл проверки. Codex читает репозиторий, вносит изменения и сам запускает тесты или сборку; если проверка падает — чинит и перезапускает. Что именно агенту разрешено делать, задаётся командой /permissions: песочница для команд, список директорий для записи, авто-одобрение безопасных действий. Флаг --approve-for-me (появился в 0.147.0) отдаёт агенту право самому одобрять рутинные операции вроде запуска линтера — чувствительные действия по-прежнему требуют согласия.

Установка

Системные требования по официальной документации (на момент публикации):

Требование	Детали
ОС	macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 через WSL2
Git	2.23+ (рекомендуется, для встроенных PR-инструментов)
RAM	4 ГБ минимум, 8 ГБ рекомендуется

Способов установки несколько — выбирайте любой:

Способ	Команда	Когда удобно
Standalone (macOS/Linux)	`curl -fsSL https://chatgpt.com/codex/install.sh \\| sh`	основной вариант, бинарник без зависимостей
Windows	`powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \\| iex"`	нативная установка (WSL2 — рекомендация для работы)
npm	`npm install -g @openai/codex`	если уже пользуетесь Node.js
Homebrew	`brew install --cask codex`	если уже пользуетесь brew
Вручную	архив с GitHub Releases	точный контроль версии

Обновление — той же командой установки: standalone-инсталлятор скачивает свежую версию с releases.openai.com/codex. Проверка установки:

codex --version

На момент публикации актуальная версия — 0.147.0.

Windows: официальная рекомендация — WSL2 (требования перечислены выше). PowerShell-инсталлятор тоже существует, но код для Windows из-под нативного окружения агент запускает реже — большинство гайдов и кейсов работает в WSL.

Вход: ChatGPT-подписка или API-ключ

Первый запуск — codex в директории проекта. CLI предложит войти; доступны два способа (документация по аутентификации):

Способ	Команда	Что даёт	Ограничения
Вход через ChatGPT	`codex login` → браузерный flow	лимиты по подписке (Free/Go/Plus/Pro/Business), облачные функции	нужен VPN из РФ; облако требует MFA на аккаунте
API-ключ	`printenv OPENAI_API_KEY \\| codex login --with-api-key`	оплата за токены по API-тарифам, для CI и автоматизации	нет облачных функций (codex cloud, авторевью PR)

Проверка состояния — codex login status, выход — codex logout. Креды кешируются в ~/.codex/auth.json (или в системном хранилище). При входе через ChatGPT агент использует те же лимиты и права, что и ваш аккаунт ChatGPT; при входе по API-ключу — стандартные тарифы API и правила хранения данных организации (help-центр OpenAI).

Для enterprise-автоматизации есть третий путь — Codex access tokens: printenv CODEX_ACCESS_TOKEN | codex login --with-access-token (для доверенных скриптов и приватных CI-раннеров).

Сколько это стоит: планы и лимиты

Codex включён во все планы ChatGPT — от бесплатного до Enterprise (страница pricing, на момент публикации):

План	Цена	Что даёт для Codex
Free	$0	знакомство: быстрые задачи на скромных лимитах
Go	$8/мес	лёгкие задачи
Plus	$20/мес	несколько фокус-сессий в неделю, все модели GPT-5.6, расширение расходов ChatGPT credits
Pro	от $100/мес	лимиты ×5 или ×20 от Plus, research-модель GPT-5.3-Codex-Spark
Business	$20/пользователь/мес (годовая, от 2 человек)	командные лимиты, SAML SSO, MFA, без обучения на данных
Enterprise / Edu	по запросу	приоритетная обработка, SCIM, EKM, RBAC, Compliance API
API-ключ	оплата за токены	CLI/SDK/IDE, без облака

Лимиты считаются в «локальных сообщениях за 5 часов» (диапазон зависит от сложности задачи; есть и недельные окна). Для Plus на момент публикации:

Модель	Plus (за 5 ч)	Pro ×5	Pro ×20
GPT-5.6 Sol	15–90	75–450	300–1800
GPT-5.6 Terra	20–110	100–550	400–2200
GPT-5.6 Luna	50–280	250–1400	1000–5600

Расход Codex идёт из общего «agentic pool» вместе с ChatGPT Work и Workspace Agents; у части пользователей Plus/Pro расход можно продлить покупкой ChatGPT credits (help-центр OpenAI).

Скриншот официальной страницы pricing: карточки планов Free $0, Go $8, Plus $20, Pro от $100 — Официальная страница Codex pricing (скриншот на момент публикации): Codex входит во все планы ChatGPT — Free $0, Go $8, Plus $20, Pro от $100 (лимиты ×5 или ×20).

Схема: планы ChatGPT и лимиты Codex CLI (локальные сообщения за 5 часов) для Plus и Pro — Планы и лимиты Codex CLI на момент публикации: Free $0, Go $8, Plus $20, Pro от $100 (×5/×20), Business $20/пользователь, API-ключ — по токенам. Лимиты локальных сообщений за 5-часовое окно для GPT-5.6 Sol/Terra/Luna.

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

cd /путь/к/проекту
codex

Дальше — разговор на естественном языке. Примеры промптов, которые работают сразу:

> Объясни, что делает модуль auth.py, и найди в нём потенциальные проблемы
> Напиши тесты для функции parse_config и запусти их
> Собери проект и почини ошибки компиляции
> Создай файл AGENTS.md с правилами этого репозитория

Скриншот официальной документации Codex CLI: интерфейс codex, модель gpt-5.6-sol, команды /init /status /permissions /model /review — Страница Codex CLI в официальной документации (скриншот на момент публикации): интерфейс `codex`, модель по умолчанию `gpt-5.6-sol medium`, команды `/init`, `/status`, `/permissions`, `/model`, `/review`.

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

/init — сгенерировать AGENTS.md с правилами проекта (агент сам изучит репозиторий);
/permissions — что агенту разрешено: песочница, директории для записи, авто-одобрение;
/model — сменить модель и уровень рассуждений;
/review — ревью незакоммиченных изменений, коммита или ветки в стиле пул-реквеста;
/status — текущая конфигурация сессии.

Вне сессии:

codex exec "задача"          # неинтерактивный запуск — для скриптов и CI
codex resume                 # вернуться в сохранённый чат
codex --image ошибка.png "промпт"   # приложить скриншот к задаче
codex --search "промпт"      # запустить с живым веб-поиском
codex mcp                    # управление MCP-серверами
codex cloud                  # передать работу в облако и забрать результат
codex completion             # автодополнение для вашей shell

Полный список команд и флагов — в CLI reference (там же флаг --model, -a для режима запросов подтверждения и --oss — работа с локальными моделями через Ollama, без облака).

Практические приёмы из кейса

То, что сработало у Нэйва на миграции, переносится на обычные задачи:

Держите план в файле, а не в голове. Промпт из кейса — «Execute @plans/… . Keep going. Don’t stop unless you are blocked» — работал, потому что план содержал команды проверки и список незакрытых файлов.
Сбрасывайте контекст между батчами. /new перед каждой порцией задач лечит «context rot» — деградацию длинных сессий.
Ревьюйте вторым проходом. /review перед коммитом ловит то, что агент не заметил; в большом кейсе ревьюером выступала вообще другая модель.
Давайте агенту проверяемый критерий. «Напиши тесты и запусти» лучше, чем «исправь код»: у агента появляется объективный способ убедиться, что задача сделана.
Авто-одобрение — только после доверия. --approve-for-me снимает шум подтверждений, но включать его стоит в сессии, которую вы уже контролируете.

Российские реалии

Специфика доступа из РФ — по опыту тех, кто уже работает с Codex и ChatGPT:

Установка из РФ работает штатно: GitHub, npm и Homebrew доступны, инсталлятор качает бинарник с releases.openai.com/codex. Проблемы начинаются на входе: OpenAI ограничила доступ с российских IP ещё в декабре 2022 года («ChatGPT: как пользоваться нейросетью в России») — для codex login и работы с ChatGPT-аккаунтом нужен VPN со «чистым» иностранным IP.
Бесплатный план Free — без карты. Для знакомства этого достаточно: лимиты скромные, но хватает на десятки небольших задач в неделю.
Оплата Plus ($20/мес) — российские Visa/Mastercard и Mir не принимаются. Рабочие варианты: виртуальные зарубежные карты (пополнение по СБП или USDT), карты банков Казахстана/Грузии/Армении, покупка подписки через посредников. OpenAI при этом отклоняет карты и может блокировать аккаунты при входе с российских IP — личный опыт с реальными суммами и сервисами разобран в статье «Как оплатить подписку ChatGPT из России в 2026 году».
API-ключ — platform.openai.com для России не работает: ключ создаётся с аккаунтом на зарубежный номер и карту. Если ключ есть — Codex CLI работает с ним без VPN-проблем на уровне API.
Codex CLI можно подключить к другим провайдерам. Российский разработчик на практике собрал Codex CLI с инференсом Яндекса (AI Studio API через Responses API) и разобрал, что для этого пришлось менять в конфиге провайдера — «Агентность на практике: Codex CLI и российский AI-ландшафт».
Русскоязычные материалы по теме есть: полный гид от установки до воркфлоу — перевод «Ультимативного гида по Codex CLI», свежее сравнение Codex, Claude Code и Kimi на одной задаче — Habr, 4 августа 2026, перенос контекста из ChatGPT в локальную сессию Codex — Habr.

Коротко для РФ: ставится штатно, бесплатный план не требует карты, вход и оплата — с VPN и зарубежной картой или посредником; альтернатива — API-ключ или подключение российского провайдера.

Советы для безопасного старта

Начните на пет-проекте: «объясни код» и «напиши тесты» — безопасные первые задачи, «перепиши всё» — нет.
Смотрите диффы до коммита. /review перед коммитом дешевле, чем разбор сломанного продакшена.
Ограничьте права через /permissions, пока не привыкли: песочница для команд, только нужные директории.
Не используйте --approve-for-me и --yolo на ранних сессиях — сначала посмотрите, что агент делает сам.
Следите за лимитами: при входе через ChatGPT расход показывает раздел usage в настройках; на Free/Go лимиты по 5-часовым окнам.
Для облака (codex cloud) включите MFA — агент работает с вашим кодом от вашего имени.

Ограничения (честно)

Контекст меньше, чем у конкурентов. ~256 тыс. токенов против 1 млн у Claude Code и Kimi (на момент публикации) — на очень больших кодовых базах Codex раньше «забывает» начало сессии, лечится /new и декомпозицией.
Лимиты по времени. Даже на Pro лимиты считаются 5-часовыми и недельными окнами, а не «безлимитом»; сложные задачи съедают сообщения неравномерно.
Облако — только через ChatGPT. При входе по API-ключу недоступны codex cloud, авторевью PR и облачные интеграции; оплата — по токенам.
Данные. На планах Plus/Pro чаты могут использоваться для обучения (отключается в настройках данных ChatGPT); Business/Enterprise не обучаются по умолчанию.
Переходные модели. GPT-5.4 и 5.4 mini при входе через ChatGPT отключаются 31.08.2026 — конфиги и автоматы, завязанные на них, придётся обновить.
Безопасность. Агент выполняет команды и читает файлы — в непроверенных репозиториях есть риск промпт-инъекций; песочница и /permissions обязательны, а не опциональны.
Из РФ — VPN и оплата. Вход и подписка требуют обхода региональных ограничений OpenAI; подробности — в разделе «Российские реалии».

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

Нужна ли подписка, чтобы пользоваться Codex CLI? Нет. Бесплатного плана ChatGPT (или API-ключа) достаточно, чтобы установить и попробовать. Платные лимиты нужны для регулярной работы.

Чем Codex CLI отличается от openai CLI? Codex CLI — агент: сам читает код, правит файлы и запускает команды. openai CLI — утилита для разовых запросов к API (responses, изображения, аудио) из терминала; у него нет агентного цикла.

Чем Codex CLI отличается от Codex web и десктоп-приложения? Это один агент в разных оболочках: CLI — в терминале, IDE-расширение — рядом с кодом в редакторе, десктоп — для длинных сессий, web на chatgpt.com/codex — в браузере; облачные задачи запускаются оттуда.

Работает ли Codex CLI в России? Сам CLI — да, ставится штатно. Вход через ChatGPT требует VPN из-за ограничений OpenAI по российским IP; бесплатный план не требует карты. Оплата платных планов — зарубежная карта или посредник (раздел «Российские реалии»).

Где хранится вход и не «слетит» ли он? Креды — в ~/.codex/auth.json (или системном хранилище); при входе через ChatGPT токены обновляются автоматически. codex login status покажет текущий способ входа.

Итог

Codex CLI — терминальный агент OpenAI с самой простой установкой в серии: одна команда, вход через бесплатный план ChatGPT или API-ключ, модели GPT-5.6 и предсказуемые лимиты по планам. Кейс Нэйва показывает его сильную сторону — долгую монотонную работу по плану с проверкой на тестах — и честные границы: контекст меньше, чем у конкурентов, длинные сессии деградируют, а облако требует входа через ChatGPT.

Из России инструмент заводится без карты (бесплатный план + VPN для входа), а для платных лимитов понадобится зарубежная карта или посредник. Попробуйте на маленькой задаче — «объясни этот модуль» или «напиши тесты и запусти» — этого достаточно, чтобы понять, ваш ли это инструмент.

Дальше по серии «Агентный кодинг для программистов»: общая вводная — «Что такое агентный кодинг», бесплатный старт — «Как установить OpenCode», настройка и подписки — «Как установить Claude Code», курсор-новинки — «Как пользоваться Cursor», Google-вариант — «Gemini CLI от Google», подключение внешних данных — «Что такое MCP», файлы-конвенций — «AGENTS.md», локальные модели — «Aider и локальные модели».

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка / 5. Количество оценок:

Оценок пока нет. Поставьте оценку первым.

Статьи по теме:

ИИ для документации кода: генерируем README и обновляем changelog

Gemini CLI от Google: как установить и начать пользоваться

AGENTS.md: файл-конвенций, который понимают все AI-агенты