Codex CLI на Windows, Mac и Linux: ставим без путаницы с Node и WSL

Коротко (TL;DR)

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

npm install -g @openai/codex

Что нужно заранее: Node.js версии 16 или новее (с ним ставится и npm) плюс аккаунт ChatGPT или API-ключ OpenAI для входа. По сути вся установка — это одна команда и разовый вход в аккаунт. Если Node ставить не хочется, у OpenAI есть отдельный установщик-скрипт, который тянет уже собранный бинарник, — про него ниже.

Все команды и номера версий в статье проверены на 16 июля 2026 года; актуальная версия пакета на тот момент — 0.144.5. Codex обновляется по несколько раз в неделю, поэтому конкретный номер быстро сменится — сам способ установки при этом стабилен.

Дальше — требования по каждой ОС, четыре способа поставить Codex CLI (и как выбрать свой), проверка, вход в аккаунт, обновление, удаление и разбор ошибок, на которые чаще всего жалуются.

Что такое Codex CLI и что понадобится

Codex CLI — это одна из «поверхностей» Codex наряду с облачными задачами, расширением для VS Code и Codex в ChatGPT. CLI-версия живёт в терминале: вы описываете задачу словами, а агент сам правит файлы и выполняет команды. Как именно ставить задачи и как устроен рабочий цикл — тема отдельных материалов; здесь мы доводим инструмент до состояния «установлен и готов к первому запуску».

Google выпустила Gemini 3.6 Flash — агенты стали экономичнее по токенам

Лимиты Codex: одно окно на локаль и облако — и как его растянуть

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

Два входа в Codex: аккаунт ChatGPT для работы, API-ключ для скриптов

Codex есть в каждом плане ChatGPT — но по-разному: что выбрать и как оплатить

Codex работает на моделях OpenAI, поэтому локально он ничего не «крутит» — считает всё на серверах OpenAI. Если вам интересно, какие именно модели OpenAI стоят за агентом, это разбирается отдельно; для установки достаточно знать, что нужен активный аккаунт.

Минимальный набор для старта:

Если вы уже работали с Node-инструментами, ставить ничего дополнительно не придётся. Тем, кто ещё не сталкивался с терминальными агентами, но уже пробовал похожий инструмент от Anthropic, будет проще: логика близкая — как и в нашем гайде про то, как установить Claude Code, Codex тоже ставится глобальным npm-пакетом, а различия — в командах и способе входа.

Требования: Node.js, ОС и откуда берётся путаница

Здесь кроется главная ловушка, из-за которой люди с рабочим окружением зря переустанавливают Node. Разберёмся по пунктам.

Какая версия Node.js нужна на самом деле

Опубликованный npm-пакет @openai/codex в своём манифесте (engines) требует Node.js 16 и новее — это официальное требование именно для конечного пользователя, который ставит готовый пакет. Проверить у себя:

node --version

Многие блоги пишут «нужен Node 22+». Это требование относится не к обычной установке, а к сборке Codex из исходников (репозиторий на Rust, для контрибьюторов) — там в корневом манифесте действительно стоит Node 22 и pnpm. Обычному пользователю сборка из исходников не нужна.

Практический вывод: формальный минимум — Node 16, но если вы ставите Node с нуля, берите актуальный LTS (20 или 22) — на свежих версиях меньше шансов поймать рантайм-предупреждения, и это тот же Node, что нужен для большинства современных инструментов. Старьё вроде Node 14 не подойдёт.

Поддержка операционных систем

Codex CLI официально работает на всех трёх системах, а пакет собирается под нативные платформы (в npm лежат отдельные сборки под darwin-arm64, darwin-x64, win32-x64, win32-arm64, linux-x64, linux-arm64). Это важно для Windows: раньше единственным путём был WSL2, а теперь агент запускается нативно в PowerShell.

Официальная страница установки OpenAI не задаёт минимальных версий macOS или дистрибутива Linux для готового пакета — жёсткие требования вроде «macOS 12+» или «Ubuntu 20.04+» встречаются только в инструкции по сборке из исходников, и к обычной установке через npm или скрипт они не относятся. Отдельная документация OpenAI по Windows прямо советует по умолчанию использовать нативную песочницу PowerShell и переходить на WSL2 только когда вам реально нужны Linux-инструменты. Так что если старый туториал требует «сначала поставьте WSL2» — он устарел.

