detachbox
PagesDémarrer votre première box

Démarrer votre première box

Une box detachbox est une box Linux toujours allumée, avec Docker, conçue pour les agents de code en CLI. Vous choisissez une taille, vous payez, et l’installation démarre dès que le paiement arrive. Votre agent tourne dans un onglet tmux sur la box : fermer le navigateur n’arrête rien.

Créer votre compte

  1. Ouvrez my.detachbox.com.
  2. Choisissez Continuer avec Google, ou saisissez votre e-mail et choisissez Continuer avec l’e-mail.
  3. Pour une nouvelle adresse, définissez un mot de passe d’au moins 8 caractères et choisissez Créer le compte.
  4. Saisissez le code à 6 chiffres reçu par e-mail et choisissez Confirmer l’e-mail.

Plus tard, ajoutez une clé d’accès ou une application d’authentification dans Paramètres. La même page liste vos appareils connectés et propose Déconnecter les autres appareils.

Créer votre box

  1. Choisissez Créer une box. La taille, l’agent et le nom sont déjà remplis : un clic suffit.
  2. Sous 1. Taille, choisissez une offre. Start, Pro et Max sont les tailles personnelles. Business et Business Plus se trouvent sous Pour les équipes. Le tableau des offres les compare.
  3. Sous 2. Agent, choisissez ce que Chaque onglet lance : Claude Code, Codex, OpenCode, Gemini CLI, une surcouche de Claude Code pour Z.ai ou DeepSeek, ou un simple shell.
  4. Sous 3. Nom, gardez le nom proposé ou saisissez le vôtre. Il devient votre identifiant SSH. Utilisez de 3 à 32 lettres latines minuscules, chiffres et tirets. La page vérifie le nom pendant la saisie.
  5. Vous avez un code promo ? Ouvrez Vous avez un code ? et choisissez Appliquer.
  6. Choisissez Créer la box pour $19 / mois. Le prix sur le bouton suit votre offre. Stripe Checkout s’ouvre.
  7. Payez. De retour dans le tableau de bord, la page de la box affiche l’installation et se met à jour toute seule.
Créer une box : Start, Pro et Max avec leur prix, CPU, mémoire, disque et réseau, puis Business et Business Plus avec snapshots, et Enterprise.

Stripe débite le premier mois tout de suite. Il n’y a ni offre gratuite ni essai. Un paiement laissé en plan expire au bout de 60 minutes, et la box non payée part avec lui.

Ouvrir votre premier onglet de terminal

  1. Sur la page de la box, choisissez Ouvrir le terminal.
  2. Le premier onglet s’ouvre tout seul et lance l’agent que vous avez choisi.
  3. Choisissez le bouton + à côté des onglets pour en ouvrir un autre. Une box accueille jusqu’à 10 onglets.

Chaque onglet est une session tmux sur la box. Le guide du terminal couvre les raccourcis, le collage, les images, les liens vers les fichiers et le reste.

Connecter un abonnement Codex ou Claude

Claude Code et Codex tournent sur les abonnements que vous payez déjà. Connectez chacun une fois et liez-le à une box :

  1. Ouvrez Comptes et choisissez Connecter Codex ou Connecter Claude. Suivez les étapes de la fenêtre.
  2. Ouvrez la box. Dans Vue d’ensemble, trouvez le panneau Agent et choisissez le compte.
  3. Relancez l’agent dans les onglets déjà ouverts. Un agent en cours garde son ancienne connexion.

La box connecte ensuite la CLI d’elle-même. Aucune connexion dans la box, aucun auth.json à copier. Les limites, les réinitialisations et les comptes déconnectés sont traités dans Abonnements.

Vous pouvez aussi vous passer du tableau de bord et vous connecter dans la box. Choisissez Non lié dans le panneau Agent et suivez la connexion propre à la CLI dans un onglet. OpenCode et Gemini CLI se connectent toujours ainsi. Les surcouches Z.ai et DeepSeek tournent sur votre propre clé d’API, comme l’explique Agents.

Fermer l’onglet et revenir

Confiez une tâche à l’agent et fermez le navigateur. tmux garde la session, et l’agent continue de travailler sur la box.

Revenez comme il vous plaît :

  • Ouvrez la box dans le tableau de bord, depuis n’importe quel navigateur ou téléphone. Vos onglets sont là où vous les avez laissés, historique compris.
  • Ouvrez Terminaux pour voir chaque agent de chaque box, ceux qui vous attendent en tête.
  • Connectez-vous en SSH avec ssh <name>@ssh.detachbox.com. Lancez tmux ls pour lister les sessions des onglets et tmux attach -t <session> pour en rejoindre une.

SSH demande d’abord une clé sur votre compte. SSH montre comment en ajouter une ou importer les vôtres depuis GitHub.

Être prévenu quand l’agent a besoin de vous

Activez les notifications pour qu’un agent bloqué ou qui a terminé vous joigne. Les notifications arrivent dans votre navigateur ou sur votre téléphone, sur Telegram ou par e-mail. Réglez-les dans Notifications. Notifications présente chaque canal et explique comment répondre à un agent depuis la notification elle-même.

Et ensuite