detachbox
SeitenAgent wählen und einrichten

Agent wählen und einrichten

Öffne ein Terminal, und Claude Code, Codex und OpenCode sind installiert, fragen nicht um Erlaubnis und kennen die Anweisungen deines Projekts. Wähl den Agenten und ein verbundenes Abo oder einen API-Key von einem von sieben Anbietern und gib ihm die Aufgabe.

Den Agenten wählen

Öffne Terminals, wähl Neues Terminal und das Projekt, dann den Agent: Claude Code, Codex oder OpenCode. Wähl dann das Konto unter Läuft mit; die Liste bietet nur Konten an, die dieser Agent nutzen kann.

AgentWie er sich anmeldet
Claude CodeDein Claude-Abo oder ein passender API-Key; anmelden im Terminal geht auch
CodexDein ChatGPT-Abo oder ein passender API-Key; anmelden im Terminal geht auch
OpenCodeEin passender API-Key oder deine eigene Anmeldung im Terminal

Im Terminal anmelden kannst du dich, solange du für diesen Agenten kein Standardkonto hast: Wähl unter Läuft mit die Option, bei der sich der Agent im Terminal anmeldet. Der Agent fragt nach der Anmeldung wie auf deinem Laptop, und das Login landet im Home-Ordner dieses Projekts, wo deine anderen Projekte es nicht sehen.

Die Keys, die jeder Agent nimmt:

  • 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.

API-Keys zeigt, wie du sie hinzufügst, umbenennst und ersetzt.

Die Standard-Startvorlage von api: Claude Code auf einem von drei Claude-Abos, dazu ein DeepSeek- und ein Z.ai-Schlüssel zur Auswahl, ein optionales Modell und Rotation zwischen den Claude-Abos, wenn Limits aufgebraucht sind.

Was dein Compute mitbringt

In jedem Terminal läuft Ubuntu 26.04 LTS mit sudo und Docker Engine samt compose. Außerdem sind diese Tools bereits installiert:

  • Agenten: Claude Code, Codex und OpenCode.
  • Sprachen: Node 26, Python 3.14, Bun, uv, mise, pnpm, Yarn und pipx, dazu gcc und make aus build-essential.
  • Tools: 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 und nano.
  • Datenbanken: psql, redis-cli, sqlite3 und der MariaDB-Client.
  • Browser: Playwright mit Headless Chromium, verlinkt in den Playwright-Cache jedes Home-Ordners, und chrome-headless-shell mit gesetztem CHROME_PATH.

Go, Rust, Java und Ruby installierst du mit einem Befehl: mise use -g go@latest, mise use -g rust und so weiter.

Docker und seine Container haben bei CPU und Disk eine niedrigere Priorität als Shell, tmux und Agent. So bleiben der Agent und deine Eingaben auch bei einem schweren Build flott. Jeder Container läuft unter Dockers init, das beendete Prozesse einsammelt.

Deine eigenen Tools behalten

Ein Systempaket, das du mit sudo installierst, gibt es nur in diesem Terminal: Endet das Terminal oder startet es neu, ist das Paket weg. Ein Tool, das bleiben soll, gehört in den Home-Ordner, und der gehört zum Projekt:

  • mise use -g kubectl helm opentofu aws-cli legt diese Cloud-CLIs dort ab.
  • npm i -g <package> landet in ~/.npm-global, das schon in deinem PATH liegt.
  • Ein Binary, das du nach ~/.local/bin legst, läuft in jedem Terminal des Projekts.

Go baut in jedem Home-Ordner mit -trimpath, deshalb hält sein Build-Cache jedes Paket nur einmal statt einmal pro Worktree-Pfad eines Agenten. Findet ein Test Dateien neben sich über runtime.Caller, schalte die Einstellung ab: Führ go env -w GOFLAGS= im Terminal des Projekts aus oder setz GOFLAGS in der Umgebung.

Frische Agenten, vorher getestet

Alle 6 Stunden bauen wir das Basis-Image neu, mit Systemupdates und den neuesten Versionen von Claude Code, Codex und OpenCode, und prüfen es, bevor ein Terminal es bekommt. Neue und neu gestartete Terminals nutzen das letzte geprüfte Image; ein laufendes Terminal behält seins.

Die Agenten aktualisieren sich nie mitten im Lauf selbst: Die Version in einem Terminal ist die, die wir getestet haben. Um ein Terminal auf die neuesten Agenten zu bringen, starte es neu.

Ohne Rückfragen

AgentModus
Claude CodebypassPermissions
CodexApproval-Policy never, voller Zugriff
OpenCodeBerechtigung allow

Die Ersteinrichtung und die Frage, ob du einem Ordner vertraust, sind schon beantwortet, auch für den Projektordner. Öffne ein Terminal, und der Agent wartet auf seine Aufgabe.

Die Anweisungen deines Projekts und unsere

Jeder Agent startet in /work/<project>. Deshalb funktionieren CLAUDE.md, AGENTS.md, die Skills, Hooks und Einstellungen in .claude/ und die .mcp.json des Projekts genau wie auf deinem Laptop.

Sag einem Agenten, er soll sich etwas für das Projekt merken, und es landet in AGENTS.md im Projektstamm. Claude Code, Codex und OpenCode lesen diese Datei alle, Claude Code auch neben einer CLAUDE.md.

Dazu liest jeder Agent /etc/detachbox/AGENTS.md, eine kurze Datei von uns. Sie erklärt, wie Preview-URLs funktionieren, damit Agenten dir den Link geben, sobald ein Server läuft. Sie ist in ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md und ~/.config/opencode/AGENTS.md verlinkt und in den Einstellungsordner, den jede Startvorlage im Projekt hat.

Deine eigene Datei an einer dieser Stellen bleibt deine: detachbox fügt nur einen Verweis auf unsere hinzu.

Eine Seite im Browser öffnen mit detachbox-open

detachbox-open <url> öffnet einen http- oder https-Link im Browser der Person am Terminal. xdg-open, open, sensible-browser, www-browser, x-www-browser und $BROWSER zeigen alle darauf, also landen Anmeldungen, die gh, Pythons webbrowser oder ein Agent startet, in deinem Browser.

Ein Link auf localhost:<port> deines Compute selbst wird zu seiner Preview-URL. Andere Schemata wie file: lehnt es ab. Ist in dem Moment kein Browser mit dem Terminal verbunden, gibt es den Link aus, damit du ihn selbst öffnest. Das Browser-Terminal zeigt, was das Dashboard tut, wenn eine Seite ankommt.

detachbox-preview <port> [path] gibt die Adresse aus, unter der ein Server auf diesem Port in deinem Browser erreichbar ist, etwa https://3000-<terminal ID>.detachbox.dev/admin. Es warnt, wenn der Server nur auf localhost lauscht oder auf dem Port noch nichts lauscht. Agenten nutzen es, um dir den Link zu geben.

Einem Agenten einen Prompt geben mit detachbox-say

detachbox-say <tmux session> <text> liefert Text als neuen Prompt an den Agenten in diesem Terminal. Es nutzt den eigenen Zustellweg des Agenten, nie Tastendrücke, also bleibt eine Zeile, die du gerade tippst, unversehrt. Es funktioniert mit Claude Code und Codex.

Der Server nutzt es, um „continue“ zu tippen, wenn ein Limit zurückgesetzt wird. Exit-Code 3 heißt, dass im Terminal kein Claude Code oder Codex als Empfänger läuft, und 4, dass der Agent den Text nicht angenommen hat; in beiden Fällen tippt der Server ihn stattdessen ins Terminal.