Bring Your Own Agent (BYOA)

Was ist BYOA?

BYOA (Bring Your Own Agent) ermöglicht es Ihnen, auszuwählen, welche Agent-Laufzeitumgebung die Worker des Managers antreibt. Anstatt nur die Standard-Agents von Verdent zu nutzen, können vom Manager verteilte Worker-Aufgaben auf einem Agent laufen, den Sie bereits nutzen oder für den Sie lizenziert sind.

Möchten Sie stattdessen Ihren eigenen Anbieter-API-Schlüssel mit den integrierten Agents von Verdent verwenden? Siehe BYOK.

Unterstützte Agent-Typen

Agent	Beschreibung	Voraussetzungen
Integrierter Agent	Standard-Agent von Verdent	Keine
Claude Code	Anthropics Claude Code-CLI	Node.js installiert (für `npx`)
Codex	OpenAI Codex-CLI	Codex-CLI installiert und OpenAI-Umgebung konfiguriert

Anwendungsfälle

Zugriff auf bestimmte Modelle — Machen Sie Modellversionen, die nicht in der Standardauswahl von Verdent enthalten sind, über die Modellauswahl verfügbar.
Team-Standardisierung — Nutzen Sie eine gemeinsame Unternehmenslizenz, damit die Team-Nutzung zentral abgerechnet wird.
Vertrauter Workflow — Behalten Sie Ihren bestehenden Claude Code- oder Codex-Workflow bei und lassen Sie den Manager Worker-Aufgaben trotzdem daran verteilen.

Schnellzugriff

BYOA-Einstellungen: Settings → Models → CLI Agents
Modellauswahl im Manager-Chat: Deaktivieren Sie den Auto-Modus im Eingabefeld, um ein Task Model auszuwählen
In BYOA konfigurierte API-Schlüssel werden ausschließlich lokal gespeichert und niemals an Verdent-Server hochgeladen

Codex

Codex ist die Coding-Agent-CLI von OpenAI. Anders als Claude Code benötigt Codex innerhalb von Verdent keinen API-Schlüssel — es nutzt die Authentifizierung, die bereits in Ihrer lokalen Codex-Umgebung eingerichtet ist.

Voraussetzungen

Codex-CLI installiert (codex muss in Ihrem PATH verfügbar sein)
Codex-CLI authentifiziert und im Terminal nutzbar

Einrichtungsschritte

CLI Agents-Einstellungen öffnen

Gehen Sie zu Settings → Models → CLI Agents.

Codex hinzufügen, falls fehlend

Wenn die Codex-Karte nicht sichtbar ist, klicken Sie auf Add CLI Agent. Verdent durchsucht Ihr System-PATH nach dem Befehl codex.

Codex aktivieren

Aktivieren Sie den Codex-Schalter.

Modelle auswählen

Verdent erkennt automatisch verfügbare Modelle. Wählen Sie die gewünschten aus.

Modellerkennung

Codex-Modelle werden dynamisch erkannt. Nach dem Start von Codex ruft Verdent über dessen /models API verfügbare Modelle ab. Wenn auf Codex-Seite neue Modelle hinzugefügt werden, klicken Sie auf Refresh Models, um die Liste zu aktualisieren.

Authentifizierung

Verdent verwaltet die Codex-Authentifizierung nicht. Codex nutzt Ihre lokale Shell-Umgebung (in der Regel OPENAI_API_KEY oder den integrierten Anmeldeablauf). Solange codex in Ihrem Terminal funktioniert, funktioniert auch die Integration.

Claude Code

Claude Code ist der funktionsreichste Agent in BYOA und unterstützt mehrere Anbieter. Sie können Anthropic, OpenRouter, Zhipu GLM und andere verbinden und in der Modellauswahl zwischen ihnen wechseln.

Voraussetzungen

Node.js installiert (nur npx ist erforderlich)

Verdent startet Claude Code über:

npx -y @agentclientprotocol/claude-agent-acp

Eine globale Installation ist nicht erforderlich.

Einrichtungsschritte

CLI Agents-Einstellungen öffnen

Gehen Sie zu Settings → Models → CLI Agents.

Claude Code hinzufügen, falls fehlend

Wenn die Karte für Claude Code nicht sichtbar ist, klicken Sie auf Add CLI Agent. Verdent erkennt npx.

Claude Code aktivieren

Aktivieren Sie den Schalter Claude Code.

Anbieter hinzufügen

Klicken Sie auf Add provider und wählen Sie einen Anbieter aus (zum Beispiel Anthropic).

Zugangsdaten eingeben

Geben Sie den API-Schlüssel ein. Standardwerte werden automatisch ausgefüllt.

Testen und speichern

Klicken Sie optional auf Test Connection und anschließend auf Save.

Nach dem Speichern erscheinen die Modelle des Anbieters in der Modellliste. Aktivierte Modelle sind standardmäßig ausgewählt, können aber manuell umgeschaltet werden.

