detachbox
SeitenProjekte und Startvorlagen

Projekte und Startvorlagen

Jedes Repository, an dem du arbeitest, ist ein Projekt: ein Ordner unter /work/<project> auf deiner Konto-Disk, und ein neues kostet $0. Ein Klick setzt Claude Code, Codex oder OpenCode darin an die Arbeit, auf dem Abo oder API-Key deiner Wahl, und mehrere Agenten laufen nebeneinander.

Projekte auf shipyard: api, storefront, etl-pipeline und landing, jedes mit den Agenten, die darauf laufen.

Was ein Projekt ist

Ein Projekt ist ein Ordner unter /work/<project> auf deiner Konto-Disk, mit einem eigenen Home-Ordner, den seine Terminals unter /home/dev sehen. Der Ordner enthält deinen Code, seine Startvorlagen und die Unterhaltungen der Agenten, die sie teilen. Projektordner und Home-Ordner bleiben beide, wenn die Terminals enden, die sie benutzt haben.

Ein Projekt-Terminal sieht sein Projekt und seinen eigenen Home-Ordner. Logins, git-Schlüssel, Agent-Einstellungen und Caches darin gehören nur diesem Projekt, und nichts, was der Code eines Projekts in sein Home legt, läuft in einem anderen. Jedes Terminal hat eine eigene Docker-Installation und eigene Systempakete. Ein Shell-Terminal sieht alle Projekte seines Compute und arbeitet in einem eigenen Home-Ordner.

Jedes neue Projekt startet mit einem leeren Home-Ordner: Meld dich einmal in seinem Terminal bei git, gh und deinen anderen Tools an. Ein Projekt aus der Zeit vor den getrennten Home-Ordnern hat deine Skills, Subagents, Commands, Rules, Output-Styles und Plugins schon in sein Home kopiert bekommen.

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

Ein Projekt anlegen

  1. Öffne Projekte und wähl Neues Projekt.
  2. Wähl, woher der Code kommt:
    • Klonen: Füg die Adresse ein, die du git clone gibst, etwa git@github.com:you/app.git oder https://…. detachbox klont mit der git-Anmeldung und den Schlüsseln im Home-Ordner deiner Shell, also funktionieren private Repositorys: Melde dich einmal in einem Shell-Terminal mit gh auth login oder glab auth login an.
    • Leer: ein leerer Ordner. Lass Als git-Repository anlegen angehakt, um mit git init zu starten.
    • Ordner: ein Ordner in /home/dev deiner Shell-Terminals. Er wird ins Projekt kopiert und bleibt, wo er war.
  3. Prüf das Feld Name. Der vorgeschlagene Name richtet sich nach dem Repository oder Ordner, bis du einen eigenen eingibst: bis zu 40 lateinische Kleinbuchstaben, Ziffern und Bindestriche. Der Name wird zum Pfad, /work/<name>.
  4. Wähl Projekt anlegen.

Hast du mehr als ein Compute, fragt der Dialog auch, auf welchem das Projekt lebt. Dort bleibt es: Willst du auf einem anderen Compute daran arbeiten, push es und klon es dort.

Ein großes Repository zu klonen dauert ein paar Minuten, und die Seite zeigt den Fortschritt. Bleibt die Einrichtung stehen, sagt die Projektseite warum: Korrigier die Adresse direkt dort und wähl Erneut versuchen, um dasselbe Projekt neu einzurichten. Dein erstes Projekt kann auch direkt nach dem Checkout unter Terminals starten: Loslegen zeigt die drei Fragen.

Ein Projekt finden

Projekte listet jedes Projekt mit den Agenten seiner Startvorlagen. Ab 6 Projekten steht oben ein Suchfeld: Drück / und tipp einen Teil eines Namens, eines Agenten oder eines Kontos.

Öffne ein Projekt, und Wo es liegt zeigt den Ordner (der Button daneben kopiert den cd-Befehl), woher der Code kam und wann das Projekt angelegt wurde.

Einen Agenten im Projekt starten

Eine Startvorlage ist ein Agent und das, womit er läuft: Claude Code, Codex oder OpenCode, auf einem Abo oder einem API-Key. Dazu kommt ein Modell, wenn du ein anderes als den Standard willst; das leere Feld Modell nennt das Modell, das die Startvorlage für diesen Agenten und Anbieter bekommt. Eine Startvorlage auf einem im Dashboard verbundenen Abo oder Key kann außerdem Rotation und Nach dem Limit-Reset weitermachen einschalten, und dann beendet ein Limit den Lauf nicht mehr.

Wähl zuerst den Agenten, dann unter Läuft mit ein Konto, das er nutzen kann: ein Claude-Abo für Claude Code, ein ChatGPT-Abo für Codex oder einen passenden API-Key für jeden der drei. Agenten listet, welcher Key mit welchem Agenten funktioniert.

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.

