Menghubungkan Gateway

Gateway memungkinkan agent Anda memakai akun Claude Code atau Codex (ChatGPT) milik Anda sendiri, baik lewat langganan maupun API key, sebagai ganti credit Qlar.

Anda menjalankan sebuah program kecil di komputer atau server yang Anda kendalikan, di samping Claude Code dan/atau Codex. Program ini membuka satu koneksi keluar (outbound) ke layanan gateway Qlar, menerima request dari agent Anda, menjalankannya lewat tool tersebut, lalu mengirimkan jawabannya kembali. Tidak ada yang terhubung masuk, jadi tidak perlu mengubah firewall.

Siapa yang bisa melakukannya? Owner dan Admin, di organization yang gateway-nya sudah dinyalakan oleh Qlar. Bila tombol Connect a gateway tidak terlihat, minta support Qlar menyalakan gateway untuk organization Anda.

Model Qlar, API key, dan gateway

Organization bisa mendapatkan model dari tiga tempat. Ketiganya tampil berdampingan di Organization → AI Models, dan agent Anda memilihnya dengan cara yang sama.

Pilih gateway bila Anda sudah membayar paket Claude atau ChatGPT dan ingin agent Anda memakainya, atau bila sebuah API key sama sekali tidak boleh keluar dari mesin Anda sendiri. Pilih API key bila model harus tersedia sepanjang waktu tanpa bergantung pada komputer Anda yang menyala.

Apa yang dilindungi gateway, dan apa yang tidak

Gateway melindungi:

• Jaringan Anda. Gateway hanya terhubung keluar lewat HTTPS. Tidak ada port inbound, tidak ada socket yang mendengarkan.
• Key dan sign-in Anda. API key yang Anda berikan ke gateway disimpan terenkripsi di komputer itu, dan sign-in Claude Code serta Codex tetap di tempatnya. Tidak satu pun pernah dikirim ke Qlar.
• Komputer Anda. Claude Code dan Codex dijalankan di folder sementara yang kosong dengan tool bawaannya dimatikan: tanpa shell, tanpa file, tanpa web, tanpa server MCP atau plugin. Request yang mencoba memakainya dihentikan. (Pembuatan gambar oleh Codex adalah satu-satunya pengecualian, untuk request gambar.)
• Siapa yang boleh terhubung. Kode sekali pakai tidak berguna dengan sendirinya. Gateway tidak melayani apa pun sampai seseorang menyetujui fingerprint key-nya di Qlar, dan Qlar tidak pernah menyimpan kode tersebut.

Gateway tidak melindungi:

• Isi percakapan. Pertanyaan user dan jawabannya tetap melewati Qlar dan sampai ke Anthropic atau OpenAI lewat akun Anda. Ketentuan dan pengaturan data akun itu yang berlaku.
• Ketersediaan. Komputer harus tetap menyala dan gateway tetap berjalan. Selama mati, agent yang memakai modelnya tidak bisa menjawab, dan panggilan voice di gateway itu berakhir.
• Batas paket Anda. Batas pemakaian, aturan fair use, dan ketentuan langganan Anda berlaku untuk semua yang dikirim agent lewat gateway. Saat paket mencapai batasnya, jawaban gagal sampai batasnya direset.
• Kapasitas. Satu gateway menjalankan 2 request sekaligus secara default (kartu gateway menampilkan batasnya sendiri). Request lebih dari itu ditolak sebagai sibuk, jadi gateway lebih cocok untuk tim internal atau pilot daripada website publik yang ramai.
• Siapa pun yang bisa memakai komputer itu sebagai user yang menjalankan gateway juga bisa memakai tool yang sudah sign-in.

Sebelum mulai

• Komputer atau server yang bisa tetap menyala:
  • Windows 10 atau 11, x64 (Windows on Arm menjalankannya lewat emulasi). Memakai PowerShell; tidak perlu hak admin untuk memasang.
  • macOS dengan Apple silicon (M1 atau lebih baru). Mac Intel tidak didukung.
  • Linux x64 atau arm64 dengan glibc (Debian, Ubuntu, Fedora, …). Alpine dan sistem berbasis musl lainnya tidak didukung.
• Claude Code dan/atau Codex sudah terpasang di komputer itu. Anda sign-in ke keduanya di langkah 4, dengan langganan (paket Claude atau ChatGPT Anda) atau API key.
• HTTPS keluar (port 443) dari komputer itu. Untuk voice dengan langganan ChatGPT, juga UDP port 3478 keluar (lihat Voice di gateway Anda).
• Role Owner atau Admin di organization.

