Une tâche Codex se comporte différemment sur notre portable et sur le VPS. Le dépôt est identique, mais l’agent démarre dans un autre répertoire et hérite de consignes différentes au niveau du compte. Répéter la demande ne corrige pas l’environnement.
Nous traitons Codex AGENTS.md comme des consignes d’exploitation versionnées, pas comme une mémoire magique. Voici comment rendre leur portée reproductible avant une tâche distante sans surveillance. Il s’agit d’une procédure manuelle Codex, pas d’une nouvelle fonction de configuration d’Office Claws.
Codex AGENTS.md : ce que charge l’exécuteur
Le guide officiel décrit une chaîne construite au début de chaque exécution. Le répertoire de départ compte : un fichier présent quelque part dans le dépôt n’entre pas forcément dans la chaîne initiale.
| Couche | Découverte | Conséquence opérationnelle |
|---|---|---|
| Répertoire personnel Codex | AGENTS.override.md, sinon AGENTS.md ; premier fichier non vide | Le compte du VPS peut ajouter des règles absentes du portable |
| Racine du projet jusqu’au répertoire de travail | Un fichier par répertoire : remplacement, normal, puis noms alternatifs configurés | Démarrer dans un service charge une autre chaîne que depuis la racine |
| Consignes combinées | De la racine vers le bas ; les plus proches prévalent | Une exception locale peut modifier une règle générale |
La limite par défaut des documents de projet combinés est de 32 KiB. Restons concis et vérifions project_doc_max_bytes en cas de troncature. Un fichier de remplacement remplace le fichier normal dans le même répertoire, sans effacer toutes les couches précédentes. Le répertoire personnel par défaut est ~/.codex, mais CODEX_HOME peut le modifier.
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 | sh4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau
Rédiger un contrat de travail, pas un manuel du dépôt
Nous plaçons les règles communes stables à la racine et les commandes spécialisées près du service concerné. Inutile de copier tout le wiki d’architecture dans le contexte : citons plutôt le document pertinent et la décision qu’il éclaire.
Pour un dépôt dont la commande de test est réellement npm test, voici un petit modèle de fichier racine. Adaptez les commandes au projet avant de le versionner. Cet exemple ne donne aucune permission et n’installe aucune automatisation.
# AGENTS.md
## Scope
- Work only on the assigned branch and requested change.
- Read docs/development.md before changing build configuration.
## Verification
- Run npm test after code changes; report the command and result.
- If a check cannot run, report the blocker instead of claiming success.
## Review boundary
- Do not deploy, publish packages, or rotate credentials.
- Flag authentication and migration changes for human review.Versionnons les consignes comme le code. Passer de « proposer une migration » à « appliquer la migration » mérite une revue même sans modification du code applicatif. Excluons jetons, mots de passe et données privées : ces consignes sont transmises au modèle et ne constituent pas un coffre-fort.
Vérifier la même portée via SSH
Sur le VPS, utilisons le même compte Unix, la même copie du dépôt, le même répertoire et le même profil Codex que pour la tâche réelle. Une session administrateur ne prouve rien sur la configuration d’un compte de service. Notre guide SSH explique la connexion.
Lancez cette vérification en lecture seule depuis la racine du dépôt de confiance. Remplacez le chemin par le vôtre. Elle énumère des fichiers candidats sans prouver qu’ils sont tous chargés ; comparez la liste aux règles ci-dessus et à la réponse de l’agent. La dernière commande sollicite le modèle et peut consommer le quota du forfait.
cd ~/work/product-api
pwd
git rev-parse HEAD
codex --version
printf 'CODEX_HOME=%s\n' "${CODEX_HOME:-$HOME/.codex}"
find . -type d -name .git -prune -o -type f \
\( -name AGENTS.md -o -name AGENTS.override.md \) -print
codex exec --sandbox read-only \
"Do not edit files or execute project commands. List the instruction sources you loaded and summarize the verification and review boundaries."Inspectez séparément les fichiers du compte sans recopier leur contenu dans des journaux partagés. Vérifiez aussi les noms alternatifs configurés : find ne recherche ici que les deux noms standards. Le résumé du modèle est un test de cohérence, pas un audit formel ni une garantie de sécurité.
Si la tâche concerne un service imbriqué, répétez la vérification depuis son répertoire. Après modification des fichiers, démarrez une nouvelle exécution : la chaîne documentée est construite une fois par exécution, sans rechargement automatique dans une session existante.
Séparer les consignes des contrôles effectifs
La phrase « ne pas déployer » dans AGENTS.md ne contrôle pas les accès. Restreignons séparément les identifiants et les outils, avec des réglages de bac à sable et d’approbation adaptés. Un exécuteur nocturne ne devrait pas recevoir les accès de production simplement parce que ses consignes interdisent de s’en servir.
Avant une tâche sans surveillance, nous enregistrons le commit, la version Codex, le répertoire et la révision des consignes. Avec des agents parallèles, vérifions chaque copie plutôt que de supposer qu’une modification locale s’est propagée. En cas de divergence, contrôlons d’abord le répertoire personnel, CODEX_HOME, les remplacements, les noms alternatifs et le répertoire de départ.
Office Claws exécute des agents Codex sur votre propre Contabo VPS avec une interface CLI et un bureau pixel art. L’entretien des consignes et la revue des résultats restent à votre charge. Office Claws commence à $4.99/mois pour le premier agent ; le VPS et le forfait ChatGPT compatible sont séparés et les limites d’utilisation restent applicables. Consultez les coûts d’abonnement Codex.
Notre recommandation : versionner un contrat bref, le vérifier avec le compte réel de l’exécuteur et conserver une validation humaine. Une machine toujours disponible doit rendre la procédure reproductible, pas transformer un texte en frontière de permissions.