Окно SSH исчезает посреди рефакторинга. Переподключиться, возобновить Codex или начать заново? Это три разных действия. Ошибка может оставить двух агентов на одной ветке или привести к повтору уже выполненной операции.
Мы используем Codex resume для возобновления сессии, когда процесс завершился, но сохранённый диалог ещё доступен. Этот материал — об идентификации задачи и проверке состояния перед восстановлением, а не о поддержании процесса в рабочем состоянии. Для этого есть руководство по фоновым задачам.
Как возобновить сессию Codex: переподключение — не продолжение
В официальной документации неинтерактивного режима описана команда codex exec resume <SESSION_ID> для продолжения сохранённого запуска. Интерактивная CLI также поддерживает codex resume. Перед внедрением процедуры восстановления проверьте codex resume --help и codex exec resume --help в установленной версии.
| Ситуация | Первое действие | Чего нельзя предполагать |
|---|---|---|
| SSH оборвался; Codex продолжает работать в tmux | Подключиться к существующей сессии tmux | Отключённый терминал означает остановку агента |
| Процесс Codex завершился; сессия сохранена на сервере | Проверить состояние, затем продолжить выбранную сессию | Диалог восстанавливает файлы или внешние изменения |
| VPS заменён; хранилище сессий отсутствует | Восстановить репозиторий и описание задачи; начать новый запуск | Клон Git содержит историю диалогов Codex |
| Задачу заблокировали авторизация или лимит тарифа | Восстановить доступ или дождаться доступного лимита | Продолжение обходит авторизацию или ограничения использования |
Возобновлённый диалог — не снимок VM, не откат файловой системы и не механизм выполнения «ровно один раз». У файлов, фоновых команд, операций Git и удалённых сервисов собственное состояние. Мы проверяем его, прежде чем просить модель продолжить.
Запустите первого агента примерно за 3 минуты
Установите CLI Office Claws, подключите аккаунт Contabo и подписку Codex — агент получит собственный VPS и рабочее место в офисе.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh$4.99/мес + ваш собственный VPS в Contabo · ключи остаются в вашей связке ключей
Запишите идентификатор сессии заранее
На VPS используйте ту же учётную запись Unix и тот же домашний каталог Codex, что и для исходной задачи. Обычно Codex хранит локальное состояние в ~/.codex; переменная CODEX_HOME может изменить этот путь. Другая учётная запись или каталог создают впечатление, что существующая сессия пропала. Запуски с --ephemeral не сохраняют файлы истории сессии для последующего восстановления.
Для интерактивной задачи выберите сохранённую сессию через codex resume или используйте codex resume <SESSION_ID>, если идентификатор известен. В автоматизированном процессе сохраняйте thread_id из события thread.started, которое выдаёт codex exec --json, вместе с сервером, рабочим каталогом, веткой и коммитом. В руководстве по структурированному выводу объясняется, почему поток событий JSONL отличается от итогового результата.
Не используйте --last в скрипте восстановления на общем сервере. Последняя сессия необязательно относится к нужной задаче, особенно когда несколько агентов работают под одной учётной записью. Явный идентификатор надёжнее для выбора сессии, но не является границей авторизации.
Храните сессии и журналы событий конфиденциально. В них могут быть запросы, фрагменты исходного кода и вывод команд. Не копируйте весь домашний каталог Codex в обращение или архив артефактов: там могут находиться и данные авторизации. Резервируйте работу в репозитории и записи задач с подходящими правами доступа отдельно от учётных данных.
Проверьте рабочую копию и продолжите одну задачу
Сначала подключитесь к серверу обычным способом через SSH. Если исходная задача использовала tmux, посмотрите сессии командой tmux ls и подключитесь к нужной, прежде чем запускать что-либо новое. Также проверьте процесс или сервис, которому принадлежала задача. Один лишь обрыв соединения не доказывает, что прежний исполнитель остановился.
Убедившись, что исходный исполнитель завершился, мы проверяем его рабочую копию. Пример только читает метаданные Git и локальную справку; замените путь на исходный каталог задачи.
cd ~/work/product-api
pwd
git branch --show-current
git rev-parse HEAD
git status --short
git diff --stat
git diff --cached --stat
codex --version
codex exec resume --helpСравните результаты с записью задачи. Изучите реальный diff, неотслеживаемые файлы, результаты тестов и внешние операции в предыдущем журнале. Чистое рабочее дерево не доказывает, что ничего не произошло: агент уже мог создать коммит, отправить изменения или изменить удалённую систему. Если это входило в задачу, проверьте такие системы через доверенный интерфейс только для чтения.
Если репозиторий перешёл на другую ветку или коммит, остановитесь и разберитесь с расхождением до возобновления. Не используйте git reset --hard и удаление неотслеживаемых файлов как короткий путь к восстановлению. Сохраните незавершённые изменения; если исходную среду нельзя уверенно восстановить, начните новую сессию с проверенным описанием передачи работы.
После проверки можно явно продолжить неинтерактивный запуск. Замените идентификатор записанным значением. Команда отправляет новый запрос и может расходовать лимит Codex. Перепроверьте действующую песочницу, политику подтверждений и подключённые инструменты установленной версии; приведённый запрос — инструкция, а не техническое ограничение.
SESSION_ID='replace-with-recorded-session-id'
codex exec resume "$SESSION_ID" \
"First summarize prior progress and compare it with the current checkout. Do not edit files, run project commands, push, deploy, or repeat external operations. Report discrepancies and propose the next verification step."Сопоставьте ответ с фактическими данными до разрешения дальнейших правок. Воспоминания агента полезны как контекст, но не доказывают успешность теста или завершение удалённого действия. Не храните учётные данные развёртывания на исполнителе и ограничивайте права независимо; см. песочницы и подтверждения.
Восстановление как передача работы, а не автоматический повтор
Мы ведём небольшую запись восстановления вне рабочей копии: идентификатор задачи, сервер, учётная запись Unix, путь к домашнему каталогу Codex, идентификатор сессии, рабочий каталог, ветка, исходный коммит, последний проверенный этап и невыясненные внешние изменения. Сохраняйте только путь к каталогу, никогда не копируйте содержимое учётных данных. Обновляйте запись после каждого проверенного этапа и сохраняйте соответствующий вывод тестов.
Это процедура, которую поддерживает оператор, а не заявление о наличии в Office Claws транзакционного восстановления сессий, автоматического переноса или механизма идемпотентных повторов. Office Claws предоставляет CLI и настольный интерфейс для агентов Codex на вашем собственном Contabo VPS; локальное хранение сессий, резервные копии и проверки восстановления остаются вашей ответственностью.
VPS может быть доступен круглосуточно, но это не обещание бесконечного выполнения задачи. Office Claws стоит от $4.99 в месяц за первого агента; VPS оплачивается отдельно, а доступ к Codex через поддерживаемый тариф ChatGPT по-прежнему ограничен квотами. Возобновление не сбрасывает лимиты и не делает сохранённый контекст бесплатным. Разделение расходов описано в сравнении подписки и стоимости API.
Наша рекомендация: отрепетируйте безобидное прерывание, прежде чем рассчитывать на ночное восстановление. Найдите сессию, подтвердите остановку прежнего исполнителя, сравните рабочую копию с записью задачи и продолжите по явному идентификатору. Надёжное восстановление начинается с доказательств, а не с очередного цикла повторов.