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.
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.
- Codex biedt de geconfigureerde standaardwaarde plus de gedocumenteerde familie voor aanmelding via ChatGPT: GPT-5.6 Sol, Terra, Luna en GPT-5.3 Codex Spark.
- 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.
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 Settings → Gebruikersbeheer → Agents. De instelling wordt bewaard en gaat onmiddellijk in, zonder herstart.
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.
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 Settings → Gebruikersbeheer → Agents (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.