Codex CLI

Описание модуля

Этот модуль посвящен освоению OpenAI Codex CLI — терминального AI-агента для автоматизации разработки. Вы научитесь использовать Codex как для локальной разработки, так и для интеграции в CI/CD pipeline.

Структура модуля

Статистика

• Всего уроков: 3
• Общий объем: 56 KB
• Строк кода примеров: ~1500+
• Диаграмм Mermaid: 6
• Практических заданий: 12
• Примеров YAML/JSON: 15+

Рекомендуемая последовательность

День 1: Введение (3 часа)

1. Прочитайте Урок 1 целиком
2. Установите Codex на вашу машину
3. Выполните Задание 1-3 из Урока 1
4. Создайте AGENTS.md в тестовом проекте

День 2: Практика с агентом (4 часа)

1. Прочитайте Урок 2 целиком
2. Выполните все задания из Урока 2
3. Попробуйте агентный режим в suggest, auto-edit режимах
4. Запустите полный workflow рефакторинга в своем проекте

День 3: CI/CD интеграция (3 часа)

1. Прочитайте Урок 3 целиком
2. Выполните задания 1-4
3. Протестируйте GitHub Action на приватном репозитории
4. Настройте 2-3 workflow’а для вашего основного проекта

Знания и навыки

По завершению модуля вы сможете:

Знания

• Понимать архитектуру и возможности Codex CLI
• Объяснить три режима безопасности (suggest, auto-edit, full-auto)
• Знать когда использовать локальный CLI vs GitHub Actions
• Разбираться в стоимости API vs ChatGPT+ подписки

Практические навыки

• Установить и настроить Codex на своей машине
• Авторизироваться через API ключ или ChatGPT аккаунт
• Использовать TUI интерфейс для интерактивной работы
• Выполнять мультифайловые рефакторинги через Codex
• Интегрировать Codex в Git workflow
• Создавать и тестировать GitHub Action workflows
• Настраивать AGENTS.md для специфики вашего проекта
• Ограничивать действия агента для безопасности в CI/CD

Требования

Софт

• Node.js 16.0+ или Python 3.8+
• Git 2.30+
• OpenAI API ключ или ChatGPT+ подписка
• Любой текстовый редактор (VS Code, Vim, Nano)
• GitHub аккаунт (для Урока 3)

Знания

• Базовое понимание CLI/Terminal
• Знакомство с Git
• Базовый Python или JavaScript (для примеров)
• Представление о CI/CD pipeline

Установка (Quick Start)

# 1. Установить Codex
npm install -g @openai/codex

# 2. Установить API ключ
export OPENAI_API_KEY="sk-..."

# 3. Проверить
codex --version
codex auth status

Подробнее — см. Урок 1.

Примеры и демо

Пример 1: Анализ проекта

codex "опиши структуру этого проекта"

Пример 2: Мультифайловый рефакторинг

codex "перенеси все функции работы с датами из utils.py в date_utils.py"

Пример 3: GitHub Action для баг-фиксов

Смотрите .github/workflows/codex.yml в Уроке 3

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

OpenAI API (платишь за использование)

• gpt-4o-mini: $0.15/M входящих + $0.60/M исходящих
• Примерная стоимость: $10-50/месяц при регулярном использовании
• Выгодно для: спорадического использования

ChatGPT Plus ($20/месяц)

• Включена определенная квота на API
• Выгодно для: тех, кто уже платит за ChatGPT

Сравнение с другими инструментами

Проблемы и решения

Проблема: “command not found: codex”

# Решение: переустановить
npm uninstall -g @openai/codex
npm install -g @openai/codex

Проблема: “API key invalid”

# Решение: проверить переменную окружения
echo $OPENAI_API_KEY
# Если пусто:
export OPENAI_API_KEY="sk-..."

Проблема: “Tests failed after Codex changes”

# Решение: запустить с verbose флагом
codex --verbose "исправь ошибки в коде, чтобы пройти все тесты"

Дополнительные ресурсы

• Официальный GitHub: https://github.com/openai/codex
• OpenAI API документация: https://platform.openai.com/docs
• AGENTS.md спецификация: https://github.com/openai/codex/blob/main/AGENTS.md
• GitHub Actions документация: https://docs.github.com/en/actions

Лицензия и авторство

Содержание модуля разработано на основе:

• OpenAI Codex (Apache 2.0, Rust)
• GitHub Actions документации
• Best practices сообщества AI-разработчиков

Контрольные вопросы

После Урока 1

• Что такое Codex CLI и чем он отличается от Claude Code?
• Как установить Codex на Linux?
• Какой метод авторизации более дешевый?
• Что такое AGENTS.md и зачем он нужен?

После Урока 2

• Объясните разницу между suggest и auto-edit режимами
• Как Codex интегрируется с Git?
• Можно ли использовать Codex для полного рефакторинга архитектуры?
• Как запустить тесты через Codex?

После Урока 3

• Как GitHub Action узнает, что нужно запустить Codex?
• Почему full-auto режим опасен в CI/CD?
• Какие команды нужно запретить в workflow?
• Когда использовать GitHub Action вместо локального CLI?

Запуск тестов для примеров

# Тестовый проект из Урока 2
cd codex-training
pytest tests/ -v

# Тестовый проект из Урока 3
cd test-codex-action
pytest tests/ -v

Обновления и изменения

Версия 1.0 (март 2026)

• Базовые три урока
• Примеры для Python
• GitHub Actions integratio

Планируемые обновления:

• Примеры для JavaScript/TypeScript
• Интеграция с GitLab CI
• Расширенные workflow’ы
• Видео-демонстрации

Для кого: Разработчики, использующие GitHub.

После модуля вы сможете: Работать с GitHub Copilot в agent mode и настроить GitHub Actions с AI.

Автор: Образовательная программа по AI-агентам Уровень: Junior+ разработчики Время на прохождение: 8-10 часов Дата создания: 2026-03-01