将已安装的编程 Agent 用作聊天模型
如果已付费使用编程 Agent，并在 Libre WebUI 后端机器上登录，就可以在普通聊天中使用它，而无需另加 API 密钥。Libre WebUI 会检测 CLI 并在模型选择器中显示。
检测内容
每次请求模型列表时，Libre WebUI 在服务器 PATH 中查找：
| 模型 | 命令 | 提供方 |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
发现的命令出现在Agent组中；系统不会代为安装，也不需要配置文件。
选择模型，而不只是 CLI
- Claude Code 提供默认模型和 Sonnet、Opus、Haiku。
- Codex 提供默认模型以及 GPT-5.6 Sol、Terra、Luna、GPT-5.3 Codex Spark。
- Pi 使用 CLI 中配置的模型。
- OpenCode 从
opencode models列出已认证提供商并要求明确选择；CLI 默认值可能指向 Libre WebUI 主机无法访问的本地服务器。
Pi 以 --no-session 无状态运行，禁用本地工具并使用中性系统 Prompt，不会读写服务器用户的个人 Pi 配置。
使用方法
- 以管理员身份登录。
- 打开聊天和模型选择器。
- 在 Agent 中选择。
- 正常发送，回复逐 Token 流式返回。
聊天可保存、重命名和搜索；每轮会发送最近对话转录。
谁能使用及其访问范围
此功能仅限管理员。Agent 以与后端相同的操作系统用户在主机运行，而非 Work 容器，因此继承该用户的 Agent 凭据、文件和命令访问权。启用它等同于授予 Shell 权限，所以默认关闭，必须在设置 → 用户管理 → Agent中启用，并立即生效。
部署级固定并锁定界面：
AGENT_CLI_MODELS_ENABLED=false # or true
需要沙箱文件访问时使用 Work。
配置
| 变量 | 默认值 | 用途 |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | 未设置 | 固定 true/false，否则使用管理开关 |
AGENT_CLI_TIMEOUT_MS | 600000 | 单轮最长运行时间 |
故障排除
没有 Agent 组 — 检查功能开关、管理员身份和后端进程的 PATH。
立即失败 — 以服务器用户运行 claude -p "hello" 或 codex exec "hello"，检查登录或订阅限额；OpenCode 可重新执行 opencode auth login。
回复中断 — 提高 AGENT_CLI_TIMEOUT_MS 或拆分请求。