agent-ecosystem/landing/product-docs/de/guide/runtime-setup.md

title	description	lang
Runtime-Einrichtung – Agent Teams Dokumentation	Konfigurieren Sie die Runtimes Claude Code, Codex oder OpenCode. Behandelt Authentifizierung, Anbieterzugriff, Multimodell-Modus und Prüfungen vor dem Start.	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:

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:

claude login

Überprüfen Sie dann, ob die CLI erreichbar ist:

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 beschriebene Authentifizierungs-Diagnoseprotokoll ist der beste Ausgangspunkt.

Codex

Installieren und authentifizieren Sie sich über den CLI-Ablauf von OpenAI:

codex login

Überprüfen Sie dann, ob die Runtime erreichbar ist:

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:

{
  "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.

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