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. Подготовка и инспекция
- Проверьте, что занимает место. Осмотрите:sessions/ (активные чаты)
archived_sessions/
Worktrees и archived worktrees
Логи (обычно в ~/Library/Logs/com.openai.codex/ на macOS или аналогичных путях)
Конфиг, глобальное состояние, индекс сессий, локальную БД. - Сделайте бэкап. Скопируйте: конфиг, глобальное состояние, индекс сессий, БД, memories, skills, plugins, automations.
- Убедитесь, что Codex закрыт. При запущенном приложении только инспектируйте. Чистку проводите после закрытия.
4–7. Работа с чатами и историей
- Найдите гигантские активные чаты. Отсортируйте файлы в sessions/ по размеру. Старые длинные разговоры часто остаются активными.
- Архивируйте старые непривязанные чаты. Перемещайте чаты старше 7–10 дней в архив (если не pinned и не актуальны). В приложении есть инструменты для архивации.
- Держите активными только свежие работы. Боковая панель не должна содержать недели/месяцы старых потоков.
- Используйте handoff-документы. Превращайте важный старый поток в Markdown-документ (с промптами для реактивации), архивируйте чат и начинайте новый из handoff. Это официальная рекомендация для поддержания производительности.
8–11. Конфиг, пути и артефакты
- Нормализуйте странные пути (критично для Windows). Очистите несоответствия C:\ и \\?\C:\.
- Обрежьте мёртвые конфиг-проекты. Удалите пути к несуществующим или временным папкам.
- Переместите устаревшие worktrees. Архивируйте вместо удаления. Codex поддерживает автоматическое управление worktrees, но ручная архивация помогает.
- Ротируйте большие логи. Переместите старые в архив — приложение создаст свежие.
12–15. Завершение и автоматизация
- Проверьте фоновые процессы. Node.js/dev-серверы: закройте ненужные вручную.
- Проверьте результат.Конфиг парсится
БД открывается
Размер активных сессий уменьшился
Архив вырос
Нет битых путей
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 создан для продуктивности, но без обслуживания превращается в тяжёлый монолит. Этот подход превращает это в предсказуемую, почти автоматическую рутину. Регулярная чистка не только ускоряет приложение, но и улучшает качество ответов агента за счёт свежего контекста.