95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
11 KiB
| title | description | lang |
|---|---|---|
| Schnellstart – Agent Teams Dokumentation | Kommen Sie in wenigen Minuten von einer frischen Installation zu einem laufenden KI-Agententeam. Behandelt Installation, Runtime-Auswahl, Team-Erstellung und das erste Code-Review. | de-DE |
Schnellstart
Diese Anleitung bringt Sie in wenigen Minuten von einer frischen Installation zu einem laufenden Team.
Kürzester Weg
# 1. Install prerequisites
node --version # need 20+
pnpm --version # need 10+
# 2. Clone and install
git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
# 3. Start the desktop app (default workflow)
pnpm dev
# 4. Verify a docs-only change
pnpm --dir landing docs:build
Die Desktop-Electron-App (pnpm dev) ist das primäre Ziel — verwenden Sie für die normale Entwicklung nicht den Browser-/Web-Dev-Server. Dem Browser-Pfad fehlen Desktop-IPC, Terminal, Anbieter-Authentifizierung und das Verhalten des Team-Lebenszyklus.
Bevor Sie beginnen
Sie benötigen:
- Einen Computer mit macOS, Windows oder Linux
- (Empfohlen) Ein Git-getracktes Projekt — Worktree-Isolierung und Diff-Review setzen Git voraus
- (Optional) Anbieterzugang — die Runtime-Einrichtung erkennt verfügbare Anbieter über die UI, aber einige Pfade benötigen vorhandene Authentifizierung (Anthropic, OpenAI usw.)
Falls ein Schritt unten nicht funktioniert, sehen Sie in der Fehlerbehebungsanleitung nach gängigen Lösungen.
Konsultieren Sie für Projektkonventionen und Architekturhinweise diese maßgeblichen Dateien, bevor Sie Änderungen vornehmen:
- AGENTS.md — Repo-Navigation und Architektur-Wegweiser
- CLAUDE.md — Arbeitskonventionen und Projektregeln
- Feature-Architekturstandard — Struktur für neue Features
- Debugging-Runbook — Diagnose von Launch und Teammitgliedern
1. Aus dem Quellcode ausführen oder herunterladen
Laden Sie die paketierte App für macOS, Windows oder Linux von der Download-Seite herunter – keine Voraussetzungen nötig. Beginnen Sie mit dem kostenlosen Modell ohne Authentifizierung oder verbinden Sie die Anbieter-Authentifizierung über die UI, wenn Sie mehr Modelle möchten.
Oder führen Sie aus dem Quellcode aus für die Entwicklung:
Erfordert Node.js 24.16.0 LTS und pnpm 10+. Unter macOS erfordern die offiziellen vorkompilierten Node.js-24-Binärdateien macOS 13.5+.
git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
pnpm dev
pnpm dev startet die Desktop-Electron-App mit Hot Reload. Dies ist das standardmäßige Entwicklungsziel. Starten Sie für die normale Entwicklung keinen Browser-Web-Dev-Server — dem Browser-Pfad fehlen das vollständige Desktop-IPC, das Terminal, die Anbieter-Authentifizierung und das Verhalten des Team-Lebenszyklus.
2. Ein Projekt öffnen oder erstellen
Starten Sie die App und wählen Sie das Projektverzeichnis aus, in dem die Agenten arbeiten sollen. Agent Teams liest lokale Projektdateien sowie den Runtime-/Session-Status, damit die UI Aufgaben, Logs, Diffs und die Aktivität der Teammitglieder anzeigen kann.
::: tip Wählen Sie für die beste Erfahrung ein Git-getracktes Projekt. Sowohl die Worktree-Isolierung als auch das Diff-basierte Review setzen Git voraus. :::
Bevor Sie ein Team starten, prüfen Sie, ob das Projekt eine ausreichend saubere Ausgangsbasis hat:
git status --short
Sie brauchen keinen perfekt sauberen Baum, aber Sie sollten wissen, welche Änderungen von Ihnen stammen, bevor die Agenten mit dem Bearbeiten beginnen. Das macht Aufgaben-Diffs und das Review auf Hunk-Ebene deutlich vertrauenswürdiger.
3. Einen Runtime-Pfad wählen
Der Einrichtungsablauf erkennt installierte Runtimes auf Ihrem Rechner automatisch. Eine gängige erste Einrichtung ist:
| Runtime | Gut für |
|---|---|
| Claude | Claude-Code-Nutzer und vorhandenen Anthropic-Zugang |
| Codex | Codex-native Workflows und OpenAI-Zugang |
| OpenCode | Kostenloses Modell ohne Authentifizierung, Multimodell-Teams und viele Anbieter-Backends |
::: info Gemini ist als unterstützter Anbieterpfad verfügbar. Siehe Anbieter und Runtimes für Authentifizierungsoptionen und den aktuellen Anbieterstatus. :::
Siehe Runtime-Einrichtung für eine detaillierte Konfiguration pro Anbieter.
Um eine kostenpflichtige oder kontogebundene Runtime außerhalb der App zu überprüfen, prüfen Sie die Binärdatei und testen Sie die Authentifizierung:
# Check that the runtime is installed and on PATH
command -v claude && claude --version
command -v codex && codex --version
command -v opencode && opencode --version
Wenn der Befehl fehlschlägt, beheben Sie zuerst die Runtime-Installation oder den PATH. Team-Prompts können eine fehlende Binärdatei oder eine fehlende Anbieter-Authentifizierung für Modelle, die sie benötigen, nicht umgehen.
::: tip Wenn die Binärdatei gefunden wird, die App aber "not logged in" meldet, kann sich die Umgebung zwischen Ihrem Terminal und der App unterscheiden. Siehe das Authentifizierungs-Diagnoselog, um sie zu vergleichen. :::
4. Ihr erstes Team erstellen
Erstellen Sie ein Team mit einem Lead und einem oder mehreren Spezialisten. Halten Sie das erste Team klein: ein Lead, ein Implementierungs-Agent und ein review-orientierter Agent reichen aus, um den Workflow zu validieren.
Siehe Team erstellen für die empfohlene Struktur und Tipps.
Bevorzugen Sie für den ersten Start eine Teamform wie diese:
| Mitglied | Verantwortung | Hinweise |
|---|---|---|
| Lead | Das Ziel in Aufgaben aufteilen und den Status koordinieren | Beim zuverlässigsten Anbieter belassen, den Sie haben |
| Builder | Eng abgegrenzte Aufgaben umsetzen | Klare Datei- oder Feature-Grenzen vorgeben |
| Reviewer | Abgeschlossene Arbeit überprüfen | Bitten Sie ihn, sich auf Regressionen und fehlende Tests zu konzentrieren |
Vermeiden Sie es, mit fünf oder mehr Teammitgliedern zu beginnen. Mehr Agenten erhöhen Parallelität, Logs, Anbieternutzung und Konfliktrisiko, bevor Sie wissen, dass die Einrichtung gesund ist.
5. Dem Lead ein konkretes Ziel geben
Formulieren Sie das Ziel so, wie Sie einen Engineering-Lead briefen würden:
Improve the onboarding flow. Split the work into tasks, keep changes small, and ask for review before broad refactors.
Gute erste Prompts enthalten konkreten Umfang, Sicherheitsgrenzen und Verifizierung:
Improve the docs quickstart. Keep edits inside landing/product-docs. Add practical examples, preserve existing VitePress syntax, and run `pnpm --dir landing docs:build` before marking tasks done.
Vermeiden Sie für den ersten Lauf vage Prompts wie "make the app better". Der Lead kann große Ziele aufschlüsseln, aber bessere Eingaben führen zu kleineren Aufgaben und einem saubereren Review.
::: tip Wenn das Team startet, aber keine Aufgaben erscheinen, prüfen Sie, ob der Lead Ihren Prompt erhalten hat. Siehe Antworten der Agenten fehlen für die Diagnose. :::
Der Lead erstellt Aufgaben, weist Arbeit zu und koordiniert die Teammitglieder. Sie können den Fortschritt auf dem Kanban-Board verfolgen und jederzeit mit Kommentaren oder Direktnachrichten eingreifen.
6. Ergebnisse überprüfen
Öffnen Sie abgeschlossene oder review-bereite Aufgaben, prüfen Sie das Diff und akzeptieren, lehnen Sie ab oder kommentieren Sie einzelne Änderungen. Verwenden Sie die Aufgaben-Logs, wenn Sie verstehen müssen, warum ein Agent eine Entscheidung getroffen hat.
Siehe Code-Review für den vollständigen Review-Workflow.
Bevor Sie die erste Aufgabe genehmigen, prüfen Sie drei Dinge:
- Der Aufgabenkommentar erklärt, was sich geändert hat
- Die geänderten Dateien entsprechen dem Aufgabenumfang
- Das Verifizierungsergebnis ist im Aufgabenkommentar oder in den Logs sichtbar
Häufige Fallstricke
| Symptom | Wahrscheinliche Ursache | Prüfen |
|---|---|---|
| App erkennt eine Runtime nicht | Binärdatei nicht im PATH, oder App und Terminal sehen unterschiedliche Umgebungen |
Führen Sie command -v <runtime> in einem Terminal aus und starten Sie die App dann mit derselben Terminal-Umgebung |
| Team-Launch hängt | Fehlende Anbieter-Authentifizierung für ein kostenpflichtiges/kontogebundenes Modell, falscher Modell-String oder Runtime-Binärdatei nicht gefunden | Siehe Fehlerbehebung |
OpenCode-Lane bleibt auf registered hängen |
Lane-Nachweis noch nicht committet, oder Modell-String-Diskrepanz | Untersuchen Sie ~/.claude/teams/<team>/.opencode-runtime/lanes/ |
| Antworten der Agenten fehlen | Problem mit Runtime-Zustellung, Wiederholung, Parsing oder Aufgabenzuordnung | Öffnen Sie die Aufgaben-Logs und prüfen Sie das Zustellungs-Ledger |
| Anbieter liefert 429er | Ratenlimit erreicht | Auf das Zurücksetzen warten oder Modell/Anbieter wechseln |
Nächste Schritte
- Team erstellen — empfohlene Teamformen und das Schreiben von Briefings
- Runtime-Einrichtung — Anbieter-Authentifizierung und Modellauswahl
- Code-Review — überprüfen, genehmigen oder Änderungen anfordern
Für Mitwirkende
Wenn Sie Agent Teams oder diese Dokumentation ändern, beginnen Sie mit den maßgeblichen Projektdateien im Repo-Stammverzeichnis:
- CLAUDE.md — Arbeitskonventionen und Projektregeln
- AGENTS.md — Navigationsebene für Architektur- und Implementierungshinweise
- AGENT_CRITICAL_GUARDRAILS.md — harte Implementierungs-Guardrails
- Feature-Architekturstandard — Struktur für neue Features
- Debugging-Runbook für Agent-Teams — Diagnose von Launch, Bootstrap und Teammitgliedern
Um zu überprüfen, ob diese Dokumentationsseite korrekt baut:
pnpm --dir landing docs:build