설치된 코딩 에이전트를 채팅 모델로 사용하기
이미 코딩 에이전트를 구독하고 있고 Libre WebUI를 실행하는 컴퓨터에서 로그인되어 있다면 별도의 API 키를 추가하는 대신 일반 채팅에서 사용할 수 있습니다. Libre WebUI는 에이전트의 명령줄 인터페이스를 감지하고 다른 모델처럼 모델 선택기에 표시합니다.
감지되는 항목
Libre WebUI는 모델 목록을 요청할 때마다 서버의 PATH에서 다음 명령을 찾습니다.
| 모델 | 명령 | 제공자 |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
찾은 항목은 모델 선택기의 에이전트 그룹에 나타납니다. Libre WebUI가 대신 설치해 주는 항목은 없으며 설정 파일도 필요하지 않습니다. 서버 셸에서 명령이 실행되면 표시됩니다.
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 설정이 응답에 영향을 주거나 채팅에 접근하지 않습니다.
사용 방법
- 관리자로 로그인합니다.
- 채팅을 시작하고 모델 선택기를 엽니다.
- 에이전트 아래에서 항목을 선택합니다.
- 평소처럼 메시지를 보냅니다. 응답은 토큰 단위로 스트리밍됩니다.
대화는 다른 채팅과 동일하게 저장되므로 나갔다가 다시 돌아오고, 이름을 바꾸고, 명령 팔레트에서 검색할 수 있습니다. 각 턴은 최근 대화 기록을 에이전트에 보내고 답변을 스트리밍합니다.
사용할 수 있는 사람과 접근 가능한 범위
이 기능은 관리자 전용이며 그 이유가 중요합니다. 에이전트는 Work 컨테이너 안이 아니라 호스트에서 Libre WebUI 백엔드와 동일한 운영 체제 사용자로 실행됩니다. 따라서 해당 사용자의 에이전트 자격 증명과 에이전트가 일반적으로 갖는 모든 접근 권한을 상속합니다. 에이전트가 결정하면 서버의 파일을 읽고 명령을 실행할 수도 있습니다.
이 기능을 활성화하는 것은 에이전트에 컴퓨터의 셸 접근 권한을 부여하는 것과 동일하게 취급하세요. 이 때문에 기능은 비활성화된 상태로 제공됩니다. 관리자가 설정 → 사용자 관리 → 에이전트에서 켜야 합니다. 설정은 저장되며 다시 시작하지 않아도 즉시 적용됩니다.
런타임 토글과 관계없이 배포 수준에서 결정을 고정하려면 환경 변수를 어느 쪽으로든 설정하세요. 그러면 인터페이스의 토글도 잠깁니다.
AGENT_CLI_MODELS_ENABLED=false # or true
파일을 다룰 수 있으면서 샌드박스 안에 머무르는 모델이 필요하면 Work를 사용하세요. 도구를 지원하는 모델을 격리된 워크스페이스가 있는 엄격히 제한된 컨테이너에서 실행합니다.
설정
| 변수 | 기본값 | 용도 |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | 설정 안 됨 | 기능을 true/false로 고정합니다. 설정하지 않으면 관리자 토글(기본값 꺼짐)을 따릅니다. |
AGENT_CLI_TIMEOUT_MS | 600000 | 에이전트의 한 턴이 종료되기 전까지 실행할 수 있는 시간 |
문제 해결
에이전트 그룹이 나타나지 않습니다. 설정 → 사용자 관리 → 에이전트에서 기능이 활성화되어 있는지(기본값은 꺼짐), 관리자로 로그인했는지 확인하세요. 그다음 대화형 셸이 아니라 백엔드를 실행하는 프로세스의 PATH에 명령이 있는지 확인하세요. 서비스 관리자, Docker 컨테이너 또는 데스크톱 실행기는 로그인 터미널보다 훨씬 짧은 PATH로 시작하는 경우가 많습니다.
응답이 즉시 실패합니다. 서버 사용자로 동일한 명령을 직접 실행하세요(claude -p "hello" 또는 codex exec "hello"). 대부분은 에이전트 로그인이 만료되었거나 기본 구독의 사용량 제한에 도달해서 발생합니다. 특히 OpenCode는 만료된 제공자 로그인을 자체 로그에만 보고하므로 서버 사용자로 opencode auth login을 다시 실행하세요.
응답이 도중에 멈춥니다. 긴 턴이 AGENT_CLI_TIMEOUT_MS에 도달했을 수 있습니다. 값을 늘리거나 요청을 더 작은 단계로 나누세요.