Учебник

Codex CLI: автоматизация правок в коде без программиста

У вас нет штатного программиста, а разработчики на аутсорсе берут за каждую мелочь. Разбираем Codex CLI - бесплатный терминальный агент OpenAI, который сам читает, правит и запускает код в изолированной среде. Вы узнаете, как установить инструмент за 5 минут, настроить три уровня безопасности и подключить готовые MCP-серверы для GitHub и баз данных. Никакой теории - только конкретные шаги для внедрения.

Макс Космов··8 мин чтения

У вас в компании нет программиста. А тот, кого нанимаете почасово, берёт $50 за правку одной строчки в коде и ждёт три дня. А заявки на доработку сайта или скрипта копятся. Знакомо? Есть инструмент, который делает часть этой работы сам - без вашего участия. Разберём на примере небольшой веб-студии: менеджер может сам поправить баги в лендинге или настроить форму обратной связи, не дёргая разработчика.

OpenAI Codex CLI - это не тот Codex API, который закрыли в 2021 году. Это новый open-source Rust-агент для терминала: читает файлы, вносит изменения и запускает команды в изолированной sandbox-среде. Доступен бесплатно на GitHub, работает с GPT-5 и поддерживает MCP. Всё, что нужно - компьютер с интернетом и 15 минут на установку.

Что такое новый Codex CLI: отличие от старого Codex API (закрыт в 2021) и от ChatGPT

Старый Codex API (2021-2023) - это была языковая модель, специализированная на генерации кода, которая лежала в основе GitHub Copilot первого поколения. OpenAI закрыли его в 2023 году, переведя всех пользователей на GPT-4.

Новый Codex CLI (2025) - принципиально другая вещь. Это не API, а терминальный агент-приложение:

  • Читает файлы в вашем проекте
  • Редактирует код напрямую
  • Запускает команды в терминале
  • Делает всё это в изолированной среде с контролем безопасности

Отличие от ChatGPT: чат работает в браузере и не имеет доступа к вашим файлам (если не загружать их вручную). Codex CLI живёт в терминале и видит весь проект. Для предпринимателя это значит: вместо того чтобы копировать куски кода в ChatGPT и просить «напиши, как исправить», вы просто говорите агенту «исправь баг в форме заказа» - и он делает это сам.

Отличие от Claude Code: оба - терминальные агенты похожей концепции. Codex CLI строится на GPT-5-Codex и написан на Rust для максимальной скорости. Claude Code работает с семейством Claude и глубже интегрирован с экосистемой Anthropic.

Codex CLI полностью open-source: код доступен на github.com/openai/codex. Это позволяет использовать его в корпоративной среде с полным аудитом кода агента. Для малого бизнеса это значит, что вы не привязаны к одному вендору и можете проверить, что именно делает агент.

Установка: npm install -g @openai/codex или cargo install, настройка OPENAI_API_KEY

Два основных способа установки. Ваш менеджер справится за 5 минут - нужен только терминал.

Через npm (рекомендуется для большинства):

npm install -g @openai/codex
codex --version

Npm-версия - тонкий враппер, который скачивает нативный Rust-бинарник под вашу платформу. Если у вас нет Node.js, установите его сначала с nodejs.org - это бесплатно.

Через Cargo (если нужна последняя версия или кастомная сборка):

cargo install openai-codex

Требует установленного Rust toolchain. Нативная сборка немного быстрее запускается.

Настройка API-ключа:

export OPENAI_API_KEY=sk-proj-...
# Для постоянного хранения:
echo 'export OPENAI_API_KEY=sk-proj-...' >> ~/.zshrc

Где взять ключ? Зарегистрируйтесь на platform.openai.com, пополните баланс на $5-10 - этого хватит на десятки сессий.

Проверка:

codex "напиши hello world на Python"

Первый запуск создаёт конфигурационный файл ~/.codex/config.toml. Там можно зафиксировать модель по умолчанию и режим безопасности.

Примерная стоимость: GPT-5-Codex стоит около $0.003 за 1K входных токенов. Токен - это примерно часть слова. Стандартная сессия рефакторинга на 2-3 файлах обходится в $0.05-0.30. Дешевле, чем одна чашка кофе.

Три режима безопасности: suggest (только подсказки), auto-edit (правит файлы), full-auto (запускает команды)

Codex CLI проектировался с учётом разных уровней доверия. Режим безопасности выбирается при запуске. Для предпринимателя это важно: вы не хотите, чтобы агент случайно удалил базу данных клиентов.

suggest - минимальный доступ:

codex --mode suggest "как улучшить эту функцию"

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

auto-edit - стандартный режим:

codex --mode auto-edit "исправь все TypeScript-ошибки в src/"

Агент читает и редактирует файлы, показывает diff до применения. Команды в терминале не запускает. Хорош для 80% задач рефакторинга и правок кода. Для бизнеса: можно поручить агенту «поправь вёрстку формы на всех страницах» - он сделает, а вы проверите изменения.

full-auto - полная автономия:

codex --mode full-auto "настрой ESLint, установи зависимости, исправь все замечания"

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

По умолчанию Codex CLI запускается в auto-edit. Изменить дефолт в конфиге:

# ~/.codex/config.toml
[defaults]
mode = "auto-edit"

Режим можно менять прямо в ходе сессии командой /mode full-auto.

Работа с GPT-5-Codex: как подключить и что изменилось по сравнению с GPT-4o

GPT-5-Codex - специализированная версия GPT-5, дообученная на задачах программирования. Отличия от базового GPT-4o:

  • Лучше понимает большие кодовые базы: оптимизирован для работы с длинным контекстом файлов
  • Выше точность при multi-file изменениях: меньше ситуаций, когда агент меняет не тот файл
  • Дешевле GPT-5 базовой версии: специализированные модели обычно эффективнее по цене

Подключение:

codex --model gpt-5-codex "задача"

Или зафиксируйте в конфиге:

# ~/.codex/config.toml
[model]
default = "gpt-5-codex"

По умолчанию Codex CLI использует gpt-5-codex. Если нужен базовый GPT-5 или GPT-4o:

codex --model gpt-4o "задача"
codex --model gpt-5 "задача"

GPT-4o дешевле и быстрее, но хуже на сложных многофайловых задачах. Для простых правок типа «переименуй переменную» GPT-4o вполне достаточен. Для бизнеса: если задача простая - экономьте, используйте GPT-4o. Если нужно переписать полсайта - берите GPT-5-Codex.

MCP-инструменты: подключаем GitHub, базы данных, внешние API к агенту

Codex CLI поддерживает MCP (Model Context Protocol) - это протокол, который позволяет агенту общаться с внешними сервисами. Конфигурация серверов в ~/.codex/mcp.json:

{
 "mcpServers": {
 "github": {
 "command": "npx",
 "args": ["@modelcontextprotocol/server-github"],
 "env": {
 "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
 }
 },
 "postgres": {
 "command": "npx",
 "args": ["@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
 }
 }
}

После настройки агент автоматически видит эти инструменты:

codex "создай PR на GitHub с изменениями из текущей ветки"
codex "посмотри схему таблицы users и сгенерируй Pydantic-модель"

Codex CLI подключает MCP-сервер как дочерний процесс и общается через stdio. Список доступных серверов быстро растёт - большинство серверов, написанных для Claude Code или Cline, совместимы с Codex CLI.

Просмотр подключённых инструментов:

codex tools
# github: create_pull_request, list_issues, ...
# postgres: query, list_tables, describe_table, ...

Для предпринимателя это означает: вы можете подключить агента к вашему GitHub-репозиторию и он будет сам создавать задачи, коммитить изменения и открывать pull request. Или подключить к базе данных - и агент сам напишет запросы и сгенерирует модели.

Sandbox-выполнение: как Codex запускает код безопасно и откуда берутся ограничения

Когда Codex CLI запускает команды в full-auto режиме, он делает это через sandbox-изоляцию. На macOS используется macOS Seatbelt (sandbox-exec), на Linux - seccomp + namespace isolation.

Что это даёт:

  • Команды не могут обращаться к файлам вне разрешённых директорий
  • Нет доступа к сети (если явно не разрешено)
  • Нет доступа к системным ресурсам вне проекта

На практике это означает: агент не может случайно rm -rf / или скрыто отправить ваши файлы куда-то. Физическое ограничение, а не просто обещание.

Настройка разрешений sandbox:

# ~/.codex/config.toml
[sandbox]
allow_network = false # по умолчанию
allow_write_outside_cwd = false
max_exec_time = 30 # секунды, по умолчанию 30

Есть задачи, где сеть нужна (например, npm install). Для них:

codex --allow-network --mode full-auto "установи зависимости и запусти тесты"

Sandbox-ограничения - основная причина, почему Codex CLI в full-auto безопаснее, чем произвольные bash-команды. Но это не абсолютная защита: агент всё равно может сломать код проекта, просто не выйдет за его пределы. Для бизнеса: всегда держите резервную копию или работайте в Git-ветке.

Codex macOS App: десктопный дашборд для управления параллельными агентами

Parallel-режим через Codex macOS App - одна из уникальных возможностей, которых нет у конкурентов. Приложение скачивается отдельно с platform.openai.com и работает поверх CLI.

Что даёт приложение:

  • Визуальный дашборд активных агентных задач
  • Запуск нескольких задач параллельно (каждая в отдельном workspace)
  • Просмотр progress и diff в реальном времени
  • Управление всеми задачами из одного интерфейса

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

App работает только на macOS. Для Linux и Windows - только CLI без визуального дашборда. Мультиагентность в терминале доступна через tmux с несколькими сессиями Codex.

Требования: macOS 13+, подписка OpenAI API, установленный Codex CLI.

Сравнение с Claude Code и Aider: модели, цены, экосистема

Все три инструмента решают одну задачу - агентное кодирование в терминале, но с разными акцентами.

Codex CLI:

  • Модели: GPT-5-Codex (основная), GPT-4o, GPT-5
  • Sandbox-выполнение команд - уникальная функция
  • Codex macOS App для параллельных задач
  • Open-source (Rust)
  • Минус: только OpenAI-модели

Claude Code:

  • Модели: Claude семейства (Sonnet, Opus, Haiku)
  • Лучшая автономия на долгих задачах 30+ мин
  • Нативная интеграция с Anthropic-экосистемой
  • Не open-source
  • Минус: привязан к Anthropic

Aider:

  • Модели: любые (Anthropic, OpenAI, DeepSeek, локальные)
  • Git-first: коммит на каждое изменение
  • Самый гибкий в выборе провайдера
  • Open-source (Python)
  • Минус: нет sandbox для команд

Для новичка: начните с Codex CLI если уже есть подписка OpenAI. Для работы с несколькими провайдерами - Aider. Для долгих автономных задач - Claude Code.

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

Codex CLI платный или есть бесплатный доступ для ChatGPT Plus?

Codex CLI сам по себе бесплатный (open-source). Расходы только на OpenAI API: токены GPT-5-Codex примерно $0.003/1K входных токенов. Подписка ChatGPT Plus не даёт бесплатных API-запросов - это отдельный продукт. Нужна оплата через platform.openai.com. Для старта достаточно $5-10 кредитов на API.

Насколько безопасен full-auto режим - агент может удалить мои файлы?

В full-auto режиме агент может редактировать файлы и запускать команды, в том числе потенциально деструктивные. Sandbox ограничивает выход за пределы рабочей директории. Для дополнительной защиты работайте в отдельной Git-ветке: если агент что-то сломает, git checkout main всё восстановит. Критичные данные держите вне рабочей директории.

Как Codex CLI работает с MCP - нужно ли писать свои серверы?

Нет, писать серверы не нужно: для большинства типичных задач уже есть готовые MCP-серверы. GitHub, PostgreSQL, Supabase, Slack, Google Drive - всё есть в реестре на modelcontextprotocol.io. Свой MCP-сервер нужен только для подключения к вашим внутренним API или специфическим корпоративным системам.

Codex это то же самое, что старый Codex API для Copilot?

Нет, это разные продукты. Старый Codex API (davinci-codex) - языковая модель 2021 года, которую OpenAI закрыли в 2023. На ней работал ранний GitHub Copilot. Новый Codex CLI (2025) - терминальный агент-приложение на базе GPT-5. Общее только название.

Чем GPT-5-Codex лучше GPT-4o для задач программирования?

GPT-5-Codex дообучен специально на задачах разработки: он лучше удерживает контекст большой кодовой базы, точнее делает multi-file изменения и реже «галлюцинирует» имена методов и API. На простых задачах разница небольшая. На сложных рефакторингах с 10+ файлами разница заметна: GPT-5-Codex делает меньше ошибок с зависимостями между файлами.

Что дальше

Следующий шаг: попробуйте установить Codex CLI по инструкции выше и дать ему простую задачу - например, «найди и исправь все опечатки в тексте на сайте». Это займёт 15 минут и покажет, как инструмент работает в деле.

AI Компас (t.me/kosmoslab_ai) - канал для предпринимателей в РФ и СНГ, которые применяют AI в своём бизнесе без программиста. Разбираем инструменты и схемы - без курсов и теории.