Установка Codex CLI

Проверено 19 июля 2026 года. Команды ниже сверены с официальной документацией OpenAI. Не скачивайте неофициальные сборки, не передавайте кому-либо коды входа и не сохраняйте ключи в репозитории.

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

терминал на macOS, Linux или Windows;
папка проекта, лучше — Git-репозиторий;
аккаунт ChatGPT с доступом к Codex либо API-ключ OpenAI с оплатой по фактическому использованию;
Node.js и npm — только если вы выберете установку через npm.

Codex работает локально в терминале и получает доступ к файлам и командам в пределах выбранных разрешений. Начинайте работу из конкретной папки проекта, а не из домашнего каталога.

Установка

macOS и Linux — официальный установщик

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

Эту же команду можно использовать для обновления standalone-версии.

Через npm

Если Node.js и npm уже установлены:

npm install --global @openai/codex

Для обновления повторите эту команду. Проверьте результат:

codex --version

Для Windows используйте официальный раздел Windows на странице Codex CLI либо npm-вариант в поддерживаемой среде. Не устанавливайте пакет @codex/cli: официальный npm-пакет называется @openai/codex.

Вход

Запустите браузерный вход:

codex login

Выберите один из двух режимов:

Вход через ChatGPT — использует доступ к Codex в вашей подписке или рабочем пространстве.
API-ключ — запросы оплачиваются по тарифам OpenAI API и могут не включать отдельные возможности ChatGPT или облачных задач.

Проверьте состояние авторизации:

codex login status

Для входа с API-ключом без его записи в команду:

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

Не вставляйте ключ в публичные сообщения, Git, скриншоты или shell-скрипты. Для смены аккаунта выполните codex logout, затем войдите снова.

Первый запуск

Перейдите в проект и запустите интерактивную сессию:

cd /путь/к/проекту
codex

Первую задачу лучше сформулировать как проверяемый результат:

Изучи структуру проекта и AGENTS.md. Объясни, какие проверки нужно запустить, но пока не меняй файлы.

Так вы убедитесь, что Codex видит правильный репозиторий и понимает его правила до первой правки.

Правила проекта

Команда /init создаёт черновик AGENTS.md. Отредактируйте его под реальный проект: укажите команды сборки и тестов, архитектурные ограничения, правила Git, деплоя и работы с секретами.

Инструкции в AGENTS.md действуют на каталог и его вложенные папки. Более близкий вложенный файл может уточнять правила отдельного приложения или пакета.

Не превращайте файл в энциклопедию. Оставьте только то, что агент должен учитывать почти в каждой задаче, а подробную документацию подключайте ссылками.

Безопасный режим работы

начинайте со стандартных ограничений и подтверждайте потенциально рискованные действия;
открывайте Codex только в доверенном репозитории;
перед коммитом проверяйте diff, тесты и список изменённых файлов;
не включайте полный доступ к системе без изолированной и понятной среды;
не поручайте публичному или недоверенному вводу формировать команды для автономного выполнения;
храните секреты во внешнем менеджере или переменных окружения, а не в коде.

Стандартный сценарий с записью только в рабочую папку и подтверждением выхода за её пределы подходит для большинства локальных задач.

Автоматизация

Для проверяемых неинтерактивных задач можно использовать codex exec:

codex exec "Запусти тесты и кратко объясни причину каждого сбоя"

В CI обычно применяют API-авторизацию и минимально необходимые права. Сначала отладьте сценарий локально, зафиксируйте допустимые команды и исключите секреты из вывода.

Если что-то не работает

Команда `codex` не найдена

Перезапустите терминал и проверьте, что каталог установки доступен через PATH. Для npm также проверьте npm --version и глобальный каталог пакетов.

Не открывается вход

Проверьте состояние через codex login status. Если сессия повреждена или выбран не тот аккаунт, выполните codex logout и повторите codex login.

Codex запущен не в том проекте

Завершите сессию, перейдите командой cd в корень нужного репозитория и запустите codex заново. До правок попросите агента назвать текущую папку и найденные инструкции.

Сеть ограничена политикой компании

Используйте только разрешённый организацией способ подключения. Не копируйте логины и пароли прокси в репозиторий, AGENTS.md или публичную инструкцию.

Официальные источники

Материал описывает базовую локальную установку. Возможности подписок, поддерживаемые платформы и команды могут меняться — перед автоматизацией и развёртыванием сверяйтесь с официальной документацией.