Projets et lancements
Chaque dépôt sur lequel vous travaillez est un projet : un dossier sous /work/<project> sur le disque de votre compte, et un nouveau coûte $0. Un clic y met Claude Code, Codex ou OpenCode au travail sur l’abonnement ou la clé API de votre choix, et plusieurs agents tournent côte à côte.

Ce qu’est un projet
Un projet est un dossier sous /work/<project> sur le disque de votre compte, avec un dossier personnel bien à lui que ses terminaux voient sous /home/dev. Le dossier contient votre code, ses lancements et les conversations d’agent qu’ils partagent. Le dossier du projet et son dossier personnel restent tous deux quand les terminaux qui les ont utilisés se terminent.
Un terminal de projet voit son propre projet et son propre dossier personnel. Les connexions, clés git, réglages d’agent et caches qui s’y trouvent n’appartiennent qu’à ce projet, et rien de ce que le code d’un projet dépose dans son dossier personnel ne s’exécute dans un autre. Chaque terminal a son propre Docker et ses paquets système. Un terminal shell accède à tous les projets de son Compute et travaille dans un dossier personnel à lui.
Chaque nouveau projet démarre avec un dossier personnel vierge : connectez-vous une fois à git, à gh et à vos autres outils dans son terminal. Un projet créé avant la séparation des dossiers personnels a déjà vos skills, sous-agents, commandes, règles, styles de sortie et plugins, copiés dans son dossier personnel.
/work/<project> · CLAUDE.md · AGENTS.md · .claude/ · .mcp.json
Créer un projet
- Ouvrez Projets et choisissez Nouveau projet.
- Choisissez d’où vient le code :
- Cloner : collez l’adresse que vous donneriez à
git clone, commegit@github.com:you/app.gitouhttps://…. Le clonage passe par la connexion et les clés git du dossier personnel de vos terminaux shell : les dépôts privés marchent. Connectez-vous une fois dans un terminal shell avecgh auth loginouglab auth login. - Vide : un dossier vide. Laissez En faire un dépôt git coché pour démarrer avec
git init. - Dossier : un dossier dans le
/home/devde vos terminaux shell. Il est copié dans le projet, et le dossier reste où il était.
- Cloner : collez l’adresse que vous donneriez à
- Vérifiez le Nom. Il suit le dépôt ou le dossier jusqu’à ce que vous tapiez le vôtre : jusqu’à 40 lettres latines minuscules, chiffres et tirets. Le nom devient le chemin,
/work/<name>. - Choisissez Créer le projet.
Avec plus d’un Compute, la fenêtre demande aussi sur quel Compute vit le projet. Il y reste : pour y travailler depuis un autre Compute, poussez-le puis clonez-le là-bas.
Le clonage d’un gros dépôt prend quelques minutes, et la page affiche l’avancement. Si la préparation s’arrête, la page du projet dit pourquoi : corrigez l’adresse sur place et choisissez Réessayer pour préparer à nouveau le même projet. Votre premier projet peut aussi démarrer depuis Terminaux juste après le paiement : Bien démarrer montre les trois questions.
Trouver un projet
Projets liste chaque projet avec les agents de ses lancements. À partir de 6 projets, un champ de recherche apparaît en haut : appuyez sur / et tapez une partie d’un nom, d’un agent ou d’un compte.
Ouvrez un projet pour voir Où il vit : le dossier (le bouton à côté copie la commande cd), l’origine du code et la date de création du projet.
Lancer un agent dans un projet
Un lancement, c’est un agent et ce sur quoi il tourne : Claude Code, Codex ou OpenCode, sur un abonnement ou une clé API. Ajoutez un modèle si vous en voulez un autre que celui par défaut ; vide, le champ Modèle affiche le modèle que le lancement reçoit pour cet agent et ce fournisseur. Un lancement sur un abonnement ou une clé connectés dans le tableau de bord peut aussi activer la rotation et Reprendre après la réinitialisation de la limite : une limite ne met alors plus fin au travail.
Choisissez d’abord l’agent, puis sous Tourne sur un compte qu’il peut utiliser : un abonnement Claude pour Claude Code, un abonnement ChatGPT pour Codex, ou une clé API compatible pour n’importe lequel des trois. Agents indique quelle clé fonctionne avec quel agent.

