Use um agente de programação instalado como modelo de chat
Se você já paga por um agente de programação e ele está conectado na máquina que executa o Libre WebUI, pode conversar com ele em um chat normal em vez de adicionar outra chave de API. O Libre WebUI detecta a interface de linha de comando do agente e a oferece no seletor de modelos como qualquer outro modelo.
O que é detectado
A cada solicitação da lista de modelos, o Libre WebUI procura estes comandos no PATH
do servidor:
| Modelo | Comando | Fornecido por |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
Tudo o que for encontrado aparecerá em um grupo Agentes no seletor de modelos. Nada é instalado para você e nenhum arquivo de configuração é necessário — se o comando for executado no shell do servidor, ele aparecerá.
Como escolher um modelo, e não apenas uma CLI
Cada CLI pode oferecer várias opções no grupo Agentes:
- O Claude Code oferece seu padrão conectado, além de Sonnet, Opus e Haiku.
- O Codex oferece seu padrão configurado, além da família documentada de login do ChatGPT: GPT-5.6 Sol, Terra, Luna e GPT-5.3 Codex Spark.
- O Pi é executado com o modelo configurado na própria CLI.
- O OpenCode lista os modelos de todos os provedores nos quais está autenticado
(a partir de
opencode models) e sempre exige uma escolha explícita — seu padrão no nível da CLI pode apontar para um servidor local inacessível pelo host do Libre WebUI.
O Pi executa cada interação sem estado (--no-session), com as ferramentas locais desativadas e um
prompt de sistema neutro; assim, as respostas não são influenciadas pela configuração pessoal do Pi
do usuário do sistema operacional do servidor, e as conversas nunca a acessam.
Como usar
- Entre como administrador.
- Inicie uma conversa e abra o seletor de modelos.
- Escolha uma opção em Agentes.
- Envie mensagens normalmente. As respostas chegam em streaming, token por token.
A conversa é armazenada como qualquer outro chat; portanto, você pode sair e voltar a ela, renomeá-la e pesquisá-la pela paleta de comandos. A cada interação, uma transcrição da conversa recente é enviada ao agente, e a resposta volta em streaming.
Quem pode usar e o que pode ser acessado
Este recurso é exclusivo para administradores, por um motivo importante. O agente é executado como o mesmo usuário do sistema operacional que o backend do Libre WebUI, no host — e não dentro de um contêiner do Work. Portanto, ele herda as credenciais do agente desse usuário e todo o acesso que esses agentes normalmente têm, incluindo a possibilidade de ler arquivos e executar comandos no servidor, caso decida fazê-lo.
Trate a ativação desse recurso como equivalente a conceder ao agente acesso ao shell da máquina. Por isso, o recurso vem desativado: um administrador precisa ativá-lo em Configurações → Gerenciamento de Usuários → Agentes. A configuração é persistida e entra em vigor imediatamente, sem reinicialização.
Para fixar a decisão no nível da implantação, independentemente da opção do ambiente de execução, defina a variável de ambiente como desejar (isso também bloqueia a opção na interface):
AGENT_CLI_MODELS_ENABLED=false # or true
Para usar um modelo que possa atuar sobre arquivos, mas permaneça dentro de um sandbox, use Work: ele executa modelos compatíveis com ferramentas em um contêiner restrito com espaço de trabalho isolado.
Configuração
| Variável | Padrão | Finalidade |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | unset | Fixa o recurso em true/false; unset delega à opção do administrador (desativada por padrão) |
AGENT_CLI_TIMEOUT_MS | 600000 | Tempo máximo de uma interação do agente antes de ser encerrada |
Solução de problemas
O grupo Agentes não aparece. Confirme se o recurso está ativado em
Configurações → Gerenciamento de Usuários → Agentes (ele é desativado por padrão), se você entrou
como administrador e, depois,
verifique se o comando está no PATH do processo que executa o backend — e não
apenas no seu shell interativo. Um gerenciador de serviços, contêiner Docker ou inicializador
desktop costuma iniciar com um PATH muito menor que o de um terminal de login.
A resposta falha imediatamente. Execute o mesmo comando manualmente como o usuário do servidor
(claude -p "hello" ou codex exec "hello"). Na maioria das vezes, a falha indica que o agente solicita
um login expirado ou que a assinatura subjacente atingiu um limite de taxa.
Em particular, o OpenCode informa um login de provedor expirado somente nos próprios logs;
execute novamente opencode auth login como o usuário do servidor.
As respostas param no meio. Uma interação longa pode ter atingido AGENT_CLI_TIMEOUT_MS. Aumente
esse valor ou divida a solicitação em etapas menores.