Как начать пользоваться OpenAI Codex: терминальный AI-агент для разработчиков

OpenAI Codex - терминальный AI-агент для разработчиков, созданный компанией OpenAI. В отличие от GitHub Copilot или Cursor, которые встроены в редактор кода, Codex запускается прямо в командной строке вашего компьютера. Вы описываете задачу обычным языком, а Codex самостоятельно читает файлы проекта, пишет код, запускает тесты, исправляет ошибки и продолжает работу до завершения - без вашего участия на каждом шагу.

Важно сразу уточнить: OpenAI Codex 2025-2026 годов - это совершенно другой продукт по сравнению со старой моделью Codex 2021 года. Новый Codex - это полноценный автономный агент с функциями computer use, встроенным браузером, системой параллельных subagents и интеграцией с MCP-инструментами. По функциональности он является прямым конкурентом Claude Code от Anthropic и gemini-cli от Google.

Codex подойдет вам если вы:

Codex работает с любым языком программирования: Python, JavaScript, TypeScript, Go, Rust, Java, C++, Ruby и другими. Он понимает структуру вашего проекта, читает конфигурационные файлы, следует вашим соглашениям по стилю кода и использует ту модель GPT, которую вы выберете.

Для использования Codex нужен аккаунт ChatGPT. Codex включен в планы Plus, Pro, Business и Enterprise. Также можно использовать API-ключ OpenAI, если у вас есть доступ к API-платформе.

Системные требования:

Установка через npm (рекомендуется для всех платформ):

npm install -g @openai/codex

Установка через Homebrew (macOS):

brew install --cask codex

Проверка установки:

codex --version

После установки запустите Codex первый раз командой codex. Откроется TUI (Terminal User Interface) и появится запрос войти в аккаунт. Нажмите Enter - в браузере откроется страница авторизации OpenAI. Войдите в ваш ChatGPT аккаунт и разрешите доступ. Токен аутентификации сохранится локально, повторный вход не нужен.

Если вы предпочитаете использовать API-ключ напрямую - создайте файл конфигурации:

mkdir -p ~/.codex
echo '{"apiKey": "sk-..."}' > ~/.codex/config.json

После аутентификации вы окажетесь в главном интерфейсе Codex. Нажмите /model чтобы выбрать модель - по умолчанию используется GPT-5.3-Codex, оптимизированная для задач кодирования. Для сложных аналитических задач можно переключиться на GPT-5.4.

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

cd ~/projects/my-project
codex

Откроется интерактивный TUI с полем ввода внизу. Codex автоматически проанализирует структуру вашего проекта (файлы, зависимости, язык программирования) и будет готов к работе.

Начните с простых задач, чтобы понять как работает агент:

1. Анализ кода: напишите "Найди все TODO и FIXME комментарии в проекте и создай markdown-файл со списком задач". Codex просмотрит все файлы и создаст структурированный список.

2. Добавление документации: "Добавь docstring в Python-стиле к каждой функции в файле utils.py, которая их не имеет". Codex прочитает файл и добавит документацию, сохраняя ваш стиль кода.

3. Написание тестов: "Напиши unit-тесты для модуля auth.py с покрытием не менее 80%, используй pytest". Это более сложная задача - Codex напишет тесты, запустит их и исправит если что-то не работает.

Перед выполнением любой задачи Codex покажет план действий и попросит подтверждение. Это важная особенность - агент не вносит изменения без вашего ведома. Чтобы работать полностью автономно (например в CI/CD), используйте флаг --approve-all.

Запуск без интерактивного TUI (для одной задачи):

codex "Отрефакторь функцию parse_config в config.py, убери дублирование кода"

Codex выполнит задачу, покажет diff изменений и спросит применить ли их. Это удобно для быстрых правок без открытия полного TUI.

Полезные команды внутри TUI:

1. Computer Use (macOS)

Codex может управлять macOS-приложениями: открывать Xcode, кликать кнопки интерфейса, заполнять поля. Это полезно для автоматизации нативных GUI-операций, которые сложно сделать через код. Например: "Открой Simulator, запусти приложение и сделай скриншот экрана настроек". Функция computer use активируется автоматически когда задача требует работы с GUI.

2. Встроенный браузер

Прямо в TUI открывается браузер, где вы можете добавлять текстовые комментарии на веб-страницы. Codex видит эти комментарии как инструкции. Например: откройте страницу вашего приложения, кликните на кнопку и оставьте комментарий "Эта кнопка должна быть синей и выровнена по правому краю" - Codex найдет соответствующий CSS и внесет изменения.

