Как ускорить Codex в 10 раз: полное руководство по очистке и обслуживанию OpenAI Codex App

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

Один из ярких примеров — опыт пользователя @meta_alchemist, который столкнулся с серьёзным замедлением, но после системной очистки получил прирост скорости примерно в 10 раз. В его твите описана проверенная 15-пунктная система обслуживания, которая ничего не удаляет безвозвратно, а лишь архивирует и организует данные.

## Почему Codex замедляется со временем?

• Накопление сессий: Активные чаты хранят полную историю. Большие файлы сессий загружаются целиком, вызывая лаги при переключении.
• Логи: До 8 ГБ и больше — приложение активно пишет логи фоновых процессов, Node/dev-серверов и операций.
• Worktrees: Git-worktrees для изолированной работы агентов. Старые экземпляры занимают место и требуют сканирования.
• Конфигурация и состояние: Устаревшие пути проектов, дублирующиеся записи, несогласованные пути (особенно на Windows: C:\ vs \\?\C:\).
• База данных состояния и индексы: Локальная БД растёт, и параллельный доступ (при открытом приложении) усугубляет проблемы.
• Контекстная деградация (context rot): Длинные чаты ухудшают качество ответов и производительность.

Главный принцип от @meta_alchemist:
Чаты — для выполнения задач. Handoff-документы — для памяти. Архивы — для истории. Свежие потоки — для скорости.

## 15-этапная система чистки Codex (адаптировано и дополнено)

Важные предварительные условия:

• Сделайте всесторонние handoff-документы для активных чатов (с ключевыми промптами, состоянием задач и ссылками). Это позволит быстро возобновить работу в новом чате.
• Закройте Codex перед применением изменений, затрагивающих БД.
• Создайте резервную копию всей папки ~/.codex (или %USERPROFILE%\.codex на Windows).

1–3. Подготовка и инспекция

1. Проверьте, что занимает место.
   Осмотрите:

   • sessions/ (активные чаты)
   • archived_sessions/
   • Worktrees и archived worktrees
   • Логи (обычно в ~/Library/Logs/com.openai.codex/ на macOS или аналогичных путях)
   • Конфиг, глобальное состояние, индекс сессий, локальную БД.

2. Сделайте бэкап.
   Скопируйте: конфиг, глобальное состояние, индекс сессий, БД, memories, skills, plugins, automations.

3. Убедитесь, что Codex закрыт.
   При запущенном приложении только инспектируйте. Чистку проводите после закрытия.

4–7. Работа с чатами и историей

4. Найдите гигантские активные чаты.
   Отсортируйте файлы в sessions/ по размеру. Старые длинные разговоры часто остаются активными.

5. Архивируйте старые непривязанные чаты.
   Перемещайте чаты старше 7–10 дней в архив (если не pinned и не актуальны). В приложении есть инструменты для архивации.

6. Держите активными только свежие работы.
   Боковая панель не должна содержать недели/месяцы старых потоков.

7. Используйте handoff-документы.
   Превращайте важный старый поток в Markdown-документ (с промптами для реактивации), архивируйте чат и начинайте новый из handoff. Это официальная рекомендация для поддержания производительности.

8–11. Конфиг, пути и артефакты

8. Нормализуйте странные пути (критично для Windows).
   Очистите несоответствия C:\ и \\?\C:\.

9. Обрежьте мёртвые конфиг-проекты.
   Удалите пути к несуществующим или временным папкам.

10. Переместите устаревшие worktrees.
    Архивируйте вместо удаления. Codex поддерживает автоматическое управление worktrees, но ручная архивация помогает.

11. Ротируйте большие логи.
    Переместите старые в архив — приложение создаст свежие.

12–15. Завершение и автоматизация

12. Проверьте фоновые процессы.
    Node.js/dev-серверы: закройте ненужные вручную.

13. Проверьте результат.

    • Конфиг парсится
    • БД открывается
    • Размер активных сессий уменьшился
    • Архив вырос
    • Нет битых путей

14–15. Сделайте еженедельным ритуалом.
Превратите в скучную повторяемую процедуру: бэкап → архивация сессий → нормализация → pruning → ротация логов → отчёт.
Попросите самого Codex настроить автоматизацию (например, на каждое воскресенье).

## Дополнительные лучшие практики из сообщества и документации

• One thread per task — избегайте монолитных чатов.
• Используйте /compact, /fork и handoff для управления контекстом.
• Регулярно просматривайте и архивируйте через настройки приложения.
• Для Windows: особое внимание stale workspaces и git-процессам (множественные git.exe).
• Мониторьте RAM: при 4–5+ ГБ в renderer-процессе UI заметно деградирует.
• Автоматизации Codex — идеально для еженедельного обслуживания.

## Возможные риски и edge-кейсы

• Потеря данных: Всегда бэкап + handoff.
• Параллельная работа: Не чистите при запущенных агентах/automations.
• Большие проекты/monorepo: Может потребоваться более частая чистка.
• После обновлений: Иногда помогают свежие версии, но чистка даёт более стабильный эффект.
• Если проблема сохраняется — проверьте GitHub issues OpenAI Codex и логи.

## Заключение: Профилактика лучше лечения

Codex создан для продуктивности, но без обслуживания превращается в тяжёлый монолит. Этот подход превращает это в предсказуемую, почти автоматическую рутину. Регулярная чистка не только ускоряет приложение, но и улучшает качество ответов агента за счёт свежего контекста.