Codex CLI — гайд для начинающих

Codex — это программа от OpenAI, которая работает в терминале (чёрное окно с текстом). Ты пишешь ей задачу на обычном языке — она пишет и запускает код за тебя. Как ChatGPT, только прямо на твоём компьютере, с доступом к файлам и командам.

Что нужно

Про Windows: официально Codex работает на Mac и Linux. На Windows можно через WSL (Windows Subsystem for Linux) — но это отдельная история. Если у тебя Windows, спроси ChatGPT «как установить WSL на Windows» первым делом.

Установка — 4 шага

Открой терминал

На Mac: нажми ⌘ Cmd + Пробел, набери Terminal, нажми Enter.

Появится окно с чёрным (или белым) фоном и мигающим курсором. Это терминал — сюда мы будем вводить команды.

Last login: Sun Apr 6 14:22:01 on ttys000 user@MacBook ~ $ ▊

Установи Node.js

Codex написан на JavaScript, поэтому нужен Node.js — движок для запуска JS-программ. Скопируй и вставь в терминал:

Если у тебя Mac с Homebrew:

$ brew install node

— или —

Если Homebrew нет — установи его одной командой:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

После этого запусти brew install node.

Проверь, что всё встало:

$ node --version v22.4.0 ← любое число 18 и выше = ок

Установи Codex

Одна команда:

$ npm install -g @openai/codex

Подожди 10–30 секунд. Когда появится новая строка с $ — готово.

Проверь:

$ codex --version

Запусти и войди в аккаунт

Набери:

$ codex

Откроется браузер с окном входа в OpenAI. Войди своим аккаунтом ChatGPT Plus. После входа вернись в терминал — Codex будет готов к работе.

$ codex Opening browser for authentication... ✓ Authenticated successfully codex> ▊ Сюда пишешь задачу обычным текстом.

Первые команды — попробуй

Пример: создай файл

В строке codex> напиши:

codex> создай файл hello.py который печатает "Привет мир"

Codex покажет план: какой файл создаст и что в нём будет. Нажми Enter чтобы подтвердить.

Если что-то пошло не так

Спроси ChatGPT если застрял

Ошибка	Что делать
command not found: codex	Node.js или npm не установлены, или Codex не установился. Попробуй `npm install -g @openai/codex` ещё раз. Если не помогает — перезапусти терминал.
command not found: node	Node.js не установлен. Вернись к шагу 2.
command not found: brew	Homebrew не установлен. Запусти длинную команду из шага 2 (которая начинается с `/bin/bash`).
Authentication failed	Проблема с входом. Убедись что у тебя ChatGPT Plus ($20/мес). Бесплатный аккаунт не подходит.
EACCES permission denied	Нет прав на установку. Добавь `sudo` в начало: `sudo npm install -g @openai/codex` и введи пароль.
Error 429 / rate limit	Слишком много запросов. Подожди пару минут и попробуй снова.
Network error	Проверь интернет. Codex работает только онлайн.

Если ничего не помогает — открой chat.openai.com и скопируй один из этих промптов. ChatGPT разберётся.

💬 Готовые промпты для ChatGPT

Не могу установить

нажми чтобы скопировать Я пытаюсь установить OpenAI Codex CLI на Mac. Когда я ввожу «npm install -g @openai/codex» в терминале, я получаю ошибку. Вот что пишет терминал: [вставь текст ошибки]. Объясни простым языком что делать, я не программист.

Не могу войти в аккаунт

нажми чтобы скопировать Я установил Codex CLI, но когда запускаю команду «codex», браузер открывается и я не могу войти. У меня подписка ChatGPT Plus. Что может быть не так? Я не разбираюсь в программировании, объясни максимально просто.

Что-то не работает (универсальный)

нажми чтобы скопировать Я начинающий пользователь, не программист. Пытаюсь пользоваться OpenAI Codex CLI на Mac. У меня проблема: [опиши проблему]. Вот что показывает терминал: [вставь текст из терминала]. Помоги разобраться простым языком, пошагово.

Команда	Что делает
/model	Переключить модель ИИ (по умолчанию стоит самая умная)
/diff	Показать какие файлы изменил Codex
/clear	Очистить историю разговора, начать заново
Ctrl + C	Отменить текущую операцию, если зависло
exit	Выйти из Codex обратно в терминал