# Bring Your Own Agent (BYOA) (/de/docs/verdent-manager/configuration/byoa)
> Führen Sie die Worker-Aufgaben des Managers auf Ihren eigenen Agent-Laufzeitumgebungen wie Codex oder Claude Code aus
## Was ist 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](/docs/verdent-manager/configuration/byok).
## Unterstützte Agent-Typen [#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 [#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 [#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]
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 [#voraussetzungen]
* Codex-CLI installiert (`codex` muss in Ihrem `PATH` verfügbar sein)
* Codex-CLI authentifiziert und im Terminal nutzbar
### Einrichtungsschritte [#einrichtungsschritte]
Gehen Sie zu **Settings → Models → CLI Agents**.
Wenn die Codex-Karte nicht sichtbar ist, klicken Sie auf **Add CLI Agent**. Verdent durchsucht Ihr System-`PATH` nach dem Befehl `codex`.
Aktivieren Sie den **Codex**-Schalter.
Verdent erkennt automatisch verfügbare Modelle. Wählen Sie die gewünschten aus.
### Modellerkennung [#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 [#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]
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 [#voraussetzungen-1]
* Node.js installiert (nur `npx` ist erforderlich)
Verdent startet Claude Code über:
```bash
npx -y @agentclientprotocol/claude-agent-acp
```
Eine globale Installation ist nicht erforderlich.
### Einrichtungsschritte [#einrichtungsschritte-1]
Gehen Sie zu **Settings → Models → CLI Agents**.
Wenn die Karte für Claude Code nicht sichtbar ist, klicken Sie auf **Add CLI Agent**. Verdent erkennt `npx`.
Aktivieren Sie den Schalter **Claude Code**.
Klicken Sie auf **Add provider** und wählen Sie einen Anbieter aus (zum Beispiel Anthropic).
Geben Sie den API-Schlüssel ein. Standardwerte werden automatisch ausgefüllt.
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 [#unterstützte-anbieter]
Claude Code unterstützt mehrere Anbieter. Sie können mehrere gleichzeitig konfigurieren, und alle Modelle erscheinen in der Auswahl.
#### Anthropic [#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](https://platform.claude.com/settings/keys)
#### OpenRouter [#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](https://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) [#zhipu-glm-china]
* **Base URL:** `https://open.bigmodel.cn/api/anthropic`
* **Modell:** GLM-5
* **Schlüssel:** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
* **Dokumentation:** [docs.bigmodel.cn](https://docs.bigmodel.cn)
#### Zhipu GLM (Global) [#zhipu-glm-global]
* **Base URL:** `https://api.z.ai/api/anthropic`
* **Modell:** GLM-5
* **Schlüssel:** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
* **Dokumentation:** [docs.z.ai](https://docs.z.ai)
#### Kimi [#kimi]
* **Base URL:** `https://api.kimi.com/coding/`
* **Modell:** Kimi K2.5
* **Schlüssel:** [kimi.com/code/console](https://kimi.com/code/console)
* **Dokumentation:** [kimi.com/code/docs](https://kimi.com/code/docs)
#### Moonshot [#moonshot]
* **Base URL:** `https://api.moonshot.cn/anthropic`
* **Modell:** Kimi K2.5
* **Schlüssel:** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
* **Dokumentation:** [platform.moonshot.cn/docs](https://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) [#minimax-china]
* **Base URL:** `https://api.minimaxi.com/anthropic`
* **Modell:** MiniMax-M2.7
* **Schlüssel:** [platform.minimaxi.com](https://platform.minimaxi.com)
* **Dokumentation:** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)
#### MiniMax (Global) [#minimax-global]
* **Base URL:** `https://api.minimax.io/anthropic`
* **Modell:** MiniMax-M2.7
* **Schlüssel:** [platform.minimax.io](https://platform.minimax.io)
* **Dokumentation:** [platform.minimax.io/docs](https://platform.minimax.io/docs)
#### Xiaomi MiMo [#xiaomi-mimo]
* **Base URL:** `https://api.xiaomimimo.com/anthropic`
* **Modell:** MiMo V2 Pro
* **Schlüssel:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Dokumentation:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Xiaomi MiMo (Token-Tarif) [#xiaomi-mimo-token-tarif]
* **Base URL:** `https://token-plan-cn.xiaomimimo.com/anthropic`
* **Modell:** MiMo V2 Pro
* **Schlüssel:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Dokumentation:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Anthropic-kompatibel (benutzerdefinierter Endpunkt) [#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 [#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 [#byoa-modelle-im-manager-verwenden]
Nach der Konfiguration:
Deaktivieren Sie den **Auto**-Modus im Chat-Eingabefeld.
Öffnen Sie das **Task Model**-Dropdown.
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 [#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.
## FAQ [#faq]
### CLI Agent wird nicht erkannt? [#cli-agent-wird-nicht-erkannt]
Stellen Sie sicher, dass die Befehle in `PATH` verfügbar sind:
* Claude Code benötigt `npx` (Node.js installiert)
* Codex benötigt die installierte `codex`-CLI
Führen Sie aus:
```bash
which npx
which codex
```
### Test Connection fehlgeschlagen? [#test-connection-fehlgeschlagen]
* Überprüfen Sie den API-Schlüssel
* Überprüfen Sie die Base URL
* Stellen Sie sicher, dass Netzwerkzugriff auf den API-Endpunkt besteht
* Überprüfen Sie gegebenenfalls die Proxy-Konfiguration
### Anbieter hinzugefügt, aber Modelle nicht sichtbar? [#anbieter-hinzugefügt-aber-modelle-nicht-sichtbar]
* Stellen Sie sicher, dass Claude Code aktiviert ist
* Stellen Sie sicher, dass die Anbieter-Modelle aktiviert sind
* Starten Sie Verdent bei Bedarf neu