Обзор настольного приложения

📚 Навигация по серии: Предыдущая статья 06 Выполнение первой задачи помогла вам отправить первый запрос и увидеть процесс генерации кода агентом. В этой статье мы подробно изучим основной интерфейс Codex — настольное приложение (Desktop App). Мы разберем его интерфейс, доступные функции, настройки и горячие клавиши. В следующей статье 08 Быстрый старт в CLI-клиенте мы вернемся к работе с консольной версией.

OpenAI предлагает четыре интерфейса для работы с Codex, однако ключевой акцент в промо-материалах, документации и презентациях сделан на настольном приложении (Desktop App) — отдельном графическом клиенте.

Это подтверждается и структурой документации: разделы, посвященные настольной версии (features, commands, settings, review, worktrees, automations, browser, computer-use, local-environments, chrome-extension), превосходят по объему материалы CLI-клиента более чем в два раза. Настольная версия является приоритетным направлением разработки.

Многие разработчики ошибочно полагают, что графический клиент — это упрощенный инструмент для тех, кто не умеет пользоваться консолью. В случае с Codex это не так: настольное приложение объединяет в себе параллельные вычисления, изоляцию рабочих деревьев (Worktree), визуальное ревью, встроенный браузер и средства автоматизации, являясь наиболее функциональным интерфейсом.

В этой статье мы подробно изучим интерфейс приложения, разберем параллельную работу без конфликтов слияния, визуальный аудит и полезные сочетания клавиш.

После прочтения этой статьи вы получите:

• Схему интерфейса приложения с описанием функций боковой панели, области диалогов и панели ревью
• Описание трех режимов выполнения задач (Local, Worktree, Cloud) для выбора оптимального сценария
• Навык использования графической панели ревью: комментирование строк, точечный коммит или откат кода
• Преимущества настольной версии (встроенный терминал, кнопки Actions, автоматизация по расписанию)
• Справочник горячих клавиш и слэш-команд, а также пошаговый алгоритм для быстрого старта

⚠️ Примечание: все упоминания горячих клавиш, параметров настроек и поведения по умолчанию приведены в соответствии с официальной документацией Codex. Обратите внимание, что в руководстве указаны сочетания для macOS. На Windows сверяйтесь со справочником в меню Settings > Keyboard Shortcuts.

---

01 Назначение настольного приложения

Интерфейс приложения с обилием вкладок и кнопок может показаться сложным на первый взгляд. Для начала проясним концепцию инструмента.

Главный вывод: настольное приложение Codex разработано как рабочая среда для параллельного выполнения задач. В документации оно описывается как «a focused desktop experience for working on Codex threads in parallel» (специализированная настольная среда для параллельной работы с потоками Codex). Под потоком (thread) понимается отдельная сессия выполнения задачи (например, ваш запрос из Статьи 06).

Аналогия: производственный цех с несколькими рабочим местами. В CLI вы работаете последовательно над одной задачей за одним столом. В настольном приложении вы выступаете в роли руководителя цеха: перед вами несколько рабочих столов, за каждым из которых агент решает отдельную задачу (исправление багов на одном, написание тестов на другом, запуск долгого скрипта на третьем). Вы контролируете процесс визуально, переключаясь между задачами по мере необходимости. Параллельный мониторинг и координация процессов — сильная сторона приложения.

Приложение использует то же ядро Codex, что и CLI или расширения для IDE. У них общие конфигурационные файлы AGENTS.md (правила проекта из Статьи 02), настройки серверов MCP и навыки (Skills). Графический клиент — это удобная визуальная оболочка для совместной работы.

Сценарии, где настольное приложение наиболее эффективно:

• Параллельная работа над несколькими задачами, требующая изоляции изменений для исключения конфликтов слияния.
• Исследование стороннего веб-проекта, требующее визуального контроля рендеринга во встроенном браузере в реальном времени.
• Автоматическое составление ежедневных отчетов об изменениях в кодовой базе репозитория за прошедшие сутки.

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