Какой способ установки выбрать

Codex CLI можно поставить четырьмя способами, и они не равнозначны. Ниже — дерево решений, чтобы не гадать.

Короткое правило: есть Node — ставьте через npm; нет Node и не хотите его — берите скрипт-установщик; на маке с Homebrew удобен brew; для серверов и CI — бинарник. Дальше — конкретные команды по каждой ОС.

Установка на Windows

На Windows проще всего использовать официальный установщик — он не требует Node.js. Откройте PowerShell и выполните:

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

Флаг -ExecutionPolicy ByPass нужен, чтобы PowerShell разрешил разовый запуск скрипта. Codex установится нативно, WSL2 при этом не требуется.

Если у вас уже стоит Node.js (проверка — node --version), можно поставить пакетом:

npm install -g @openai/codex

Проверьте результат:

codex --version

Команда должна вывести номер версии (например, 0.144.5). Если вместо этого видите codex: command not found или не является внутренней или внешней командой — закройте и откройте PowerShell заново (обновится PATH), а если не помогло — смотрите раздел про ошибки ниже. WSL2 остаётся вариантом на случай, когда вам нужны именно Linux-инструменты внутри проекта, но как обязательный шаг он больше не нужен.

Установка на macOS

На Mac есть три рабочих пути. Самый быстрый, если у вас стоит Homebrew:

brew install --cask codex

Форма именно с --cask — так пакет ставится официально; сокращённое brew install codex из чужих постов может подтянуть не тот формат.

Если Homebrew нет, но есть Node.js:

npm install -g @openai/codex

Универсальный вариант без Node и без Homebrew — официальный скрипт-установщик, он работает и на Apple Silicon, и на Intel-маках:

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

После любого из способов проверьте установку:

codex --version

Установка на Linux

На Linux используйте npm (если Node уже стоит):

npm install -g @openai/codex

Либо официальный скрипт-установщик — он подходит и для дистрибутивов без Node, и для x86_64, и для arm64:

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

Проверка после установки:

codex --version

Если ставите глобальный npm-пакет и ловите ошибку доступа (EACCES) — не спешите добавлять sudo, это создаёт проблемы на будущее. Правильное решение — в разделе про ошибки.

Вход в Codex после установки

Установленный Codex ещё не знает, кто вы. При первом запуске он попросит войти. Есть два пути:

• Вход через ChatGPT — командой codex и выбором «Sign in with ChatGPT». Доступ к Codex входит в тарифы Free, Go, Plus, Pro, Business, Enterprise и Edu (набор планов на 16 июля 2026 года; старый план Team переименован в Business ещё в апреле 2026-го). Лимиты зависят от плана.
• Вход по API-ключу — оплата по токенам, отдельная настройка. Подходит для скриптов и автоматизации.

Какой способ выбрать и чем отличаются тарифы по лимитам — тема отдельного разбора; для установки достаточно знать, что после codex вы один раз авторизуетесь, и дальше агент помнит вход.

Проверка установки и первый запуск

Формальная проверка — уже знакомая команда:

codex --version

Если она вернула номер версии, пакет установлен корректно. Чтобы запустить самого агента, перейдите в папку проекта и введите:

codex

Codex покажет стартовый экран с моделью, рабочей директорией и статусом контекста — это и есть готовый к работе интерфейс. Что вводить дальше и как поставить агенту первую осмысленную задачу — отдельный шаг; здесь важно одно: если codex запускается и показывает интерфейс, установка удалась.

Обновление и удаление Codex CLI

Способ обновления зависит от того, как вы ставили Codex — это тот момент, где источники часто путаются.

Homebrew обновляется и удаляется стандартными командами для cask (с тем же флагом --cask, что и при установке). По сообщениям пользователей, в свежих сборках появляется и встроенная команда обновления, но надёжнее держаться способа под ваш метод установки. Обновляться стоит: Codex развивается быстро, и часть багов (о них ниже) лечится именно апдейтом.

Типичные ошибки установки и как их исправить

Большинство проблем — не в самом Codex, а в окружении (права npm, PATH, версия Node) либо в конкретной «сырой» версии пакета. Вот что встречается чаще всего.

