Codex CLI — це AI-агент OpenAI, який працює прямо у терміналі вашого комп'ютера.
Ви відкриваєте папку з проєктом, запускаєте Codex і пишете звичайною мовою, що потрібно зробити. Наприклад:
Знайди, чому не працює форма реєстрації, виправ помилку та перевір результат.
Codex може сам подивитися файли проєкту, знайти потрібний код, змінити його, створити нові файли та запускати команди.
Тобто вам не потрібно вручну шукати, у якому файлі знаходиться кнопка або яка функція відповідає за авторизацію.
У цій інструкції розберемося, що таке Codex CLI, як його встановити і як дати йому першу реальну задачу.
Що таке Codex CLI
CLI означає Command Line Interface, тобто інтерфейс командного рядка.
Звучить технічно, але на практиці все простіше.
Замість окремої програми з кнопками та вікнами ви відкриваєте термінал і запускаєте:
codex
Після цього можете спілкуватися з Codex майже так само, як із ChatGPT.
Різниця в тому, що Codex CLI працює безпосередньо з папкою вашого проєкту.
Він може:
- читати файли;
- створювати нові файли;
- змінювати код;
- шукати помилки;
- запускати команди;
- запускати тести;
- пояснювати, як влаштований проєкт;
- перевіряти внесені зміни.
Саме тому Codex CLI цікавий для вайбкодингу. Ви можете більше думати про те, що хочете отримати, і менше про те, у якому саме файлі потрібно щось змінити.
Чим Codex CLI відрізняється від звичайного Codex
Назва Codex зараз використовується одразу для кількох способів роботи з coding agent OpenAI.
Codex CLI працює у терміналі безпосередньо на вашому комп'ютері.
Codex також можна використовувати через інші інтерфейси, наприклад у графічному застосунку або в середовищі розробки.
Для новачка головна різниця дуже проста.
Якщо ви користуєтеся Codex CLI, ви спочатку відкриваєте папку свого проєкту в терміналі, а потім запускаєте агента.
Наприклад:
cd my-project
codex
Після цього Codex розуміє, з яким проєктом ви працюєте.
Чи потрібно знати термінал
Майже ні.
На початку вам знадобиться буквально кілька команд.
Наприклад:
cd my-project
означає «перейти в папку my-project».
А:
codex
запускає Codex CLI.
Далі більшість дій можна описувати звичайною мовою.
Наприклад:
Подивись на цей проєкт і поясни, як він працює.
Або:
Знайди головну сторінку і зміни заголовок.
Тобто термінал тут швидше є місцем, де працює Codex, ніж інструментом, який вам потрібно окремо вивчати.
Як встановити Codex CLI на Windows
Відкрийте PowerShell.
Для цього натисніть Start у Windows, введіть:
PowerShell
І відкрийте програму.
Після цього вставте команду встановлення:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Дочекайтеся завершення встановлення.
Після цього закрийте PowerShell і відкрийте його знову.
Тепер введіть:
codex
Якщо Codex запускається, встановлення завершено.
Як встановити Codex CLI на macOS або Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Після встановлення відкрийте нове вікно терміналу та введіть:
codex
Є також інші способи встановлення, наприклад через npm або Homebrew, але якщо ви тільки починаєте, немає великого сенсу ускладнювати собі вибір.
Як увійти в Codex
Під час першого запуску Codex запропонує авторизуватися.
У більшості випадків найпростіше увійти через ваш акаунт ChatGPT.
Після цього Codex CLI буде використовувати доступ, який передбачений вашим планом.
Якщо ви ще не розібралися, скільки коштує Codex і які є варіанти використання, у нас є окрема стаття про Codex pricing.
Створюємо перший проєкт
Тепер спробуємо використати Codex для реальної задачі.
Створіть папку:
mkdir my-first-project
Перейдіть у неї:
cd my-first-project
І запустіть Codex:
codex
Тепер можна просто написати:
Створи просту HTML-сторінку для кав'ярні. Додай назву, короткий опис, кнопку «Замовити» і зроби сучасний дизайн.
Codex проаналізує задачу і почне створювати необхідні файли.
Вам не потрібно говорити:
Створи index.html, додай div, потім CSS-файл і пропиши flexbox.
Це вже його робота.
Ви описуєте результат, який хочете отримати.
Що попросити Codex далі
Коли перша версія готова, продовжуйте звичайну розмову.
Наприклад:
Зроби сторінку більш сучасною.
Потім:
Зроби так, щоб вона добре виглядала на телефоні.
Потім:
Додай блок із трьома популярними напоями.
І нарешті:
Запусти сайт локально і скажи, як мені його відкрити в браузері.
Це вже базовий workflow вайбкодингу:
ідея → перша версія → дивимося результат → просимо змінити → повторюємо.
Як відкрити сайт у браузері
Codex CLI сам по собі не є браузером.
Він працює з файлами та може запустити ваш проєкт локально.
Після цього Codex може сказати вам відкрити адресу на кшталт:
http://localhost:3000
Відкриваєте її у Chrome, Edge або іншому браузері й бачите результат.
localhost означає, що сайт зараз працює тільки на вашому комп'ютері.
Щоб він став доступним іншим людям через інтернет, його потрібно буде окремо задеплоїти на хостинг.
Як почати не з нового, а з уже існуючого проєкту
Це ще один дуже корисний сценарій.
Перейдіть у папку свого проєкту:
cd my-project
Запустіть:
codex
І першою командою напишіть:
Подивись на весь проєкт і коротко поясни мені, як він влаштований. Поки нічого не змінюй.
Це хороший спосіб почати роботу, особливо якщо проєкт створювали не ви або якщо ви вже не пам'ятаєте його структуру.
Після цього можна попросити:
Знайди, де реалізована форма входу.
А потім:
Додай можливість показати пароль перед входом.
Codex сам знайде потрібні файли.
Чи безпечно дозволяти Codex змінювати файли
Codex CLI працює з реальними файлами на вашому комп'ютері, тому варто дотримуватися кількох простих правил.
Не запускайте його просто в корені диска C: або в папці, де знаходяться всі ваші особисті документи.
Краще мати окрему папку для кожного проєкту і запускати Codex саме всередині неї.
Так агент буде працювати в зрозумілому для вас контексті.
Codex також використовує систему дозволів для дій, які можуть виходити за межі звичайної роботи з проєктом. Якщо агент просить дозвіл на дію, якої ви не розумієте, не потрібно автоматично погоджуватися. Можна просто запитати:
Навіщо тобі потрібен цей дозвіл?
Чи потрібен Git
Для першого знайомства — ні.
Але якщо ви продовжите працювати над проєктом, Git дуже швидко стане корисним.
Уявімо, що ваш сайт працював нормально. Потім ви попросили Codex додати нову функцію, він змінив десять файлів — і щось зламалося.
Git дозволяє повернутися до попередньої робочої версії.
Для вайбкодингу це особливо важливо, тому що AI може робити багато змін одночасно.
Тому після перших експериментів я б додав Git до вашого workflow.
Codex CLI чи Claude Code
За принципом роботи вони дуже схожі.
Обидва інструменти запускаються локально, бачать файли вашого проєкту, можуть їх змінювати, запускати команди та виконувати досить великі задачі.
Головна різниця вже не в тому, що один «пише код», а інший «агент». Обидва є coding agents.
Вибір більше залежить від моделей, тарифів, конкретного workflow та того, який інструмент вам суб'єктивно краще виконує ваші задачі.
Ми окремо порівняли Claude Code та Codex для початківців.
Codex CLI чи Codex App
Якщо сам вигляд терміналу вас дратує, CLI не є єдиним варіантом.
Codex також має більш візуальні способи роботи.
CLI хороший своєю простотою: відкрили папку, запустили `codex`, дали задачу.
Графічний інтерфейс може бути зручнішим, якщо ви хочете бачити більше інформації про зміни, працювати з кількома задачами або просто не любите термінал.
Для самого вайбкодингу принцип при цьому залишається однаковим: ви формулюєте задачу, а агент працює з кодом.
З чого почати
Не намагайтеся спочатку вивчити всі команди Codex CLI.
Для першого дня достатньо вміти зробити три речі:
відкрити папку проєкту;
запустити:
codex
і нормально описати, що ви хочете отримати.
Почніть з маленької задачі.
Наприклад, створіть просту сторінку, калькулятор, трекер витрат або невеликий інструмент для власної роботи.
Потім подивіться на результат і продовжуйте говорити Codex, що потрібно змінити.
Саме в цей момент Codex CLI перестає виглядати як незрозуміла програма в терміналі й стає тим, чим він насправді є: агентом, якому можна передавати роботу з кодом.