Урок 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 (по умолчанию gpt-5.6-sol / gpt-5.6), умеет читать код, редактировать файлы и запускать команды.

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

┌─────────────────────────────────┐
│   OpenAI Codex CLI              │
├─────────────────────────────────┤
│ Язык:      Rust (быстро)        │
│ Интерфейс: Terminal UI (TUI)    │
│ Модель:    gpt-5.6-sol / GPT-5.6       │
│ Безопасность: 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-5.6"
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
• разделить большие функции
• улучшить обработку ошибок
• добавить логирование

Цены и расчет затрат

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

Не используйте старые цифры «~$1.50 / $6» и модель codex-mini-latest (снята с API 12 февраля 2026). По умолчанию в CLI — gpt-5.6-sol / gpt-5.6. Номер релиза бинаря в домашнее задание не ставьте.

Источник: openai.com/api/pricing (август 2026).

Вариант 2: подписка ChatGPT

• Go — $8/мес
• Plus — $20/мес
• Pro — $100/мес или $200/мес

Удобно, если ChatGPT уже оплачен: Codex ходит в те же модели, флагман — GPT-5.6 Sol.

Диаграмма: 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.