Takeover Sekali Klik untuk Alat Pemrograman AI

Takeover sekali klik (Takeover) memungkinkan Anda mengarahkan alat CLI pemrograman AI yang umum digunakan ke gateway AI lokal tanpa perlu mengedit file konfigurasi secara manual. Setelah takeover, semua permintaan dari alat-alat ini akan dirutekan melalui http://127.0.0.1:11580, yang kemudian diteruskan ke channel vendor yang Anda atur di gateway. Semua penggunaan dan biaya akan dikelola dalam satu sistem statistik.

Cara Kerjanya

Saat Anda menjalankan takeover pada setiap alat, gateway akan melakukan langkah-langkah berikut:

1. Memeriksa kesehatan gateway untuk memastikan endpoint proxy dapat digunakan.
2. Secara otomatis membuat satu kunci virtual khusus (value hanya akan dikembalikan saat pembuatan, dan akan ditulis ke pengaturan alat).
3. Membackup file konfigurasi lama dengan menambahkan ekstensi .bak (misal: ~/.claude/settings.json.bak).
4. Menulis/merge pengaturan arsitektur yang mengarah ke gateway, tanpa mengubah pengaturan lain yang Anda miliki.
5. Menyegarkan status antar muka untuk menampilkan status takeover saat ini.

Saat menghapus takeover, prosesnya juga bersifat "presisi": hanya kunci yang benar-benar diarahkan ke gateway ini yang akan dihapus, sehingga tidak terjadi penghapusan pengaturan yang Anda buat secara manual.

Status Takeover

Setiap alat akan menampilkan salah satu dari empat status berikut pada halaman AI Gateway → Endpoints:

Status	Penjelasan
Sudah Takeover (gateway ini)	Alat diarahkan ke AI Gateway lokal
Terkoneksi (alamat lain)	Alat diarahkan ke alamat lain (manual atau ke gateway lain), tidak akan di-overwrite
Belum Takeover	Alat terdeteksi, tapi belum diarahkan ke gateway
Tidak Terdeteksi	Direktori konfigurasi alat tidak ditemukan di komputer Anda

Prasyarat

• Telah masuk ke akun ServBay dan menambah minimal satu channel yang aktif di halaman Channel.
• Alat AI target sudah terinstall di komputer Anda (gateway mendeteksi lewat direktori konfigurasi alat).

Langkah Takeover Sekali Klik

Masuk ke AI Gateway → Endpoints, cari alat yang ingin diatur, lalu klik Takeover Sekali Klik pada daftar. Setelah sukses, status akan berubah menjadi "Sudah Takeover (gateway ini)". Untuk mengembalikan, klik Hapus / Pulihkan.

Detail Takeover Setiap Alat

Tabel berikut menampilkan file konfigurasi yang diubah untuk setiap alat, sehingga Anda memahami perubahan yang terjadi:

Alat	File Konfigurasi	Isi yang Ditulis	Alamat Gateway
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (tanpa /v1)
Codex	~/.codex/config.toml	Bagian [model_providers.servbay] + model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Baris GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (kompatibel OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Bagian [model_providers.servbay] + definisi model	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Deep merge node model servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Deep merge node provider.servbay (agregasi model channel)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Deep merge node providers.servbay	http://127.0.0.1:11580/v1

Kenapa alamat Claude Code tidak pakai /v1

Claude Code menggunakan protokol Anthropic, sehingga gateway akan otomatis menambahkan path /v1/messages dan sebagainya. Oleh sebab itu, ANTHROPIC_BASE_URL harus diisi alamat root gateway (tanpa /v1). Mayoritas alat lain menggunakan protokol OpenAI yang memang perlu /v1 di ujung alamatnya. Takeover sekali klik akan mengisi alamat sesuai aturan tiap alat secara otomatis, Anda tidak perlu membedakan manual.

Pemulihan & Troubleshooting

• Mengembalikan konfigurasi semula — Klik Hapus untuk menghapus pengaturan gateway pada alat. Anda juga bisa mengembalikannya secara manual menggunakan file backup .bak di folder yang sama.
• Status “Terkoneksi (alamat lain)” — Ini berarti alat sedang diarahkan ke alamat selain gateway ini (baik oleh Anda sendiri ataupun oleh gateway lain). Untuk menghindari konflik, gateway tidak akan takeover secara otomatis. Anda perlu membersihkan pengaturan tersebut manual sebelum menjalankan takeover.
• Jika alat tetap error setelah takeover — Pastikan layanan proxy gateway berjalan, channel sudah sehat, dan kunci virtual tidak dicabut. Anda juga dapat mengecek request di halaman Statistik & Monitoring untuk memastikan permintaan sudah masuk ke gateway.

Pertanyaan Umum (FAQ)

• T: Apakah takeover sekali klik akan merusak pengaturan alat saya?
  • J: Tidak. Gateway hanya menulis atau merge pada kunci pengaturan terkait gateway. Backup .bak juga selalu dibuat sebelum perubahan. Pengaturan lain tetap aman.
• T: Apakah saya masih bisa mengubah setting manual setelah takeover?
  • J: Bisa. Anda bisa klik "Hapus" untuk mengembalikan dari gateway, atau restore manual dari file .bak.
• T: Di mana saya melihat kunci virtual takeover?
  • J: Gateway akan membuat kunci virtual khusus untuk setiap alat yang di-takeover, yang bisa dikelola pada halaman Kunci.
• T: Kenapa status tool saya “Tidak Terdeteksi”?
  • J: Ini berarti direktori konfigurasi alat tidak ditemukan di komputer Anda. Instal dan jalankan alat tersebut minimal satu kali agar membuat folder konfigurasi sehingga bisa di-takeover.

Kesimpulan

Fitur takeover sekali klik menyederhanakan proses manual yang merepotkan dan rawan error menjadi hanya satu klik: otomatis membuat kunci, auto-backup, tulis presisi, dan dapat dieksekusi ulang kapan saja. Dengan sistem statistik channel & penggunaan yang terintegrasi, kini semua alat pemrograman AI Anda berbagi pengaturan vendor dan pengelolaan biaya yang terpusat. Jika ingin memanggil gateway dari aplikasi Anda sendiri, silakan baca Endpoint & Environment Variable.