Codex CLI: как установить и использовать для задач разработки

Codex CLI полезен в момент, когда у вас уже есть проект на диске и конкретная задача: найти баг, написать тест, объяснить чужой модуль, поправить README или собрать маленький скрипт.

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

@yourself_realize

Больше практики по AI coding

В Telegram разбираю Codex, Claude Code, ИИ-агентов и рабочие сценарии без обещаний магии.

Подписаться

Что такое Codex CLI простыми словами

Codex CLI — это coding agent от OpenAI, который запускается локально на компьютере. По описанию npm-пакета @openai/codex, он работает как агент для кода на вашей машине. На 15 июня 2026 года latest-версия пакета — 0.139.0.

Проще: вы открываете терминал в папке проекта, запускаете Codex и даёте задачу обычным языком. Например: «найди, почему падает форма оплаты», «напиши тест на этот helper», «объясни, где в проекте собирается sitemap».

Codex CLI не отменяет IDE, git и тесты. Он ускоряет скучные проходы по проекту: прочитать файлы, сопоставить зависимости, предложить патч, собрать черновик документации. Решение всё равно принимает человек.

Чем Codex CLI отличается от ChatGPT, Codex Web, Claude Code и Cursor

Холивар тут не нужен. Для предпринимателя или маркетолога важнее вопрос: где лежит ваш проект и какой результат нужен. Если задача живёт в репозитории, CLI-агент обычно практичнее обычного чата.

Как установить Codex CLI

OpenAI в README даёт несколько способов установки. Выберите тот, который подходит под вашу систему и привычный пакетный менеджер.

Mac и Linux

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

После установки откройте новый терминал или перезапустите shell, если команда codex сразу не находится.

Через npm

npm install -g @openai/codex

Этот вариант удобен, если у вас уже настроен Node.js и глобальные npm-пакеты ставятся без танцев с правами доступа.

Windows PowerShell

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

На Windows лучше запускать установку из PowerShell, а проект открывать там, где вы обычно работаете: PowerShell, Windows Terminal или WSL, если проект живёт в Linux-окружении.

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

Откройте терминал и перейдите в папку проекта. Не запускайте агента из случайной директории: ему нужен контекст файлов, а не весь домашний каталог.

cd ~/projects/my-app
codex

Для первого прогона дайте безопасную задачу без записи в продакшен и без секретов. Например:

Объясни структуру проекта.
Найди основные папки, точку входа, где лежат тесты и как запускается сборка.
Ничего не меняй в файлах. Верни краткую карту проекта и команды для проверки.

Так вы проверите, понимает ли агент проект, не рискуя получить пачку неожиданных правок.

Какие задачи делегировать Codex CLI

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

• найти баг по тексту ошибки, логам или описанию сценария;
• объяснить незнакомый проект: папки, зависимости, команды запуска;
• написать тест на функцию, API-ручку или компонент;
• собрать маленький скрипт для импорта, выгрузки, конвертации или проверки данных;
• поправить README, инструкцию по запуску, changelog или комментарии;
• подготовить SEO/маркетинговый прототип страницы: структуру блоков, моковые тексты, простую верстку;
• сделать безопасный рефакторинг в одном модуле без изменения поведения.

Слабый запрос: «перепиши всё красиво». Рабочий запрос: «в файле src/pricing.ts упростить расчёт скидки, не менять публичный API, добавить тесты на 0%, 10% и 100%, показать diff».

Как формулировать задачу, чтобы агент не гадал

Хороший промпт для Codex CLI держится на пяти вещах: контекст, файлы, ограничение, формат результата, проверка. Чем меньше тумана на входе, тем меньше мусора в diff.

Шаблон задачи для Codex CLI

Задача: [что нужно сделать].
Контекст: [что это за проект и почему нужна правка].
Файлы: [какие файлы смотреть в первую очередь].
Ограничения: [что нельзя менять].
Результат: [diff / план / тест / объяснение / README].
Проверка: [какую команду запустить или какой критерий выполнить].

Безопасность: что проверить до правок и перед коммитом

CLI-агент работает рядом с вашим кодом, поэтому дисциплина важнее красивого ответа. Перед задачей проверьте состояние репозитория.

git status
git diff

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

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

Мини-чеклист перед коммитом

1. Посмотрите git status: какие файлы изменились.
2. Прочитайте git diff: нет ли лишних правок, секретов, случайных форматирований на полпроекта.
3. Запустите тесты или минимальную проверку сборки.
4. Проверьте сценарий руками, если правка касается интерфейса, оплаты, заявок или данных.
5. Сформулируйте commit message по факту: что изменили и зачем.

Если diff невозможно объяснить в двух предложениях, его рано коммитить. Разбейте задачу на меньшие куски и прогоните проверку ещё раз.

Что почитать дальше

Если выбираете между инструментами, посмотрите материал про Claude Code и отдельную инструкцию как установить Claude Code. Для общего подхода к разработке с ИИ полезна статья про вайбкодинг.

@yourself_realize

Разбираю AI coding на практике

Подписывайтесь на Telegram: там показываю, как применять Codex CLI, Claude Code и ИИ-агентов в реальных задачах бизнеса и разработки.

Читать канал