Отдельно стоит знать про баг избыточного логирования: в ранних версиях Codex мог писать на диск огромные объёмы трейс-логов (в худшем сценарии оценивали до сотен ТБ в год) — резонанс был на Hacker News в июне 2026-го, часть фиксов вошла в версию 0.142.0. Это ещё один довод не сидеть на старой сборке.

Общий принцип разбора: ошибка на этапе npm -g — почти всегда про права и PATH (не про Codex), а «команда есть, но падает сразу» — повод посмотреть, не поймали ли вы конкретную битую версию, и обновиться.

Слабые места и риски: что знать до установки

Установка — быстрая, но у Codex CLI есть ограничения, которые лучше знать заранее, чем упереться в них после.

• Без интернета и аккаунта он не работает. Codex считает всё на серверах OpenAI, локально ничего не запускается. Это не автономный инструмент: пропал доступ или лимит — агент встал. Если нужна работа офлайн, это принципиально другой класс инструментов (локальные модели), а не Codex CLI.
• Ваш код уходит на серверы OpenAI. Агент отправляет содержимое проекта в облако. Для учебного или открытого кода это нормально, а вот для закрытых репозиториев с секретами стоит заранее подумать о том, что и куда уходит, и о настройках доступа. Это вопрос не установки, а зрелого использования, но решать его лучше до того, как агент получит доступ к рабочей папке.
• Быстрые релизы — палка о двух концах. Несколько версий в неделю означают не только свежие фичи, но и «сырые» сборки: мы уже видели, как версия 0.144.0 из Homebrew падала на каждой команде. Хвататься за самый свежий тег в тот же час не всегда разумно — иногда стоит подождать патч.
• Установка бесплатна, а работа — нет. Поставить и запустить CLI можно и на бесплатном плане, но лимиты Free и Go упираются быстро. Для реальной работы нужен платный план или оплата по API — это не про установку, но про ожидания.
• Песочница по умолчанию ограничивает агента. Codex не даёт себе свободно выходить в сеть и менять файлы вне проекта без разрешения. Это защита, а не баг, но новичка может удивить «почему агент чего-то не может» — режимы доступа настраиваются отдельно.

Ни один из этих пунктов не мешает установке — но понимание границ инструмента экономит время потом.

Что дальше

Codex установлен и запускается — базовый шаг сделан. Дальше по логике курса идут: вход и тарифы подробно, первая реальная задача агенту и разбор интерфейса CLI с рабочим циклом. Codex, как и другие терминальные агенты, живёт не только в консоли — у него есть облачные задачи, расширение для VS Code и работа из ChatGPT; для сравнения, как один агент растягивается на терминал, десктоп и телефон, показано на примере Claude Code на разных устройствах. Но всё это — уже про работу, а не про установку.

FAQ

Нужен ли Node.js для установки Codex CLI? Для установки через npm — да, нужен Node.js 16 или новее (вместе с ним ставится npm). Если Node ставить не хочется, используйте официальный скрипт-установщик (curl … install.sh | sh на Mac/Linux или PowerShell-версию на Windows) — он тянет готовый бинарник и Node не требует.

Обязателен ли WSL2 для Codex CLI на Windows? Нет. Актуальный Codex CLI работает на Windows нативно в PowerShell со встроенной песочницей. WSL2 нужен только тогда, когда вам необходимы именно Linux-инструменты внутри рабочего процесса. Старые инструкции, где WSL2 подаётся как единственный путь, устарели.

Почему после установки пишет «codex: command not found»? Пакет установился, но папка с бинарником (<npm-prefix>/bin) не попала в PATH вашего терминала. Сначала просто перезапустите терминал — чаще всего этого хватает. Если нет, узнайте путь командой npm bin -g и добавьте его в переменную PATH.

Какая версия Codex CLI актуальна и как часто он обновляется? На 16 июля 2026 года в npm была версия 0.144.5. Codex выходит очень часто — по несколько релизов в неделю, включая мелкие патчи. Конкретный номер быстро устареет, поэтому периодически обновляйтесь способом под ваш метод установки (для npm — npm install -g @openai/codex@latest).

Нужна ли платная подписка, чтобы установить Codex CLI? Сама установка бесплатна. Для входа нужен аккаунт: доступ к Codex есть в тарифах от Free и Go до Plus, Pro, Business, Enterprise и Edu, либо можно платить по API-ключу за фактические запросы. То есть поставить и запустить CLI можно и на бесплатном плане, с его лимитами.