Урок 1: Установка и первый запуск OpenAI Codex CLI

Чему вы научитесь

• Что такое OpenAI Codex CLI и чем он отличается от других AI-агентов
• Как установить Codex на macOS, Linux и Windows (WSL)
• Как настроить авторизацию через API ключ или ChatGPT аккаунт
• Как выполнить первый запрос и понять структуру конфигурации

Введение: Codex CLI в экосистеме AI-агентов

OpenAI Codex CLI — это терминальный агент, написанный на Rust, который работает с вашим кодом. В отличие от:

• Claude Code (Anthropic) — CLI-агент с акцентом на контекст всего проекта
• Antigravity CLI (agy, Google) — терминальный агент вместо потребительского Gemini CLI

Codex CLI — это быстрый, локальный агент, который интегрируется прямо в вашу разработку. Он использует модели OpenAI (в октябре 2026 — линейка gpt-6.1-sol / gpt-6-luna, а также поддерживаемые в API gpt-5.6-sol и gpt-5.3-codex), умеет читать код, редактировать файлы и запускать команды.

Ключевые характеристики

┌─────────────────────────────────┐
│   OpenAI Codex CLI              │
├─────────────────────────────────┤
│ Язык:      Rust (быстро)        │
│ Интерфейс: Terminal UI (TUI)    │
│ Модель:    gpt-6.1-sol / 6-luna │
│ Безопасность: 3 режима sandbox  │
│ Git-интеграция: Нативная        │
│ Цена:      По API или ChatGPT   │
└─────────────────────────────────┘

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

Установка Codex CLI

Вариант 1: Через npm (универсальный)

# Установить глобально
npm install -g @openai/codex

# Проверить версию
codex --version

Вариант 2: Через brew (macOS и Linux)

# Установить
brew install --cask codex

Вариант 3: Из исходников (для разработчиков)

# Сборка из исходников — не основной вариант.
# Рекомендуется установить через npm, brew или скачать binary:
# https://github.com/openai/codex/releases/latest

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

# Должна вывести версию
codex --version

# Должна показать справку
codex --help

# Должна вывести путь к конфигурации
codex config show

Авторизация: выбираем метод

Метод 1: API ключ OpenAI (рекомендуется для разработки)

Шаг 1: Получить API ключ на https://platform.openai.com/api/keys

Шаг 2: Сохранить ключ в переменной окружения

# На macOS/Linux добавить в ~/.zshrc или ~/.bashrc
export OPENAI_API_KEY="sk-..."

# Применить изменения
source ~/.zshrc

Шаг 3: Проверить авторизацию

# Должно вывести информацию об аккаунте
codex auth status

Метод 2: ChatGPT+ аккаунт (проще для новичков)

# Пройти интерактивную авторизацию
codex auth login

# Откроется браузер для входа в ChatGPT
# Следуйте инструкциям на экране

Конфигурация: файл ~/.codex/config.toml

После первого запуска Codex автоматически создает конфиг:

# ~/.codex/config.toml
model = "gpt-6.1-sol"
sandbox = "workspace-write"
max_tokens = 4096
temperature = 0.7
timeout_seconds = 30
git_integration = true
auto_commit = false
verbose = false

Основные параметры конфигурации

Редактировать конфиг вручную:

# Открыть в редакторе
nano ~/.codex/config.json

# Или использовать команду CLI
codex config set model gpt-5.6
codex config set sandbox workspace-write

AGENTS.md — стандарт для инструкций

Codex поддерживает файл AGENTS.md в корне проекта — это инструкции для AI-агента о вашем проекте.

Пример AGENTS.md:

# Инструкции для Codex

## Структура проекта
- `src/` — исходный код Python
- `tests/` — тесты pytest
- `docs/` — документация Markdown
- `requirements.txt` — зависимости

## Соглашения кодирования
- Используем PEP 8
- Минимум 80% покрытие тестами
- Все функции должны иметь docstring

## Перед изменениями
1. Прочитать соответствующий файл полностью
2. Убедиться, что это не нарушит существующие тесты
3. Добавить/обновить тесты для новой логики

## Команды для тестирования
- `pytest tests/` — запустить все тесты
- `black .` — форматировать код
- `flake8 src/` — проверить стиль

Создать AGENTS.md в проекте:

cat > AGENTS.md << 'EOF'
# Инструкции для Codex

## Стек технологий
- Python 3.10+
- FastAPI для веб-приложений
- SQLAlchemy для БД

## Правила
- Используем type hints везде
- Код должен пройти `mypy`
- Каждый тест должен быть независимым

## Готовые команды
- `make test` — запустить тесты
- `make lint` — проверить код
- `make format` — форматировать код
EOF

Первый запуск: простая команда

Задача 1: Описать текущий проект

# Перейти в директорию с проектом
cd my-python-project

# Попросить Codex описать проект
codex "опиши структуру этого проекта и его основное назначение"

Ожидаемый результат:

Analyzing project structure...

Found:
  - 12 Python files
  - 3 configuration files
  - tests/ directory with 45 tests

Project Purpose: Data processing library for financial analytics
Main modules:
  1. core/ - основная логика обработки
  2. api/ - REST API endpoints
  3. utils/ - утилитарные функции

Задача 2: Получить рекомендацию по улучшению

# Попросить рекомендацию
codex "что я могу улучшить в качестве кода в этом проекте?"

