Codex Desktop: Полный Гайд

Установка, настройка и использование OpenAI Codex Desktop — автономного AI-агента для разработки. CLI, агентный режим, sandbox, интеграция с GitHub.

# 1. ЧТО ТАКОЕ CODEX DESKTOP

Codex Desktop — десктопный AI-агент от OpenAI, работающий как полноценный разработчик в терминале. В отличие от Codex CLI, Desktop-версия имеет GUI, file browser, встроенный sandbox для безопасного выполнения кода и агентный режим с планированием задач. Построен на GPT-5 Codex, оптимизированном для программирования.

# 2. УСТАНОВКА

Codex Desktop доступен на macOS, Windows и Linux. Установка через официальный сайт или пакетные менеджеры.

# Скачать DMG с codex.openai.com/desktop
# Или через Homebrew:
brew install --cask openai-codex

# AppImage (рекомендуется)
wget https://codex.openai.com/desktop/codex-latest.AppImage
chmod +x codex-latest.AppImage
./codex-latest.AppImage

# Или .deb пакет:
sudo dpkg -i codex-desktop-latest.deb

# 3. ПЕРВЫЙ ЗАПУСК И АВТОРИЗАЦИЯ

При первом запуске Codex Desktop попросит авторизоваться через OpenAI аккаунт. Нужна подписка ChatGPT Plus/Pro или отдельный Codex-план.

# После запуска — авторизация через браузер
# Или через API-ключ в CLI-режиме:
codex auth --api-key sk-proj-...

# Проверить статус:
codex status
→ Codex Desktop v2.4.1 | Model: gpt-5-codex | Tier: Pro

# 4. АГЕНТНЫЙ РЕЖИМ: ПИШЕМ ПРОЕКТ С НУЛЯ

Главная фича Codex Desktop — агентный режим. Вы описываете задачу на естественном языке, агент сам планирует шаги, пишет код, тестирует и фиксит ошибки.

# Агентный режим: создаём REST API
codex agent "Создай REST API для блога на FastAPI:
 - GET /posts — список постов с пагинацией
 - POST /posts — создать пост (title, body, tags)
 - GET /posts/{id} — детальный пост с комментариями
 - База: SQLite через SQLAlchemy
 - Тесты: pytest с 80% покрытием
 - Dockerfile и docker-compose"

# Агент создаст:
# 1. main.py — FastAPI приложение
# 2. models.py — SQLAlchemy модели
# 3. schemas.py — Pydantic схемы
# 4. test_api.py — тесты (pytest)
# 5. Dockerfile + docker-compose.yml
# 6. requirements.txt

# 5. SANDBOX: БЕЗОПАСНОЕ ТЕСТИРОВАНИЕ

Codex Desktop использует изолированный sandbox (Docker-based) для выполнения и тестирования кода. Агент не имеет доступа к вашей файловой системе, пока вы явно не разрешите.

# Запуск в sandbox по умолчанию
codex agent "исправь баг в auth.py" # sandbox

# Полный доступ к проекту (осторожно!)
codex agent "рефактори весь проект" --unsafe

# Проверить что агент сделал в sandbox:
codex sandbox list          # список файлов
codex sandbox pull           # скачать изменения

# 6. ИНТЕГРАЦИЯ С GITHUB

Codex Desktop умеет читать issues, создавать ветки, коммитить и открывать PR. Полный цикл: issue → ветка → код → тесты → PR.

# Связать с GitHub:
codex github connect

# Взять issue и реализовать:
codex agent "возьми issue #42 и реализуй фичу"

# Агент сам:
# 1. Прочитает issue
# 2. Создаст ветку feature/issue-42
# 3. Напишет код и тесты
# 4. Закоммитит изменения
# 5. Откроет PR с описанием

Codex Desktop — мощный AI-агент для полного цикла разработки. Ключевые преимущества: агентный режим с планированием, безопасный sandbox для тестирования, глубокая интеграция с GitHub. При цене $10/мес (ChatGPT Plus) — один из самых доступных AI-агентов. Для продакшен-использования рекомендуем Pro-план с расширенным контекстом и приоритетным доступом к GPT-5 Codex.

Нужна помощь с оплатой Codex из России?