Как установить Codex: CLI, приложение и обновление

Как установить Codex: сначала выберите формат

Как установить Codex, зависит от того, где вы собираетесь работать: в терминале или в отдельном окне. Для терминала нужен Codex CLI; настольное приложение скачивается отдельно. На Windows CLI можно поставить из PowerShell без Microsoft Store.

Проверено по документации OpenAI 26.10.2026. Установка программы и доступ к сервису - отдельные шаги: понадобится собственная учётная запись и доступный ей способ работы с Codex.

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

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

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

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

Codex CLI запускается командой в терминале: вы заходите в папку с проектом, пишете codex, и агент работает с файлами прямо в ней. Настольное приложение ставится отдельно. Его выбор разобран в таблице выше; дальше идут шаги для CLI.

Перед установкой проверьте два условия.

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

После установки нужен отдельный вход в аккаунт. Наличие команды в терминале не подтверждает вход. Сохранённые учётные данные проверяет codex login status.

Команды ниже сверены с официальной инструкцией. Номер версии проверяйте через codex --version; пример номера в статье не означает, что это последний релиз.

Шаг 1. Поставить Codex

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

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 на машине уже есть. Для npm нужен установленный совместимый Node.js:

npm install -g @openai/codex

Через Homebrew на macOS:

brew install --cask codex

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

Самостоятельный установщик CLI для macOS/Linux по умолчанию добавляет команду в ~/.local/bin. Если команда не находится, сначала откройте новый терминал и проверьте PATH. Подробности зависят от установщика и системы; пути от другого способа установки могут отличаться.

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

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

codex --version

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

codex-cli 0.152.1

Строка с версией подтверждает, что команда запускается. Если терминал пишет command not found: codex, проверьте установку и PATH. Расположение зависит от выбранного способа установки.

На macOS/Linux расположение найденной команды показывает:

command -v codex

Если использовали самостоятельный установщик macOS/Linux, отдельно проверьте файл:

ls -la ~/.local/bin/codex

У npm и Homebrew каталог может отличаться. Не подставляйте путь самостоятельного установщика в проверку другого способа.

В PowerShell путь найденной команды показывает:

Get-Command codex -All

Если файл установлен, но команда не находится, проверьте, входит ли каталог именно этой установки в PATH, и откройте новый терминал.

Шаг 3. Войти в аккаунт

codex login

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

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

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

codex login status

При входе через ChatGPT пример строки: Logged in using ChatGPT. При входе по ключу строка будет про ключ. Если браузер вход принял, а терминал ответил token exchange failed, варианты этой ошибки разобраны в статье Codex: token exchange failed.

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

Я сам плачу за ChatGPT и Codex картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF

Шаг 4. Первый запуск

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

codex

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

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

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

У этой команды должен появиться ответ модели. Сам запрос расходует лимит подписки или оплачивается по API. В этой редакционной проверке запрос к модели не запускали.

Если codex exec пишет Not inside a trusted directory and --skip-git-repo-check was not specified, проверьте папку запуска. В официальной инструкции неинтерактивный режим по умолчанию требует Git-репозиторий. Начните с отдельной папки проекта под Git, чтобы можно было посмотреть изменения.

Шаг 5. Прогнать аудит установки

У Codex есть встроенная проверка установки, настроек, входа и среды работы.

codex doctor

По официальной справке, codex doctor проверяет установку, конфигурацию, вход и среду работы. Названия разделов и доступные параметры зависят от версии. Уточните их через codex doctor --help.

Успешная диагностика подтверждает проверенные ею условия. Ответ на первую задачу отдельно показывает, что аккаунту доступна модель. Подключение внешних инструментов - следующий шаг: Codex MCP.

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

Для пошагового разбора Windows используйте отдельную статью.

Как обновить Codex: CLI и приложение

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

codex update

После обновления откройте новый терминал и повторите codex --version. У CLI и настольного приложения разные установки: команда codex update обновляет CLI, а приложение обновляется своим механизмом. Если обновилась не та копия, сравните пути команды через command -v codex на macOS/Linux или Get-Command codex -All в PowerShell. Так можно проверить расположение команды.

Доступ к файлам проекта

Права на файлы задаются отдельно. При запуске можно указать, насколько далеко пускать агента:

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 работает в терминале. Иконки в списке приложений после установки CLI не появится.
4. Запускать из домашней папки. Агент работает с той папкой, из которой запущен. Из домашней он либо откажется, либо получит слишком широкую папку для задачи - ни то ни другое не нужно.
5. Сразу включать полный доступ. danger-full-access и --ask-for-approval never в первый же вечер - самый быстрый способ получить правки там, где вы их не ждали.

Что дальше

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

После установки агенту можно подключить материалы ClaudeBase. Код подключения выдаётся в кабинете; агент получает уроки и инструкции через MCP. Подписки Claude и OpenAI оплачиваются отдельно.

Источники

Команды и различия способов сверены 26.10.2026:

• OpenAI: установка и обновление CLI
• OpenAI: настольное приложение
• OpenAI: вход ChatGPT и API
• OpenAI: команды login, doctor и update
• OpenAI: неинтерактивный запуск