Tutorial Lengkap Menambahkan Pemasok CC-Switch: Panduan Konfigurasi 4 Langkah dengan APIYI sebagai Contoh

Setelah menginstal CC-Switch, langkah selanjutnya adalah menambahkan penyedia API Anda sendiri. Banyak pemula yang bingung di tahap ini: tidak tahu apa yang harus diisi, di mana mengisinya, dan bagaimana cara menerapkannya. Artikel ini menggunakan APIYI apiyi.com sebagai contoh, untuk memandu Anda langkah demi langkah melalui seluruh proses penambahan, peralihan, uji kecepatan, dan pemulihan login resmi di CC-Switch.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai manajemen penyedia CC-Switch secara lengkap, menyelesaikan seluruh konfigurasi hanya dalam 3 menit.

Persiapan Sebelum Menambahkan Penyedia di CC-Switch

Sebelum memulai konfigurasi, Anda perlu menyiapkan hal-hal berikut:

Daftar Persyaratan

Pendaftaran Akun APIYI

Jika Anda belum memiliki akun APIYI, selesaikan pendaftaran terlebih dahulu:

1. Kunjungi situs resmi APIYI apiyi.com
2. Klik daftar, selesaikan pembuatan akun
3. Masuk ke konsol, dapatkan API Key
4. Catat informasi berikut:
   • API Key: String kunci yang dimulai dengan sk-
   • Base URL: https://api.apiyi.com

🚀 Keuntungan Pengguna Baru: Daftar di APIYI apiyi.com langsung mendapatkan kuota uji coba gratis. Mendukung Claude, GPT, Gemini, dan model-model populer lainnya. Anda bisa mencoba dulu sebelum memutuskan untuk mengisi saldo.

Periksa Konflik Variabel Lingkungan

Penting: Jika sebelumnya Anda pernah mengatur API Key di variabel lingkungan (environment variables) sistem, hal tersebut mungkin menimpa konfigurasi CC-Switch.

Periksa dan bersihkan variabel lingkungan yang berkonflik:

macOS/Linux:

# Periksa apakah ada variabel yang berkonflik
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# Jika ada isinya, Anda perlu menghapusnya dari ~/.zshrc atau ~/.bashrc

Windows:

• Buka "System Properties → Advanced → Environment Variables"
• Periksa dan hapus variabel seperti ANTHROPIC_API_KEY, OPENAI_API_KEY, dll.

Langkah-langkah Menambahkan Penyedia di CC-Switch

Langkah 1: Membuka Antarmuka Tambah Penyedia

1. Jalankan aplikasi CC-Switch.
2. Temukan tombol 「Add Provider」 pada antarmuka utama (biasanya terletak di atas daftar penyedia).
3. Klik tombol tersebut untuk memunculkan jendela konfigurasi penyedia.

Langkah 2: Memilih Metode Konfigurasi

CC-Switch menyediakan dua cara untuk menambahkan penyedia:

Karena APIYI adalah penyedia pihak ketiga, kita akan memilih konfigurasi kustom 「Custom」.

Langkah 3: Mengisi Informasi Konfigurasi Penyedia

Ini adalah langkah paling krusial. Anda perlu mengisi bidang-bidang berikut dengan akurat:

Informasi Dasar

Konfigurasi Claude Code (Jika digunakan)

CC-Switch mendukung konfigurasi bidang-bidang berikut untuk keperluan Claude Code:

Konfigurasi Pemetaan Model (Opsional)

Jika Anda perlu menentukan model default, Anda bisa mengonfigurasi bidang berikut:

Contoh Konfigurasi Lengkap

Berikut adalah konfigurasi lengkap untuk menambahkan APIYI sebagai penyedia:

# Informasi Dasar
Name: APIYI
Base URL: https://api.apiyi.com

# Konfigurasi Claude Code
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# Konfigurasi Model (Opsional)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

Langkah 4: Menyimpan Konfigurasi

