Reanudar una sesión de Codex: recuperar trabajo en un VPS

Reanudar una sesión de Codex: recuperar trabajo en un VPS — Usa Codex resume para continuar una sesión guardada en tu VPS, distinguir reconexión de reanudación y evitar repetir operaciones en el repositorio equivocado.
18 nov 20266 min de lectura
Share with

La ventana SSH desaparece a mitad de una refactorización. ¿Nos reconectamos, reanudamos Codex o empezamos de nuevo? Son tres acciones distintas. Elegir mal puede dejar a dos agentes editando la misma rama o repetir una operación ya realizada.

Usamos Codex resume para reanudar una sesión cuando el proceso terminó pero su conversación guardada sigue disponible. Esta guía trata de identificar la tarea y comprobar su estado al recuperarla, no de mantener vivo un proceso. Para eso, consulta nuestra guía de tareas en segundo plano.

Reanudar una sesión de Codex no es reconectarse

La documentación oficial del modo no interactivo describe codex exec resume <SESSION_ID> para continuar una ejecución guardada. La CLI interactiva también admite codex resume. Comprueba codex resume --help y codex exec resume --help en la versión instalada antes de adoptar un procedimiento de recuperación.

SituaciónPrimera acciónQué no debemos suponer
SSH se cortó; Codex sigue ejecutándose en tmuxReconectarse a esa sesión tmux existenteUn terminal desconectado significa que el agente se detuvo
El proceso Codex terminó; la sesión sigue guardada en el servidorInspeccionar el estado y reanudar la sesión elegidaUna conversación restaura archivos o efectos externos
Se reemplazó el VPS; falta el almacenamiento de sesionesRecuperar el repositorio y las instrucciones; iniciar otra ejecuciónUn clon Git incluye el historial de conversaciones Codex
La autenticación o el cupo bloquearon la tareaResolver el acceso o esperar a recuperar el cupoReanudar elude la autenticación o los límites de uso

Una conversación reanudada no es una instantánea de VM, una restauración del sistema de archivos ni un mecanismo de ejecución exactamente una vez. Los archivos, comandos en segundo plano, operaciones Git y servicios remotos tienen su propio estado. Lo inspeccionamos antes de pedir al modelo que continúe.

Reconectarse al proceso activo, reanudar el contexto guardado o reconstruir el estado perdido

Pon en marcha tu primer agente en unos 3 minutos

Instala la CLI de Office Claws, conecta tu cuenta de Contabo y tu suscripción de Codex, y tu agente tendrá su propio VPS y un escritorio en la oficina.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/mes + tu propio VPS de Contabo · las claves se quedan en tu llavero

Registra la identidad de la sesión antes de necesitarla

En el VPS, usa la misma cuenta Unix y el mismo directorio de Codex que en la tarea original. Codex suele guardar el estado local en ~/.codex; CODEX_HOME puede cambiar esa ubicación. Otra cuenta o directorio puede hacer que una sesión existente parezca ausente. Las ejecuciones iniciadas con --ephemeral no conservan los archivos del historial de sesión para recuperarlos después.

Para una tarea interactiva, usa codex resume y elige una sesión guardada, o codex resume <SESSION_ID> si conoces su identidad. En flujos automatizados, captura el thread_id del evento thread.started que emite codex exec --json y regístralo junto al servidor, directorio de trabajo, rama y commit. Nuestra guía de salida estructurada explica por qué este flujo de eventos JSONL es distinto del resultado final.

Evita --last en scripts de recuperación de servidores compartidos. La sesión más reciente no tiene por qué ser la tarea deseada, especialmente si varios agentes trabajan con la misma cuenta. Un identificador explícito es una mejor clave de recuperación, pero no un límite de autorización.

Mantén privados el almacenamiento de sesiones y los registros de eventos. Pueden incluir instrucciones, fragmentos de código y salidas de comandos. No copies todo el directorio de Codex a una incidencia o archivo de artefactos: también puede contener material de autenticación. Respalda el trabajo del repositorio y las fichas de tareas con controles de acceso adecuados, separados de las credenciales.

Inspecciona la copia de trabajo y continúa una sola tarea

Primero vuelve a conectarte al servidor mediante tu flujo SSH habitual. Si la tarea original usaba tmux, inspecciona sus sesiones con tmux ls y entra en la correcta antes de iniciar nada nuevo. Revisa también el proceso o servicio responsable de la tarea. La desconexión de la terminal no demuestra que el proceso anterior haya terminado.

Una vez confirmado que se detuvo, inspeccionamos su copia de trabajo. Este ejemplo solo lee metadatos Git y la ayuda local; sustituye la ruta por el directorio original de la tarea.

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

Compara los resultados con la ficha de la tarea. Inspecciona las diferencias reales, archivos sin seguimiento, artefactos de pruebas y operaciones externas del registro anterior. Un árbol de trabajo limpio no demuestra que no haya ocurrido nada: el agente podría haber creado commits, enviado cambios o modificado un sistema remoto. Comprueba esos sistemas mediante una interfaz fiable de solo lectura si estaban dentro del alcance.

Si el repositorio está ahora en otra rama o commit, detente y aclara la situación antes de reanudar. No uses git reset --hard ni borres archivos sin seguimiento como atajo de recuperación. Conserva los cambios inacabados; si no puedes reconstruir el entorno original con confianza, inicia una sesión nueva con un traspaso revisado.

Tras la inspección, esta es una continuación no interactiva explícita. Sustituye el identificador por el valor registrado. Envía un turno nuevo y puede consumir tu cupo de Codex. Confirma el aislamiento efectivo, la política de aprobación y las herramientas conectadas de tu versión; la instrucción siguiente es orientación, no un control técnico.

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."

Contrasta la respuesta con las pruebas antes de autorizar más ediciones. Los recuerdos del agente aportan contexto, no demuestran que una prueba pasara o una acción remota terminara. Mantén las credenciales de despliegue fuera del servidor de ejecución y aplica permisos de forma independiente; consulta aislamiento y aprobaciones.

Trata la recuperación como un traspaso, no un reintento automático

Guardamos fuera de la copia de trabajo una pequeña ficha de recuperación: identificador de tarea, servidor, cuenta Unix, ruta del directorio Codex, identificador de sesión, directorio de trabajo, rama, commit base, último hito verificado y efectos externos pendientes. Guarda solo la ruta, nunca el contenido de las credenciales. Actualiza la ficha tras cada hito revisado y conserva la salida de las pruebas relevantes.

Este es un flujo mantenido por el operador, no una afirmación de que Office Claws incluya recuperación transaccional, migración automática de sesiones o un motor de reintentos idempotente. Office Claws ofrece una CLI y una interfaz de escritorio para agentes Codex en tu propio Contabo VPS; la conservación local de sesiones, las copias de seguridad y las comprobaciones de recuperación siguen siendo tu responsabilidad.

El VPS puede estar disponible las 24 horas sin prometer que una tarea se ejecute para siempre. Office Claws empieza en $4.99/mes para el primer agente; el VPS se paga aparte y el acceso Codex mediante un plan ChatGPT compatible sigue sujeto a límites de uso. Reanudar no reinicia esos límites ni hace gratuito el contexto conservado. Consulta suscripción frente a coste API para distinguir las capas de gasto.

Nuestra recomendación: ensaya una interrupción inofensiva antes de depender de la recuperación nocturna. Localiza la sesión, confirma que el proceso anterior se detuvo, compara la copia de trabajo con la ficha y reanuda mediante un identificador explícito. Una recuperación fiable empieza con pruebas, no con otro bucle de reintentos.

Autor

Office Claws Team

Construyendo el futuro de la gestión de agentes de IA en Office Claws. Compartiendo conocimientos sobre infraestructura, seguridad y experiencia del desarrollador.

Pon en marcha tu primer agente en unos 3 minutos

Instala la CLI de Office Claws, conecta tu cuenta de Contabo y tu suscripción de Codex, y tu agente tendrá su propio VPS y un escritorio en la oficina.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/mes + tu propio VPS de Contabo · las claves se quedan en tu llavero