💡 Краткий вывод: Настольное приложение представляет собой многозадачную рабочую среду для параллельного выполнения задач с удобной визуализацией процессов на базе стандартного ядра Codex.

---

02 Поддерживаемые платформы

Начнем с ограничений: настольная версия для ОС Linux в настоящее время отсутствует.

Пользователям Linux доступна только консольная версия CLI (подробно в следующей Статье). Настольное приложение разработано для macOS и Windows.

Нюансы установки дистрибутивов (подробнее в Статье 03):

Платформа	Источник	Возможные проблемы
macOS (процессоры Apple M-серии)	Официальная страница загрузки	Несовместимость при ошибке выбора архитектуры
macOS (процессоры Intel)	Ссылка Intel build на той же странице	Убедитесь, что скачали версию для Intel
Windows	Магазин приложений Microsoft Store или команда winget	Особенности настройки песочницы (см. Статью 03)
Linux	Отсутствует	Используйте CLI-клиент

Важное примечание по авторизации в приложении:

Для полноценной работы графического клиента рекомендуется использовать авторизацию через учетную запись ChatGPT. При входе по API-ключу часть функций может быть ограничена (согласно документации: «some functionality might not be available»). Точный перечень ограничений зависит от текущей версии клиента, но для использования всех облачных возможностей и интеграций применяйте подписку ChatGPT (Plus/Pro).

Мой опыт это подтверждает: при первом запуске в марте 2026 года я вошел по API-ключу, после чего обнаружил, что часть облачных модулей осталась неактивной. Сброс настроек и повторный вход под учетной записью ChatGPT мгновенно активировали все серые пункты меню.

💡 Краткий вывод: Графический клиент поддерживается на macOS и Windows. Пользователям Mac важно скачивать дистрибутив под свою архитектуру процессора. Используйте вход через аккаунт ChatGPT для сохранения доступа ко всем функциям.

---

03 Архитектура интерфейса

Интерфейс приложения разделен на три вертикальные области: навигация слева, диалоги по центру и вывод результатов справа.

Общая схема трехпанельной компоновки:

Логика проста: вы выбираете проект и поток в левой колонке → ставите задачу агенту в центральном окне → контролируете результаты рендеринга и diff в правой панели.

Левая колонка: Навигация

Интерфейс левой колонки содержит элементы управления (названия могут незначительно отличаться в зависимости от версии):

• New Thread: запуск новой сессии или задачи. Самая часто используемая кнопка.
• Search: сквозной поиск по истории диалогов и файлов проекта.
• Plugins: управление интеграциями (браузер, GitHub и др.).
• Automations: планировщик задач автоматизации (подробнее в Разделе 05).
• Projects: список подключенных репозиториев для переключения между проектами.
• Chats: диалоги без привязки к локальной файловой системе (для общих вопросов).

Разграничивайте понятия: Проект (Project) не является простым Чатом (Chat).

Аналогия: штатный сотрудник против случайного посетителя. Проект жестко привязан к конкретному рабочему каталогу на диске, в котором Codex разрешено считывать и записывать файлы. Чат запускается изолированно в служебной папке ~/.codex/threads/ для обсуждения общих вопросов (например, теории алгоритмов или справочных данных), не затрагивая ваш код.

Примеры сценариев:

• Внесение изменений в логику ~/code/my-app — используйте раздел Projects.
• Общие вопросы по программированию на Rust — используйте раздел Chats.

Центральная область: Диалоги

Центральная панель отображает ход беседы и список задействованных файлов. В нижней части находятся переключатели настроек перед отправкой запроса:

• Выбор режима: Local / Worktree / Cloud (подробнее в Разделе 04).
• Выбор модели: переключение модели непосредственно во время сессии.
• Политики подтверждения: правила блокировок и запросов перед записью.

Правая панель: Результаты

Панель справа сворачивается и разворачивается с помощью иконки в верхнем углу. Она содержит три вкладки:

• Diff: визуальное двухпанельное сравнение изменений.
• Terminal: встроенный терминал с общим окружением для тестов.
• Preview: предпросмотр веб-страниц, изображений и файлов проекта.

Общий вид разделов в рабочем окне приложения:

На схеме отмечены: заголовок (выбор проекта и режима), боковая панель потоков, окно чата, область diff, терминал и статусная строка. Расположение элементов может меняться с обновлениями клиента.

Реальный интерфейс настольной версии приложения:

💡 Краткий вывод: Интерфейс состоит из трех панелей: навигационной, диалоговой и панели результатов. Помните, что запись файлов разрешена только в сессиях раздела Projects.

---

04 Режимы выполнения задач: Local, Worktree и Cloud

Перед отправкой промпта выберите один из трех режимов выполнения:

Режим	Среда выполнения	Место сохранения изменений	Сценарий применения
Local	Локально, рабочий каталог	Редактирует файлы рабочей папки напрямую	Повседневная разработка с контролем в IDE
Worktree	Локально, изолированная папка	В отдельном рабочем дереве (worktree) без затрагивания основной папки	Параллельная работа над несколькими независимыми фичами
Cloud	Облачная среда OpenAI	Удаленная песочница, отправка результатов в PR	Ресурсоемкие долгие задачи, компиляция

Важно: режимы Local и Worktree выполняются локально на вашем компьютере. Cloud переносит вычисления на облачную инфраструктуру. Режим Worktree просто изолирует файлы в системном каталоге.

Разберем подробнее режим Worktree — основу многозадачности приложения.

Аналогия: копирование чертежа для разных инженеров. Если несколько разработчиков одновременно вносят изменения в один оригинальный файл, они затрут правки друг друга. Режим Worktree создает изолированные копии (копии папок проекта средствами git worktree), позволяя агентам работать параллельно над разными задачами. Изменения не пересекаются до момента их явного слияния.

Запуск двух параллельных сессий в режиме Local для одного проекта приведет к конфликтам перезаписи файлов. Для параллельной разработки всегда используйте режим Worktrees.

Правила работы в режиме Worktree:

• Требуется инициализация Git: механизм использует штатные команды git worktree. Для работы репозиторий должен быть создан предварительно.
• Игнорируемые файлы не копируются: файлы, внесенные в .gitignore (папки зависимостей node_modules, конфигурации .env), не переносятся в изолированное дерево. Настройку зависимостей необходимо прописать в сценарии автоматизации сборки (см. Раздел 05).
• Расположение файлов: временные деревья сохраняются в каталоге ~/.codex/worktrees/ в состоянии detached HEAD.
• Перенос сессий (Handoff): вы можете переносить активную сессию между режимами Local и Worktree кнопкой Hand off. Это позволяет перенести сгенерированный в фоне код в вашу основную рабочую область.
• Автоматическая очистка: по умолчанию клиент хранит до 15 недавних деревьев, удаляя устаревшие (с возможностью восстановления из резервной копии). Лимиты настраиваются в панели параметров.

💡 Краткий вывод: Режим Local изменяет рабочий каталог напрямую; Worktree создает независимую временную копию файлов проекта (требуется инициализация Git); Cloud переносит задачи на внешние серверы. Для многозадачности используйте Worktree.

---

05 Уникальные преимущества настольной версии

Интерфейс приложения предоставляет ряд функций, недоступных в терминале:

Визуальная панель ревью (Review Pane)

Визуальная панель ревью существенно превосходит текстовый вывод терминала. Вместо простого лога вы получаете интерактивный интерфейс сравнения файлов.

Аналогия: рецензирование документа. В CLI вы читаете отчет об изменениях и описываете свои правки текстом в чате. Панель ревью похожа на режим совместного редактирования в документах: вы оставляете комментарии непосредственно напротив нужной строки кода, что значительно точнее.

Функциональные возможности панели ревью:

• Анализ незафиксированных изменений: панель считывает состояние всего Git-репозитория, показывая любые правки (в том числе сделанные вами вручную).
• Выбор контекста: поддержка переключения режимов просмотра (All branch changes — сравнение с базовой веткой, Last turn changes — изменения последнего шага генерации).
• Построчные комментарии: наведите мышь на строку кода, нажмите кнопку + и оставьте комментарий. Агент внесет правки по вашим точечным указаниям.
• Точечный коммит и откат (Hunk staging): вы можете добавлять в индекс (stage) или сбрасывать (revert) отдельные измененные фрагменты кода, файлы или весь diff целиком.

Приложение поддерживает создание коммитов, отправку веток в удаленный репозиторий и открытие Pull Request непосредственно из окна ревью.

Для работы с комментариями к PR в GitHub требуется предварительно настроить авторизацию в утилите GitHub CLI (gh auth login).

Встроенный терминал

Каждая сессия имеет встроенную консоль, открытую в рабочем каталоге. Вызвать терминал можно кнопкой в заголовке окна или сочетанием клавиш Cmd + J (на macOS).

Терминал синхронизирован с рабочим деревом агента. Любые проверки сборки или запуск тестов происходят в том же каталоге, с которым работает Codex. Агент может считывать логи вывода консоли для исправления ошибок компиляции.

Обратите внимание: сочетание Cmd + K в графическом клиенте зарезервировано под открытие командного меню. Для очистки встроенной консоли используйте Ctrl + L.

Управляющие кнопки Actions

Вы можете вынести часто используемые сценарии (запуск сборщика, линтера, тестов) в виде кнопок Actions на верхнюю панель.

Сценарии кнопок настраиваются в файлах папки .codex в корне репозитория (что позволяет версионировать их в Git). Они выполняются в изолированном дереве автоматически при развертывании проекта.

Автоматизация по расписанию (Automations)

Планировщик задач позволяет запускать Codex для регулярных проверок по расписанию.

Примеры сценариев автоматизации:

• Сводка изменений за сутки: анализ коммитов репозитория за прошедшие 24 часа;
• Анализ логов ошибок: регулярная проверка файлов телеметрии с автоматической генерацией фиксов;
• Повторный запуск потоков: автоматическое возобновление фоновых задач по таймеру с сохранением контекста.

Для работы планировщика необходимо держать запущенным приложение Codex и обеспечить постоянный доступ к файлам проектов на диске.

💡 Краткий вывод: Интерактивное ревью с комментированием строк, встроенная общая консоль, скрипты автоматической сборки Actions и планировщик задач по расписанию — ключевые преимущества графической версии.

---

06 Горячие клавиши и слэш-команд

Выделим основные сочетания клавиш:

Сочетания клавиш приведены для macOS. На Windows настройте или сверьте привязку клавиш в меню Settings > Keyboard Shortcuts.

Основные сочетания клавиш на macOS:

Сочетание клавиш (macOS)	Действие	Описание
Cmd + Shift + P или Cmd + K	Открыть командную панель	Быстрый поиск и вызов любых функций
Cmd + N или Cmd + Shift + O	Создать новый поток	Быстрый запуск параллельных задач
Cmd + J	Показать/скрыть консоль	Переключение встроенного терминала
Cmd + B	Показать/скрыть боковую панель	Расширение рабочей области диалогов
Cmd + Option + B	Показать/скрыть панель Diff	Быстрый вызов области сравнения кода
Cmd + G	Поиск по истории потоков	Поиск завершенных сессий
Cmd + F	Поиск в текущей ветке диалога	Поиск текстовых логов в открытом чате
Cmd + ,	Открыть настройки	Панель параметров, подключение MCP
Ctrl + L	Очистить консоль	Сброс логов встроенного терминала
Ctrl + M	Голосовой ввод	Трансляция речи в текст

Основные слэш-команды в строке ввода:

Слэш-команда	Назначение
/status	Просмотр ID потока, размера контекста и лимитов
/review	Вход в режим визуального ревью изменений
/plan	Переключение режима составления планов (Plan Mode)
/goal	Задание долгосрочной цели агенту
/mcp	Контроль состояния подключенных серверов MCP
/feedback	Отправка отзывов и логов разработчикам

