Zum Hauptinhalt springen

Installierten Coding-Agenten als Chatmodell verwenden

Ist ein bezahlter Coding-Agent auf dem Backend-Rechner angemeldet, kannst du ihn im normalen Chat verwenden. Libre WebUI erkennt seine CLI und zeigt sie im Modellwähler.

Erkennung​

Bei jeder Modelllistenabfrage sucht Libre WebUI im Server-PATH:

ModellBefehlAnbieter
Claude CodeclaudeAnthropic
CodexcodexOpenAI
Kirokiro-cliAWS
Muse CodemuseMeta
OpenCodeopencodeSST
PipiMario Zechner

Gefundene Befehle erscheinen unter Agenten. Nichts wird installiert oder konfiguriert.

Einstellungen → Chat → Standardwerte kennzeichnet diese Einträge ebenfalls als Agent, einschließlich Strands, wenn dein Konto es verwenden darf. Plugin-Modelle behalten ihren Anbieternamen; nur Ollama-Modelle tragen die Ollama-Bezeichnung. Ollama abzuschalten verbirgt keine konfigurierten Agenten oder Plugins. Die Modellinformationskarte zeigt Anzeigename und Anbieter sowie Größe, Familie und Format nur, wenn ihr Katalog diese liefert.

Modell statt nur CLI wählen​

Jede CLI kann mehrere Einträge in der Agentengruppe anbieten:

  • Claude Code bietet Standard, Sonnet, Opus und Haiku sowie die ausdrücklichen Auswahlen Sonnet 5.5 (claude-sonnet-5-5), Opus 5.5 (claude-opus-5-5) und Haiku 5.5 (claude-haiku-5-5). Sonnet 5.5 erfordert Claude Code 2.1.284 oder neuer, Opus 5.5 erfordert Claude Code 2.1.280 oder neuer, und Haiku 5.5 erfordert Claude Code 2.1.293 oder neuer, jeweils mit Zugriff über das angemeldete Konto; aktualisieren Sie die CLI mit claude update. Die bestehenden Aliase Sonnet, Opus und Haiku folgen weiterhin der aktuellen Modellzuordnung der CLI.
  • Codex bietet Standard sowie GPT-6 Astra, GPT-6.1 Sol (gpt-6.1-sol), GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, Terra, Luna, GPT-5.5 und GPT-5.3 Codex Spark. Die Verfügbarkeit hängt von der CLI-Anmeldung und dem Kontozugriff ab.
  • Kiro listet die Modelle, die sein angemeldetes Konto nutzen kann (aus kiro-cli chat --list-models), neben seinem konfigurierten Standard. Jeder Turn läuft nicht interaktiv auf der V3-Agent-Engine der CLI mit fixiertem eingebautem Standardagenten (vibe), daher gilt ein eigener chat.defaultAgent nicht. Erfordert Kiro CLI 2.27 oder neuer.
  • Muse Code bietet seinen konfigurierten Standard sowie Muse Spark 1.3 (muse-spark-1.3), Muse Spark 1.3 Contributor (muse-spark-1.3-contributor) und Muse Wonder 1.0 (muse-wonder-1.0). Die Anmeldung erfolgt mit muse login (ein Meta-Konto) oder mit einem Meta-Model-API-Schlüssel aus META_API_KEY oder muse auth set. Contributor-Modelle werden günstiger abgerechnet, weil Meta mit dem, was du an sie sendest, trainieren darf.
  • Pi nutzt sein CLI-Modell.
  • OpenCode listet authentifizierte Anbieter aus opencode models und verlangt eine Auswahl; sein CLI-Standard kann auf einen vom Libre-Host unerreichbaren lokalen Server zeigen.

Die eingebettete Strands-Engine erscheint ebenfalls in der Gruppe Agenten, wenn dein Konto sie verwenden darf. Sie ist keine CLI: Sie läuft im Backend und steuert deine Ollama- und Anbieter-Plugin-Modelle. Der einfache Eintrag Strands (strands) verwendet dein Standard-Chatmodell. Die übrigen Einträge (strands:<route>) listen je einen pro verfügbarem Modell auf, etwa Strands · gpt-5.6-sol (Codex (ChatGPT)), und fixieren Modell und Anbieter für dieses Gespräch. Bei einem Ausfall darf kein anderer verfügbarer Anbieter einspringen. Die Auflistung der Optionen startet die Engine nicht.

