detachbox
PagesChoisir et configurer votre agent

Choisir et configurer votre agent

Ouvrez un terminal : Claude Code, Codex et OpenCode sont installés, les demandes d’autorisation sont coupées et les instructions de votre projet sont en place. Choisissez l’agent et un abonnement connecté ou une clé API de l’un des sept fournisseurs, puis confiez-lui la tâche.

Choisir l’agent

Ouvrez Terminaux, choisissez Nouveau terminal et le projet, puis l’Agent : Claude Code, Codex ou OpenCode. Choisissez ensuite le compte sous Tourne sur ; la liste ne propose que les comptes que cet agent peut utiliser.

AgentComment il se connecte
Claude CodeVotre abonnement Claude, une clé API compatible ou votre propre connexion dans le terminal
CodexVotre abonnement ChatGPT, une clé API compatible ou votre propre connexion dans le terminal
OpenCodeUne clé API compatible ou votre propre connexion dans le terminal

La connexion dans le terminal marche tant que vous n’avez pas de compte par défaut pour cet agent : sous Tourne sur, choisissez l’option où l’agent se connecte dans le terminal. L’agent vous demande de vous connecter comme sur votre portable, et la connexion reste dans le dossier personnel de ce projet, hors de vue de vos autres projets.

Les clés compatibles avec chaque agent :

  • Claude Code : Anthropic, DeepSeek, Z.ai, abliteration.ai.
  • Codex : OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai.
  • OpenCode : Anthropic, OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai, Gemini.

Clés API montre comment les ajouter, les renommer et les remplacer.

Le lancement par défaut d’api : Claude Code sur l’un de trois abonnements Claude, avec une clé DeepSeek et une clé Z.ai aussi proposées, un modèle facultatif, et la rotation entre les abonnements Claude quand les limites s’épuisent.

Ce que contient votre Compute

Chaque terminal tourne sous Ubuntu 26.04 LTS, avec sudo, Docker Engine et compose, et ces outils :

  • Agents : Claude Code, Codex et OpenCode.
  • Langages : Node 26, Python 3.14, Bun, uv, mise, pnpm, Yarn et pipx, avec gcc et make issus de build-essential.
  • Outils : git, gh, glab, ripgrep, fd, fzf, jq, yq, bat, delta, git-lfs, httpie, tmux, tree, ncdu, htop, btop, rsync, strace, lsof, netcat, dig, ping, socat, zip, vim et nano.
  • Bases de données : psql, redis-cli, sqlite3 et le client MariaDB.
  • Navigateurs : Playwright avec Chromium headless, lié dans le cache Playwright de chaque dossier personnel, et chrome-headless-shell avec CHROME_PATH défini.

Go, Rust, Java et Ruby sont à une commande : mise use -g go@latest, mise use -g rust, et ainsi de suite.

Docker et tout ce qu’il fait tourner passent après le shell, tmux et l’agent pour le CPU et le disque : un gros build laisse l’agent et votre saisie réactifs. Chaque conteneur tourne sous l’init de Docker, qui récupère les processus terminés.

Garder vos propres outils

Un paquet système installé avec sudo vit dans son terminal : il disparaît quand vous terminez ou redémarrez celui-ci. Pour garder un outil, installez-le dans le dossier personnel, qui appartient au projet :

  • mise use -g kubectl helm opentofu aws-cli y place ces CLI cloud.
  • npm i -g <package> atterrit dans ~/.npm-global, déjà dans votre PATH.
  • Un binaire déposé dans ~/.local/bin tourne dans chaque terminal du projet.

Go compile avec -trimpath dans chaque dossier personnel : son cache de build garde une seule copie de chaque paquet au lieu d’une par chemin de worktree d’agent. Les tests qui trouvent des fichiers à côté d’eux via runtime.Caller ont besoin qu’il soit coupé : lancez go env -w GOFLAGS= dans le terminal du projet, ou définissez GOFLAGS dans l’environnement.

Des agents frais, testés d’abord

Nous reconstruisons l’image de base toutes les 6 heures, avec les mises à jour système et les derniers Claude Code, Codex et OpenCode, et nous la vérifions avant qu’un terminal ne l’utilise. Les terminaux nouveaux ou redémarrés prennent la dernière image vérifiée ; un terminal en marche garde la sienne.

Les agents ne se mettent jamais à jour en cours de route : la version d’un terminal est celle que nous avons testée. Pour passer un terminal sur les agents les plus récents, redémarrez-le.

Les demandes d’autorisation sont coupées

AgentMode
Claude CodebypassPermissions
CodexPolitique d’approbation never, accès complet
OpenCodePermission allow

Les écrans du premier lancement et les questions de confiance sur les dossiers sont déjà passés, dossier du projet compris. Ouvrez un terminal : l’agent est prêt pour une tâche.

Les instructions de votre projet, et les nôtres

Chaque agent démarre dans /work/<project> : le CLAUDE.md, l’AGENTS.md, les skills, hooks et réglages .claude/ du projet, et son .mcp.json, marchent comme sur votre portable.

Demandez à n’importe quel agent de retenir quelque chose pour le projet : il l’écrit dans AGENTS.md, à la racine du projet. Claude Code, Codex et OpenCode lisent tous ce fichier, Claude Code même à côté d’un CLAUDE.md.

En plus, chaque agent lit /etc/detachbox/AGENTS.md, un court fichier à nous. Il explique comment fonctionnent les URL d’aperçu, pour que les agents vous donnent le lien dès qu’un serveur tourne. Il est lié dans ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md et ~/.config/opencode/AGENTS.md, ainsi que dans le dossier de réglages que chaque lancement garde dans le projet.

Votre propre fichier à l’un de ces emplacements reste le vôtre : detachbox n’y ajoute qu’une référence au nôtre.

Ouvrir une page dans votre navigateur avec detachbox-open

detachbox-open <url> ouvre un lien http ou https dans le navigateur de la personne devant le terminal. xdg-open, open, sensible-browser, www-browser, x-www-browser et $BROWSER pointent tous vers lui : les connexions lancées par gh, par le webbrowser de Python ou par un agent arrivent dans votre navigateur.

Un lien vers le localhost:<port> de votre Compute devient son URL d’aperçu. Les autres schémas, comme file:, sont refusés. Si aucun navigateur n’est sur le terminal à ce moment-là, la commande affiche le lien pour que vous l’ouvriez. Le terminal du navigateur montre ce que fait le tableau de bord quand une page arrive.

Obtenir un lien d’aperçu avec detachbox-preview

detachbox-preview <port> [path] affiche l’adresse à laquelle votre navigateur ouvre le serveur de ce port, comme https://3000-<terminal ID>.detachbox.dev/admin. Il prévient quand le serveur n’écoute que sur localhost ou que rien n’écoute encore sur le port. Les agents s’en servent pour vous donner le lien.

Donner un prompt à un agent avec detachbox-say

detachbox-say <tmux session> <text> transmet un texte à l’agent de ce terminal sous forme de nouveau prompt. Il passe par le mécanisme de l’agent lui-même, jamais par des frappes clavier : une ligne que vous êtes en train de taper reste intacte. Il fonctionne avec Claude Code et Codex.

Le serveur s’en sert pour taper « continue » quand une limite se réinitialise. Le code de sortie 3 signifie que le terminal n’a aucun Claude Code ni Codex en marche à qui transmettre le texte, et 4 que l’agent n’a pas pris le texte ; dans les deux cas, le serveur le tape dans le terminal à la place.