インストール済みコーディングエージェントをチャットモデルとして使う
すでにコーディングエージェントを契約していて、Libre WebUI を実行しているマシン上でサインイン済みなら、別の API キーを追加せず通常のチャットからそのエージェントと対話できます。Libre WebUI はエージェントのコマンドラインインターフェイスを検出し、ほかのモデルと同じようにモデルセレクターへ表示します。
検出対象
モデル一覧へのリクエストごとに、Libre WebUI はサーバーの PATH から次のコマンドを探します。
| モデル | コマンド | 提供元 |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| Kiro | kiro-cli | AWS |
| Muse Code | muse | Meta |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
見つかったものは、モデルセレクターのエージェントグループに表示されます。Libre WebUI が代わりにインストールすることはなく、設定ファイルも必要ありません。サーバーのシェルでコマンドを実行できれば表示されます。
設定 → チャット → デフォルトでも、これらはエージェントとして識別され、アカウントが使える場合は Strands も含まれます。プラグインモデルは提供元名を保ち、Ollama ラベルは Ollama モデルだけに付きます。Ollama を無効にしても設定済みエージェントやプラグインは隠れません。モデル情報カードは表示名と提供元を示し、サイズ、系列、形式はカタログに情報がある場合だけ表示します。
CLI だけでなくモデルを選ぶ
各 CLI は、エージェントグループに複数の項目を表示できます。
- Claude Code は、サインイン済みの既定モデルに加えて Sonnet、Opus、Haiku を提供します。
明示的な Sonnet 5.5(
claude-sonnet-5-5)、Opus 5.5(claude-opus-5-5)、Fable 5.2(claude-fable-5-2)、Haiku 5.5(claude-haiku-5-5)の選択肢も提供します。Sonnet 5.5 には Claude Code 2.1.284 以降、Opus 5.5 には Claude Code 2.1.280 以降、Fable 5.2 には Claude Code 2.1.321 以降、Haiku 5.5 には Claude Code 2.1.293 以降が必要で、いずれもサインイン済みアカウントの利用権限が必要です。claude updateを実行して CLI を更新してください。プランによっては、Fable の利用分がプランに含まれる利用上限ではなく利用クレジットに課金される場合があります。既存の Sonnet、Opus、Haiku のエイリアスは、引き続き CLI の現在のモデルマッピングに従います。 - Codex は、設定済みの既定モデルに加え、文書化された ChatGPT サインイン対応モデルファミリー、GPT-6 Astra、GPT-6.1 Sol (
gpt-6.1-sol)、GPT-6.1 Terra (gpt-6.1-terra)、GPT-6 Sol、GPT-6 Luna、GPT-5.6 Sol、Terra、Luna、GPT-5.5、GPT-5.3 Codex Spark を提供します。 実際に利用できるかどうかは、CLI のサインイン状態とアカウントのモデル利用権限によって決まります。 - Kiro は、設定済みの既定モデルに加えて、サインイン済みアカウントが使えるモデル(
kiro-cli chat --list-modelsから取得)を一覧表示します。各ターンは CLI の V3 エージェントエンジン上で非対話的に実行され、組み込みの既定エージェント(vibe)が固定されるため、カスタムのchat.defaultAgentは適用されません。Kiro CLI 2.27 以降が必要です。 - Muse Code は、設定済みの既定モデルに加えて Muse Ember 1.0(
muse-ember-1.0)、Muse Spark 1.3(muse-spark-1.3)、Muse Spark 1.3 Contributor(muse-spark-1.3-contributor)、Muse Wonder 1.0(muse-wonder-1.0)を提供します。Muse Ember は Meta の Muse モデルの中で最も小さく効率的なモデルで、サブエージェントの作業、ツール呼び出し、大量処理に向いています。Standard モードでのみ動作します。muse login(Meta アカウント)、またはMETA_API_KEYかmuse auth setで設定した Meta Model API キーでサインインします。Contributor モデルは、送信した内容を Meta が学習に使う可能性があるため、より低い料金で課金されます。 - Pi は、CLI 自体に設定されたモデルで実行します。
- OpenCode は、認証済みの全プロバイダーのモデル(
opencode modelsから取得)を一覧表示し、常に明示的な選択を求めます。CLI レベルの既定値が、Libre WebUI ホストから到達できないローカルサーバーを指している可能性があるためです。
組み込みの Strands エンジンも、アカウントが使える場合はエージェントグループに表示されます。これは CLI ではありません。バックエンド内で動作し、Ollama とプロバイダープラグインのモデルを動かします。単独の Strands 項目(strands)は既定のチャットモデルを使います。そのほかの項目(strands:<route>)は Strands · gpt-5.6-sol (Codex (ChatGPT)) のように利用可能なモデルごとに 1 つずつ表示され、その会話のモデルと提供元の両方を固定します。障害時に別の利用可能な提供元へ置き換えられることはありません。一覧の取得でエンジンが起動することはありません。
同じ Strands 項目は設定 → チャット → デフォルトの自動タイトル・推論要約のタスクモデルにも使えます。現在実行中のモデルを使用は会話に保存された Strands の選択を使います。これらの短いテキスト要求は基になるモデルを直接呼び、エージェントツールやセッションは使いません。他の CLI プロファイルでは、補助要求用に Ollama、プラグイン、Strands のタスクモデルが必要です。
Pi は各ターンをステートレス(--no-session)で実行し、ローカルツールを無効にして中立なシステムプロンプトを使います。そのため、返信がサーバーの OS ユーザー個人の Pi 設定に影響されたり、チャットがその設定に触れたりすることはありません。
Kiro はどちらの点でも逆です。サーバーユーザーの Kiro 設定で実行され、組み込みの既定エージェントは固定されますが、権限ルール(~/.kiro/settings/permissions.yaml)、MCP サーバー、設定済みの既定モデルは引き続き適用されます。また、各ターンはそのユーザーの Kiro セッションストアに新しいセッションとして保存されます(kiro-cli chat --list-sessions で表示でき、最近のチャットのトランスクリプトが含まれます)。これをオフにするフラグはないため、チャットの内容は Libre WebUI のデータベースの外、バックエンドユーザーのホームディレクトリにも残ります。Kiro のツールは有効なままです。権限ルールが信頼するもの(既定では読み取りと date などの読み取り専用コマンド)は確認なしで実行され、承認が必要なツール呼び出しはすべて拒否されます。チャットのターンではその確認に応答できないためです。
Muse Code はプロンプトを非公開のファイルから読み込み、承認をオフにして(--approval-mode never)ヘッドレスで実行します。チャットのターンでは承認の確認に応答できないためです。Muse 自身のサンドボックスは有効なままで、各ターンには終了後に削除される一時ワークスペースが割り当てられるため、ファイルの書き込みがサーバーユーザーのホームに残ることはありません。ターンは Muse のセッションログに保存されません(--no-session-log)が、サーバーユーザーの Muse 設定、ルール、既定モデルは適用されます。
使い方
- 管理者としてサインインします。
- チャットを開始し、モデルセレクターを開きます。
- エージェントにある項目を選びます。
- 通常どおりメッセージを送信します。返信はトークン単位でストリーミングされます。
会話はほかのチャットと同じように保存されるため、いったん離れて後から再開したり、名前を変更したり、コマンドパレットから検索したりできます。各ターンでは直近の会話記録をエージェントに送り、回答をストリーミングで返します。
利用できるユーザーと到達可能な範囲
この機能は管理者専用であり、それには重要な理由があります。エージェントは Work コンテナ内ではなく、ホスト上で Libre WebUI バックエンドと同じ OS ユーザーとして実行されます。そのため、そのユーザーのエージェント認証情報と、各エージェントが通常持つアクセス権を継承します。エージェントが必要と判断すれば、サーバー上のファイルを読んだりコマンドを実行したりする権限も含まれます。
有効化は、エージェントにマシンへのシェルアクセスを与えることと同等です。そのため既定では無効で、管理者が設定 → ユーザー管理 → アクセスとポリシー → エージェントCLIモデルで有効化する必要があります。設定は保存され、再起動なしで直ちに反映されます。
この切り替えを変更するとモデル一覧は即時更新されます。エージェントは直接 CLI 項目、プラグインモデルは Codex (ChatGPT) などのプロバイダー API 統合です。Strands も同じカテゴリーに表示されますが、この切り替えではなく独自の Strands エンジン のアクセス設定に従うため、エージェントCLIモデルがオフでも表示されることがあります。そのモデル検出が、インストール済み CLI エージェントの検出を妨げることはありません。
個別の CLI 設定を保存するまで、既存のインストールは従来保存したエージェントの有効状態を引き継ぎます。
実行時の切り替えに関係なくデプロイレベルで判断を固定するには、環境変数をどちらかの値に設定します(インターフェイス上の切り替えもロックされます)。
AGENT_CLI_MODELS_ENABLED=false # or true
ファイルを操作でき、サンドボックス内に留まるモデルが必要なら、代わりに Work を使ってください。Work はツール対応モデルを、隔離ワークスペースを備えた厳重に制限されたコンテナ内で実行します。
Work での同じエージェント
Work でも同じエージェントを同じモデルの選択肢と同じログインで使えますが、ホストではなくタスクのサンドボックス内で実行し、実際のトークンをサンドボックスに入れないエグレスプロキシを経由させます。これらには独自のアクセスモード Work のエージェントCLI があり、上記の切り替えは不要です。Work のエージェントCLI を参照してください。
使用量の記録
プロバイダー使用状況(/usage)を開き、上部近くのエージェントを確認してください。Claude Code、Codex、Kiro、Muse Code、OpenCode、Pi、Strands に独立した項目があり、期間内に記録がなければ明示されます。
LWUI 経由の CLI 呼び出しは結果、所要時間、報告されたトークン数を記録します。呼び出しごとに 1 件のイベントを作り、重複したスナップショットやステップ報告でイベントやトークンが二重計上されることはありません。欠けた数値は未報告のままです。応答の停止はキャンセルとして記録し、一部のテキストが出ても CLI が異常終了すれば成功扱いにしません。LWUI 外の呼び出しは取り込みません。
Strands の呼び出しは Strands エージェントに集計されます。内訳と制限はエージェント使用量を参照してください。
設定
| 変数 | 既定値 | 用途 |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | 未設定 | 機能を true/false に固定します。未設定なら管理者の切り替えに従います(既定ではオフ)。 |
AGENT_CLI_TIMEOUT_MS | 600000 | エージェントの 1 ターンを終了させるまで実行できる時間。 |
トラブルシューティング
エージェントグループが表示されない。 設定 → ユーザー管理 → アクセスとポリシー → エージェントCLIモデルで有効化済みであること(既定では無効)、管理者としてログインしていることを確認してください。コマンドは対話シェルだけでなく、バックエンドプロセスの PATH に必要です。サービス管理機能、Docker コンテナー、デスクトップランチャーの PATH はログイン端末より狭い場合があります。
返信がすぐに失敗する。 サーバーユーザーとして同じコマンド(claude -p "hello"、codex exec "hello"、muse exec "hello"、または echo hello | kiro-cli chat --no-interactive --output-format stream-json --agent-engine v3 --agent vibe)を手動で実行してください。Kiro CLI 2.27 以降が必要です。古い CLI はまずここで失敗し、エラーを確認できます。チャットでは同じ失敗が Kiro exited unsuccessfully としか表示されません。多くの場合、エージェントのログイン期限切れや、基盤となるサブスクリプションのレート制限が原因です。特に OpenCode は、プロバイダーのログイン期限切れを自身のログにしか表示しません。サーバーユーザーとして opencode auth login を再実行してください。Kiro は kiro-cli login でサインインし、セッションの期限が切れた場合も同じように失敗します。Muse Code は、サーバーユーザーとして muse login を実行するまで missing meta credentials と表示します。
返信が途中で止まる。 長いターンが AGENT_CLI_TIMEOUT_MS に達した可能性があります。値を増やすか、依頼を小さな手順に分けてください。