Как установить Codex: пошагово

Что понадобится

• Компьютер с macOS, Linux или Windows.
• Терминал - тот, что уже есть в системе.
• Аккаунт ChatGPT либо ключ платформы OpenAI: без входа Codex не ответит ни на один запрос.
• Папка с проектом, на которой будешь пробовать. Подойдёт любая рабочая.

Что такое Codex сам по себе - в словаре. Чем он отличается от второго популярного агента - в разборе.

Главное, что надо понять до первой команды

Codex CLI - это не программа с окном и кнопкой «Установить». Это команда в терминале: ты заходишь в папку с проектом, пишешь codex, и агент работает с файлами прямо в ней. Настольное приложение у Codex тоже есть, но ставится отдельно, и статья не про него.

Отсюда две вещи, на которых спотыкаются чаще всего.

Способов установки четыре, а Codex получается один и тот же. Разница только в том, чем ты потом будешь его обновлять. Выбирай один способ. От двух установок в системе окажутся две разные команды codex, и ты будешь гадать, какая из них сейчас запустилась.

После установки нужен отдельный вход в аккаунт. Поставленный, но не залогиненный Codex молчит. Жалоба «поставил, а не работает» чаще всего про пропущенный вход.

Всё, что ниже, проверено на живой установке: codex-cli 0.152.1 на macOS. У тебя числа будут другие - Codex обновляется часто, свою версию всегда смотри командой codex --version, а не по статьям в интернете.