Menyiapkannya

Buka halaman Organization → Configure pada organization Anda → tile AI Models → tab Sources.

1. Beri nama dan pilih sistemnya

Klik Connect a gateway. Isi Name gateway dengan nama yang akan dikenali tim Anda di daftar model, misalnya "Office PC" (bisa diganti nanti), lalu pilih sistem komputer tempat gateway akan berjalan: Windows, macOS, atau Linux. Klik Create code.

2. Jalankan perintahnya di komputer itu

Qlar menampilkan satu perintah, dibuat untuk sistem yang Anda pilih, dengan kode sekali pakai Anda sudah ada di dalamnya. Klik Copy command, lalu di komputer itu:

Perintahnya terlihat seperti ini. Selalu salin dari halaman, karena Qlar mengisi alamat layanan gateway dan kode Anda:

# Windows
& ([scriptblock]::Create((irm 'https://<gateway service>/install.ps1'))) -Code 'XXXX-XXXX-XXXX' -Force

# macOS dan Linux
curl -fsSL 'https://<gateway service>/install.sh' | sh -s -- --code 'XXXX-XXXX-XXXX' --force

Perintah ini mengunduh gateway, memeriksa checksum-nya, memasangnya untuk user Anda (tanpa hak admin), lalu menghubungkannya dengan kode Anda. Biarkan jendelanya tetap terbuka: gateway terus berjalan di sana.

Perlu diketahui:

• Kode hanya sekali pakai dan kedaluwarsa setelah 15 menit. Qlar tidak menyimpannya, jadi kode tidak bisa ditampilkan lagi. Bila kedaluwarsa atau hilang, klik Get a new code.
• Menyiapkan dari ponsel? Ketuk Send to my computer… untuk mengirim perintah ke diri sendiri (lewat pesan atau email) lalu buka di komputer. Bila berbagi tidak tersedia, tombol ini menyalin perintahnya.
• Menjalankannya di komputer yang sudah punya gateway akan menggantikan gateway itu. Perintah ini selalu melakukan enrolment ulang.
• Gateway sudah terpasang? Halaman juga menampilkan perintah yang lebih pendek, qlar-inference-gateway enroll --hub … --code … --force.
• Anda boleh meninggalkan halaman. Penyiapan dilanjutkan dari kartu gateway di Sources. Cancel menghapus gateway yang belum disetujui.

3. Bandingkan fingerprint lalu setujui

Setelah perintah berjalan, gateway mencetak key fingerprint di terminal: 16 grup berisi 4 karakter, dalam 4 baris. Qlar menampilkan nama komputer, sistemnya, dan fingerprint yang sama dengan susunan yang sama.

Bandingkan setiap grup, dan setujui hanya bila semuanya identik. Klik Fingerprint matches — approve.

Inilah langkah yang penting. Sampai Anda menyetujuinya, gateway tidak menerima apa pun. Bila fingerprint berbeda dengan terminal Anda, berarti orang lain memakai kode Anda: klik It doesn't match — cancel lalu mulai lagi.

4. Sign-in setiap tool dan pilih model

Kembali di terminal, gateway menanyakan cara sign-in untuk setiap tool yang ditemukannya:

• Subscription memakai sign-in tool itu sendiri: paket Claude Anda untuk Claude Code, paket ChatGPT Anda untuk Codex.
• API key meminta sebuah key (diketik tersembunyi). Key disimpan terenkripsi di komputer itu dan tidak pernah sampai ke Qlar.

Qlar menampilkan status setiap tool, misalnya Claude Code · subscription (Max) atau Codex (ChatGPT) · not signed in, beserta model yang ditawarkan komputer itu. Centang model yang boleh dipakai agent Anda dan beri masing-masing sebuah nama: itulah yang dilihat tim Anda di daftar model. Nama memakai huruf kecil, angka, ., _, atau -, dan tidak boleh berisi + (tanda Fast mode). Klik Finish.

Tool yang belum sign-in menampilkan apa yang perlu dijalankan di komputer itu, yaitu claude (lalu sign-in) untuk Claude Code dan codex login untuk Codex, sebagai user yang sama dengan yang menjalankan gateway. Setelah sign-in, restart gateway atau tunggu hingga 5 menit sampai gateway mendeteksinya. Anda bisa kembali menambah model nanti lewat tombol Models di kartu gateway.

Hanya model yang bisa chat, memanggil tool, dan mengembalikan jawaban terstruktur yang ditawarkan; Claude Code dan Codex sama-sama bisa.

5. Jaga agar tetap berjalan

Gateway berjalan di jendela tempat Anda memulainya, jadi gateway berhenti saat jendela itu ditutup atau komputer di-restart. Setelah penyiapan selesai, hentikan gateway (Ctrl+C) lalu pasang sebagai service, sekali saja:

Service berjalan sebagai user Anda, jadi memakai sign-in Claude Code dan Codex yang sama. Selesai: kartunya menampilkan Connected · ● Online.

Memakai model gateway

Model gateway tampil di Models dalam grupnya sendiri, Your gateways, beserta tempat model itu berjalan: ● Office PC saat online, ○ Office PC, offline 3 h ago saat tidak.

Sejak itu Anda memakainya seperti model lain:

• Di sebuah agent: sebagai model percakapan, di Allowed Conversation AI Models, dan sebagai Answering AI model untuk panggilan voice Natural conversation. Daftar model mengelompokkannya di bawah nama gateway.
• Sebagai default fitur di Defaults, untuk semua fitur kecuali KB Training.

Yang perlu Anda ketahui:

• Tidak ada credit Qlar yang ditagih untuk token model gateway. Tool yang dipakai jawabannya, seperti web search, knowledge base, dan plugin, tetap ditagih seperti biasa.
• Tidak untuk training konten atau deskripsi gambar. Training knowledge base dan deskripsi gambar yang diunggah tetap memakai model Qlar atau API key; model gateway tidak ditawarkan di sana.
• Jawaban gagal selama komputer offline. User melihat "This assistant can't answer right now. Please try again later." dan tidak pernah melihat nama komputer. Bila semua slot request-nya sedang terpakai, user melihat "This assistant is busy right now. Please try again in a moment." Detailnya, dengan nama gateway dan alasannya, masuk ke Monitoring Logs agent. Halaman AI Models juga menampilkan banner selama gateway yang modelnya dipakai sedang offline.
• Bila Qlar mematikan gateway untuk organization Anda, modelnya berhenti dipakai dan fitur kembali ke default Qlar. Tidak ada yang dihapus: semuanya kembali seperti semula saat gateway dinyalakan lagi. Selama itu Anda tetap bisa menghapus gateway.

Voice di gateway Anda

Gateway yang punya Codex juga bisa menjalankan suara panggilan Natural conversation, memakai realtime voice dari akun yang sign-in di komputer itu. Claude Code tidak punya voice.

Di halaman Conversation → Voice milik agent, pilih Natural conversation, lalu di Voice runs on pilih gateway sebagai ganti Qlar. Gateway yang tidak bisa menerima panggilan tampil abu-abu beserta alasannya (offline, belum terhubung, tool-nya tidak bisa voice, atau Codex belum sign-in).

Voice di gateway tidak tersedia selama Mode Privasi menyala; panggilan agent yang diatur ke gateway berakhir sampai mode itu dimatikan. Bila gateway yang menjalankan voice sebuah agent dihapus, panggilan agent itu berhenti sampai Anda memilih lagi tempat voice berjalan. Panduan Berbicara dengan Suara menjelaskan lebih lanjut.

Menjalankannya

Kartu setiap gateway di Sources menampilkan statusnya, komputernya, sistem dan versinya, jumlah request yang sedang berjalan, dan cara setiap tool sign-in. Menu ⋯ berisi sisanya.

Menghapus gateway memutusnya untuk selamanya (gateway berhenti di komputernya dan tidak bisa dipakai lagi), dan:

• modelnya dihapus dari organization, dan agent yang memakainya kembali ke default organization;
• default fitur yang memakainya kembali ke default Qlar, yang memakai credit Qlar;
• agent yang voice-nya berjalan di gateway itu berhenti menerima panggilan voice sampai voice lain dipilih. Panggilannya tidak pindah ke voice Qlar.

Gateway yang belum pernah disetujui langsung dihapus. Untuk menghapus programnya dari komputer juga, jalankan qlar-inference-gateway uninstall-service (dengan hak admin di Windows), "$HOME/.local/bin/qlar-inference-gateway" uninstall-service di macOS, atau sudo "$HOME/.local/bin/qlar-inference-gateway" uninstall-service di Linux, lalu hapus programnya.

Troubleshooting

Halaman Terkait

• Memakai API Key Sendiri
• AI Models (organization)
• Referensi layar AI Models
• Pengaturan Natural Conversation
• Model & Context