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 можна й на безкоштовному плані, з його лімітами.