Die erste Startvorlage in einem Projekt wird seine Standard-Startvorlage: die, die ein einziger Klick ausführt. Ein Projekt ohne sie zeigt Standard-Startvorlage festlegen. Jede andere Kombination, die du startest oder speicherst, wartet unter Gespeicherte Startvorlagen; Neue Startvorlage legt dort eine an, ohne sie zu starten.

Jede Startvorlage hat ihre eigenen Einstellungen und ihre Anmeldung im Projekt, außerhalb von git. Die Unterhaltungen des Agenten gehören dem Projekt: Jede Startvorlage findet sie mit claude --resume, codex resume oder opencode --continue, egal mit welchem Konto sie begonnen wurden, also geht beim Kontowechsel nie eine Unterhaltung verloren. Ein neues Terminal beginnt eine neue Unterhaltung. Terminal in dieser Unterhaltung neu starten und Nach dem Limit-Reset weitermachen führen die laufende fort.

Deine Skills, Subagents, Commands, Output-Styles und Rules im ~/.claude des Projekts und deine Skills in ~/.codex/skills erreichen jede Startvorlage des Projekts, egal mit welchem Konto sie läuft.

Claude und Codex · API-Keys · Rotation

Eine Startvorlage bearbeiten

  • Standard-Startvorlage: Wähl Bearbeiten in ihrer Zeile.
  • Gespeicherte Startvorlage: Öffne ihr Menü ⋯ und wähl Bearbeiten oder Als Standard setzen.

Ändere den Agenten, Läuft mit, das Modell, die Rotation und Nach dem Limit-Reset weitermachen und wähl dann Speichern. Agent und Modell gelten für Terminals, die du ab dann öffnest. Die Rotation gilt sofort auch für die laufenden.

Ein Terminal eines Projekts öffnen

Wähl Starten neben einer Startvorlage auf der Projektseite, oder wähl Neues Terminal unter Terminals und beantworte Projekt, Agent und Läuft mit. Eine Kombination, die du schon gespeichert hast, läuft so, wie sie ist; eine neue wird dabei als Startvorlage des Projekts gespeichert, bereit fürs nächste Mal. Die Zeile unter dem Formular sagt, was von beidem Starten tut.

Neues Terminal auf shipyard: Projekt, Agent und womit er läuft wählen, dann Starten; oder eine normale Shell öffnen.

Jedes Terminal in der Liste zeigt sein Projekt, seinen Agenten und das Konto, mit dem er läuft. Ein Rotationszeichen steht dabei, wenn seine Startvorlage Abos durchwechselt.

Das Projekt api: Claude Code mit Rotation als Standard-Startvorlage, mit einem Klick startbar, und Codex review auf eigenem Konto unter den gespeicherten Startvorlagen.

Was für den nächsten Lauf bleibt

Dein Projektordner mit seinem Code, seinen Startvorlagen und allen Unterhaltungen der Agenten bleibt auf der Konto-Disk. Genauso der Home-Ordner des Projekts, /home/dev in seinen Terminals.

Docker-Images, Build-Cache, Container, apt-Pakete und Systemdienste gehören zu diesem Terminal. Sie überstehen einen geschlossenen Browser und einen Neustart des Nodes und verschwinden, wenn du das Terminal beendest oder neu startest. Speichere Datenbanken und andere Arbeit im Projekt oder in seinem Home-Ordner.

Eine Startvorlage entfernen oder ein Projekt löschen

  • Startvorlage entfernen: Öffne ihr Menü ⋯ auf der Projektseite, wähl Entfernen und dann Startvorlage entfernen. Ihre Terminals enden, und ihre Einstellungen und ihre Anmeldung werden aus dem Projekt entfernt. Code und Unterhaltungen des Agenten bleiben für die anderen Startvorlagen des Projekts. Entfernst du die Standard-Startvorlage, wird die älteste gespeicherte zum Standard.
  • Projekt löschen: Öffne das Menü ⋯ des Projekts, wähl Projekt löschen und tipp seinen Namen ein. Seine Terminals enden, detachbox entfernt seine Startvorlagen und löscht den Ordner mit allen Dateien und Unterhaltungen der Agenten. Pushe vorher, was du behalten willst.

Projekte und Service-Keys

Mit Vault bekommt jedes Projekt seinen eigenen Sallyport-Agenten namens detachbox · <project>. detachbox legt ihn für dich an, und alles, was im Projekt läuft, nutzt ihn. Was jedes Projekt aufrufen darf, legst du in Sallyport fest; sein Pass liegt im Ordner .detachbox des Projekts.