Использование установленного агента программирования как чат-модели
Если вы уже оплачиваете агента программирования и он вошёл в систему на компьютере Libre WebUI, можно общаться с ним в обычном чате вместо добавления API-ключа. Libre WebUI обнаруживает CLI агента и показывает его в выборе моделей.
Что обнаруживается
При каждом запросе списка Libre WebUI ищет на PATH сервера:
| Модель | Команда | Поставщик |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
Найденные команды появляются в группе Agents. Ничего не устанавливается и конфигурационный файл не нужен: если команда работает в shell сервера, она видна.
Выбор модели, не только CLI
Каждый CLI может дать несколько позиций:
- Claude Code предлагает вошедшее значение по умолчанию и Sonnet, Opus, Haiku.
- Codex предлагает настроенное значение и документированное семейство входа ChatGPT: GPT-5.6 Sol, Terra, Luna и GPT-5.3 Codex Spark.
- Pi работает с моделью своего CLI.
- OpenCode перечисляет модели всех аутентифицированных поставщиков (из
opencode models) и всегда требует выбора — значение CLI может указывать локальный сервер, недоступный хосту Libre WebUI.
Pi выполняет каждый ход без состояния (--no-session), с отключёнными локальными инструментами и нейтральным системным промптом, поэтому ответы не зависят от личной конфигурации Pi системного пользователя, а чаты её не затрагивают.
Использование
- Войдите как администратор.
- Создайте чат и откройте список моделей.
- Выберите позицию Agents.
- Отправляйте сообщения. Ответы поступают по токенам.
Диалог хранится как обычный чат: к нему можно вернуться, переименовать и найти через палитру. Каждый ход отправляет недавнюю транскрипцию агенту и стримит ответ.
Кто может использовать и к чему есть доступ
Функция только для администраторов, и это важно. Агент работает на хосте от того же пользователя ОС, что и бэкенд, а не в контейнере Work. Он наследует учётные данные и обычный доступ агентов, включая возможность чтения файлов и выполнения команд сервера.
Считайте включение эквивалентом предоставления shell-доступа. Поэтому функция поставляется выключенной: администратор включает её в Settings → Управление пользователями → Agents. Значение сохраняется и применяется сразу без перезапуска.
Чтобы закрепить решение на уровне развёртывания независимо от переключателя (и заблокировать его в интерфейсе), задайте переменную:
AGENT_CLI_MODELS_ENABLED=false # or true
Для модели, работающей с файлами в песочнице, используйте Work: она запускается в закрытом контейнере с изолированной областью.
Конфигурация
| Переменная | По умолчанию | Назначение |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | не задано | Закрепляет true/false; без значения действует переключатель администратора (по умолчанию выкл.) |
AGENT_CLI_TIMEOUT_MS | 600000 | Максимальная длительность одного хода |
Устранение неполадок
Группа Agents отсутствует. Убедитесь, что функция включена в Settings → Управление пользователями → Agents и вы вошли администратором. Затем проверьте команду на PATH процесса бэкенда, а не только интерактивной shell. Менеджер служб, контейнер или desktop-launcher часто имеет меньший PATH.
Ответ сразу завершается ошибкой. Запустите команду вручную от пользователя сервера (claude -p "hello" или codex exec "hello"). Обычно истёк вход агента или лимит подписки. OpenCode сообщает об истёкшем входе лишь в собственных журналах; повторите opencode auth login от пользователя сервера.
Ответ обрывается. Ход мог достичь AGENT_CLI_TIMEOUT_MS. Увеличьте лимит или разбейте запрос.