Reprendre une session Codex : récupérer le travail sur un VPS

Reprendre une session Codex : récupérer le travail sur un VPS — Reprenez une session Codex enregistrée sur votre VPS : distinguez reconnexion et reprise, puis vérifiez le dépôt pour éviter de répéter des opérations.
18 nov. 20266 min de lecture
Share with

La fenêtre SSH disparaît au milieu d'une refactorisation. Faut-il se reconnecter, reprendre Codex ou repartir de zéro ? Ce sont trois actions différentes. Un mauvais choix peut laisser deux agents modifier la même branche ou répéter une opération déjà effectuée.

Nous utilisons Codex resume pour reprendre une session lorsque le processus est terminé, mais que sa conversation enregistrée reste disponible. Ce guide porte sur l'identité et l'état à vérifier lors d'une reprise, pas sur la persistance du processus. Pour celle-ci, consultez notre guide des tâches en arrière-plan.

Reprendre une session Codex : se reconnecter n'est pas reprendre

La documentation officielle du mode non interactif décrit codex exec resume <SESSION_ID> pour poursuivre une exécution enregistrée. La CLI interactive propose aussi codex resume. Vérifiez codex resume --help et codex exec resume --help sur la version installée avant d'adopter une procédure de reprise.

SituationPremière actionCe qu'il ne faut pas supposer
SSH coupé ; Codex tourne toujours dans tmuxSe reconnecter à la session tmux existanteUn terminal déconnecté signifie que l'agent s'est arrêté
Processus Codex terminé ; session enregistrée sur le serveurInspecter l'état, puis reprendre la session choisieUne conversation restaure les fichiers ou les effets externes
VPS remplacé ; stockage de session absentRécupérer le dépôt et la consigne ; lancer une nouvelle exécutionUn clone Git contient l'historique des conversations Codex
Authentification ou quota bloquant la tâcheRésoudre l'accès ou attendre le quotaLa reprise contourne l'authentification ou les limites d'usage

Une conversation reprise n'est ni un instantané de VM, ni une restauration du système de fichiers, ni une garantie d'exécution unique. Fichiers, commandes en arrière-plan, opérations Git et services distants ont leur propre état. Nous l'inspectons avant de demander au modèle de continuer.

Se reconnecter au processus actif, reprendre le contexte enregistré ou reconstruire l'état manquant

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

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

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau

Consigner l'identité de session avant d'en avoir besoin

Sur le VPS, utilisez le même compte Unix et le même répertoire Codex que pour la tâche initiale. Codex stocke normalement son état local sous ~/.codex ; CODEX_HOME peut changer cet emplacement. Un autre compte ou répertoire peut donner l'impression qu'une session a disparu. Les exécutions lancées avec --ephemeral ne conservent pas les fichiers de déroulement de session nécessaires à une reprise ultérieure.

Pour une tâche interactive, codex resume permet de choisir une session enregistrée ; utilisez codex resume <SESSION_ID> si vous connaissez déjà son identité. Pour les automatismes, capturez le thread_id de l'événement thread.started produit par codex exec --json et consignez-le avec l'hôte, le répertoire de travail, la branche et le commit. Notre guide de sortie structurée explique pourquoi ce flux d'événements JSONL est distinct du résultat final.

Évitez --last dans un script de reprise sur un serveur partagé. La session la plus récente n'est pas forcément la tâche visée, surtout lorsque plusieurs agents utilisent le même compte. Un identifiant explicite est une meilleure clé de reprise ; ce n'est pas une barrière d'autorisation.

Gardez privés le stockage des sessions et les journaux d'événements. Ils peuvent contenir des consignes, des extraits de code et des sorties de commandes. Ne copiez pas tout le répertoire Codex dans un ticket ou une archive d'artefacts : il peut aussi contenir des éléments d'authentification. Sauvegardez le travail du dépôt et les fiches de tâche avec des contrôles d'accès adaptés, séparément des identifiants.

