Gebruik een geïnstalleerde programmeeragent als chatmodel
Als u al voor een programmeeragent betaalt en die is aangemeld op de computer waarop Libre WebUI draait, kunt u er vanuit een gewone chat mee praten in plaats van een afzonderlijke API-sleutel toe te voegen. Libre WebUI detecteert de opdrachtregelinterface van de agent en biedt deze net als elk ander model aan in de modelkiezer.
Wat wordt gedetecteerd
Bij elke aanvraag van de modellenlijst zoekt Libre WebUI op het PATH van de server naar deze opdrachten:
| Model | Opdracht | Aangeboden door |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
Alles wat wordt gevonden, verschijnt onder de groep Agents in de modelkiezer. Er wordt niets voor u geïnstalleerd en er is geen configuratiebestand nodig: als de opdracht in de shell van uw server werkt, wordt deze weergegeven.
Instellingen → Chat → Standaardwaarden duidt deze vermeldingen eveneens aan als Agent, inclusief Strands wanneer uw account het mag gebruiken. Plugin-modellen behouden hun providernaam; alleen Ollama-modellen krijgen het label Ollama. Ollama uitschakelen verbergt geen geconfigureerde agents of plugins. De modelinformatiekaart toont de weergavenaam en provider van de selectie, met grootte, familie en formaat alleen wanneer de catalogus die levert.
Een model kiezen, niet alleen een CLI
Elke CLI kan meerdere vermeldingen in de groep Agents aanbieden:
- Claude Code biedt de aangemelde standaardwaarde plus Sonnet, Opus en Haiku.
Er zijn ook expliciete keuzes voor Sonnet 5.5 (
claude-sonnet-5-5) en Opus 5.5 (claude-opus-5-5). Sonnet 5.5 vereist Claude Code 2.1.284 of hoger en Opus 5.5 vereist Claude Code 2.1.280 of hoger, beide met toegang via het aangemelde account; voerclaude updateuit om de CLI bij te werken. De bestaande aliassen Sonnet en Opus blijven de huidige modeltoewijzing van de CLI volgen. - Codex biedt de geconfigureerde standaardwaarde plus de gedocumenteerde familie voor aanmelding via ChatGPT: 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 en GPT-5.3 Codex Spark. De beschikbaarheid hangt af van de aanmelding van de CLI en de accounttoegang. - Pi draait met het model dat in de CLI zelf is geconfigureerd.
- OpenCode toont de modellen van elke provider waarvoor authenticatie is ingesteld (van
opencode models) en vereist altijd een expliciete keuze. De standaardwaarde op CLI-niveau kan verwijzen naar een lokale server die vanaf de Libre WebUI-host niet bereikbaar is.
De ingebouwde Strands-engine verschijnt ook in de groep Agents wanneer uw account hem mag gebruiken. Het is geen CLI: de engine draait binnen de backend en stuurt uw Ollama-modellen en modellen van providerplugins aan. De gewone vermelding Strands (strands) gebruikt uw standaard chatmodel. De andere vermeldingen (strands:<route>) tonen er één per beschikbaar model, zoals Strands · gpt-5.6-sol (Codex (ChatGPT)), en leggen zowel het model als de provider vast voor dat gesprek; een andere beschikbare provider kan deze bij een storing niet vervangen. De lijst opvragen start de engine niet.
Dezelfde Strands-vermeldingen kunnen onder Instellingen → Chat → Standaardwaarden als taakmodel dienen voor automatische titels en denksamenvattingen. Huidig actief model gebruiken gebruikt de opgeslagen Strands-selectie van het gesprek. Deze korte tekstverzoeken roepen rechtstreeks het onderliggende providermodel aan; ze voeren geen agenttools uit en maken geen agentsessie. Andere CLI-profielen vereisen voor deze aanvullende verzoeken een Ollama-, plugin- of Strands-taakmodel.
Pi voert elke beurt zonder status uit (--no-session), met lokale tools uitgeschakeld en een neutrale systeemprompt. Antwoorden worden daardoor niet gekleurd door de persoonlijke Pi-configuratie van de besturingssysteemgebruiker van de server en chats raken die configuratie nooit aan.
Gebruik
- Meld u aan als beheerder.
- Start een chat en open de modelkiezer.
- Kies een vermelding onder Agents.
- Verstuur berichten zoals gewoonlijk. Antwoorden worden token voor token gestreamd.
De conversatie wordt net als elke andere chat opgeslagen. U kunt haar verlaten en later terugkeren, hernoemen en vanuit het opdrachtenpalet doorzoeken. Elke beurt stuurt een transcript van de recente conversatie naar de agent en streamt het antwoord terug.
Wie kan dit gebruiken en waar heeft het toegang toe?
Deze functie is alleen voor beheerders, en daar is een belangrijke reden voor. De agent draait als dezelfde besturingssysteemgebruiker als de Libre WebUI-backend, op de host en niet in een Work-container. Hij erft daarom de agentreferenties van die gebruiker en alle toegang die deze agents normaal hebben, waaronder de mogelijkheid om bestanden te lezen en opdrachten op de server uit te voeren als de agent daarvoor kiest.
Behandel het inschakelen hiervan alsof u de agent shelltoegang tot de computer geeft. Daarom wordt de functie uitgeschakeld geleverd: een beheerder moet haar inschakelen onder Instellingen → Gebruikersbeheer → Toegang en beleid → CLI-agentmodellen. De instelling wordt bewaard en gaat onmiddellijk in, zonder herstart.
Deze schakelaar vernieuwt de modelcatalogus onmiddellijk: Agents bevat directe CLI-vermeldingen, terwijl Plugin-modellen API-integraties van providers zoals Codex (ChatGPT) bevat. Strands staat in dezelfde categorie, maar volgt zijn eigen toegangsinstelling Strands-engine en niet deze schakelaar, dus het kan verschijnen terwijl CLI-agentmodellen uit staan. De modeldetectie van Strands kan de detectie van geïnstalleerde CLI-agents niet blokkeren.
Bestaande installaties erven hun eerder opgeslagen keuze voor Agents totdat een afzonderlijke CLI-instelling wordt opgeslagen.
Stel de omgevingsvariabele in een van beide richtingen in om de keuze op implementatieniveau vast te zetten, ongeacht de runtimeschakelaar (hiermee wordt de schakelaar in de interface ook vergrendeld):
AGENT_CLI_MODELS_ENABLED=false # or true
Gebruik in plaats daarvan Work voor een model dat bestanden kan bewerken maar binnen een sandbox blijft: dit voert modellen met toolondersteuning uit in een afgesloten container met een geïsoleerde werkruimte.
Gebruik bijhouden
Open Providergebruik (/usage) en zoek Agents bovenaan. Claude Code, Codex, OpenCode, Pi en Strands-activiteit hebben expliciete vermeldingen, inclusief een duidelijke melding wanneer de geselecteerde periode geen geregistreerde aanroepen bevat.
CLI-aanroepen via LWUI registreren hun resultaat, duur en gemeld tokengebruik. Elke aanroep maakt één gebruiksgebeurtenis; herhaalde snapshots en rapporten per stap verdubbelen geen gebeurtenissen of tokens. Ontbrekende tokentellers blijven ongemeld. Een antwoord stoppen wordt als annulering geregistreerd; een mislukte CLI-afsluiting wordt geen succes doordat er gedeeltelijke tekst is geproduceerd. CLI-gebruik buiten LWUI wordt niet geïmporteerd.
Strands-aanroepen worden toegeschreven aan de agent Strands. Zie Agentgebruik voor de uitsplitsing en beperkingen.
Configuratie
| Variabele | Standaard | Doel |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | niet ingesteld | Zet de functie vast op true/false; niet ingesteld volgt de beheerdersschakelaar (standaard uit) |
AGENT_CLI_TIMEOUT_MS | 600000 | Hoelang één agentbeurt mag duren voordat deze wordt beëindigd |
Problemen oplossen
Er verschijnt geen groep Agents. Controleer of de functie is ingeschakeld onder Instellingen → Gebruikersbeheer → Toegang en beleid → CLI-agentmodellen (standaard is zij uit) en of u als beheerder bent aangemeld. Controleer vervolgens of de opdracht op het PATH staat van het proces dat de backend uitvoert, niet alleen van uw interactieve shell. Een servicebeheerder, Docker-container of desktopstartprogramma begint vaak met een veel kleiner PATH dan een aanmeldingsterminal.
Het antwoord mislukt onmiddellijk. Voer dezelfde opdracht handmatig uit als de servergebruiker (claude -p "hello" of codex exec "hello"). De meeste fouten ontstaan doordat de agent om een verlopen aanmelding vraagt of doordat de onderliggende abonnementslimiet is bereikt. Vooral OpenCode meldt een verlopen provideraanmelding alleen in de eigen logboeken; voer opencode auth login opnieuw uit als de servergebruiker.
Antwoorden stoppen halverwege. Een lange beurt kan AGENT_CLI_TIMEOUT_MS hebben bereikt. Verhoog de waarde of splits het verzoek op in kleinere stappen.