Codex проанализирует файлы и предложит улучшения:

• добавить type hints
• разделить большие функции
• улучшить обработку ошибок
• добавить логирование

Цены и расчет затрат (октябрь 2026)

Вариант 1: OpenAI API (платите за токены)

Не используйте старые цифры «~$1.50 / $6», модель codex-mini-latest (снята с API 12 февраля 2026) или GPT-5.5 (выведена из ChatGPT и Codex 14 октября 2026). Осенью 2026 в Codex и API действуют расценки линейки GPT-6, а также сохраняются модели поколения GPT-5.6 на период миграции (benchlm.ai/openai/api-pricing, usagebox.com):

Вариант 2: подписка ChatGPT и лимиты за 5 часов

• Free ($0) и Go ($8/мес) — доступ к Codex в десктопном приложении с быстрой моделью GPT-6 Luna.
• Plus ($20/мес) — полноценная работа в CLI, IDE и облаке. В рамках скользящего 5-часового окна подписка Plus даёт 15–160 локальных сообщений (или 5–25 облачных задач) на GPT-6.1 Sol / GPT-6 Sol, до 350–3 000 локальных сообщений на GPT-6 Luna и 5–45 сообщений на GPT-6 Astra (usagebox.com).
• Pro ($100, $200 или $500/мес) — приоритетная скорость без жёсткого 5-часового потолка (на тарифе Pro $500 доступен режим Ultrafast).
• Business ($20/польз./мес при годовой оплате, $25 помесячно) — общий пул кредитов и корпоративная безопасность.

Практика: как растянуть 5-часовой лимит Codex в 2–3 раза

По руководству OpenAI Codex Pricing & Usage Limits (Oct 2026), расход вашей квоты зависит не от числа нажатий Enter, а от суммарного объёма токенов в каждом шаге агента:

1. Переключайтесь на GPT-6 Luna для рутины: переименование переменных, написание шаблонного кода и мелкие баг-фиксы на gpt-6-luna расходуют квоту примерно в 20 раз медленнее, чем на gpt-6.1-sol.
2. Не держите /fast включённым постоянно: режим /fast ускоряет генерацию, но списывает квоту с множителем 2,5× на каждый запрос.
3. Держите AGENTS.md компактным и отключайте лишние MCP-серверы: файл AGENTS.md и схемы всех активных MCP-инструментов отправляются в контекст при каждом сообщении. Уберите неиспользуемые серверы и сократите AGENTS.md до ключевых команд сборки и тестирования.

Диаграмма: Workflow первого запуска

graph TD
    A[Установить npm или brew] --> B{Авторизация}
    B -->|API ключ| C[Установить OPENAI_API_KEY]
    B -->|ChatGPT+| D[codex auth login]
    C --> E[Отредактировать ~/.codex/config.toml]
    D --> E
    E --> F[Создать AGENTS.md в проекте]
    F --> G[Запустить первую команду]
    G --> H{Результат успешен?}
    H -->|Да| I[Готово к работе!]
    H -->|Нет| J[Проверить логи: codex --verbose]
    J --> K[Смотри troubleshooting]

Попробуйте сами: задание

Задание 1: Установка и первый запуск (15 минут)

1. Установить Codex:

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

2. Получить API ключ или использовать ChatGPT+

3. Настроить авторизацию:

   codex auth status

4. Создать простой Python-файл для теста:

   mkdir test-codex
   cd test-codex
   
   cat > hello.py << 'EOF'
   def calculate_sum(numbers):
       total = 0
       for n in numbers:
           total = total + n
       return total
   
   result = calculate_sum([1, 2, 3, 4, 5])
   print(result)
   EOF

5. Запустить Codex:

   codex "как улучшить функцию calculate_sum?"

Задание 2: Создать AGENTS.md (10 минут)

В папке test-codex создайте файл AGENTS.md:

cat > AGENTS.md << 'EOF'
# Инструкции для AI-агента

Это простой тестовый проект для обучения.

## Правила
- Все функции должны иметь docstring
- Использовать типы данных (type hints)
- Минимум 2 теста на каждую функцию

## Команды
- python hello.py - запустить программу
- python -m pytest tests/ - тесты
EOF

Задание 3: Проверить конфигурацию (5 минут)

# Посмотреть текущую конфигурацию
codex config show

# Изменить модель (если нужно экономить)
codex config set model gpt-5.6

# Проверить авторизацию
codex auth status

Точка контроля: Все команды должны выполняться без ошибок. Если есть ошибки, запустите с флагом --verbose:

codex --verbose "любая команда"

Ключевые выводы

1. OpenAI Codex CLI — быстрый локальный AI-агент на Rust, идеален для разработчиков, предпочитающих работать в терминале

2. Выбор авторизации: API ключ для полного контроля и учёта расходов, ChatGPT+ для простоты и интеграции

3. Конфигурация через TOML позволяет настроить поведение агента: режим безопасности, модель, параметры запросов

4. AGENTS.md — это стандарт для коммуникации с агентом о правилах вашего проекта (поддерживается нативно)

5. Первый запуск прост: установка → авторизация → одна команда. Дальше можно переходить к агентному режиму.

Следующий урок

Урок 2: Агентный режим и мультифайловые изменения

В следующем уроке вы узнаете, как использовать полную мощь Codex для автоматического рефакторинга целых проектов, работать с git и делать безопасные изменения в режиме auto-edit.