💡 Краткий вывод: Запомните два сочетания: Cmd + K (командная панель) и Cmd + N (создание задачи). Из слэш-команд наиболее важны /status (оценка лимитов) и /review (запуск аудита кода).

---

07 Практика: Настройка параллельных задач

Выполним настройку параллельной генерации кода в режиме Worktree:

Подготовка: у вас должно быть установлено приложение и выполнена авторизация под аккаунтом ChatGPT. Выберите тестовый репозиторий под управлением Git.

Шаг 1: Добавление проекта и выбор режима Worktree

Выберите каталог проекта в левой боковой панели и переключите режим выполнения в положение Worktree.

Критерий проверки: в окне отобразится выбор исходной ветки Git (например, main). При ошибке инициализации Git выполните команду git init в папке проекта.

Шаг 2: Отправка первого запроса

Отправьте первую команду рефакторинга, например:

找一处 TODO 注释，把它实现掉

или:

给这个项目的 README 补一段「如何本地运行」的说明

Нажмите Enter. Codex создаст изолированную копию ветки (worktree) и начнет работу в фоне, не затрагивая ваш основной рабочий каталог.

Шаг 3: Запуск параллельной сессии

Не дожидаясь завершения первой задачи, нажмите кнопку New Thread для старта второй задачи в режиме Worktree:

把项目里所有 console.log 调试输出清理掉

Ожидаемый результат: в боковой панели появятся два независимых потока выполнения. Вы можете переключаться между ними, оценивая прогресс.

Шаг 4: Аудит изменений в панели ревью

Откройте панель Diff (Cmd + Option + B на macOS) для анализа измененных файлов по окончании генерации.

Выполните проверку изменений:

• Наведите мышь на строчку кода → нажмите + → оставьте комментарий → попросите Codex переписать код по вашим указаниям.
• Добавьте в индекс корректный код (stage) или сбросьте ошибочные строки (revert) для точечной фиксации.

Ожидаемый результат: изменения изолированы во временной ветке и переносятся в основную кодовую базу только после вашего подтверждения и коммита.

Шаг 5: Перенос сессии в локальный каталог (Handoff)

Для переноса сгенерированного кода в основной рабочий каталог нажмите кнопку Hand off в заголовке потока.

Ожидаемый результат: перенос измененных файлов в вашу рабочую область IDE. Помните, что неотслеживаемые Git файлы при этом не переносятся.

💡 Краткий вывод: Создайте поток Worktree → дождитесь завершения → проверьте изменения в панели ревью (с комментированием или откатными действиями) → сделайте коммит.

---

08 Резюме

Основные итоги изучения настольного приложения:

• Позиционирование: полноценная многозадачная среда разработки с общим ядром настроек, правил AGENTS.md и серверов MCP.
• Платформы: macOS и Windows. Авторизация предпочтительна через подписку ChatGPT.
• Компоновка: навигация слева, окно чата в центре, вывод diff и терминал справа. Файловые операции доступны только в профилях Projects.
• Режимы: Local (прямая запись), Worktree (изоляция веток через Git), Cloud (облачные вычисления).
• Уникальные функции: визуальное ревью, общий встроенный терминал, скрипты Actions и задачи по расписанию Automations.
• Управление: используйте сочетания Cmd + K и Cmd + N, контролируйте лимиты через /status и запускайте аудит через /review.

Освоив графический интерфейс клиента и логику изолированных рабочих деревьев, вы сможете эффективно вести параллельную разработку нескольких задач.

В следующей статье 08 · Быстрый старт в CLI-клиенте мы вернемся к консольной версии. CLI необходим для автоматизации, интеграции в CI/CD и удаленной работы на серверах.

---

Рекомендуемые материалы

• Режим Worktrees: параллельная разработка без конфликтов слияния
• Интеграция внешних инструментов по протоколу MCP
• Файл правил AGENTS.md: фиксация стандартов кодирования