Inspecter le dépôt, puis poursuivre une seule tâche

Reconnectez-vous d'abord à l'hôte selon votre procédure SSH habituelle. Si la tâche utilisait tmux, inspectez les sessions avec tmux ls et rattachez-vous à la bonne avant de lancer quoi que ce soit. Vérifiez aussi le processus ou le service responsable de la tâche. Une coupure de connexion ne prouve pas que l'ancien processus de travail a disparu.

Une fois son arrêt confirmé, nous inspectons sa copie de travail. Cet exemple ne lit que les métadonnées Git et l'aide locale ; remplacez le chemin par le répertoire de la tâche initiale.

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

Comparez ces résultats à la fiche de tâche. Inspectez les différences réelles, fichiers non suivis, artefacts de test et opérations externes du journal précédent. Un arbre de travail propre ne prouve pas que rien ne s'est passé : l'agent peut avoir créé un commit, envoyé des changements ou modifié un système distant. Vérifiez les systèmes concernés par une interface fiable en lecture seule.

Si le dépôt est passé à une autre branche ou à un autre commit, arrêtez-vous et clarifiez l'écart avant de reprendre. N'utilisez pas git reset --hard et ne supprimez pas les fichiers non suivis pour accélérer la récupération. Préservez les modifications inachevées ; si l'environnement initial ne peut pas être reconstitué avec confiance, ouvrez une nouvelle session avec une passation vérifiée.

Après inspection, voici une continuation non interactive explicite. Remplacez l'identifiant par la valeur enregistrée. Elle envoie un nouveau tour et peut consommer votre quota Codex. Revérifiez le bac à sable effectif, la politique d'approbation et les outils connectés de votre version ; la consigne ci-dessous ne constitue pas un contrôle technique.

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

Confrontez la réponse aux éléments observés avant d'autoriser d'autres modifications. Les souvenirs de l'agent fournissent du contexte, pas la preuve qu'un test a réussi ou qu'une action distante s'est achevée. Retirez les identifiants de déploiement du serveur d'exécution et imposez les permissions indépendamment ; consultez bac à sable et approbations.

Faire de la reprise une passation, pas une répétition automatique

Nous conservons hors du dépôt une petite fiche de reprise : identifiant de tâche, hôte, compte Unix, chemin du répertoire Codex, identifiant de session, répertoire de travail, branche, commit de départ, dernier jalon vérifié et effets externes non résolus. Enregistrez uniquement le chemin du répertoire, jamais le contenu des identifiants. Actualisez cette fiche après chaque jalon contrôlé et conservez les sorties de test utiles.

Il s'agit d'une procédure gérée par l'opérateur, pas d'une promesse de récupération transactionnelle, de migration automatique des sessions ou de moteur de répétition idempotent dans Office Claws. Office Claws fournit une CLI et une interface de bureau pour les agents Codex sur votre propre Contabo VPS ; conservation locale des sessions, sauvegardes et contrôles de reprise restent à votre charge.

Le VPS peut rester disponible 24 h/24 sans garantir qu'une tâche s'exécute indéfiniment. Office Claws commence à $4.99/mois pour le premier agent ; le VPS est facturé séparément et l'accès Codex via un forfait ChatGPT pris en charge reste soumis aux limites d'usage. Reprendre ne réinitialise pas ces limites et ne rend pas gratuit le contexte conservé. Voir abonnement ou coût API pour distinguer les postes de dépense.

Notre recommandation : répétez une interruption sans risque avant de compter sur une reprise nocturne. Sachez où se trouve la session, confirmez l'arrêt de l'ancien processus, comparez le dépôt à la fiche et reprenez par identifiant explicite. Une reprise fiable commence par des preuves, pas par une nouvelle boucle de tentatives.

Auteur

Office Claws Team

Nous construisons le futur de la gestion des agents IA chez Office Claws. Partage d'analyses sur l'infrastructure, la sécurité et l'expérience développeur.

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

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

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau