Codex CLI: команды, режимы и как начать в терминале (2026)

Codex CLI работает как командная утилита от OpenAI и запускает ИИ-агента прямо в вашем терминале: он читает файлы проекта, пишет и правит код, выполняет команды и объясняет, что делает. Ставится одной строкой через npm, работает на macOS, Linux и Windows, а модель по умолчанию берётся из семейства GPT-5. Ниже, что это за инструмент, как его установить, какие есть команды и режимы безопасности (sandbox и approvals), как запустить первый проект и что с оплатой из России.

Что такое Codex CLI и чем отличается от веб-версии

Codex у OpenAI существует в нескольких видах: облачный агент внутри ChatGPT, расширение для редактора кода и CLI, то есть утилита для терминала. CLI устроен как локальная программа с открытым исходным кодом: она работает на вашем компьютере, видит вашу папку с проектом и запускается командой в консоли, а не в браузере.

Смысл терминального агента в том, что он сам применяет правки к файлам и запускает команды (установить пакет, прогнать тесты, собрать проект), спрашивая у вас разрешение по заданным правилам, а не только выдаёт текст с кодом. Для того, кто раньше не работал с кодом, это удобно тем, что не нужно вручную копировать куски кода из чата в файлы: агент делает это сам, а вы наблюдаете и подтверждаете шаги.

• Работает офлайн-локально с вашими файлами, а не через загрузку в облако.
• Понимает не только текст, но и картинки: можно показать скриншот ошибки или макет.
• Умеет выполнять команды в системе, но по умолчанию в изолированном режиме (sandbox).
• Открытый исходный код, поэтому видно, как именно устроена работа с файлами.

Установка: требования и команда

Основной способ поставить Codex CLI проходит через менеджер пакетов npm. Нужен установленный Node.js версии 22 или новее, иначе установка выдаст ошибку. После этого команда одна:

1. Установите Node.js 22+ с официального сайта и проверьте версию командой node -v.
2. Выполните в терминале: npm install -g @openai/codex
3. Проверьте, что всё встало: codex --version

Частая ошибка, установить пакет без префикса @openai. Команда npm i -g codex поставит совсем другой, старый проект 2012 года, не связанный с OpenAI. Правильное имя пакета обязательно с приставкой: @openai/codex. На macOS и Linux есть альтернатива без npm, установочный скрипт с сайта, но подробности установки под разные платформы (в том числе особенности Windows) мы вынесем в отдельный разбор.

Если после установки терминал пишет command not found, чаще всего дело в PATH: закройте и откройте окно терминала заново, а если не помогло, проверьте, что папка глобальных npm-пакетов прописана в переменной PATH.

По теме: Как установить Codex в 2026: приложение на Windows и Mac, CLI и IDE

Вход в аккаунт и первый запуск

Codex CLI входит в подписку ChatGPT: авторизоваться можно через аккаунт ChatGPT (командой codex login) на любом тарифе, включая бесплатный. Второй вариант, работать по ключу OpenAI API и платить за токены отдельно. Для старта проще первый способ.

1. Перейдите в терминале в папку своего проекта (или создайте пустую папку под новый).
2. Запустите агента командой codex, откроется интерактивный режим.
3. При первом запуске выберите вход через ChatGPT и подтвердите его в браузере.
4. Напишите задачу обычными словами, например: создай простую страницу-визитку на HTML и CSS.
5. Смотрите, что предлагает агент, и подтверждайте предлагаемые действия.

Если задачу нужно выполнить без диалога, одной командой и сразу с результатом, есть неинтерактивный режим codex exec, ему передают задачу текстом, и он отрабатывает её от начала до конца. Это удобно для однотипных задач и сценариев автоматизации.

Режимы: sandbox и approvals

Главное, что отличает Codex CLI от обычного чата, это контроль над тем, что агенту позволено делать с вашим компьютером. За это отвечают два набора настроек: sandbox (что можно с файлами и сетью) и approvals (когда спрашивать разрешение). Их подробно описывает документация OpenAI по безопасности.

Уровни sandbox (флаг --sandbox):

• read-only: агент может только читать файлы, но ничего не меняет и не запускает.
• workspace-write: агент пишет и правит файлы внутри текущей папки проекта и временных каталогов, без доступа в остальную систему; сеть по умолчанию отключена.
• danger-full-access: полный доступ к файлам и сети без ограничений, включать только осознанно.

Режимы подтверждений переключаются прямо во время работы командой /permissions: она открывает меню, где выбираете пресет доступа, например Read Only (только чтение) или Auto (действовать самостоятельно в пределах песочницы). Раньше был ярлык --full-auto, но сейчас OpenAI считает его устаревшим и рекомендует явно указывать --sandbox workspace-write (подтверждения по умолчанию будут спрашиваться по необходимости).

Тонкая настройка (модель, режимы по умолчанию, дополнительные серверы) хранится в файле конфигурации ~/.codex/config.toml, а правила по конкретному проекту, в файле AGENTS.md в его папке. Для первых шагов трогать их не обязательно.

Начинайте с workspace-write и подтверждений, а не с полного доступа. Так агент правит только вашу папку проекта, и одна неверная команда не заденет остальные файлы на компьютере.

По теме: Claude CLI, он же Claude Code: установка и первые команды

Как запустить первый маленький проект

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

1. Создайте пустую папку и откройте её в терминале.
2. Запустите codex и убедитесь, что стоит режим workspace-write.
3. Опишите задачу конкретно: что за страница, какие блоки, какой текст.
4. Подтверждайте шаги и просите поправить то, что не нравится, обычными словами.
5. Откройте получившийся файл в браузере или запустите скрипт и проверьте результат.

Чем точнее формулируете задачу и чем меньше шаг, тем предсказуемее результат. Если агент пошёл не туда, попросите откатить или изменить конкретный кусок, переписывать всё заново не нужно.

Сколько стоит и доступ из России

Отдельной подписки на Codex нет: доступ входит в тарифы ChatGPT. По данным страницы тарифов OpenAI, для личного использования это Free за $0, Go за $8 в месяц, Plus за $20 в месяц и Pro за $100 в месяц; лимиты CLI, веба и расширения общие для вашего тарифа. Альтернатива, оплата по API за токены.

С апреля 2026 года расход на платных тарифах считается по потреблению токенов/кредитов, а не по числу сообщений. Точные лимиты и тарифы стоит смотреть на официальной странице перед покупкой, они меняются.

Сам инструмент из России технически доступен, основная сложность, оплата: российские карты Visa и Mastercard за рубежом не проходят из-за ограничений платёжных систем. Обычно подписку оформляют через зарубежную карту или сервисы-посредники (например, оплата через посредника).

Частые вопросы

Нужно ли уметь программировать, чтобы пользоваться Codex CLI?

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

Чем Codex CLI отличается от Codex в ChatGPT?

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

Безопасно ли давать агенту выполнять команды?

Для этого и придуманы режимы sandbox и approvals. Если оставить workspace-write и подтверждения, агент меняет только текущую папку проекта и по умолчанию не выходит в сеть. Полный доступ (danger-full-access) включайте только осознанно.

Работает ли Codex CLI на Windows?

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

Можно ли попробовать бесплатно?

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