Takeover Sekali Klik untuk Alat Pemrograman AI

Takeover sekali klik memungkinkan Anda mengarahkan alat CLI pemrograman AI yang umum digunakan ke Gateway AI lokal tanpa perlu mengedit file konfigurasi apa pun secara manual. Setelah takeover, permintaan dari alat-alat tersebut akan dirutekan secara terpusat melalui http://127.0.0.1:11580 ke saluran penyedia yang Anda konfigurasikan di gateway, dan akan tercatat dalam statistik penggunaan serta biaya yang terpadu.

Cara Kerja

Saat melakukan takeover sekali klik untuk setiap alat, gateway akan melakukan hal berikut secara berurutan:

1. Memeriksa kesehatan gateway, memastikan endpoint proxy tersedia.
2. Membuat kunci virtual khusus secara otomatis (gateway akan menuliskannya ke konfigurasi alat; nilai plaintext-nya dapat diambil kembali kapan saja di halaman Kunci).
3. Mencadangkan file konfigurasi asli dengan akhiran .bak (misalnya ~/.claude/settings.json.bak).
4. Menulis secara presisi / melakukan deep merge konfigurasi yang mengarah ke gateway, tetap mempertahankan pengaturan Anda yang lain.
5. Menyegarkan status antarmuka, menampilkan kondisi takeover saat ini.

Saat menghentikan takeover, prinsipnya juga "penghapusan presisi": hanya ketika konfigurasi memang mengarah ke gateway ini, kunci terkait akan dicabut, sehingga menghindari penghapusan yang tidak disengaja terhadap pengaturan lain yang Anda konfigurasikan secara manual; sekaligus mencabut kunci virtual yang dibuat otomatis saat takeover.

Status Takeover

Setiap alat akan menampilkan salah satu dari empat status di halaman Gateway AI → Manajemen Akses → Klien:

Status	Arti
Sudah Diambil Alih (Gateway Ini)	Alat telah diarahkan ke Gateway AI lokal
Terhubung (Alamat Lain)	Alat telah dikonfigurasi dengan alamat lain (konfigurasi manual Anda atau mengarah ke gateway lain), gateway tidak akan menimpanya secara sepihak
Belum Diambil Alih	Alat terdeteksi, tetapi belum diarahkan ke gateway
Tidak Terdeteksi	Direktori konfigurasi alat tersebut tidak ditemukan di komputer lokal

Prasyarat

• Anda sudah login ke akun ServBay, dan telah mengonfigurasi setidaknya satu saluran yang tersedia di halaman Saluran.
• Alat AI target sudah terinstal di komputer lokal (gateway menentukan keberadaannya berdasarkan direktori konfigurasinya).

Operasi Takeover Sekali Klik

Buka halaman Gateway AI → Manajemen Akses → Klien, temukan alat target di daftar alat, lalu klik Takeover Sekali Klik. Setelah takeover berhasil, status akan berubah menjadi "Sudah Diambil Alih (Gateway Ini)". Jika ingin membatalkan, klik Hentikan Takeover.

Detail Takeover untuk Setiap Alat

Tabel berikut mencantumkan file konfigurasi dan konten yang sebenarnya diubah saat setiap alat diambil alih, agar Anda dapat memahami dan melakukan troubleshooting:

Alat	File Konfigurasi	Konten 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" tingkat atas	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (kompatibel dengan 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 (mengagregasikan model dari berbagai saluran)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Deep merge node providers.servbay	http://127.0.0.1:11580/v1

Mengapa alamat Claude Code tidak menyertakan /v1

Claude Code menggunakan protokol Anthropic, gateway akan menyusun sendiri path seperti /v1/messages, sehingga ANTHROPIC_BASE_URL harus berupa alamat root gateway (tanpa /v1). Sebagian besar alat lainnya menggunakan protokol yang kompatibel dengan OpenAI, sehingga memerlukan akhiran /v1. Takeover sekali klik akan mengisi secara otomatis sesuai konvensi masing-masing alat, Anda tidak perlu membedakannya secara manual.

Pemulihan dan Penelusuran Masalah

• Memulihkan konfigurasi asli — Klik Hapus, gateway akan mencabut konfigurasi yang mengarah ke gateway ini secara presisi. Anda juga dapat memulihkannya secara manual menggunakan file cadangan .bak di direktori yang sama.
• Status menampilkan "Terhubung (Alamat Lain)" — Menandakan bahwa alat tersebut saat ini mengarah ke alamat lain (konfigurasi manual Anda atau mengarah ke gateway lain). Untuk menghindari menimpa pengaturan Anda, gateway tidak akan mengambil alih secara otomatis; Anda dapat membersihkan konfigurasi tersebut secara manual terlebih dahulu, lalu melakukan takeover.
• Setelah takeover alat masih menampilkan error — Pastikan layanan proxy gateway sedang berjalan, saluran terkait sehat, kunci virtual belum dicabut, dan Anda dapat memeriksa apakah permintaan sampai ke gateway di halaman Statistik dan Pemantauan.

Pertanyaan Umum (FAQ)

• T: Apakah takeover sekali klik akan merusak konfigurasi alat saya yang lama?
  • J: Tidak. Gateway hanya menulis / menggabungkan secara presisi kunci yang terkait dengan gateway, dan mencadangkan file asli sebagai .bak sebelum menulis. Pengaturan lainnya tetap tidak berubah.
• T: Setelah takeover, apakah saya masih bisa mengubahnya kembali secara manual?
  • J: Bisa. Klik "Hapus" untuk mencabutnya melalui gateway, atau pulihkan secara manual menggunakan cadangan .bak.
• T: Di mana kunci virtual yang digunakan untuk takeover?
  • J: Gateway akan otomatis membuat kunci virtual khusus untuk setiap alat yang diambil alih, yang dapat dilihat dan dikelola di halaman Kunci.
• T: Alat di daftar menampilkan "Tidak Terdeteksi"?
  • J: Itu berarti direktori konfigurasi alat tersebut tidak ditemukan di komputer lokal. Instal dan jalankan alat tersebut sekali terlebih dahulu agar direktori konfigurasinya dibuat, lalu lakukan takeover.

Ringkasan

Takeover sekali klik menyederhanakan hal yang rumit dan rawan kesalahan—"mengedit file konfigurasi setiap alat secara manual"—menjadi satu klik: membuat kunci otomatis, mencadangkan otomatis, menulis secara presisi, dan dapat dipulihkan kapan saja. Dengan saluran dan statistik penggunaan yang terpadu, Anda dapat membuat semua alat pemrograman AI Anda berbagi konfigurasi penyedia dan tampilan biaya yang sama. Jika Anda ingin memanggil gateway dari kode Anda sendiri, lihat Endpoint dan Variabel Lingkungan.