Schnellstart

Dieses Kapitel führt Sie durch Ihre erste vollständige Sitzung mit Bromure Agentic Coding: das Erstellen eines Arbeitsbereichs, die Wahl eines Agenten und seiner Authentifizierung, das Freigeben eines Projektordners in die Sandbox, das Ausführen einer ersten Aufgabe, das Prüfen dessen, was der Agent über das Netzwerk gesendet hat, und das Schließen der Sitzung, sodass Sie sie später wieder aufnehmen können. Planen Sie etwa zehn Minuten ein.

Die Anleitung verwendet bewusst überall die Standardeinstellungen, wo dies möglich ist. Jede Einstellung, die Sie hier berühren, hat später im Handbuch eine vollständige Referenz — Links werden unterwegs bereitgestellt und in Wie es weitergeht gesammelt.

Bevor Sie beginnen

Sie benötigen:

• Bromure Agentic Coding installiert und mindestens einmal gestartet, mit bereitgestelltem Basis-OS-Image — siehe Installation. (Ein Mac mit Apple Silicon unter macOS 14 oder neuer ist erforderlich.)
• Eine Möglichkeit, den Coding-Agenten zu authentifizieren. Für Claude Code — den Standardagenten — ist das entweder ein Anthropic-API-Schlüssel oder ein Claude-Abonnement, bei dem Sie sich anmelden können. Beide Wege werden in Schritt 4 unten behandelt.
• Optional einen Projektordner auf Ihrem Mac, an dem der Agent arbeiten soll. Ein kleines Git-Repository eignet sich am besten für den ersten Test, aber jeder Ordner funktioniert.

Ein Gedanke, den Sie vor dem Start im Kopf behalten sollten: Der Agent läuft in einer wegwerfbaren Ubuntu-VM, und Ihre echten Zugangsdaten gelangen niemals in diese VM. Die VM hält immer nur gefälschte Platzhalter-Token; ein Proxy auf der Host-Seite tauscht sie in dem Moment gegen die echten Werte aus, in dem eine Anfrage Ihren Mac verlässt. Dies ist die Übertragungsgrenze, und deshalb bittet Sie die Anleitung, einen API-Schlüssel in die App einzufügen statt in das Terminal.

Erstellen Sie Ihren ersten Arbeitsbereich

Ein Arbeitsbereich ist die Isolationseinheit: eine Ubuntu-VM mit eigener Systemfestplatte, eigenem persistenten Home-Ordner, eigenen Agenten, Zugangsdaten und Sicherheitsrichtlinien. Sie können beliebig viele erstellen; diese Anleitung erstellt einen.

1. Öffnen Sie das Hauptfenster. Die linke Seitenleiste trägt die Überschrift ARBEITSBEREICHE; an ihrem unteren Rand befindet sich eine schwarze runde +-Schaltfläche (Tooltip: Neuer Arbeitsbereich). Klicken Sie darauf.

2. Ein Einstellungseditor öffnet sich in einem Fenster mit dem Titel Neuer Arbeitsbereich, vorausgefüllt aus Ihrer Einstellungsvorlage und benannt „Standard-Arbeitsbereich" (automatisch nummeriert, falls dieser Name bereits vergeben ist). Der Bereich Allgemein wird angezeigt. Geben Sie einen eigenen Namen ein — zum Beispiel My First Project. Der Name ist das einzige Pflichtfeld; alles andere in dieser Anleitung ist optionaler Feinschliff. Wenn Sie möchten, wählen Sie eine Farbe — sie färbt die Kachel des Arbeitsbereichs in der Seitenleiste ein.

Klicken Sie noch nicht auf Erstellen — zwei Bereiche sind vorher einen Besuch wert.

Wählen Sie einen Agenten und die Authentifizierung

3. Klicken Sie im Kategorien-Seitenmenü des Editors auf Agenten. Der Bereich zeigt eine Karte pro unterstütztem Agenten — Claude Code, Codex und Grok Build — jeweils mit einem Aktivierungsschalter. Claude Code ist aktiviert und trägt ab Werk die orangefarbene Primär-Plakette: Der primäre Agent ist derjenige, der im ersten Tab der Sitzung automatisch startet. Andere aktivierte Agenten sind ebenfalls installiert und authentifiziert, aber Sie starten sie selbst aus einem neuen Tab.

