detachbox
PagesProjets et lancements

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. Un clic y lance Claude Code, Codex ou OpenCode, chacun sur son propre abonnement, plusieurs côte à côte.

Projets sur shipyard : api, storefront, etl-pipeline et landing, chacun avec les agents qui tournent dessus.

Ce qu’est un projet

Un projet est un dossier sous /work/<project> sur le disque de votre compte, à côté de votre dossier personnel /home/dev. Il contient votre code, ses lancements et les sessions d’agent qu’ils partagent tous, et il reste quand les terminaux qui l’ont utilisé se terminent.

Un terminal de projet voit son projet et votre dossier personnel partagé. Chaque terminal a son propre Docker et ses paquets système. Un terminal Shell accède à tous vos projets.

/work/<project> · CLAUDE.md · AGENTS.md · .claude/ · .mcp.json

Créer un projet

  1. Ouvrez Projets et choisissez Nouveau projet.
  2. Choisissez d’où vient le code :
    • Cloner : collez l’adresse que vous donneriez à git clone, comme git@github.com:you/app.git ou https://…. Le clonage passe par vos clés git sur votre Compute : les dépôts privés marchent.
    • Vide : un dossier vide. Laissez En faire un dépôt git coché pour démarrer avec git init.
    • Dossier : un dossier dans /home/dev sur votre Compute. Il est copié dans le projet, et le dossier reste où il était.
  3. 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>.
  4. Choisissez Créer le projet.

Le clonage d’un gros dépôt prend quelques minutes, et la page suit le mouvement. Votre premier projet peut aussi démarrer depuis Terminaux juste après le paiement : Bien démarrer montre les trois questions.

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 de l’agent et, pour Claude Code et Codex, la rotation et Reprendre après la réinitialisation de la limite.

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.

Un lancement sur api : Claude Code qui tourne sur l’un de trois comptes Claude et deux clés API, un modèle facultatif, et la rotation vers l’abonnement qui a le plus de marge quand les limites s’épuisent.

Le premier lancement d’un projet devient son Lancement par défaut : celui qu’un seul clic démarre. Chaque autre combinaison que vous lancez ou enregistrez attend sous Lancements enregistrés : lancez-la, modifiez-la, retirez-la ou mettez-la par défaut.

Chaque lancement garde ses propres réglages et sa connexion dans le projet, hors de git. Les sessions de l’agent appartiennent au projet : tous ses lancements les voient dans claude --resume ou codex resume, et un nouveau lancement reprend la plus récente, quel que soit le compte qui l’a ouverte.

Claude / Codex · API · Rotation

Ouvrir un nouveau terminal

Choisissez Nouveau terminal dans Terminaux et remplissez trois champs : Projet, Agent et Tourne sur. Choisissez Lancer. 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.

Nouveau projet… dans la liste des projets amène du code, et Shell ouvre un simple shell de connexion qui n’a besoin d’aucun lancement. Chaque choix démarre un environnement neuf ; choisissez un terminal en marche dans la liste pour y revenir.

Nouveau terminal sur shipyard : choisissez le projet, l’agent et ce sur quoi il tourne, puis Lancer ; ou ouvrez un simple Shell.

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

Le projet api : Claude Code avec rotation comme lancement par défaut, à un clic, et Codex review sur son propre compte parmi les lancements enregistrés.

Ce qui reste pour la prochaine session

Le dossier de votre projet, avec son code, ses lancements et chaque session d’agent, reste sur le disque du compte, tout comme le contenu de /home/dev.

Images Docker, cache de compilation, conteneurs, paquets apt et services système appartiennent à ce terminal. Ils tournent après la fermeture du navigateur et sont supprimés quand vous terminez le terminal. Gardez les données et votre travail dans le projet ou le dossier personnel.

Retirer un lancement ou supprimer un projet

  • Retirer un lancement : ouvrez son menu ⋯ sur la page du projet et choisissez Retirer. Ses onglets se ferment, et ses réglages et sa connexion quittent le projet. Le code et les sessions de l’agent restent pour les autres lancements du projet.
  • Supprimer un projet : ouvrez le menu ⋯ du projet, choisissez Supprimer le projet et tapez son nom. Ses onglets se ferment, ses lancements partent, et le dossier est effacé avec tous ses fichiers et toutes ses sessions 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>, créé pour vous et partagé par tout ce qui tourne dans le projet. Vous décidez dans Sallyport ce que chaque projet peut appeler, et son laissez-passer vit dans le dossier .detachbox du projet.