Usar un agente de programación instalado como modelo de chat
Si ya pagas por un agente y ha iniciado sesión en la máquina que ejecuta Libre WebUI, puedes hablar con él desde un chat normal sin añadir otra clave API. Libre WebUI detecta su CLI y la ofrece en el selector.
Qué se detecta
En cada solicitud de modelos, Libre WebUI busca estos comandos en el PATH del servidor:
| Modelo | Comando | Proveedor |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
Lo encontrado aparece en Agentes. No se instala nada ni hace falta configuración: si el comando funciona en el shell del servidor, aparece.
Elegir un modelo, no solo una CLI
- Claude Code ofrece el predeterminado y Sonnet, Opus y Haiku.
- Codex ofrece el predeterminado y GPT-5.6 Sol, Terra, Luna y GPT-5.3 Codex Spark.
- Pi usa el modelo configurado en su CLI.
- OpenCode lista los modelos de los proveedores autenticados (
opencode models) y exige una selección explícita.
Pi ejecuta cada turno sin estado (--no-session), sin herramientas locales y con un mensaje neutro, por lo que no toca la configuración personal del usuario del servidor.
Uso
- Inicia sesión como administrador.
- Abre un chat y el selector.
- Elige una entrada de Agentes.
- Envía mensajes normalmente; las respuestas fluyen token a token.
La conversación se guarda como cualquier chat. Cada turno envía una transcripción reciente al agente.
Quién puede usarlo y a qué accede
Es una función solo para administradores. El agente se ejecuta en el host como el mismo usuario del backend, no dentro de Work. Hereda sus credenciales y acceso, incluida la posibilidad de leer archivos o ejecutar comandos.
Activarla equivale a dar acceso shell al agente. Por eso viene desactivada y un administrador debe habilitarla en Configuración → Gestión de usuarios → Agentes. Se aplica inmediatamente sin reiniciar.
Para fijar la decisión en el despliegue:
AGENT_CLI_MODELS_ENABLED=false # or true
Para actuar sobre archivos dentro de un sandbox, usa Work.
Configuración
| Variable | Predeterminado | Propósito |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | sin definir | Fijar true/false; sin valor usa el interruptor de administración |
AGENT_CLI_TIMEOUT_MS | 600000 | Duración máxima de un turno antes de terminarlo |
Solución de problemas
No aparece Agentes. Confirma que esté activado, que seas administrador y que el comando esté en el PATH
del proceso del backend, no solo en tu shell interactivo.
La respuesta falla de inmediato. Ejecuta el comando como usuario del servidor (claude -p "hello" o
codex exec "hello"). Suele ser una sesión caducada o un límite del abono. Para OpenCode, repite
opencode auth login como usuario del servidor.
La respuesta se detiene. Puede haber alcanzado AGENT_CLI_TIMEOUT_MS; auméntalo o divide la petición.