WatchUne limite d’usage restreint l’utilisation de Claude sur une fenêtre de temps donnée, tandis que les limites de fenêtre de contexte contraignent la capacité d’une seule conversation. Si la fenêtre de contexte est simplement pleine, utilisez /compact ou /clear dans Claude Code. Si vous avez atteint une limite d’usage du compte et devez changer d’agent, Watch transfère l’historique de session local enregistré vers Codex. Watch ne contourne pas les limites et ne modifie pas les fichiers du dépôt local.
Lors de tâches d’ingénierie prolongées, Claude Code peut signaler que vous avez atteint la limite de votre forfait, avec un horodatage de réinitialisation. Le raisonnement, les itérations échouées et les sorties de commandes accumulés restent sur votre disque. Watch fait le pont de cette session enregistrée vers OpenAI Codex, pour que le nouvel outil inspecte le contexte précédent sans que vous résumiez l’enquête à la main.
Étape 1 : Vérifier l’ID de session source et le répertoire de travail
Localisez l’ID de session Claude Code active. L’historique est stocké sous ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl. Assurez-vous que le chemin du répertoire (cwd) correspond à l’espace de travail réel du projet, afin d’éviter les décalages de worktree et de dépôt.
Étape 2 : Vérifier que le projet cible existe dans Codex Desktop
Selon les exigences officielles d’importation d’agent externe, l’espace de travail de destination doit déjà être enregistré dans Codex Desktop. Ouvrez d’abord le dossier dans Codex Desktop pour établir la confiance locale et la reconnaissance du projet.
Étape 3 : Préparer le plan d’importation (Prepare)
Dans Watch Desktop, sélectionnez la session source et cliquez sur OpenAI Codex, ou lancez la commande CLI prepare. Cette étape effectue des contrôles en lecture seule, vérifie l’état du verrou et établit un journal d’exécution sans modifier les fichiers cibles.
Étape 4 : Confirmer l’importation et examiner les dégradations (Confirm)
Examinez le nombre de messages prévisualisé, le répertoire de travail et les traces d’appels d’outils. Confirmez explicitement pour lancer le transfert via le protocole d’importation local du app-server Codex. Notez que les événements d’appels d’outils peuvent se dégrader en représentations textuelles.
Étape 5 : Lancer le client cible séparément (Open)
Une fois confirmé, ouvrez Codex Desktop via l’interface de l’application ou la commande de reprise. Importation et ouverture sont strictement séparées : si le lancement échoue, ne réessayez que l’ouverture, sans répéter la phase d’importation.
# 1. Préparer le plan d’importation (sonde en lecture seule et génération du plan)
npm run watch -- import-codex prepare <claude-id> --cwd /abs/project/path --desktop-project --experimental --json
# 2. Confirmer et exécuter l’importation (avec le planId issu de prepare)
npm run watch -- import-codex confirm <plan-id> --json
# 3. Vérifier l’état d’exécution (sonde en lecture seule en cas d’interruption)
npm run watch -- import-codex status <plan-id> --json1. Aucune garantie sans perte : les structures d’appels d’outils se dégradent en texte brut dans Codex, et la poursuite par le modèle est hors du périmètre de validation limité. 2. Arrêt en cas d’état incertain : si le processus est interrompu ou expire, le verrou est conservé. Inspectez avec la commande status plutôt que de supprimer les verrous de force ou de resoumettre. 3. La conversion locale n’est pas entièrement hors ligne : Watch fonctionne sans serveurs externes, mais Codex invoque son propre démon app-server et s’authentifie auprès de son fournisseur de modèle.