Как начать пользоваться OpenAI Codex: терминальный AI-агент для разработчиков
OpenAI Codex - официальный терминальный агент от OpenAI: пишет код, запускает тесты, делает PR-ревью прямо из командной строки. Полный гайд по установке и первым шагам.
OpenAI Codex: как пользоваться терминальным AI-агентом для кода
Обновления OpenAI Codex CLI (2026)
Обновление (июнь 2026): Codex CLI продолжает активно развиваться и не закрывается. Устаревают только отдельные версии моделей: GPT-5.2-Codex (прекращён 5 июня 2026) и GPT-5.3-Codex (устаревание до конца 2026). Сам инструмент Codex CLI работает в штатном режиме. Текущая рекомендуемая модель -- GPT-5.5. Обновите клиент: npm update -g @openai/codex.
Устаревание моделей (июнь 2026): GPT-5.2-Codex прекращён 5 июня 2026. GPT-5.3-Codex устаревает до конца 2026. Если ваши конфигурации явно указывают эти версии -- обновите их на GPT-5.5 или GPT-5.5 Instant. Codex CLI сам по себе продолжает работу и не закрывается.
GPT-5.5 как дефолтная модель Codex CLI (с мая 2026): обновите через npm update -g @openai/codex для получения автоматического переключения на GPT-5.5. Значительно улучшена скорость ответа (GPT-5.5 Instant) и уменьшено количество ошибок в сгенерированном коде.
Terminal context reading: Codex теперь читает полный вывод терминала при анализе ошибок. Запустите тест - Codex видит весь stack trace и предлагает исправление с пониманием контекста выполнения. Автоматически определяет версии зависимостей из package.json/requirements.txt.
Cloud Tasks: создавайте долгосрочные задачи через Codex которые выполняются в облаке OpenAI. Команда codex task create с описанием задачи - агент работает асинхронно, уведомит когда готово. Идеально для задач занимающих часы.
Codex для CI/CD: интеграция с GitHub Actions через официальный action openai/codex-action. Добавьте в workflow для автоматического code review каждого PR, генерации changelog из git commits, обновления документации при изменении API. Ключ через GitHub Secrets OPENAI_API_KEY.
Что такое OpenAI Codex в 2026 году
OpenAI Codex в 2026 году - это унифицированная агентная система, работающая на базе GPT-5.5 и GPT-5.5 Pro. Терминал, IDE, веб и захват экрана - все поверхности используют единую модель выполнения. Многошаговое использование инструментов встроено в основу: модель самостоятельно проверяет работу перед отправкой, а CLI может выполнять полноценные задачи разработки ПО через сотни последовательных вызовов инструментов без вмешательства пользователя.
Ключевые обновления 2026 года
Апрель 2026: добавлены настраиваемые TUI-кейбинды, подсказки режима планирования, заголовки терминала при необходимости действия и редактирование /statusline и /title в активных сессиях.
30 апреля 2026: постоянные /goal-рабочие процессы с API приложения-сервера, инструменты модели, продолжение выполнения и TUI-элементы управления для создания, паузы, возобновления и очистки.
Codex app (отдельное приложение): введен как самостоятельная поверхность для работы с агентами. Доступен для ChatGPT Plus и Pro пользователей.
Партнерство с OpenCode: OpenAI официально интегрировалась с OpenCode - подписчики Codex и ChatGPT получают прямой доступ к агенту через OpenCode. Проект набрал 161 000 GitHub-звезд и 7,5 миллиона активных разработчиков в месяц.
Установка и настройка CLI
Установка через npm: npm install -g @openai/codex. Требуется Node.js 18+. После установки авторизуйтесь: codex login. Введите ваш OpenAI API ключ или войдите через браузер.
Для пользователей ChatGPT Plus/Pro: Codex CLI включен в подписку с определенными лимитами использования. Для неограниченного использования через API потребуется отдельный API-ключ с балансом.
Первый запуск: перейдите в директорию вашего проекта и выполните codex. Агент просканирует структуру проекта и предложит опции. Или начните с конкретной задачи: codex "Fix the failing tests in src/auth/".
Основные команды и возможности
/model - переключение между GPT-5.5 и GPT-5.5 Instant или настройка уровня рассуждения. ВНИМАНИЕ: GPT-5.2 был удалён из GitHub Copilot 5 июня 2026 года. GPT-5.3-Codex отключается 31 декабря 2026 2026 -- не используйте эти модели для новых проектов.
/goal - установите долгосрочную цель для текущей сессии. С апреля 2026 цели сохраняются между сессиями через app-server API.
/memory - управление памятью агента: просмотр, редактирование и удаление запомненной информации о проекте. Доступен переключатель отключения памяти на уровне репозитория.
Прикрепление файлов: добавляйте скриншоты, дизайн-спецификации или изображения ошибок к запросам. Codex прочитает их вместе с вашим промптом.
Генерация изображений: прямо в CLI можно генерировать и редактировать изображения через DALL-E.
Продвинутые рабочие процессы
Параллельные вызовы инструментов: Codex выполняет чтение файлов и другие безопасные операции параллельно, значительно ускоряя анализ крупных кодовых баз.
OAuth и MCP-серверы: улучшенная настройка MCP (Model Context Protocol) с поддержкой OAuth и настройками для каждого сервера. Позволяет подключать внешние инструменты - базы данных, API, корпоративные системы.
Удаленные сессии и Windows: улучшена надежность работы в удаленных средах, Windows и песочницах. Профили через --profile для переключения между конфигурациями разных проектов.
Практические примеры
Отладка: codex "There's a memory leak in the WebSocket handler. Find it and fix it." - агент проанализирует код, найдет утечку, предложит исправление и напишет тест.
Рефакторинг: codex "Migrate the auth module from callbacks to async/await" - агент понимает контекст всего проекта и вносит изменения согласованно.
Документация: codex "Generate JSDoc comments for all exported functions in src/api/" - создает документацию в стиле существующих комментариев в проекте.
OpenAI Codex: обновления июня 2026
Sites -- semi-private web hosting. Codex теперь умеет создавать Sites -- приватные веб-приложения с аутентификацией, доступные только по приглашению. Команда: codex site create. Подходит для внутренних корпоративных инструментов, дашбордов команды, прототипов для стейкхолдеров.
Annotations -- in-place editing. Новый режим работы с кодом: Codex добавляет аннотации прямо в исходный файл в виде комментариев с предложениями изменений. Разработчик просматривает аннотации и одобряет или отклоняет каждое предложение. Это быстрее, чем полная регенерация блоков кода.
6 role-specific плагинов. OpenAI запустил 6 специализированных плагинов для Codex по профессиональным ролям: в совокупности они охватывают 62 приложения и 110 навыков. Доступные интеграции включают Snowflake (для аналитиков данных), Figma (для дизайнеров, работающих с кодом) и Salesforce (для разработчиков CRM). Установка через codex plugin install <name>.
Масштаб платформы. OpenAI Codex достиг 5 миллионов еженедельных пользователей. Примечательно, что 20% пользователей -- не разработчики: аналитики, продакт-менеджеры, исследователи, которые используют Codex для автоматизации задач и работы с данными.
Amazon Bedrock (июнь 2026): OpenAI Codex теперь доступен через Amazon Bedrock. Разработчики, уже использующие AWS, могут интегрировать Codex без отдельной подписки OpenAI.
Обновления OpenAI Codex (2026): Добавлена архивация сессий: команды codex archive и codex unarchive позволяют сохранять и восстанавливать контекст длинных задач. Многоагентный режим v2 улучшает координацию между параллельными агентами. Поддержка Windows Sandbox в альфа-версии. В режиме code-mode агенты теперь могут выполнять параллельные веб-поиски для сбора контекста.
Обновления TUI (июнь 2026)
В июне 2026 OpenAI выпустила обновлённый терминальный интерфейс Codex:
- Цветовое выделение синтаксиса -- diff-просмотр с подсветкой добавленных и удалённых строк прямо в терминале
- Inline подтверждения -- вместо отдельного диалога вопросы появляются inline в потоке вывода
- Прогресс-бар для длинных задач -- визуальный индикатор прогресса при многошаговых операциях
- Сворачивание вывода команд -- длинный stdout команд сворачивается, раскрывается по нажатию Enter
Расширение для генерации изображений
Image Generation Extension (июнь 2026): Codex теперь может генерировать изображения прямо в рабочем процессе разработки. Расширение использует DALL-E 4 через OpenAI API. Применение: генерация placeholder изображений для UI макетов, создание диаграмм архитектуры, иллюстрации для документации. Установка: codex extensions install image-gen. Команда в сессии: /image "Нарисуй диаграмму микросервисной архитектуры".
GPT-5.5 Instant в Codex
GPT-5.5 Instant -- оптимизированная для скорости версия GPT-5.5, доступная в Codex. Latency снижена до ~2 секунд для простых задач (генерация функции, объяснение кода). Подходит для интерактивных сессий где важна скорость ответа. Активация: codex --model gpt-5.5-instant. Полная версия GPT-5.5 по умолчанию используется для сложных рефакторингов.
Практические рабочие процессы
CI/CD интеграция. Codex можно встроить в GitHub Actions для автоматических задач:
- name: Run Codex analysis
run: |
codex "Проверь что все публичные API методы задокументированы" --output json > codex-report.json
cat codex-report.jsonПараллельная работа над несколькими задачами. Используйте tmux или screen для параллельных Codex сессий на разных ветках git. Каждая сессия работает независимо -- это аналог worktrees в Cursor. Пример: одна сессия пишет тесты, другая рефакторит основной код.
Автоматизация code review. Перед слиянием PR запустите: codex "Найди потенциальные баги, проблемы безопасности и нарушения code style в изменениях" --context git-diff. Вывод можно автоматически добавить как комментарий в PR через GitHub CLI.
Детальное расписание отключения Codex CLI
Уточнение о расписании устаревания моделей. OpenAI объявила об устаревании конкретных старых версий моделей Codex: GPT-5.2-Codex вышел из эксплуатации 5 июня 2026 года; GPT-5.3-Codex будет выведен до конца 2026 года. Codex CLI как инструмент продолжает активно развиваться -- новые версии выходят регулярно. Пользователям, использующим устаревшие версии моделей в своих конфигурациях, нужно обновить их на GPT-5.5 или GPT-5.5 Instant.
Если ваши скрипты или конфигурации явно указывают устаревшие версии моделей (GPT-5.2-Codex, GPT-5.3-Codex) -- обновите их на GPT-5.5. Сам Codex CLI при этом обновлять не нужно, он продолжает работать. Рекомендуемые альтернативы существуют, но переход не является срочной необходимостью: Claude Code или OpenCode -- опциональный выбор, а не вынужденная миграция.
GPT-5.5 как текущая модель по умолчанию
С мая 2026 года GPT-5.5 стал дефолтной моделью в Codex CLI. Для переключения обновите клиент: npm update -g @openai/codex. GPT-5.5 показывает значительно улучшенную скорость ответа и лучшее понимание контекста кодовых баз по сравнению с предыдущими версиями. Версия GPT-5.5 Instant оптимизирована для скорости: latency снижена до 2 секунд для простых задач (генерация функции, объяснение кода), что делает её подходящей для интерактивного использования.
Важно: GPT-5.2 и GPT-5.3-Codex выведены из эксплуатации. Новые запросы через эти модели прекращены 30 июня 2026 года. Если ваши скрипты или конфигурации явно указывают эти версии, обновите их на GPT-5.5.
Новые функции v0.140.0
Версия v0.140.0 добавила несколько важных функций для активных пользователей:
- /usage -- команда для просмотра статистики потребления токенов: дневные и недельные отчёты по использованию. Помогает контролировать расходы и оптимизировать промпты.
- /import из Claude Code -- импорт конфигурации, системных промптов и истории памяти из Claude Code. Упрощает переход или параллельное использование двух инструментов.
- @ mentions для файлов -- при наборе
@в промпте появляется автодополнение файлов из текущего проекта. Это позволяет явно указать контекст:@src/auth/middleware.ts исправь утечку памяти.
Amazon Bedrock и управляемая аутентификация
С июня 2026 года OpenAI Codex доступен через Amazon Bedrock. Разработчики, уже работающие в экосистеме AWS, могут интегрировать Codex без отдельной подписки OpenAI -- через стандартные механизмы IAM и AWS API. Это особенно ценно для компаний с требованиями по дата-резидентности или существующими контрактами с AWS.
Managed Amazon Bedrock auth поддерживает автоматическую ротацию ключей и интеграцию с AWS Secrets Manager -- безопасный способ использовать Codex в корпоративной среде без хранения API-ключей в коде или переменных окружения.
Функция /app: переход на Codex Desktop
Для пользователей macOS и Windows доступна команда /app в Codex CLI. Эта команда передаёт текущий контекст сессии в Codex Desktop -- полноценное desktop-приложение с расширенным GUI. Полезно, когда задача требует визуальных инструментов, работы с изображениями или более удобного интерфейса для длительных агентных сессий.
Руководство по миграции: переход с Codex CLI
Для тех, кто планирует перейти на альтернативный инструмент до декабря 2026 года, вот практическое руководство:
Миграция на Claude Code:
- Установите Claude Code:
npm install -g @anthropic-ai/claude-code. Требуется API-ключ Anthropic. - Скопируйте системные промпты из
~/.codex/instructions.mdвCLAUDE.mdв корне проекта. Claude Code автоматически читает этот файл как контекст. - Используйте
/importв Codex CLI (v0.140.0+) для экспорта конфигурации памяти в формат, совместимый с Claude Code. - Замените скрипты CI/CD: команды
codex "задача"заменяются наclaude -p "задача".
Миграция на OpenCode:
- Установите OpenCode:
npm install -g opencode-ai. - Настройте провайдер в
~/.config/opencode/config.toml. OpenCode поддерживает OpenAI GPT-5.5 как один из провайдеров -- минимальные изменения при сохранении той же модели. - Перенесите пользовательские инструкции в
.opencode/instructions.mdв корне проекта. - Обновите CI/CD скрипты: синтаксис вызова схож с Codex CLI.
Ключевые различия при миграции: Claude Code лучше интегрирован с моделями Anthropic и имеет более богатую экосистему; OpenCode даёт больше гибкости в выборе провайдера и полностью open-source. Оба инструмента поддерживают MCP-серверы и работают в терминале.
GPT-5.4 как рекомендуемая модель для Codex (июнь 2026): OpenAI обновила рекомендации по выбору модели для Codex CLI. GPT-5.4 теперь рекомендован для большинства задач кодирования вместо GPT-5.5. Причина: GPT-5.4 специализирован для кода -- показывает сопоставимое или лучшее качество при более низкой стоимости и латентности. GPT-5.5 остаётся в наличии для задач, требующих расширенного рассуждения и работы с нестандартными архитектурами. Переключение: codex --model gpt-5.4 или настройка в ~/.codex/config.json: "model": "gpt-5.4".
Codex CLI: обновления июня 2026
v0.140 (15 июня): /usage - просмотр потраченных токенов и погашение кредитов. /import из Claude Code: перенос контекста и файлов из сессии Claude Code в Codex без переинициализации. v0.141: /plugins с категоризацией по типу (tools, data, actions). @ unified menu: единый поиск по файлам, функциям и символам. Amazon Bedrock auth: запуск Codex через Bedrock без API ключа OpenAI.
Новые возможности Codex CLI (июнь 2026)
Плагин DigitalOcean: Codex CLI получил плагин для работы с DigitalOcean. Плагин позволяет развернуть Droplet прямо из терминала, настроить SSH-подключение и использовать его как удалённое рабочее пространство. Это удобно для запуска агента на мощном облачном сервере без локальных ресурсов.
Настройки личности агента по хостам: В конфигурации Codex CLI добавлены per-host personality settings. Для каждого хоста (локального или удалённого) можно выбрать режим: Friendly (разговорный стиль с пояснениями) или Pragmatic (лаконичный стиль, только результат). Это позволяет адаптировать поведение агента под конкретную среду разработки.
Чтение вывода встроенного терминала: Codex теперь умеет читать вывод интегрированного терминала. Агент видит, что выводит запущенный dev-сервер или тест-раннер, и может реагировать на ошибки и предупреждения без ручного копирования вывода в чат.
Обновления Codex CLI (июль 2026)
Индексированный веб-поиск в агенте. Codex CLI получил встроенный режим веб-поиска: агент может выполнять живые поисковые запросы прямо в процессе работы. Важная деталь -- режим ограничивает прямой доступ к страницам до одобренных сервером URL, что обеспечивает управляемый и безопасный доступ к актуальной информации без риска выхода агента за разрешённые границы.
Делегирование подзадач (multi-agent delegation). App-server клиенты теперь могут настраивать делегирование задач подагентам в трёх режимах: disabled (делегирование запрещено), explicit-request-only (только по явному запросу), proactive (агент сам решает когда делегировать). Уровни задаются на уровне thread и turn. Увеличение параметра max delegation depth превращает широкие инструкции делегирования в повторяющийся fan-out -- это увеличивает потребление токенов и задержку, но открывает возможности для параллельного выполнения сложных многошаговых задач.
Настраиваемые бюджеты токенов (rollout token budgets). Codex CLI получил конфигурируемые лимиты расхода токенов для сессий и задач. Это позволяет командам управлять операционными расходами: задать максимальный бюджет для одного PR-ревью, автоматической задачи или цикла агента. Настраивается в конфигурационном файле проекта или через флаги CLI.
MCP: таргетинг по серверам и OAuth для HTTP. Model Context Protocol получил улучшения: теперь можно настраивать переменные окружения для каждого MCP-сервера отдельно (per-server environment targeting). Добавлена поддержка OAuth для HTTP-транспорта -- это открывает возможность подключения к корпоративным MCP-серверам с аутентификацией. Дополнительно: зашифрованное локальное хранение OAuth-токенов для CLI, поддержка фиксированного порта для локального HTTP callback-сервера при OAuth-входе (по умолчанию -- эфемерный порт ОС), повторные попытки при временных сбоях запуска MCP-серверов.
Погашение кредитов использования (usage credits redemption). Команда /usage теперь поддерживает не только просмотр статистики токенов, но и погашение накопленных кредитов использования. Это упрощает контроль затрат для команд, работающих с Codex через корпоративные планы OpenAI.
Новые возможности OpenAI Codex (июль 2026). Команда /usage позволяет просматривать остаток кредитов и погашать задолженность прямо в чате без выхода в браузер. Команда /plugins переработана: расширения теперь разделены на три секции - Curated (рекомендованные командой OpenAI), Workspace (установленные в вашем окружении) и Shared (общие для всей команды). Token budgets для agent threads: задайте максимальный расход токенов на один агентный поток, чтобы избежать неожиданных списаний при долгих автономных задачах.
Multi-agent delegation и встроенный веб-поиск в OpenAI Codex. Режим делегирования задач между агентами настраивается в трёх вариантах: disabled (агент работает только самостоятельно), explicit (делегирование только по явной команде пользователя), proactive (агент сам решает, когда передать подзадачу другому агенту). Indexed web search - встроенный поиск по актуальным веб-страницам прямо в контексте разработки: агент находит документацию, примеры кода и обсуждения без переключения в браузер.
Обновление Codex CLI rust-v0.143.0 (8 июля 2026)
Новые модели через Amazon Bedrock: GPT-5.6 Sol, Terra, Luna. В Codex CLI rust-v0.143.0 добавлена первоклассная поддержка семейства моделей GPT-5.6 через Amazon Bedrock: GPT-5.6 Sol (базовая), GPT-5.6 Terra (расширенный контекст) и GPT-5.6 Luna (оптимизирована для reasoning). Все три модели поддерживают параметр max для максимального усилия рассуждения (max reasoning effort). Переключение: флаг --model gpt-5.6-sol, gpt-5.6-terra или gpt-5.6-luna. GPT-5.6 является актуальным семейством наряду с GPT-5.5.
Удалённые плагины по умолчанию и системный прокси. Начиная с rust-v0.143.0 удалённые плагины (remote plugins) включены по умолчанию для всех пользователей. Каталог плагинов расширен и содержит новые интеграции для популярных инструментов разработки. Добавлена поддержка системного прокси: Codex CLI автоматически читает настройки PAC/WPAD на macOS и Windows и направляет через них трафик аутентификации и API-запросов. Это устраняет ручную настройку HTTP_PROXY в корпоративных сетях.
Поиск MCP-инструментов по умолчанию (июль 2026). Начиная с Codex CLI rust-v0.143.0, поиск по каталогу MCP-инструментов включён по умолчанию для всех пользователей. При запросе, требующем внешнего инструмента, агент автоматически просматривает доступные MCP-серверы и предлагает подключить подходящий. Ранее поиск MCP-инструментов требовал явного указания флага или ручной настройки. Обновлённый каталог плагинов в браузере Codex отображает MCP-серверы с рейтингом, числом загрузок и описанием возможностей.
Патч-обновление rust-v0.144.1 (9 июля 2026). На следующий день после выхода rust-v0.143.0 команда OpenAI выпустила патч-версию rust-v0.144.1, устранившую два набора проблем: надёжность установщика - исправлена ситуация, когда автономная установка (standalone install) завершалась ошибкой, если GitHub возвращал метаданные релиза в компактном или переупорядоченном формате; исправления code-mode - установочные пакеты macOS теперь корректно регистрируют хост code-mode (codex-code-mode-host), что устраняло ошибку codex-code-mode-host is missing после установки через .pkg-файл. Обновите клиент командой npm update -g @openai/codex или через встроенный автообновлятор Codex CLI.
Обновленный браузер плагинов и multi-agent delegation (июль 2026)
Обновленный браузер плагинов (июль 2026): Codex получил переработанный интерфейс выбора и управления плагинами. В новом пикере плагины группируются по категориям (разработка, данные, коммуникации, инфраструктура), есть поиск по названию и описанию. Рейтинги популярности и пользовательские отзывы помогают выбрать нужный инструмент. Одним кликом можно установить плагин и сразу начать использовать его в текущей сессии. Доступно через команду /plugins в Codex или через меню Tools в веб-интерфейсе.
Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.
Хотите получать подобные материалы раньше?
Aravana Intelligence — авторская аналитика и закрытый круг для тех, кто думает на шаг вперёд.
Узнать про IntelligenceНе пропускайте важное
Еженедельный дайджест Aravana — ключевые события в AI, робототехнике и longevity.
Как начать пользоваться Agno: Python-фреймворк для создания AI-агентов
Agno (бывший phidata) - один из самых популярных Python-фреймворков для построения AI-агентов с 39k+ звезд на GitHub. Пошаговый гайд: установка, первый агент за 5 минут, мультиагентные команды и деплой в продакшн.
Seedance 2.5: как начать пользоваться генератором видео от ByteDance
Seedance 2.5 от ByteDance генерирует нативное 30-секундное видео в один проход, принимает до 50 мультимодальных референсов и позволяет редактировать отдельные фрагменты без перегенерации всего клипа.
ChatGPT Work: как начать пользоваться агентным рабочим столом OpenAI
9 июля 2026 OpenAI запустила ChatGPT Work -- агента, который берёт у вас целый проект, сам планирует шаги, работает часами в фоне и возвращает готовый документ, таблицу или презентацию.