1. Periksa kembali apakah semua bidang wajib telah terisi dengan benar.
2. Klik tombol 「Save」 atau 「Konfirmasi」.
3. CC-Switch akan memvalidasi format konfigurasi Anda.
4. Setelah berhasil disimpan, penyedia baru akan muncul di dalam daftar.

💡 Tips Konfigurasi: Interface yang disediakan oleh APIYI (apiyi.com) sepenuhnya kompatibel dengan format OpenAI dan Anthropic. Oleh karena itu, Anda cukup mengisi Base URL dengan https://api.apiyi.com tanpa perlu menambahkan akhiran /v1 (CC-Switch akan menanganinya secara otomatis).

3 Cara Berpindah Penyedia di CC-Switch

Setelah ditambahkan, kamu harus pindah ke penyedia baru agar pengaturannya aktif. CC-Switch menyediakan 3 cara untuk melakukannya:

Cara 1: Antarmuka Utama (Rekomendasi Pemula)

Ini adalah cara yang paling gamblang:

1. Buka daftar penyedia di antarmuka utama CC-Switch.
2. Cari 「APIYI」 yang baru saja kamu tambahkan.
3. Klik tombol 「Enable」 atau 「Aktifkan」 di sisi kanan penyedia tersebut.
4. Jika status berubah menjadi Active, berarti perpindahan berhasil.

┌─────────────────────────────────────────────────┐
│              Daftar Penyedia CC-Switch           │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (Active)          [Disable] [Test]    │  ← Aktif saat ini
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

Cara 2: System Tray (Rekomendasi Pengguna Mahir)

Cara yang lebih cepat karena tidak perlu membuka jendela utama:

1. Temukan ikon CC-Switch di system tray (pojok kanan bawah di Windows / menu bar di macOS).
2. Klik ikon tersebut untuk memunculkan menu.
3. Langsung klik nama penyedia 「APIYI」.
4. Perubahan akan langsung aktif tanpa perlu konfirmasi tambahan.

Keunggulan: Cara ini adalah yang tercepat, sangat pas jika kamu sering berganti-ganti penyedia.

Cara 3: Konfigurasi per Aplikasi

Jika kamu menggunakan beberapa alat CLI sekaligus, kamu bisa mengatur penyedia yang berbeda untuk setiap aplikasi:

Di CC-Switch, setiap aplikasi dapat dikonfigurasi dengan penyedia yang berbeda secara mandiri.

Cara Pemberlakuan Vendor CC-Switch

Penting: Setelah mengganti vendor, konfigurasi tidak akan langsung berlaku di alat CLI. Anda perlu memulai ulang aplikasi yang terkait.

Langkah-langkah Pemberlakuan

Memverifikasi Konfigurasi

Setelah memulai ulang, Anda dapat memverifikasinya melalui cara berikut:

Metode 1: Tes percakapan langsung

claude
# Masukkan pertanyaan sederhana, jika dibalas dengan normal berarti konfigurasi berhasil
> Hello, mohon balas dalam Bahasa Indonesia

Metode 2: Menggunakan fitur uji kecepatan CC-Switch

1. Klik tombol 「Test」 di samping vendor
2. Lihat latensi dan status
3. Muncul tanda ✓ hijau menunjukkan koneksi normal

Metode 3: Memeriksa berkas konfigurasi

# Berkas konfigurasi Claude Code
cat ~/.claude/settings.json

# Anda seharusnya melihat konten yang serupa:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 Saran Verifikasi: Anda dapat melihat catatan panggilan API melalui konsol APIYI apiyi.com. Jika ada catatan permintaan baru, berarti konfigurasi telah berhasil diterapkan.

Memulihkan Login Resmi via CC-Switch

Jika Anda perlu beralih kembali ke layanan resmi, CC-Switch menyediakan fitur pemulihan sekali klik.

Memulihkan Login Resmi Claude Code

1. Temukan preset 「Official Login」 dalam daftar vendor CC-Switch
2. Klik 「Enable」 untuk beralih ke mode resmi
3. Mulai ulang terminal, jalankan claude
4. Ikuti alur login resmi Claude Code (autentikasi OAuth)