Le premier lancement d’un projet devient son Lancement par défaut : celui qu’un seul clic démarre. Un projet qui n’en a pas affiche Définir le lancement par défaut. Chaque autre combinaison que vous lancez ou enregistrez attend sous Lancements enregistrés ; Nouveau lancement en ajoute une sans la démarrer.
Chaque lancement garde ses propres réglages et sa connexion dans le projet, hors de git. Les conversations de l’agent appartiennent au projet : chaque lancement les retrouve avec claude --resume, codex resume ou opencode --continue, quel que soit le compte qui les a ouvertes : changer de compte ne fait jamais perdre la conversation. Un nouveau terminal ouvre une nouvelle conversation. Redémarrer le terminal sur cette conversation et Reprendre après la réinitialisation de la limite poursuivent celle en cours.
Vos skills, sous-agents, commandes, styles de sortie et règles dans le ~/.claude du projet, et vos skills dans ~/.codex/skills, servent à chaque lancement du projet, quel que soit le compte sur lequel il tourne.
Claude et Codex · Clés API · Rotation
Modifier un lancement
- Lancement par défaut : choisissez Modifier sur sa ligne.
- Lancement enregistré : ouvrez son menu ⋯ et choisissez Modifier ou Mettre par défaut.
Changez l’agent, Tourne sur, le modèle, la rotation et Reprendre après la réinitialisation de la limite, puis choisissez Enregistrer. L’agent et le modèle s’appliquent aux terminaux ouverts ensuite. Les changements de rotation s’appliquent aussi aux terminaux en marche, immédiatement.
Ouvrir un terminal d’un projet
Choisissez Lancer à côté d’un lancement sur la page du projet, ou choisissez Nouveau terminal dans Terminaux et répondez à Projet, Agent et Tourne sur. Une combinaison déjà enregistrée part telle quelle ; une nouvelle est enregistrée au passage comme lancement du projet, prête pour la prochaine fois. La ligne sous le formulaire dit lequel des deux fait Lancer.

Chaque terminal de la liste affiche son projet, son agent et le compte sur lequel il tourne. Une marque de rotation apparaît quand le lancement fait tourner les abonnements.

Ce qui reste pour la prochaine session
Le dossier de votre projet, avec son code, ses lancements et toutes les conversations d’agent, reste sur le disque du compte. Le dossier personnel du projet aussi, /home/dev dans ses terminaux.
Images Docker, cache de compilation, conteneurs, paquets apt et services système appartiennent à ce terminal. Ils sont conservés quand le navigateur se ferme ou que le nœud redémarre, puis supprimés quand vous terminez ou redémarrez le terminal. Gardez les données de vos bases et le reste du travail dans le projet ou son dossier personnel.
Retirer un lancement ou supprimer un projet
- Retirer un lancement : ouvrez son menu ⋯ sur la page du projet et choisissez Retirer, puis Supprimer le lancement. Ses terminaux se terminent, et ses réglages et sa connexion quittent le projet. Le code et les conversations de l’agent servent encore aux autres lancements du projet. Retirez le lancement par défaut, et le plus ancien lancement enregistré prend sa place.
- Supprimer un projet : ouvrez le menu ⋯ du projet, choisissez Supprimer le projet et tapez son nom. Ses terminaux se terminent, ses lancements partent, et le dossier est effacé avec tous ses fichiers et toutes ses conversations d’agent. Poussez d’abord ce que vous voulez garder.
Projets et clés de service
Avec Vault, chaque projet reçoit son propre agent Sallyport, nommé detachbox · <project>. detachbox le crée pour vous, et tout ce qui tourne dans le projet le partage. Vous décidez dans Sallyport ce que chaque projet peut appeler ; son laissez-passer vit dans le dossier .detachbox du projet.