Шаг 1. Поставить Codex {#shag-1}

Выбери одну строку из четырёх.

macOS и Linux - официальный установщик. Самый короткий путь, заранее ставить ничего не надо:

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

Windows - тот же установщик, но для PowerShell:

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

Через npm - если Node.js на машине уже есть. Пакету нужен Node не ниже 16 версии:

npm install -g @openai/codex

Через Homebrew на macOS:

brew install --cask codex

Какой выбрать - вот по чему решать:

Теперь важное про то, куда всё это ложится. Официальный установщик кладёт саму программу в папку ~/.codex/packages/standalone, короткую команду - в ~/.local/bin/codex, и дописывает в файл настроек твоей оболочки блок из трёх строк - маркер, строка PATH, маркер:

# >>> Codex installer >>>
export PATH="/Users/имя/.local/bin:$PATH"
# <<< Codex installer <<<

Вместо /Users/имя установщик подставляет полный путь к твоей домашней папке.

Какой именно файл он правит, зависит от системы и оболочки: на macOS с zsh это ~/.zprofile, на macOS с bash - ~/.bash_profile, на Linux - ~/.zshrc или ~/.bashrc. Запомни это место: жалоба «команда не находится» лечится обычно именно здесь.

Шаг 2. Проверить, что команда нашлась {#shag-2}

Закрой окно терминала и открой заново. Новая строка в настройках оболочки читается только при запуске - в старом окне её ещё нет. Дальше:

codex --version

Ответ выглядит так:

codex-cli 0.152.1

Строка с версией - программа на месте, шаг закрыт. Вместо неё пришло zsh: command not found: codex (или bash: codex: command not found) - значит терминал не перезапущен либо папка ~/.local/bin не попала в PATH. Проверь, лежит ли файл вообще:

ls -la ~/.local/bin/codex

Файл есть, а команда не находится - вопрос только в PATH, вернись к блоку из трёх строк выше.

Шаг 3. Войти в аккаунт {#shag-3}

codex login

Команда откроет браузер, там ты входишь в свой аккаунт ChatGPT, и браузер возвращает вход обратно в терминал. Второй способ - по ключу платформы, если платишь за обращения, а не по подписке:

printenv OPENAI_API_KEY | codex login --with-api-key

Проверить, что вход действительно прошёл:

codex login status

На моей машине ответ короткий: Logged in using ChatGPT. При входе по ключу строка будет про ключ.

Про деньги честно: какой план открывает Codex и сколько обращений в него входит - смотри в своём аккаунте ChatGPT, в разделе подписки. Эти числа меняются, и переписанные в статью они врут уже через месяц. Вход по ключу платформы считается отдельно, по её расценкам.

Шаг 4. Первый запуск {#shag-4}

Перейди в папку с проектом и запусти без всяких аргументов:

codex

Откроется рабочий экран со строкой для запроса внизу. Напиши что-нибудь безобидное - например «расскажи, что в этом проекте». Codex прочитает файлы и ответит. Это и есть подтверждение, что связка работает целиком: программа, вход и доступ к папке.

Если хочется проверки в одну строку, без рабочего экрана, есть неинтерактивный режим:

codex exec "ответь одним словом: работает"

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

session id: 01a0656a-7100-76f0-a711-2b7ae9831a07
--------
user
ответь одним словом: работает
codex
работает
tokens used
12,503

Одна засада. Запускать это надо из папки, которую Codex считает доверенной - обычно из папки с git-репозиторием. Из случайной папки в ответ прилетит:

Not inside a trusted directory and --skip-git-repo-check was not specified.

Лечится либо переходом в нормальную папку проекта, либо флагом --skip-git-repo-check в конце команды.

Шаг 5. Прогнать аудит установки {#shag-5}

У Codex есть встроенная проверка: он сам смотрит машину, настройки, вход и обновления.

codex doctor --summary

Вывод разбит на разделы: сверху Notes - то, на что стоит посмотреть, ниже Environment, Configuration, Updates, Connectivity и другие; набор зависит от машины. Строки помечены значками: галочка означает порядок, восклицательный знак в треугольнике - обрати внимание, стрелка вверх - вышла версия свежее твоей. Настоящий кусок вывода:

Codex Doctor v0.152.1 · macos-aarch64

Notes
   ↑ updates      0.153.0 available (current 0.152.1)
   ⚠ sandbox      filesystem unrestricted · network enabled

Environment
  ✓ disk         sufficient free disk space (26.8 GiB)
  ✓ install      consistent
  ✓ git          git version 2.39.5 (Apple Git-154)

Configuration
  ✓ config       loaded
  ✓ auth         auth is configured

Две строки тут главные: install consistent - установка не побилась и лишних копий нет, auth is configured - вход на месте. Обе с галочкой - установка закончена.

Что видишь / что это значит

Обновление и доступы

Обновление идёт тем же способом, каким ставил: установщик - та же команда curl ... | sh ещё раз, npm - npm install -g @openai/codex, Homebrew - brew upgrade --cask codex. Есть и встроенная команда:

codex update

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

codex --sandbox read-only

Значений три: read-only - только читать, workspace-write - писать в рабочую папку, danger-full-access - без ограничений. Начинать стоит с первых двух. Рядом живёт ключ --ask-for-approval со значениями on-request и never - это про то, спрашивать ли у тебя разрешение перед запуском команд. Выключать вопросы на второй день знакомства не надо.

Выйти из аккаунта - codex logout, команда стирает сохранённый вход. Настройки и история остаются в папке ~/.codex.

Пять ошибок при установке

1. Ставить двумя способами сразу. Классика: сначала через npm, потом «на всякий случай» установщиком. В системе оказываются две команды codex разных версий, и какая запустится - зависит от порядка папок в PATH.
2. Не перезапускать терминал. Установка прошла, а команда не находится. В открытом окне старый PATH, новая строка туда не приехала.
3. Ждать окно программы. Codex живёт в терминале. Иконки в списке приложений после установки CLI не появится.
4. Запускать из домашней папки. Агент работает с той папкой, из которой запущен. Из домашней он либо откажется, либо возьмёт в работу весь твой диск - ни то ни другое не нужно.
5. Сразу включать полный доступ. danger-full-access и --ask-for-approval never в первый же вечер - самый быстрый способ получить правки там, где ты их не ждал.

Что дальше

• Что такое Codex - термин целиком, без установки.
• Codex или Claude Code - какой агент под какую работу.
• Скиллы в Codex - как научить его своим приёмам.
• Что такое агент - если слово пока размытое.
• Вайб-кодинг: с чего начать - первая задача после установки.

Дальше начинается вопрос не «как поставить», а «что ему давать читать». Всё, что я собрал под свои проекты, лежит в ClaudeBase: файлы добавляются в проект по инструкции, и агент берёт их сам, без пересказа руками.