Tutorial Integrasi Proxy Windsurf: Konfigurasi Endpoint Kustom untuk Agen Cascade

I. Apa itu Windsurf

Windsurf adalah IDE berbasis AI yang mengintegrasikan agen cerdas Cascade, dan mendukung penambahan endpoint model kustom. Arahkan ke gateway situs ini, dan Anda dapat memanggil Claude / GPT / Gemini menggunakan kunci API yang terpadu.

II. Persiapan

1. Masuk ke konsol API, buat API Key sk-xxxxxx (hanya ditampilkan sekali, harap simpan).
2. Konfirmasikan slug model yang ingin digunakan (misalnya claude-sonnet-5, gpt-5.4, gemini-3.7-flash).
3. Konfirmasikan alamat gateway: https://www.relay-api.com.

III. Konfigurasi di Windsurf

Buka Settings → Models / API Providers → Add Provider, pilih tipe penyedia, lalu isi:

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-kunci_anda
Model    : claude-sonnet-5
(Untuk model GPT, ganti Base URL menjadi https://www.relay-api.com/v1)
(Untuk model Gemini, ganti Base URL menjadi https://www.relay-api.com/v1beta)

Setelah disimpan, pilih model tersebut di Cascade, dan tekan Ctrl+L (macOS Cmd+L) untuk memulai percakapan.

IV. Referensi Alamat API

Grup Model	Base URL (Entri Situs)	Protokol
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

Gunakan Base URL sesuai tabel di atas.

V. Pemecahan Masalah Umum

Gejala	Tindakan
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo tidak mencukupi; pastikan sk- sudah benar dan lakukan pengisian saldo.
404 / Model tidak tersedia	Nama model tidak sesuai dengan slug platform, atau model belum diaktifkan; periksa kembali ID model.

Saran Keamanan: Jangan tuliskan kunci API ke repositori publik; buat kunci terpisah untuk tujuan yang berbeda agar mudah dalam melacak penggunaan dan membatasi kuota.