Innerhalb der Claude-Code-Karte sehen Sie vier Authentifizierungsmodi: API-Token, Abonnement (interaktive Anmeldung) mit einem Registrieren…-Link, Bedrock (AWS) und Lokales Modell (ausgegraut mit „— laden Sie ein Modell unter Lokale Modelle herunter", bis ein lokales Modell installiert ist). Wählen Sie einen der ersten beiden:

4. Wenn Sie einen Anthropic-API-Schlüssel haben: Wählen Sie API-Token und fügen Sie den Schlüssel in das Feld Anthropic-API-Schlüssel ein. Der Schlüssel wird verschlüsselt auf dem Host gespeichert; die VM erhält nur eine strukturerhaltende Fälschung, und der Proxy ersetzt den echten Schlüssel bei Anfragen an Anthropic — nirgendwo sonst. Lassen Sie das Kontrollkästchen Genehmigung zur Nutzung erforderlich vorerst deaktiviert; das Aktivieren würde dazu führen, dass die App bei der ersten Nutzung des Schlüssels in jeder Sitzung Ihre Zustimmung anfragt (siehe Zugangsdaten).

5. Wenn Sie ein Claude-Abonnement haben: Wählen Sie Abonnement (interaktive Anmeldung) — die Werkseinstellung — und klicken Sie auf Registrieren…. Bromure bootet eine temporäre Wegwerf-VM ohne Zugriff auf Ihre Ordner oder Zugangsdaten, führt die echte Claude-Anmeldung darin aus und öffnet die Anmeldeseite des Anbieters im Standardbrowser Ihres Macs. Melden Sie sich dort an; Sie haben einige Minuten Zeit, bevor der Ablauf abläuft. Bei Erfolg werden die erfassten Token verschlüsselt auf dem Host gespeichert, die Wegwerf-VM wird zerstört, und die App fragt, ob die Registrierung mit Jedem Arbeitsbereich oder Nur diesem Arbeitsbereich geteilt werden soll. Nach der Registrierung zeigt die Karte ein grünes Siegel sowie die Steuerelemente Erneut registrieren… und Vergessen. Ihre Arbeitsbereich-VMs führen niemals selbst OAuth durch und halten niemals die echten Token — der Host injiziert sie auf der Übertragung und übernimmt die Aktualisierung.

6. Das ist alles, was der Bereich Agenten für eine erste Sitzung benötigt. (Das Aktivieren von Codex oder Grok Build daneben funktioniert genauso — jede Karte erhält ihren eigenen Authentifizierungsmodus — aber ein Agent reicht heute völlig aus.)

Geben Sie einen Projektordner frei

7. Klicken Sie im Kategorien-Seitenmenü auf Ordner. Dieser Bereich listet Host-Ordner auf, die in die VM eingebunden werden. Wie die Beschriftung sagt, wird jeder Ordner unter seinem echten Namen eingebunden — zum Beispiel erscheint ~/Documents auf Ihrem Mac als ~ubuntu/Documents in der VM — und ein Arbeitsbereich ist auf 8 Ordner begrenzt. Ein brandneuer Arbeitsbereich zeigt „Keine Ordner freigegeben".

8. Klicken Sie auf Ordner hinzufügen… und wählen Sie Ihren Projektordner im Verzeichnisauswahl-Dialog. Er erscheint in der Liste mit seinem vollständigen Host-Pfad (entfernen Sie ihn später mit der Minus-Schaltfläche, falls Sie es sich anders überlegen). In der VM wird er unter /home/ubuntu/<basename> live sein — dieselben Dateien, keine Kopie, sodass Änderungen des Agenten sofort auf Ihrem Mac sind.

Hinweis: Das Freigeben eines Ordners ist optional. Alles unter /home/ubuntu der VM ist pro Arbeitsbereich persistent, sodass Sie auch ein Repository innerhalb der VM klonen und die Sandbox vollständig vom Dateisystem Ihres Macs getrennt halten können. Das Löschen eines Arbeitsbereichs berührt niemals freigegebene Host-Ordner.

9. Klicken Sie auf Erstellen. Der Editor schließt sich und Ihr Arbeitsbereich erscheint in der Seitenleiste mit dem Statuslabel Aus.

Starten Sie die Sitzung

10. Klicken Sie auf die Zeile des Arbeitsbereichs in der Seitenleiste. Die rechte Bühne zeigt das Dashboard des Arbeitsbereichs: eine Aus-Plakette unter dem Namen, Karten für CPU, Arbeitsspeicher, vCPUs, Festplatte und Betriebszeit (überwiegend Bindestriche und Nullen vor dem ersten Start — die Festplatte wird beim ersten Start erstellt), eine KONFIGURATION-Zusammenfassung mit Ihrem Agenten und Authentifizierungsmodus, den Zuständen der Schutzmechanismen und des Prompt-Injection-Scans sowie Ihren freigegebenen Ordnern. Klicken Sie oben rechts auf die Schaltfläche Starten.

11. Beim ersten Start erstellt Bromure die private Systemfestplatte des Arbeitsbereichs als Copy-on-Write-Klon des gemeinsamen Base-Images — dies ist sofort erledigt und kostet fast keinen Festplattenplatz — und bootet die VM mit 4 vCPUs und dem im Dashboard angezeigten RAM (standardmäßig an Ihren Mac angepasst: 4, 6 oder 8 GB). Während die VM bootet, überdeckt eine animierte Überlagerung mit dem Namen des Arbeitsbereichs und einem Fortschrittsbalken den Bereich; sie verblasst in dem Moment, in dem das erste Terminal des Gasts erscheint, typischerweise innerhalb von Sekunden. Erscheint innerhalb von 30 Sekunden kein Terminal, wechselt die Überlagerung zu einem DIVE FAILED-Panel mit den Schaltflächen Weiter warten und Base-Image zurücksetzen… — siehe Fehlerbehebung, falls das passiert.

12. Wenn der Bootvorgang abgeschlossen ist, blicken Sie auf ein Terminal auf der Bühne, und der primäre Agent — Claude Code — läuft bereits darin und ist bereit für einen Prompt. Sie führen niemals claude login innerhalb der VM aus; die Authentifizierung wurde an der Übertragungsgrenze abgewickelt. In der Seitenleiste ist der Statuspunkt des Arbeitsbereichs jetzt grün, das Statuslabel liest sich als Läuft, und sein erster Tab (beschriftet mit dem Vordergrundprogramm, z. B. claude) ist zusammen mit einem Docker-Knoten unter der Arbeitsbereichszeile verschachtelt. Die Fenster-Symbolleiste zeigt jetzt eine Gruppe von Steuerelementen für diese VM: ihre IP-Adresse als Klick-zum-Kopieren-Plakette und Schaltflächen zum Durchsuchen von Dateien, Neustarten, Prüfen des Trace, Bearbeiten des Arbeitsbereichs, Herauslösen der Sitzung in ihr eigenes Fenster und Umschalten der Browser- und Repo-Datei-Bereiche.

Führen Sie Ihre erste Aufgabe aus

13. Geben Sie am Claude-Code-Prompt eine Aufgabe ein und verweisen Sie auf den freigegebenen Ordner über seinen VM-internen Pfad. Zum Beispiel:

    Read the code in ~/my-project and summarize what it does.
    Then add a README.md with build instructions.
    

    Beobachten Sie den Statuspunkt auf dem Tab-Symbol in der Seitenleiste: Er pulsiert orange, während der Agent arbeitet, wird grün, wenn der Agent fertig ist, und wird rot, wenn der Agent Ihre Eingabe benötigt.

14. Da der freigegebene Ordner eine Live-Einbindung ist, befindet sich die vom Agenten geschriebene README.md sofort auf Ihrem Mac — prüfen Sie sie im Finder, wenn Sie möchten. Wenn Ihr Ordner ein Git-Repository ist, öffnet sich der Repo-Datei-Explorer-Bereich automatisch, sobald das Arbeitsverzeichnis des aktiven Tabs das Repository betritt, und zeigt einen IDE-ähnlichen Baum mit Git-Status und Diffs pro Datei; Sie können ihn auch jederzeit mit ⌃⌘E umschalten. Drücken Sie ⌘T für einen zusätzlichen einfachen Shell-Tab neben dem Agenten — jeder Tab ist ein Fenster derselben VM-internen tmux-Sitzung.

15. Alles andere, was der Agent tut — apt install, npm install, das Schreiben von Wegwerf-Dateien im VM-Home — bleibt innerhalb der Sandbox. Die Systemfestplatte und der Home-Ordner bleiben zwischen Sitzungen erhalten, und beide können später unabhängig zurückgesetzt werden (Arbeitsbereiche).

Prüfen Sie den Trace

16. Drücken Sie ⇧⌘I (oder klicken Sie auf die Symbolleisten-Schaltfläche Trace prüfen), um den Trace-Inspektor zu öffnen. Neue Arbeitsbereiche zeichnen auf der Ebene KI-Anfragedetails auf: Jede vom Agenten gestellte Netzwerkanfrage wird mit Host, Status und Latenz aufgelistet, und für bekannte LLM-Hosts werden auch die vollständigen Anfrage- und Antwortinhalte erfasst. Wählen Sie eine der Anfragen an Anthropic aus, und der Inspektor stellt sie als Konversation dar — Anbieter- und Modell-Header mit Token-Zählungen, den System-Prompt sowie die Benutzer-, Assistenten- und Tool-Nachrichten als Chat-Blasen.

17. Zwei Dinge sind bei Ihrem ersten Trace bemerkenswert. Erstens der Austauschbericht: Das gefälschte API-Token, das die VM hält, wurde auf der Übertragung genau einmal pro Anfrage gegen Ihre echten Zugangsdaten getauscht, begrenzt auf den Host des Anbieters. Zweitens: Alles Erfasste bleibt auf Ihrem Mac, im Ruhezustand verschlüsselt. Trace-Ebenen, Aufbewahrungsgrenzen und Leck-Warnungen werden in Tracing behandelt.

Schließen und fortsetzen

18. Schließen Sie die Sitzung: Fahren Sie mit der Maus über die Arbeitsbereichszeile in der Seitenleiste und klicken Sie auf ihre ×-Schaltfläche (oder drücken Sie ⌘W auf ihrem letzten Tab). Neue Arbeitsbereiche haben ihre Schließaktion auf Nachfragen gesetzt, sodass ein Dialog erscheint — „„My First Project" schließen?" — mit den Schaltflächen Im Hintergrund ausführen, Suspendieren, Herunterfahren und Abbrechen sowie der Erläuterung: „Im Hintergrund ausführen hält die VM am Laufen, sodass Sie sich später wieder verbinden können. Suspendieren speichert ihren Zustand auf der Festplatte. Herunterfahren schaltet sie aus."

19. Klicken Sie auf Suspendieren. Der RAM der VM wird als Snapshot auf die Festplatte geschrieben und das Statuslabel der Seitenleistenzeile ändert sich zu Suspendiert. Nichts geht verloren — weder die Konversation des Agenten noch Ihr Shell-Verlauf noch das Tab-Layout.

20. Fortsetzen: Klicken Sie auf den Arbeitsbereich und drücken Sie auf seinem Dashboard auf Fortsetzen (oder verwenden Sie das ⋯-Menü der Zeile → Fortsetzen). Die Sitzung wird nahezu sofort wiederhergestellt, genau dort, wo Sie aufgehört haben — dieselben Terminals, mit Claude Code mitten in der Konversation.

21. Wenn Sie immer dasselbe Verhalten beim Schließen wünschen, öffnen Sie das ⋯-Menü der Zeile → Bearbeiten… und setzen Sie Beim Schließen des Fensters im Bereich Allgemein auf Suspendieren (oder Im Hintergrund ausführen / Herunterfahren), sodass der Dialog nie erscheint. Siehe Einstellungen — Allgemein.

Tipp: Ein suspendierter oder heruntergefahrener Arbeitsbereich behält seine Systemfestplatte und seinen Home-Ordner. Das Zerstören von Daten ist immer eine ausdrückliche Handlung — Festplatte zurücksetzen, Home löschen… oder Arbeitsbereich löschen — und selbst das Löschen eines Arbeitsbereichs berührt niemals die Host-Ordner, die Sie darin freigegeben haben.

Wie es weitergeht

• Konzepte — das mentale Modell hinter dem, was Sie gerade getan haben: Arbeitsbereiche, der VM-Lebenszyklus, die Übertragungsgrenze und wie die Teile zusammenpassen.
• Arbeitsbereiche — das Duplizieren, Zurücksetzen und Löschen von Arbeitsbereichen; Speicherebenen, Prüfpunkte und die Einstellungsvorlage, von der jeder neue Arbeitsbereich abgezweigt wird.
• Sitzungen — Tabs und Git-Worktrees, das Terminal-Grid, der agentische Browser-Bereich, Dateiübertragung in die und aus der VM sowie jedes Tastaturkürzel.
• Einstellungsreferenz — jeder Einstellungsbereich, jeweils eine Seite, einschließlich Agenten und Ordner aus dieser Anleitung.
• Zugangsdaten — der vollständige Zugangsdaten-Katalog (Git-Token, SSH-Schlüssel, AWS, Kubernetes, Container-Registries, Datenbanken und mehr), Genehmigungsdialoge und wie der Fälschung-zu-Echt-Austausch im Detail funktioniert.
• Tracing — Trace-Ebenen, der Trace-Inspektor und die Leck-Erkennung.
• Lieferkette und Prompt-Injection — die Schutzmechanismen, die Sie einem Arbeitsbereich hinzufügen können, bevor Sie einen Agenten auf nicht vertrauenswürdigen Code ansetzen.
• Fusion und Lokale Modelle — das Beantworten von Prompts mit mehreren Modellen gleichzeitig und das Ausführen von Modellen auf Ihrem Mac statt in der Cloud.
• Automatisierung & CLI — das Steuern von Arbeitsbereichen aus Skripten, die HTTP-API und der bromure-cli mcp-Server.