Codex CLI: как поставить агента OpenAI в терминал и что он потребует

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

Что такое Codex CLI и зачем он в терминале

Codex CLI — агент OpenAI, который работает у вас на компьютере: читает файлы проекта, правит их и запускает команды. Код программы лежит на GitHub под лицензией Apache-2.0, поэтому посмотреть, что именно она делает с вашими файлами, может любой желающий. Сама модель при входе через ChatGPT работает на серверах OpenAI, поэтому и доступ упирается в них.

От приложения Codex терминальная версия отличается в первую очередь установкой: это десктопному приложению на Windows нужен Microsoft Store, а CLI ставится штатно, без обходов. Как обойти Store для приложения, я разбирал в канале ещё в сентябре, но для терминала эта проблема просто не возникает.

Как установить Codex CLI на Windows, Mac и Linux

Искать установочный файл незачем: на Mac и Linux, включая Ubuntu, хватит одной строки.

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

На Windows команда запускается в PowerShell:

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

Если уже стоит Node.js, подойдёт и npm:

npm install -g @openai/codex

На Mac есть ещё Homebrew:

brew install --cask codex

Установщик сам скачивает программу с серверов OpenAI, а если они недоступны, идёт за ней на GitHub. Скачать архив вручную тоже можно: в разделе Releases на GitHub лежат готовые сборки под Mac и Linux, для обычного сервера на Ubuntu подойдёт архив с пометкой linux-musl. После распаковки файл стоит переименовать в codex.

Первый старт удобнее делать из нужной папки: наберите codex, и программа предложит войти через аккаунт ChatGPT.

Codex CLI в России: что показала проверка

Для этой статьи я 3 ноября прогнал три запроса с российского сервера и получил три разных ответа. Адрес установщика вернул отказ 403 и обычную веб-страницу вместо скрипта. Реестр npm отдал пакет спокойно, версия на тот момент 0.166.0. А сервер API ответил прямым текстом: unsupported_country_region_territory.

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

Для работы нужны VPN с постоянным зарубежным адресом и зарубежный аккаунт. Правилами OpenAI такой путь не предусмотрен, и аккаунт могут заблокировать вместе с оплаченным месяцем. Похожий маршрут со всеми рисками я подробно разбирал на примере подписки Claude: регистрация с проверкой по СМС там занимает куда больше времени, чем сама программа.

Какой тариф нужен и какие лимиты у Plus

На странице цен Codex указан и для Free с Go, но там речь про приложение и младшую модель, причём с оговоркой о постепенном запуске. Терминал прямо назван начиная с Plus. Второй путь — ключ API с оплатой за расход.

Лимиты на Plus считаются окнами по пять часов. Вот сколько локальных сообщений OpenAI обещает за такое окно:

По умолчанию в примере из документации стоит GPT-6.1 Sol. Разница между соседними строками огромная, а внутри строки разброс почти десятикратный, потому что расход зависит от задачи: короткая правка и обход всего проекта считаются по-разному. Отсюда практический совет: для рутины я бы сразу переключался на младшую модель командой /model, а старшую оставлял для задач, где модель должна подумать.

Сколько осталось, видно по /status. Сообщения в локальном агенте и чаты в облаке расходуют один и тот же объём, поэтому длинная переписка на сайте тоже съест ваш терминальный запас. Как считать такие расходы на своих задачах и что вообще поручать агенту, я показывал в разборе ИИ-агентов для бизнеса.

Как пользоваться Codex CLI после установки

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

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

Работай только в этой папке. Задача: [например, объедини CSV-файлы в одну таблицу и убери дубли по телефону].

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

Для повторяющихся задач есть codex exec: так агента можно вызвать из скрипта без диалога. Я бы добирался до него только после нескольких десятков ручных запусков, когда понятно, где агент ошибается.

Codex CLI или Claude Code

Устроены они похоже, и вход по цене одинаковый: $20 в месяц за Plus у OpenAI и за Pro у Anthropic. Из России оба работают только через VPN и зарубежный аккаунт. Различий на старте два: у OpenAI есть бесплатный вариант в приложении на младшей модели, а Claude Code на Free не работает. Подробное сравнение и установку второго агента я разобрал в статье про Claude Code. Если подписка на одну из компаний уже есть, её агент и станет самым дешёвым способом проверить идею.

Где ломается

Я проверял установку и доступ с одного российского сервера и документацию OpenAI, а вход с подпиской и работу агента на реальном проекте в этом разборе не проходил. Поэтому о качестве кода здесь нет ни слова, только о том, как добраться до первого запуска.

Лимиты в таблице — оценки самой OpenAI с почти десятикратным разбросом. Страница цен предупреждает, что это не фиксированные значения, и текущие цифры стоит смотреть в личном кабинете. Модели в списке сменяются быстро: GPT-5.5 из Codex убрали ещё в октябре.

Доступ через VPN идёт против правил компании, а возврата денег при блокировке ждать не стоит. Для бизнеса, который зависит от результата, это настоящий риск, и копии проектов лучше держать у себя.

Что сделать сегодня

Откройте терминал и проверьте, что отвечает codex --version после установки любым способом. Затем заведите отдельную папку с копией рутинного файла и дайте агенту задачу по шаблону выше, начав с младшей модели. Сколько сообщений это съело, покажет /status, и прикинуть месячный расход можно уже не по чужим оценкам.

Минута уходит на установку, а настоящий экзамен Codex сдаёт на задаче, результат которой вы умеете проверить сами.