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
179 lines
9.1 KiB
Markdown
179 lines
9.1 KiB
Markdown
---
|
||
title: Runtime-Einrichtung – Agent Teams Dokumentation
|
||
description: Konfigurieren Sie die Runtimes Claude Code, Codex oder OpenCode. Behandelt Authentifizierung, Anbieterzugriff, Multimodell-Modus und Prüfungen vor dem Start.
|
||
lang: de-DE
|
||
---
|
||
|
||
# Runtime-Einrichtung
|
||
|
||
Agent Teams ist eine Koordinationsebene. Die eigentliche Modellarbeit läuft über unterstützte lokale Runtimes und Anbieter.
|
||
|
||
::: tip Schnellstart - die erste Runtime auswählen
|
||
| Wenn Sie ... | Beginnen Sie mit |
|
||
| --- | --- |
|
||
| Bereits Claude Code nutzen oder Zugriff auf Anthropic haben | **Claude** - vertraute Authentifizierung, minimale Einrichtung |
|
||
| Codex oder OpenAI-basierte Workflows nutzen | **Codex** - native Integration |
|
||
| Agent Teams ohne Registrierung oder API-Schlüssel ausprobieren möchten | **OpenCode** - nutzen Sie das enthaltene kostenlose Modell ohne Authentifizierung |
|
||
| Multimodell-Routing oder breite Anbieterabdeckung möchten | **OpenCode** - am flexibelsten, eine Konfiguration für viele Backends |
|
||
| Nicht sicher sind, welche Runtime passt | **OpenCode** - deckt die meisten Anbieteroptionen ab und lässt Sie später wechseln |
|
||
|
||
Beginnen Sie mit einer Runtime und einem Teammitglied. Bestätigen Sie, dass ein Start funktioniert, bevor Sie auf Multimodell erweitern.
|
||
:::
|
||
|
||
## Voraussetzungen
|
||
|
||
Stellen Sie vor dem Start eines Teams sicher, dass:
|
||
|
||
- Die Runtime-Binärdatei installiert ist und sich in Ihrem `PATH` befindet.
|
||
- Ihr Anbieterkonto aktiven Zugriff auf das Modell hat, das Sie verwenden möchten, es sei denn, Sie beginnen mit dem enthaltenen kostenlosen OpenCode-Modell ohne Authentifizierung.
|
||
- Der Projektpfad existiert und lesbar ist.
|
||
- Die App und Ihr Terminal dieselbe Home-/Konfigurationsumgebung verwenden, wenn Sie die Authentifizierung manuell testen.
|
||
|
||
::: tip
|
||
Beginnen Sie mit einem einzelnen Teammitglied und einem Anbieter. Bestätigen Sie, dass ein Start funktioniert, bevor Sie Multimodell-Lanes hinzufügen.
|
||
:::
|
||
|
||
Schnelle Terminal-Prüfungen:
|
||
|
||
```bash
|
||
command -v claude
|
||
command -v codex
|
||
command -v opencode
|
||
```
|
||
|
||
Führen Sie den Befehl für die Runtime aus, die Sie verwenden möchten. Wenn nichts ausgegeben wird, installieren Sie die Runtime oder korrigieren Sie den `PATH`, bevor Sie ein Team starten.
|
||
|
||
## Unterstützte Pfade
|
||
|
||
| Pfad | Standard-CLI | Typische Anbieter | Verwenden, wenn |
|
||
| --- | --- | --- | --- |
|
||
| Claude | `claude` | Anthropic | Sie bereits Claude Code oder Anthropic-gestützte Workflows nutzen |
|
||
| Codex | `codex` | OpenAI | Sie eine Codex-native Runtime-Integration möchten |
|
||
| OpenCode | `opencode` | OpenRouter und viele Backends | Sie Multimodell-Routing und breite Anbieterabdeckung möchten |
|
||
|
||
Die App erkennt unterstützte Runtimes und leitet die Einrichtung nach Möglichkeit über die Oberfläche an.
|
||
|
||
Gemini ist als unterstützter Anbieterpfad mit Google ADC (`gcloud auth`), Gemini CLI OAuth und API-Schlüssel-Authentifizierung verfügbar. Konfigurieren Sie es über die Oberfläche zur Runtime-Einrichtung, wenn das Gemini-Backend erkannt wird.
|
||
|
||
## Anbieterzugriff
|
||
|
||
Agent Teams hat keine eigene kostenpflichtige Stufe. Sie können mit dem enthaltenen kostenlosen OpenCode-Modell ohne Authentifizierung beginnen - keine Registrierung, keine API-Schlüssel, keine Kreditkarte. Für zusätzliche Modelle bringen Sie den Anbieterzugriff mit, den Sie bereits haben: Abonnements, lokale Runtime-Authentifizierung oder API-Schlüssel, je nach gewähltem Pfad.
|
||
|
||
- Die Pfade **Claude** und **Codex** stützen sich auf ihre jeweiligen CLI-Authentifizierungstools.
|
||
- **OpenCode** kann zunächst das enthaltene kostenlose Modell ohne Authentifizierung ausführen. Andere OpenCode-Modelle benötigen möglicherweise anbieterspezifische API-Schlüssel in einer Konfigurationsdatei (z. B. `openrouter`, `openai`, `anthropic`).
|
||
|
||
## Authentifizierungskonfiguration
|
||
|
||
### Claude Code
|
||
|
||
Führen Sie den standardmäßigen Authentifizierungsablauf in einem Terminal aus:
|
||
|
||
```bash
|
||
claude login
|
||
```
|
||
|
||
Überprüfen Sie dann, ob die CLI erreichbar ist:
|
||
|
||
```bash
|
||
claude --version
|
||
```
|
||
|
||
Wenn die paketierte App "nicht angemeldet" meldet, während Ihr Terminal funktioniert, vergleichen Sie die von der App gesehenen `$HOME`- und `PATH`-Werte mit dem Terminal, das Sie für die Anmeldung verwendet haben. Das in der [Fehlerbehebung](/de/guide/troubleshooting#auth-diagnostic-log) beschriebene Authentifizierungs-Diagnoseprotokoll ist der beste Ausgangspunkt.
|
||
|
||
### Codex
|
||
|
||
Installieren und authentifizieren Sie sich über den CLI-Ablauf von OpenAI:
|
||
|
||
```bash
|
||
codex login
|
||
```
|
||
|
||
Überprüfen Sie dann, ob die Runtime erreichbar ist:
|
||
|
||
```bash
|
||
codex --version
|
||
```
|
||
|
||
Codex-native Starts verwenden den Codex-Kontostatus und Modellkatalogdaten, sofern verfügbar. Wenn ein Modell in der Oberfläche fehlt, aktualisieren Sie den Anbieterstatus, bevor Sie Team-Prompts bearbeiten.
|
||
|
||
### OpenCode
|
||
|
||
Um das enthaltene kostenlose Modell ohne Authentifizierung zu verwenden, wählen Sie es in der App aus und starten Sie ohne Anbieterregistrierung. Um andere OpenCode-Backends zu verwenden, erstellen oder bearbeiten Sie `~/.opencode/config.json` (oder den entsprechenden Pfad auf Ihrer Plattform) mit dem gewünschten Anbieterschlüssel:
|
||
|
||
```json
|
||
{
|
||
"providers": {
|
||
"openrouter": {
|
||
"apiKey": "sk-or-..."
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Verwenden Sie den genauen Anbieternamen, den OpenCode erwartet. Wenn Sie einen benutzerdefinierten Anbieternamen festlegen, überprüfen Sie ihn anhand der Anbieter-ID, die Sie im Modell-String verwenden (zum Beispiel würde `openrouter/moonshotai/kimi-k2.6` den `openrouter`-Block verwenden).
|
||
|
||
Beispiele für Modell-Strings:
|
||
|
||
| Modell-String | Anbieterblock, der vorhanden sein muss |
|
||
| --- | --- |
|
||
| `openrouter/moonshotai/kimi-k2.6` | `openrouter` |
|
||
| `openai/gpt-5.4` | `openai` |
|
||
| `anthropic/claude-sonnet-4-6` | `anthropic` |
|
||
|
||
Wenn OpenCode startet, ein Teammitglied aber nie zustellbar wird, prüfen Sie die Lane-Belege, bevor Sie annehmen, dass das Modell den Prompt ignoriert hat. Siehe [Fehlerbehebung](/de/guide/troubleshooting#opencode-registered-but-bootstrap-unconfirmed).
|
||
|
||
### Gemini
|
||
|
||
Gemini unterstützt drei Authentifizierungsmethoden:
|
||
|
||
- **Google ADC** — führen Sie `gcloud auth application-default login` aus, um sich über Google Application Default Credentials zu authentifizieren.
|
||
- **Gemini CLI** — führen Sie `gemini login` aus, wenn die Gemini CLI installiert ist.
|
||
- **API-Schlüssel** — setzen Sie `GEMINI_API_KEY` in Ihrer Umgebung oder konfigurieren Sie ihn über die Oberfläche „Manage Providers“ der App.
|
||
|
||
Die App erkennt automatisch, welche Authentifizierungsmethode verfügbar ist, und zeigt den Gemini-Anbieter in der Oberfläche zur Runtime-Einrichtung und Teamerstellung an, wenn das Backend erreichbar ist.
|
||
|
||
## Multimodell-Modus
|
||
|
||
Der Multimodell-Modus kann Arbeit über viele Anbieter-Backends mittels OpenCode-kompatibler Konfiguration routen. Verwenden Sie ihn, wenn Sie Anbieterflexibilität benötigen oder möchten, dass Teammitglieder unterschiedliche Modell-Lanes nutzen.
|
||
|
||
::: info Modell-Lanes
|
||
Jedes Teammitglied kann ein anderes Paar aus `providerId` + `model` verwenden. Erweitern Sie in der Oberfläche zur Teambearbeitung die Mitgliedsoptionen, um die globalen Standardwerte zu überschreiben.
|
||
:::
|
||
|
||
Ein konservatives Multimodell-Setup:
|
||
|
||
| Rolle | Anbieter | Warum |
|
||
| --- | --- | --- |
|
||
| Lead | Claude oder Codex | Halten Sie die Koordination beim Anbieter, dem Sie am meisten vertrauen |
|
||
| Builder | OpenCode | Nutzen Sie breites Modell-Routing für Implementierungsarbeit |
|
||
| Reviewer | Claude, Codex oder ein zweites OpenCode-Modell | Trennen Sie das Review-Urteil von der Builder-Lane |
|
||
|
||
Vermeiden Sie es, beim ersten Start viele unbekannte Anbieter zu mischen. Bestätigen Sie eine kleine Aufgabe pro Lane, bevor Sie umfangreiche Arbeit zuweisen.
|
||
|
||
## Checkliste vor dem Start
|
||
|
||
Vor dem Start eines Teams:
|
||
|
||
1. Die ausgewählte Runtime ist installiert
|
||
2. Die Runtime-Binärdatei befindet sich im `PATH` der Umgebung
|
||
3. Die Anbieter-Authentifizierung ist für das gewählte Backend konfiguriert
|
||
4. Der Anbieter hat Zugriff auf den genauen Modell-String, den Sie angeben
|
||
5. Der Projektpfad existiert und ist lesbar
|
||
|
||
## Wann Runtime-Pfade gewechselt werden sollten
|
||
|
||
Wechseln Sie, wenn der aktuelle Pfad durch Modellverfügbarkeit, Ratenbegrenzungen, Anbieterfähigkeiten oder Anforderungen an Teamrollen blockiert ist. Behalten Sie denselben Projekt- und Team-Workflow bei, validieren Sie aber nach dem Wechsel eine kleine Aufgabe.
|
||
|
||
::: warning Behandeln Sie Einrichtungsfehler als Einrichtungsprobleme
|
||
Wenn die Authentifizierung fehlschlägt, ein Modellname abgelehnt wird oder die Runtime-Binärdatei nicht gefunden werden kann, beheben Sie zuerst die Einrichtung. Ändern Sie keine Team-Prompts oder Projektcode, um ein Problem mit der Runtime-Konfiguration zu umgehen.
|
||
:::
|
||
|
||
Verwenden Sie diese Entscheidungstabelle:
|
||
|
||
| Symptom | Bessere erste Maßnahme |
|
||
| --- | --- |
|
||
| Binärdatei nicht gefunden | Installation oder `PATH` korrigieren |
|
||
| Anmeldung funktioniert im Terminal, aber nicht in der App | Electron-Authentifizierungs-Diagnoseprotokoll und Umgebung prüfen |
|
||
| Modell abgelehnt | Genaue Modell-ID in der Anbieter-Runtime überprüfen |
|
||
| Wiederholte 429er | Parallelität senken oder Modell/Anbieter wechseln |
|
||
| OpenCode-Lane hängt | Lane-Manifest und `opencode-sessions.json` prüfen |
|