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
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) und Opus 5.5 (claude-opus-5-5). Sonnet 5.5 erfordert Claude Code 2.1.284 oder neuer und Opus 5.5 erfordert Claude Code 2.1.280 oder neuer, jeweils mit Zugriff über das angemeldete Konto; aktualisieren Sie die CLI mit claude update. Die bestehenden Aliase Sonnet und Opus 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.
  • 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.

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.

Nutzungserfassung​

Öffne Anbieter-Nutzung (/usage) und suche oben nach Agenten. Claude Code, Codex, 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" oder codex exec "hello" ausführen. Anmeldung oder Abo-Limit prüfen; für OpenCode opencode auth login erneut ausführen.

Antwort stoppt: AGENT_CLI_TIMEOUT_MS erhöhen oder Anfrage teilen.