Memulihkan Login Resmi Codex

1. Pilih preset 「Official Login」 (versi Codex)
2. Klik aktifkan (Enable)
3. Jalankan codex setelah memulai ulang
4. Selesaikan autentikasi resmi OpenAI sesuai petunjuk

Memulihkan Login Resmi Gemini CLI

1. Pilih preset 「Google Official」
2. Klik aktifkan
3. Jalankan gemini setelah memulai ulang
4. Selesaikan alur Google OAuth sesuai petunjuk

Ringkasan Alur Pemulihan

Catatan: Setelah memulihkan login resmi, CC-Switch akan secara otomatis mencadangkan konfigurasi kustom Anda. Saat beralih kembali ke vendor pihak ketiga di lain waktu, konfigurasi sebelumnya akan tetap tersimpan.

Tips Lanjutan Manajemen Vendor CC-Switch

Tips 1: Perbandingan Kecepatan Vendor

Setelah menambahkan beberapa vendor, kamu bisa melakukan tes kecepatan secara massal untuk memilih yang tercepat:

1. Klik tombol 「Test」 pada masing-masing vendor secara berurutan.
2. Catat nilai latensi dari setiap vendor.
3. Pilih vendor dengan latensi terendah sebagai vendor utama.

Standar Referensi:

Tips 2: Duplikasi Vendor

Jika kamu perlu membuat vendor dengan konfigurasi yang serupa:

1. Pilih vendor yang sudah ada.
2. Klik 「Duplicate」 atau klik kanan dan pilih "Salin".
3. Ubah nama dan beberapa bagian konfigurasi.
4. Simpan sebagai vendor baru.

Tips 3: Cadangan dan Sinkronisasi Konfigurasi

CC-Switch mendukung sinkronisasi awan (cloud sync) untuk konfigurasi:

1. Buka Settings → Storage.
2. Pilih folder sinkronisasi awan (seperti Dropbox atau OneDrive).
3. Semua konfigurasi vendor akan disinkronkan secara otomatis.

Dengan begini, kamu bisa berbagi konfigurasi vendor yang sama di berbagai perangkat.

Tips 4: Berbagi Konfigurasi Vendor

Versi v3.9.0+ mendukung fitur "Berbagi Vendor":

• Satu konfigurasi vendor dapat diterapkan secara bersamaan ke Claude/Codex/Gemini.
• Cocok untuk menggunakan gateway yang mendukung multi-protokol seperti APIYI.
• Centang "Sync to all apps" saat menambahkan vendor.

FAQ Menambahkan Vendor di CC-Switch

Cheat Sheet Konfigurasi Provider APIYI

Untuk memudahkan konfigurasi cepat, berikut adalah parameter lengkap untuk APIYI:

Ringkasan

Melalui tutorial ini, Anda telah mempelajari alur lengkap pengelolaan provider di CC-Switch:

1. Tambah Provider: Klik Add Provider → Pilih Custom → Isi konfigurasi → Simpan
2. Ganti Provider: Klik Enable pada antarmuka utama atau klik langsung nama provider di system tray
3. Cara Penerapan: Restart terminal atau klien CLI yang terkait
4. Kembali ke Versi Resmi: Pilih preset Official Login → Restart → Selesaikan proses OAuth

Kombinasi CC-Switch + APIYI membuat pengelolaan API menjadi sangat simpel:

• CC-Switch: Pengelolaan visual, beralih provider hanya dengan satu klik
• APIYI apiyi.com: Antarmuka terpadu, harga lebih hemat, dan mendukung berbagai model

Yuk, kunjungi APIYI apiyi.com sekarang untuk mendapatkan API Key, tambahkan providernya di CC-Switch, dan mulai nikmati pengalaman pemrograman AI yang lebih efisien!

📝 Penulis: Tim Teknis APIYI | APIYI apiyi.com – Membuat pemanggilan AI API jadi lebih mudah