Unterstützte Anbieter

Claude Code unterstützt mehrere Anbieter. Sie können mehrere gleichzeitig konfigurieren, und alle Modelle erscheinen in der Auswahl.

Anthropic

Offizieller Anthropic-API für Claude-Modelle.

Auth: API-Schlüssel
Base URL: https://api.anthropic.com
Modelle: Opus / Sonnet / Haiku
Schlüssel: platform.claude.com/settings/keys

OpenRouter

Einheitlicher API-Zugriff auf mehrere Modellanbieter.

Auth: Token
Base URL: https://openrouter.ai/api
Modelle: Opus / Sonnet / Haiku
Schlüssel: openrouter.ai/workspaces/default/keys

Sie können Role Models überschreiben, um die Anfragen an andere OpenRouter-Modelle zu leiten (zum Beispiel google/gemini-2.5-pro).

Zhipu GLM (China)

Base URL: https://open.bigmodel.cn/api/anthropic
Modell: GLM-5
Schlüssel: bigmodel.cn/usercenter/proj-mgmt/apikeys
Dokumentation: docs.bigmodel.cn

Zhipu GLM (Global)

Base URL: https://api.z.ai/api/anthropic
Modell: GLM-5
Schlüssel: z.ai/manage-apikey/apikey-list
Dokumentation: docs.z.ai

Kimi

Base URL: https://api.kimi.com/coding/
Modell: Kimi K2.5
Schlüssel: kimi.com/code/console
Dokumentation: kimi.com/code/docs

Moonshot

Base URL: https://api.moonshot.cn/anthropic
Modell: Kimi K2.5
Schlüssel: platform.moonshot.cn/console/api-keys
Dokumentation: platform.moonshot.cn/docs

Kimi und Moonshot bieten beide Kimi K2.5 an, verwenden aber unterschiedliche Endpunkte und Authentifizierungsmethoden. Wählen Sie je nachdem, woher Ihr Schlüssel stammt.

MiniMax (China)

Base URL: https://api.minimaxi.com/anthropic
Modell: MiniMax-M2.7
Schlüssel: platform.minimaxi.com
Dokumentation: platform.minimaxi.com/docs

MiniMax (Global)

Base URL: https://api.minimax.io/anthropic
Modell: MiniMax-M2.7
Schlüssel: platform.minimax.io
Dokumentation: platform.minimax.io/docs

Xiaomi MiMo

Base URL: https://api.xiaomimimo.com/anthropic
Modell: MiMo V2 Pro
Schlüssel: platform.xiaomimimo.com
Dokumentation: platform.xiaomimimo.com/docs

Xiaomi MiMo (Token-Tarif)

Base URL: https://token-plan-cn.xiaomimimo.com/anthropic
Modell: MiMo V2 Pro
Schlüssel: platform.xiaomimimo.com
Dokumentation: platform.xiaomimimo.com/docs

Anthropic-kompatibel (benutzerdefinierter Endpunkt)

Für jeden Dienst, der mit dem API-Format von Anthropic kompatibel ist.

Auth: API-Schlüssel oder Token (umschaltbar)
Base URL: manuell konfiguriert
Modelle: manuell angegeben

Verwenden Sie dies, wenn Ihr Anbieter nicht aufgeführt ist, aber Anthropic-kompatible APIs unterstützt.

Erweiterte Optionen

Erweitern Sie im Konfigurationsbereich des Anbieters Advanced Options, um auf einen JSON-Editor zuzugreifen:

Role-Models-Zuordnung:
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
Benutzerdefinierte Umgebungsvariablen (zum Beispiel API_TIMEOUT_MS)

Die meisten Nutzer müssen diese nicht ändern — die Standardwerte funktionieren von Haus aus gut.

BYOA-Modelle im Manager verwenden

Nach der Konfiguration:

Auto-Modus deaktivieren

Deaktivieren Sie den Auto-Modus im Chat-Eingabefeld.

Task Model öffnen

Öffnen Sie das Task Model-Dropdown.

Ein BYOA-Modell auswählen

Wählen Sie ein beliebiges aktiviertes BYOA-Modell aus. Worker-Aufgaben werden dann mit diesem Modell ausgeführt.

Modelle erscheinen wie folgt:

GPT-5.4 Codex-CLI (von Codex)
Claude-Opus-4.7 ClaudeCode-CLI (von Claude Code)

Beim Überfahren mit der Maus werden Details wie CLI-Quelle, Modellname und Anbieter angezeigt.

Sicherheit und Datenschutz

Nur lokale Speicherung: API-Schlüssel werden lokal gespeichert und niemals hochgeladen.
Claude Code-Schlüssel: sicher gespeichert, nicht in Klartext-Konfigurationsdateien geschrieben.
Codex-Authentifizierung: vollständig von Ihrer lokalen Umgebung verwaltet; Verdent greift nicht auf OpenAI-Schlüssel zu.