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

Codex CLI это агент OpenAI, который работает в терминале: читает проект, правит файлы, запускает команды и показывает изменения до того, как применит их. Ставится одной командой на macOS, Windows и Linux, код открыт под лицензией Apache 2.0. Отдельно покупать его не нужно: агент входит в тарифы ChatGPT и расходует общий с чатом лимит, а альтернативный вход по ключу API считает деньги строго за израсходованные токены. Актуальная версия пакета на 13 августа 2026 года это 0.147.0. Все факты проверены 13 августа 2026 года по репозиторию openai/codex и официальной документации Codex CLI.

Часть 1 · Понятие

Что такое Codex CLI

В описании проекта формулировка максимально короткая: лёгкий агент для написания кода, который живёт в твоём терминале. Разница с чатом принципиальная. В чате ты копируешь код туда и обратно и сам раскладываешь его по файлам. Агент видит структуру проекта, правит несколько файлов за задачу, запускает тесты и читает их вывод.

• Открытый код. Лицензия Apache 2.0, разработка идёт публично на GitHub, а не за закрытыми дверями.
• Два режима. Интерактивная сессия для живой работы и разовый запуск codex exec для скриптов и конвейеров сборки.
• Права под контролем. Границы доступа задаются командой /permissions: можно разрешить агенту действовать самому или требовать подтверждения на каждый шаг.
• Правила проекта. Команда /init создаёт файл AGENTS.md, где живут договорённости по проекту. Это тот же принцип, что и CLAUDE.md у Claude Code.
• Внешние инструменты. Через codex mcp подключаются сторонние серверы: база, браузер, трекер задач.

Если протокол подключения внешних инструментов пока незнаком, начни с разбора что такое MCP-серверы и как их ставить: стандарт общий, и то, что настроено для одного агента, обычно подхватывается другим.

Часть 2 · Практика

Как установить Codex CLI

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm install -g @openai/codex

brew install --cask codex

После установки терминал нужно перезапустить, иначе новая команда не подхватится. Проверка делается через codex --version: на 13 августа 2026 года в реестре npm лежит версия 0.147.0, опубликованная 7 августа. Обновление идёт тем же способом, каким ставил: повторным запуском установщика или командой npm с суффиксом @latest.

Часть 3 · Windows

Codex CLI на Windows: родная сборка или WSL

Родная установка на Windows делается скриптом PowerShell из блока выше, отдельная сборка под систему существует. Второй путь это Windows Subsystem for Linux: агент ставится внутрь Linux-окружения обычной командой curl. Оба варианта поддержаны официально, но ведут себя по-разному.

Практическое правило простое: если проект уже живёт в WSL, ставь агента туда же, иначе он будет ходить в файлы через границу систем и тормозить. Если проект лежит в обычной папке Windows, хватит родной сборки. Ровно та же логика работает и с соседним агентом, она разобрана в гайде про установку Claude Code на Windows.

Часть 4 · Доступ и деньги

Вход в Codex CLI и в какие тарифы он входит

Вход по аккаунту рекомендуется самим OpenAI и не требует ключей: агент открывает браузер, ты подтверждаешь вход, и лимит начинает считаться общим с чатом. На странице тарифов Codex перечислен в составе планов Free, Go, Plus, Pro, Business, Edu и Enterprise, при этом в README проекта рабочим минимумом называют Plus и выше. Формулировки расходятся, поэтому ориентироваться стоит на практику: на младших тарифах лимита хватает на разовые задачи, а не на рабочий день.

Про оплату из России отдельный разговор: карта российского банка в OpenAI не проходит. Рабочих путей три: зарубежная карта, карта банка стран СНГ или сервис-посредник вроде Оплати по миру, где вносишь рубли, а платёж проходит зарубежной картой. Каждый вариант со своими нюансами разобран в гайде как оплатить подписку ChatGPT.

Часть 5 · Работа

Команды и настройка под проект

codex              # интерактивная сессия в папке проекта
codex exec "..."   # разовый запуск для скриптов и CI
codex resume       # вернуться к прошлому диалогу
codex mcp          # подключить внешние инструменты
codex --version    # проверить версию

Внутри сессии работают слэш-команды. /init создаёт AGENTS.md, /status показывает текущие настройки сессии, /permissions задаёт границы доступа, /model переключает модель и глубину рассуждения, /review прогоняет изменения на предмет проблем.

Файл AGENTS.md это то же самое, что CLAUDE.md у соседнего агента: короткие правила проекта, которые агент читает перед работой. Что туда класть, а что нет, разобрано на примере памяти проекта в файле CLAUDE.md — принцип общий, различается только имя файла. Сам формат давно стал общим стандартом: какие агенты его читают и как связать два файла без дублирования, разобрано в гайде про файл AGENTS.md.

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

Часть 6 · Сравнение

Codex CLI или Claude Code

• Что сильнее у Codex CLI. Открытый код, вход уже включён в подписку ChatGPT, режим оплаты по ключу API, аккуратная работа с правами доступа.
• Что сильнее у Claude Code. Качество модели на сложных архитектурных задачах, большое сообщество и библиотека готовых скилов, плагины и субагенты.
• Что одинаково. Работа в папке проекта, файл правил, подключение внешних инструментов, разовый запуск для автоматизации.

Здравый сценарий — держать оба и выбирать по задаче и по остатку лимитов. Если интересно, во что обходится вторая половина связки, смотри цены Claude Code и способы оплаты. Из открытых альтернатив рядом стоят OpenCode с любой моделью на выбор и Qwen Code от Alibaba, а из бесплатных сред — Google Antigravity.

Вопросы

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

Читать дальше

Соседние гайды