3. PR Review

Команда /review запускает отдельный Codex-агент для ревью кода. Он анализирует: потенциальные баги, проблемы безопасности (SQL-инъекции, XSS, небезопасная обработка данных), нарушения соглашений кодирования, возможности для оптимизации производительности. Результат - структурированный отчет с конкретными предложениями и строками кода.

4. Параллельные Subagents

Для сложных многоступенчатых задач Codex автоматически создает несколько параллельных subagents. Например задача "Напиши тесты для всех 15 модулей проекта" разобьется на 15 параллельных задач, которые выполнятся одновременно. Это значительно ускоряет работу с большими кодовыми базами.

5. MCP Интеграции

Через Model Context Protocol Codex подключается к внешним инструментам. Для настройки добавьте в ~/.codex/config.json:

{"mcpServers": {"github": {"command": "npx", "args": ["@modelcontextprotocol/server-github"]}}}

Доступные MCP-серверы: GitHub (работа с Issues и PR), PostgreSQL и SQLite (прямые запросы к базе данных), Slack (отправка сообщений), Linear (управление задачами), Browserbase (управление браузером в облаке).

6. Reasoning Level

Команда /reasoning позволяет регулировать глубину «размышлений» модели. Для простых задач - low (быстро и дешево), для архитектурных решений - high (медленнее, но точнее). Это прямой аналог режима extended thinking в Claude.

7. Прикрепление файлов и скриншотов

В TUI можно перетащить файлы или скриншоты прямо в поле ввода. Codex проанализирует изображение и использует его как контекст. Удобно для задач типа "Реализуй этот макет" (прикрепите скриншот из Figma) или "Исправь этот баг" (прикрепите скриншот ошибки).

На момент написания (май 2026) Codex доступен в следующих планах:

Технические ограничения:

На что обратить внимание: Codex выполняет реальные операции с файлами вашего проекта. Перед использованием в важных проектах убедитесь что у вас есть git-история или бэкап. Используйте режим preview (без --approve-all) пока не привыкнете к работе агента.

Да, VPN необходим. OpenAI официально не работает в России и блокирует доступ с российских IP-адресов. Это касается как веб-интерфейса ChatGPT, так и API и утилиты Codex CLI.

Как настроить для работы в терминале:

Браузерного расширения VPN недостаточно - Codex CLI использует системные сетевые соединения. Нужно настроить VPN на уровне операционной системы.

Важный момент при регистрации аккаунта: если вы регистрировали аккаунт OpenAI с российского IP без VPN, аккаунт может быть заблокирован даже при последующем подключении через VPN. В этом случае нужно создать новый аккаунт полностью через VPN.

После подключения VPN проверьте доступность OpenAI API:

curl https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200

Если вы видите JSON-список моделей - всё работает корректно, можно запускать Codex.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.

Сценарий 1: Рефакторинг легаси-кода

Один из самых мощных сценариев - работа с унаследованным кодом. Дайте Codex задачу: "Проанализируй файл legacy_api.py, найди дублирующийся код, вынеси общую логику в вспомогательные функции и добавь типизацию". Codex прочитает весь файл, составит план рефакторинга, покажет его вам и после подтверждения внесет изменения. Весь процесс, который у разработчика занял бы несколько часов, займет 10-15 минут.

Сценарий 2: Написание тестов для существующего проекта

Запустите Codex в корне проекта и дайте задачу: "Напиши unit-тесты для всех публичных функций в папке /api, используй pytest, мокируй внешние HTTP-запросы через responses library". Codex изучит все файлы, поймет архитектуру и напишет полный тестовый набор. Если тесты не пройдут с первого раза - Codex сам исправит код до тех пор, пока все тесты не станут зелеными.

Сценарий 3: Разработка по дизайну

Прикрепите скриншот из Figma или любого дизайн-инструмента и напишите: "Реализуй этот компонент на React с использованием Tailwind CSS, точно следуя дизайну". Codex проанализирует изображение, определит цвета, отступы, шрифты и создаст компонент. Это особенно удобно при работе над frontend без постоянного переключения между инструментами.

Сценарий 4: Автоматизация через CI/CD

Codex можно интегрировать в пайплайн GitHub Actions. При создании нового PR автоматически запускается Codex review с флагом --approve-all и комментирует PR с найденными проблемами. Для этого используйте официальный GitHub Action от OpenAI или вызывайте CLI через bash-шаг.

Советы для эффективной работы: