Lewati ke konten utama

Gunakan Agen Koding Terpasang sebagai Model Chat

Jika Anda sudah membayar agen koding dan agen masuk di komputer Libre WebUI, gunakan melalui chat biasa tanpa kunci API tambahan. Libre WebUI mendeteksi CLI dan menampilkannya di pemilih model.

Yang Dideteksi​

ModelPerintahPenyedia
Claude CodeclaudeAnthropic
CodexcodexOpenAI
Kirokiro-cliAWS
Muse CodemuseMeta
OpenCodeopencodeSST
PipiMario Zechner

Perintah dicari di PATH server dan muncul dalam Agents. Tidak ada instalasi tambahan.

Pengaturan → Chat → Bawaan juga menandai entri ini sebagai Agen, termasuk Strands jika akun Anda boleh menggunakannya. Model plugin tetap memakai nama penyedia; hanya Ollama mendapat label Ollama. Mematikan Ollama tidak menyembunyikan agen atau plugin. Kartu informasi menampilkan nama dan penyedia, serta ukuran, keluarga, dan format hanya jika katalog menyediakannya.

Memilih Model​

Setiap CLI dapat menyediakan beberapa pilihan dalam grup Agen:

  • Claude Code: bawaan, Sonnet, Opus, Haiku. Tersedia pula pilihan eksplisit Sonnet 5.5 (claude-sonnet-5-5), Opus 5.5 (claude-opus-5-5), dan Haiku 5.5 (claude-haiku-5-5). Sonnet 5.5 memerlukan Claude Code 2.1.284 atau yang lebih baru, Opus 5.5 memerlukan Claude Code 2.1.280 atau yang lebih baru, dan Haiku 5.5 memerlukan Claude Code 2.1.293 atau yang lebih baru, semuanya dengan akses melalui akun yang masuk; jalankan claude update untuk memperbarui CLI. Alias Sonnet, Opus, dan Haiku yang ada tetap mengikuti pemetaan model CLI saat ini.
  • Codex: bawaan, GPT-6 Astra, GPT-6.1 Sol (gpt-6.1-sol), GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, Terra, Luna, GPT-5.5, GPT-5.3 Codex Spark. Ketersediaan bergantung pada sesi masuk CLI dan akses akun.
  • Kiro: model yang dapat dipakai akun yang masuk (dari kiro-cli chat --list-models) di samping bawaan yang dikonfigurasi. Setiap giliran berjalan non-interaktif di mesin agen V3 milik CLI dengan agen bawaan tertanam (vibe) yang dikunci, sehingga chat.defaultAgent kustom tidak berlaku. Memerlukan Kiro CLI 2.27 atau yang lebih baru.
  • Muse Code: bawaan yang dikonfigurasi ditambah Muse Spark 1.3 (muse-spark-1.3), Muse Spark 1.3 Contributor (muse-spark-1.3-contributor), dan Muse Wonder 1.0 (muse-wonder-1.0). Masuk dengan muse login (akun Meta) atau kunci Meta Model API dari META_API_KEY atau muse auth set. Model Contributor ditagih dengan tarif lebih rendah karena Meta dapat melatih model dengan apa yang Anda kirimkan ke model tersebut.
  • Pi: model CLI.
  • OpenCode: model penyedia dari opencode models.

Mesin Strands tertanam juga muncul di grup Agen jika akun Anda boleh menggunakannya. Mesin ini bukan CLI: mesin berjalan di dalam backend dan menjalankan model Ollama serta plugin penyedia Anda. Entri Strands biasa (strands) memakai model chat default Anda. Entri lainnya (strands:<route>) tercantum satu per model yang tersedia, misalnya Strands · gpt-5.6-sol (Codex (ChatGPT)), dan mengunci model beserta penyedianya untuk percakapan itu; penyedia lain yang tersedia tidak dapat menggantikannya saat terjadi gangguan. Menampilkan daftar pilihan tidak menyalakan mesin.

Entri Strands yang sama dapat menjadi model tugas di Pengaturan → Chat → Bawaan untuk judul otomatis dan ringkasan penalaran. Gunakan model yang sedang berjalan memakai pilihan Strands yang tersimpan di percakapan. Permintaan teks singkat ini memanggil model penyedia yang mendasarinya secara langsung; permintaan ini tidak menjalankan alat agen atau membuat sesi agen. Profil CLI lain memerlukan model tugas Ollama, plugin, atau Strands untuk permintaan tambahan tersebut.

Pi berjalan tanpa status (--no-session), alat lokal mati, dan perintah sistem netral.

Kiro justru kebalikannya dalam kedua hal: ia berjalan dengan konfigurasi Kiro milik pengguna server (agen bawaan tertanam dikunci, tetapi aturan izin (~/.kiro/settings/permissions.yaml), server MCP, dan model bawaan yang dikonfigurasi tetap berlaku), dan setiap giliran disimpan sebagai sesi baru di penyimpanan sesi Kiro milik pengguna itu (kiro-cli chat --list-sessions menampilkannya, beserta transkrip chat terbaru di dalamnya). Tidak ada flag untuk mematikannya, sehingga isi chat juga tersimpan di direktori home pengguna backend, di luar basis data Libre WebUI. Alat Kiro tetap aktif: apa pun yang dipercaya aturan izin tersebut (secara bawaan, pembacaan dan perintah hanya-baca seperti date) berjalan tanpa bertanya, dan setiap panggilan alat yang memerlukan persetujuan ditolak, karena giliran chat tidak dapat menjawab prompt tersebut.

Muse Code membaca prompt dari berkas privat dan berjalan headless dengan persetujuan mati (--approval-mode never), karena giliran chat tidak dapat menjawab prompt persetujuan. Sandbox miliknya sendiri tetap aktif, dan setiap giliran mendapat ruang kerja sementara yang dihapus setelahnya, sehingga penulisan berkasnya tidak dapat masuk ke direktori home pengguna server. Giliran tidak disimpan di log sesi Muse (--no-session-log), tetapi pengaturan, aturan, dan model bawaan Muse milik pengguna server tetap berlaku.

Penggunaan​

  1. Masuk sebagai admin.
  2. Buka pemilih model.
  3. Pilih Agents.
  4. Kirim pesan.

Percakapan disimpan seperti chat lain dan tiap giliran mengirim riwayat terbaru ke agen.

Siapa yang dapat memakai dan apa yang dapat diakses​

Fitur ini khusus administrator karena agen berjalan sebagai pengguna OS yang sama dengan backend Libre WebUI, pada host, bukan kontainer Work. Ia mewarisi kredensial serta akses normal agen, termasuk membaca berkas dan menjalankan perintah di server jika diperlukan.

Mengaktifkannya setara dengan memberikan akses shell ke komputer. Karena itu fitur dinonaktifkan secara default dan harus diaktifkan administrator di Pengaturan → Manajemen Pengguna → Akses dan kebijakan → Model agen CLI. Pilihan disimpan dan langsung berlaku tanpa restart.

Mengubah kontrol ini langsung menyegarkan katalog model. Kategori Agen berisi entri CLI langsung, sedangkan Model Plugin berisi integrasi API penyedia seperti Codex (ChatGPT). Strands tercantum di kategori yang sama, tetapi mengikuti pengaturan akses Mesin Strands miliknya sendiri, bukan sakelar ini, sehingga Strands dapat muncul saat model agen CLI mati. Penemuan modelnya tidak dapat menghalangi penemuan agen CLI yang terpasang.

Instalasi lama mewarisi pilihan Agen terdahulu sampai pengaturan CLI independen disimpan.

Untuk mengunci pilihan pada tingkat penerapan, tanpa mengikuti kontrol runtime, tetapkan variabel lingkungan ke salah satu nilai berikut. Ini juga mengunci sakelar UI:

AGENT_CLI_MODELS_ENABLED=false   # or true

Jika model perlu mengolah berkas namun tetap dalam sandbox, gunakan Work: model berkemampuan alat berjalan di kontainer terkunci dengan ruang terisolasi.

Agen yang sama di Work​

Work menawarkan agen yang sama dengan pilihan model dan login yang sama, tetapi menjalankannya di dalam sandbox tugas, bukan di host, di balik proxy egress yang menjaga token asli tetap di luar sandbox. Agen ini punya mode akses sendiri, CLI agen di Work, dan tidak memerlukan sakelar di atas. Lihat CLI agen di Work.

Pencatatan penggunaan​

Buka Penggunaan Penyedia (/usage) dan temukan Agen di bagian atas. Claude Code, Codex, Kiro, Muse Code, OpenCode, Pi, serta Strands memiliki entri terpisah dan pesan jelas jika periode itu tanpa catatan.

Panggilan CLI lewat LWUI mencatat hasil, durasi, dan token yang dilaporkan. Satu pemanggilan menghasilkan satu event; snapshot atau laporan langkah berulang tidak menggandakan event dan token. Penghitung yang hilang tetap tidak dilaporkan. Menghentikan respons dicatat sebagai pembatalan, dan exit gagal tidak menjadi sukses hanya karena ada teks parsial. Panggilan di luar LWUI tidak diimpor.

Panggilan Strands dicatat atas nama agen Strands. Lihat Penggunaan agen untuk rincian dan batasnya.

Konfigurasi​

VariabelBawaanTujuan
AGENT_CLI_MODELS_ENABLEDtidak disetelPaksa true/false; jika kosong memakai sakelar admin
AGENT_CLI_TIMEOUT_MS600000Batas giliran

Pemecahan Masalah​

Grup Agen tidak muncul. Pastikan fitur aktif di Pengaturan → Manajemen Pengguna → Akses dan kebijakan → Model agen CLI (default nonaktif) dan Anda masuk sebagai administrator. Perintah harus ada di PATH proses backend, bukan hanya shell interaktif. Manajer layanan, kontainer Docker, atau peluncur desktop sering memakai PATH yang lebih sempit daripada terminal login.

Jawaban langsung gagal. Jalankan (claude -p "hello", codex exec "hello", muse exec "hello", atau echo hello | kiro-cli chat --no-interactive --output-format stream-json --agent-engine v3 --agent vibe) sebagai pengguna server. Kiro CLI 2.27 atau yang lebih baru diperlukan; CLI yang lebih lama gagal lebih dulu di sini, tempat galatnya terlihat, sedangkan di chat kegagalan yang sama hanya tampil sebagai Kiro exited unsuccessfully. Perbarui masuk dengan opencode auth login bila perlu. Kiro masuk melalui kiro-cli login; sesi yang kedaluwarsa gagal dengan cara yang sama. Muse Code menampilkan missing meta credentials sampai muse login dijalankan sebagai pengguna server.

Jawaban terhenti. Naikkan AGENT_CLI_TIMEOUT_MS atau pecah permintaan.

Terkait​