Dieselben Strands-Einträge dienen unter Einstellungen → Chat → Standardwerte auch als Aufgabenmodell für automatische Titel und Reasoning-Zusammenfassungen. Aktuell laufendes Modell verwenden nutzt die gespeicherte Strands-Auswahl des Gesprächs. Diese kurzen Textanfragen rufen das zugrunde liegende Anbietermodell direkt auf; sie führen keine Agentenwerkzeuge aus und erstellen keine Agentensitzung. Andere CLI-Profile benötigen für solche Hilfsanfragen ein Ollama-, Plugin- oder Strands-Aufgabenmodell.

Pi läuft stateless mit --no-session, deaktivierten lokalen Tools und neutralem System-Prompt und berührt keine persönliche Konfiguration.

Kiro ist in beiden Punkten das Gegenteil: Es läuft mit der Kiro-Konfiguration des Serverbenutzers — der eingebaute Standardagent ist fixiert, aber Berechtigungsregeln (~/.kiro/settings/permissions.yaml), MCP-Server und das konfigurierte Standardmodell gelten weiterhin — und jeder Turn wird als neue Sitzung im Kiro-Sitzungsspeicher dieses Benutzers gespeichert (kiro-cli chat --list-sessions zeigt sie, mit dem jüngsten Chatverlauf darin). Es gibt keinen Schalter, um das abzuschalten, daher liegt Chatinhalt auch im Home-Verzeichnis des Backend-Benutzers, außerhalb der Libre-WebUI-Datenbank. Kiros Tools bleiben aktiv: Alles, was diese Berechtigungsregeln als vertrauenswürdig einstufen — standardmäßig Lesezugriffe und schreibgeschützte Befehle wie date — läuft ohne Rückfrage, und jeder Tool-Aufruf, der eine Freigabe braucht, wird abgelehnt, weil ein Chat-Turn die Rückfrage nicht beantworten kann.

Muse Code liest den Prompt aus einer privaten Datei und läuft headless mit abgeschalteten Freigaben (--approval-mode never), weil ein Chat-Turn keine Freigabeabfrage beantworten kann. Seine eigene Sandbox bleibt aktiv, und jeder Turn erhält einen temporären Workspace, der danach gelöscht wird, sodass seine Dateischreibvorgänge nicht im Home-Verzeichnis des Serverbenutzers landen können. Turns werden nicht im Sitzungsprotokoll von Muse gespeichert (--no-session-log), aber die Muse-Einstellungen, -Regeln und das Standardmodell des Serverbenutzers gelten.

Verwendung​

  1. Als Administrator anmelden.
  2. Chat und Modellwähler öffnen.
  3. Ein Modell unter Agenten wählen.
  4. Normal senden; Antworten streamen tokenweise.

Chats werden gespeichert, umbenannt und durchsucht. Jeder Turn sendet den jüngsten Verlauf.

Berechtigung und Reichweite​

Diese Funktion ist ausschließlich für Administratoren vorgesehen, aus gutem Grund. Der Agent läuft auf dem Host unter demselben Betriebssystembenutzer wie das Libre-WebUI-Backend, nicht in einem Work-Container. Er übernimmt dessen Agentenzugangsdaten und die üblichen Zugriffsrechte dieser Agenten, einschließlich des Lesens von Dateien und Ausführens von Serverbefehlen, wenn er sich dafür entscheidet.

Behandle die Aktivierung wie die Gewährung von Shellzugriff. Deshalb wird die Funktion deaktiviert ausgeliefert. Ein Administrator muss sie unter Einstellungen → Benutzerverwaltung → Zugriff und Richtlinien → Agent-CLI-Modelle aktivieren. Der Wert wird dauerhaft gespeichert und gilt sofort ohne Neustart.

