Codex CLI — это клиент Codex для терминала: он работает с файлами локального проекта и запускает доступные на компьютере команды. Это не приложение ChatGPT для рабочего стола и не расширение IDE. Если вам нужен именно интерфейс командной строки, ниже можно пройти весь путь по наблюдаемым результатам: оболочка находит codex, клиент открывается в каталоге проекта, вход подтверждён, и начинается первый сеанс.
На 15 августа 2026 года официальная инструкция Codex CLI предлагает четыре варианта: отдельные установщики для macOS/Linux и Windows, пакет npm и Homebrew. Поэтому Node.js нужен только для варианта с npm, а не для Codex CLI вообще. Команды и доступные способы могут измениться; перед установкой сверьте их с официальной страницей по ссылке выше.
Сначала выберите способ, который подходит вашей системе
Не устанавливайте все варианты подряд. Выберите один путь, подходящий вашей среде, а при обновлении пользуйтесь тем же способом.
- macOS или Linux без предпочтительного менеджера пакетов. Выберите отдельный установщик. Заранее понадобятся терминал,
curlи право устанавливать программы для своей учётной записи. - Windows. Выберите отдельный установщик PowerShell. Нужны PowerShell и разрешение выполнять официальный установочный сценарий.
- Среда, где уже настроены Node.js и npm. Используйте npm, если команда
npmработает, а каталог глобальных пакетов правильно добавлен вPATH. - macOS с Homebrew. Выберите Homebrew, если обычно обслуживаете программы этим менеджером и команда
brewуже работает.
PATH — это список каталогов, в которых оболочка ищет исполняемые команды. Успешное сообщение установщика ещё не доказывает, что новый исполняемый файл уже доступен в текущем окне терминала.
Установите Codex CLI одним официальным способом
macOS и Linux: отдельный установщик
Откройте терминал и выполните текущую команду с официальной страницы установки:
bashcurl -fsSL https://chatgpt.com/codex/install.sh | sh
Команда загружает сценарий с домена ChatGPT и сразу передаёт его оболочке. Если правила вашей организации запрещают запуск загруженных сценариев через конвейер, не обходите ограничение: используйте утверждённый администратором способ установки.
Windows: отдельный установщик PowerShell
В PowerShell выполните команду, которую публикует официальная документация Codex CLI:
powershellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Не отключайте ради установки корпоративные средства защиты и не меняйте системную политику шире, чем указано в официальной команде. Если запуск сценариев запрещён правилами организации, запросите утверждённый способ установки у администратора.
npm: если Node.js уже входит в вашу рабочую среду
Если npm уже установлен и глобальные пакеты доступны вашей оболочке, используйте официальный пакет:
bashnpm install -g @openai/codex
Эта же команда обновляет глобально установленный пакет. Если npm отсутствует, не нужно устанавливать Node.js только ради следования чужой инструкции: вернитесь к отдельному установщику для своей ОС. Если же в команде принят менеджер версий Node.js, запускайте установку в том окружении, которым пользуетесь для повседневной работы, иначе codex может оказаться доступен только в другой версии Node.js.
Homebrew: для уже настроенного macOS
Пользователи Homebrew могут установить cask, указанный в официальной инструкции:
bashbrew install --cask codex
Для последующего обновления:
bashbrew upgrade --cask codex
Homebrew здесь — удобный способ обслуживания программы, а не дополнительное обязательное условие работы Codex CLI.
Проверьте установку до входа
Сначала откройте новое окно терминала. Это важно: уже запущенная оболочка могла не получить изменения PATH.
На macOS и Linux спросите оболочку, где находится команда:
bashcommand -v codex
В PowerShell используйте:
powershellGet-Command codex
Если команда возвращает путь или объект команды, оболочка нашла исполняемый файл. Это подтверждает только локальную установку — ещё не вход в аккаунт и не доступ к сервису.
Затем перейдите в реальный каталог проекта и запустите клиент:
bashcd /путь/к/вашему-проекту codex
Путь после cd замените своим; запись выше — пример, а не буквальная команда для копирования. Согласно официальному быстрому старту, Codex следует запускать из каталога проекта: именно этот каталог задаёт рабочий контекст первого сеанса.
Перед задачей, которая может изменить код, проверьте текущее состояние репозитория и сделайте понятную точку возврата. Сам факт запуска Codex не означает, что любые предложенные им команды или изменения нужно одобрять без просмотра.
Войдите через ChatGPT или API-ключ
Для локального Codex OpenAI описывает два основных способа входа: через ChatGPT и через API-ключ. Они различаются не только формой входа, но и оплатой, политиками workspace и доступностью отдельных функций; актуальные границы перечислены в официальной документации об аутентификации.
Вход через ChatGPT
При первом запуске codex можно выбрать вход через ChatGPT. Если нужно начать этот процесс отдельно, выполните:
bashcodex login
CLI откроет браузерный поток входа, после которого учётные данные возвращаются клиенту. Для проверки состояния используйте документированную команду:
bashcodex login status
В управляемом рабочем пространстве успешная аутентификация не отменяет ограничения администратора, роли и доступные вашей учётной записи функции.
Вход через API-ключ
Если вы осознанно используете оплату OpenAI Platform и ключ уже сохранён в переменной окружения OPENAI_API_KEY, официальная инструкция передаёт его через стандартный ввод — поток данных, а не аргумент командной строки. В macOS и Linux команда выглядит так:
bashprintenv OPENAI_API_KEY | codex login --with-api-key
В PowerShell тот же способ передачи через стандартный ввод выглядит так:
powershell$env:OPENAI_API_KEY | codex login --with-api-key
Не вставляйте реальный ключ в статью, команду как открытый текст, скриншот или репозиторий. Вход по API-ключу тарифицируется через аккаунт OpenAI Platform, а некоторые возможности, завязанные на рабочее пространство ChatGPT или облачные сервисы, могут быть недоступны. Если вам нужен доступ, включённый в подписку ChatGPT, не подменяйте его API-ключом только ради устранения ошибки входа.
Отделите четыре результата друг от друга
После каждой ступени проверяйте именно её, а не начинайте установку заново при любой ошибке.
- Установка. Признак успеха: установщик или менеджер пакетов завершился без ошибки. Это ещё не доказывает, что текущая оболочка видит команду.
- Обнаружение команды. Признак успеха:
command -v codexилиGet-Command codexнаходит файл. Это ещё не доказывает, что пользователь вошёл. - Аутентификация. Признак успеха:
codex login statusподтверждает активный способ входа. Это ещё не доказывает, что конкретный workspace, модель или функция доступны. - Первый сеанс. Признак успеха:
codexоткрывается в нужном каталоге и принимает задачу. Это ещё не доказывает, что результат можно применять без проверки.
Такой порядок экономит время. Например, ошибка браузерного входа при уже найденной команде — не доказательство повреждённой установки. И наоборот, запрос учётных данных не поможет, если PowerShell или оболочка вообще не находит codex.
Если codex не запускается
Оболочка пишет, что команда не найдена
Закройте и заново откройте терминал, затем повторите command -v codex или Get-Command codex. Если устанавливали через npm, убедитесь, что используете то же окружение Node.js и что каталог глобальных исполняемых файлов npm входит в PATH. Если через Homebrew — проверьте, что сама команда brew доступна в этом окне.
Не смешивайте способы в попытке «усилить» установку. Две копии codex в разных каталогах усложняют обновление: оболочка запустит ту, чей каталог стоит раньше в PATH.
Запускается не тот продукт
Вернитесь к проверке пути команды. Приложение для рабочего стола и расширение IDE не обязаны создавать терминальную команду codex; их наличие не подтверждает установку CLI. Удалять их для установки CLI тоже не требуется, если нет отдельного конфликта.
Команда есть, но вход не завершается
Проверьте codex login status, активную учётную запись в браузере и правила рабочего пространства. Если выбран API-ключ, проверьте, что переменная окружения задана в текущей оболочке, но не выводите значение ключа в общий журнал.
Переустановка имеет смысл только при признаках повреждения или неправильного бинарного файла. Проблемы аккаунта, сети, политики workspace или доступности сервиса находятся на следующем уровне и обычно не исправляются повторной установкой клиента.
Возникает вопрос о доступности в стране или сети
Установка локальной команды не подтверждает региональную доступность аккаунта, сервиса или конкретных моделей. Остановитесь и проверьте актуальные официальные условия для своей учётной записи и организации. Сторонний шлюз, прокси или обещание работы «без VPN» не становятся официальным способом Codex CLI только потому, что упоминают совместимую команду.
Начните первый контролируемый сеанс
Когда команда найдена и вход подтверждён, откройте проект в терминале и снова запустите codex. Для первой безопасной проверки дайте задачу, которая не требует изменений, например:
textОбъясни структуру этого проекта и назови команды проверки, не изменяя файлы.
Сравните ответ с реальной структурой репозитория и посмотрите, какие действия клиент предлагает выполнить. После этого можно переходить к небольшой, обратимой задаче. Цель первого сеанса — убедиться, что Codex видит правильный проект и что вы понимаете границы его доступа, а не сразу поручать крупное изменение.
Команды и варианты входа в этом материале сверены с официальной документацией OpenAI 15 августа 2026 года. Мы не объявляем установку на каждой ОС собственным сравнительным тестом и не делаем выводов о региональной доступности. Для окончательной проверки перед запуском используйте актуальную страницу Codex CLI и страницу аутентификации.