Eine Änderung dieses Schalters aktualisiert den Modellkatalog sofort. Agenten enthält direkte CLI-Einträge, Plugin-Modelle dagegen API-Integrationen von Anbietern wie Codex (ChatGPT). Strands wird in derselben Kategorie aufgeführt, folgt aber seiner eigenen Zugriffseinstellung Strands-Engine und nicht diesem Schalter, daher kann es auch bei ausgeschalteten Agent-CLI-Modellen erscheinen. Seine Modellerkennung darf die Erkennung installierter CLI-Agenten nicht blockieren.

Bestehende Installationen übernehmen die bisher gespeicherte Agentenentscheidung, bis eine unabhängige CLI-Einstellung gespeichert wird.

Deploymentweit festlegen und UI sperren:

AGENT_CLI_MODELS_ENABLED=false   # or true

Für sandboxierten Dateizugriff nutze Work.

Dieselben Agenten in Work​

Work bietet dieselben Agenten mit denselben Modellauswahlen und denselben Anmeldungen, führt sie aber in der Sandbox der Aufgabe statt auf dem Host aus, hinter einem Egress-Proxy, der die echten Tokens aus der Sandbox fernhält. Sie haben einen eigenen Zugriffsmodus, Agent-CLIs in Work, und brauchen den Schalter oben nicht. Siehe Agent-CLIs in Work.

Nutzungserfassung​

Öffne Anbieter-Nutzung (/usage) und suche oben nach Agenten. Claude Code, Codex, Kiro, Muse Code, OpenCode, Pi und Strands-Aktivität haben ausdrückliche Einträge mit klarer Meldung, wenn im Zeitraum keine Aufrufe aufgezeichnet wurden.

CLI-Aufrufe über LWUI erfassen Ergebnis, Dauer und gemeldete Token-Nutzung. Jede Invocation erzeugt ein Nutzungsereignis. Wiederholte Snapshots oder schrittweise Berichte duplizieren weder Ereignisse noch Tokens. Fehlende Zähler bleiben ungemeldet. Stoppen erfasst einen Abbruch, und ein erfolgloser CLI-Abschluss gilt nicht allein wegen ausgegebenen Teiltexts als Erfolg. CLI-Nutzung außerhalb LWUI wird nicht importiert.

Strands-Aufrufe werden dem Agenten Strands zugeordnet. Einzelheiten und Grenzen beschreibt Agentennutzung.

Konfiguration​

VariableStandardZweck
AGENT_CLI_MODELS_ENABLEDnicht gesetzttrue/false festlegen; sonst Admin-Schalter
AGENT_CLI_TIMEOUT_MS600000Maximale Dauer eines Turns

Fehlerbehebung​

Keine Agentengruppe sichtbar. Prüfe die Aktivierung unter Einstellungen → Benutzerverwaltung → Zugriff und Richtlinien → Agent-CLI-Modelle (standardmäßig aus) sowie die Anmeldung als Administrator. Der Befehl muss im PATH des Backend-Prozesses liegen, nicht nur im interaktiven Shell-PATH. Ein Dienstmanager, Docker-Container oder Desktopstarter hat häufig einen deutlich kleineren PATH als ein Anmeldeterminal.

Sofortiger Fehler: Als Serverbenutzer claude -p "hello", codex exec "hello", muse exec "hello" oder echo hello | kiro-cli chat --no-interactive --output-format stream-json --agent-engine v3 --agent vibe ausführen. Kiro CLI 2.27 oder neuer ist erforderlich; eine ältere CLI scheitert zuerst hier, wo ihr Fehler sichtbar ist — im Chat erscheint derselbe Fehler nur als Kiro exited unsuccessfully. Anmeldung oder Abo-Limit prüfen; für OpenCode opencode auth login erneut ausführen. Kiro meldet sich über kiro-cli login an; eine abgelaufene Sitzung scheitert genauso. Muse Code meldet missing meta credentials, bis muse login als Serverbenutzer ausgeführt wurde.

Antwort stoppt: AGENT_CLI_TIMEOUT_MS erhöhen oder Anfrage teilen.