Panduan Lengkap CC-Switch: Pelajari Cara Mengelola Konfigurasi Multi-API Claude Code dalam 5 Menit

Pakai Claude Code emang asyik banget, tapi API resminya kemahalan? Mau pindah ke layanan perantara API pihak ketiga, tapi bingung cara ubah file konfigurasinya? CC-Switch lahir buat nyelesein masalah itu. Artikel ini bakal ngajak kamu paham cara instal dan pakai CC-Switch cuma dalam 5 menit, biar bisa kelola API buat empat asisten pemrograman AI: Claude Code, Codex, OpenCode, dan Gemini CLI dalam satu tempat.

Nilai Utama: Setelah baca artikel ini, kamu bakal bisa pakai CC-Switch buat kelola banyak API Provider secara visual, ganti konfigurasi sekali klik, dan gak perlu lagi ribet edit file JSON manual.

Apa itu CC-Switch? Kenapa Kamu Butuh Ini?

CC-Switch adalah aplikasi desktop lintas platform open-source yang dirancang khusus buat mengelola konfigurasi asisten pemrograman AI secara terpadu. Alat ini dibuat dan dibagikan secara terbuka di GitHub oleh pengembang bernama farion1231.

Posisi Utama CC-Switch

Gampangnya, CC-Switch adalah "pusat manajemen konfigurasi" buat alat pemrograman AI kamu:

4 Alat Pemrograman AI yang Didukung CC-Switch

🚀 Mulai Cepat: CC-Switch mendukung penggunaan layanan perantara pihak ketiga seperti APIYI (apiyi.com). Setelah Provider dikonfigurasi, kamu bisa pakai Claude Code dan alat lainnya dengan biaya lebih murah, plus dapet kemudahan ganti-ganti provider cuma sekali klik.

Detail Fitur Utama CC-Switch

CC-Switch bukan sekadar pengalih konfigurasi, ini adalah platform manajemen alat AI yang lengkap:

Fitur 1: Manajemen Provider (Fitur Inti)

Ini adalah fitur yang paling sering digunakan di CC-Switch, yang mendukung:

Contoh Konfigurasi Provider:

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

Fitur 2: Manajemen Server MCP

MCP (Model Context Protocol) adalah protokol ekstensi untuk Claude Code. CC-Switch menyediakan antarmuka manajemen MCP yang terpadu:

• Mendukung tiga tipe transmisi: stdio / http / sse
• Konfigurasi terpadu lintas aplikasi (Claude/Codex/Gemini)
• Penambahan, pengeditan, dan penghapusan server MCP secara visual

Fitur 3: Manajemen Skills (Keahlian)

CC-Switch dapat mendeteksi dan menginstal Claude Skills secara otomatis:

• Pindai repositori GitHub secara otomatis untuk mencari Skills
• Instal sekali klik ke direktori ~/.claude/skills/
• Mendukung pemindaian rekursif pada direktori bersarang

Fitur 4: Manajemen System Prompts

Buat preset petunjuk sistem untuk berbagai skenario kerja:

• Jumlah preset petunjuk yang tak terbatas
• Mendukung file CLAUDE.md, AGENTS.md, dan GEMINI.md
• Beralih antar mode kerja yang berbeda dengan cepat

Fitur 5: Proxy API Lokal (v3.9.0+)

CC-Switch memiliki server proxy lokal bawaan yang menyediakan fitur-fitur canggih:

💡 Saran Teknis: Fitur proxy lokal bekerja lebih optimal jika dipadukan dengan APIYI apiyi.com. APIYI menyediakan antarmuka yang kompatibel dengan OpenAI secara stabil, dan fitur failover CC-Switch dapat beralih secara otomatis saat terjadi gangguan jaringan, memastikan pengalaman pemrograman Anda tidak terputus.

Panduan Instalasi CC-Switch

CC-Switch mendukung platform Windows, macOS, dan Linux, dengan berbagai metode instalasi yang tersedia.

Instalasi di Windows

Cara 1: Installer MSI (Direkomendasikan)

Unduh file .msi dari GitHub Releases, lalu klik dua kali untuk menginstal.

Cara 2: Versi Portabel

Unduh versi portabel .zip, ekstrak, dan jalankan langsung tanpa perlu instalasi.

Instalasi di macOS

Cara 1: Homebrew (Direkomendasikan)

brew install --cask cc-switch

Cara 2: Instalasi Manual

Unduh file .dmg atau .zip, lalu seret ke folder Applications.

Catatan: Saat pertama kali dijalankan, Anda mungkin menemui peringatan Gatekeeper. Anda perlu mengizinkan aplikasi berjalan melalui "System Preferences → Security & Privacy".

Instalasi di Linux

CC-Switch menyediakan berbagai format paket untuk Linux:

Verifikasi Instalasi

Setelah instalasi selesai, jalankan CC-Switch. Anda seharusnya melihat status alat CLI yang terdeteksi pada antarmuka utama.

Konfigurasi Cepat CC-Switch

Langkah 1: Tambahkan Provider APIYI

1. Klik tombol 「Add Provider」 di antarmuka utama
2. Pilih konfigurasi kustom 「Custom」
3. Isi informasi berikut:

名称: APIYI
Base URL: https://api.apiyi.com
API Key: sk-your-apiyi-key  # Dapatkan dari apiyi.com

4. Konfigurasi pemetaan model (opsional):

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. Klik 「Save」 untuk menyimpan konfigurasi

Mendapatkan API Key: Kunjungi APIYI apiyi.com untuk mendaftar akun dan mendapatkan API Key. Platform ini menyediakan kuota uji coba gratis dan mendukung model-model populer seperti Claude, GPT, Gemini, dan lainnya.

Langkah 2: Ganti Provider

Setelah konfigurasi disimpan, pada daftar Provider di antarmuka utama:

1. Cari Provider 「APIYI」 yang baru saja ditambahkan
2. Klik 「Switch」 atau klik langsung pada Provider tersebut
3. CC-Switch akan secara otomatis mengubah file konfigurasi dari alat yang terkait
4. Mulai ulang alat CLI seperti Claude Code agar konfigurasi baru diterapkan

Langkah 3: Uji Koneksi

Gunakan fitur uji kecepatan CC-Switch untuk memverifikasi konfigurasi:

1. Klik tombol 「Test」 di samping Provider
2. Tunggu hingga pengujian latensi selesai
3. Lihat waktu respons dan indikator status

Setelah pengujian berhasil, buka terminal dan jalankan Claude Code:

claude

Jika Anda bisa melakukan percakapan dengan normal, berarti konfigurasi telah berhasil.

Contoh Konfigurasi Minimalis

{
  "id": "apiyi-provider",
  "name": "APIYI (Direkomendasikan)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

Fitur Lanjutan CC-Switch

Strategi Manajemen Multi-Provider

CC-Switch mendukung konfigurasi beberapa Provider sekaligus untuk strategi penggunaan yang lebih fleksibel:

┌─────────────────────────────────────────────────┐
│              CC-Switch Daftar Provider           │
├─────────────────────────────────────────────────┤
│  ⭐ APIYI (Utama)       Latensi: 120ms   ✓ Sehat  │
│  📦 OpenRouter (Cadangan) Latensi: 280ms   ✓ Sehat  │
│  🏢 Claude Resmi (Backup) Latensi: 350ms   ✓ Sehat  │
└─────────────────────────────────────────────────┘

Konfigurasi yang Direkomendasikan:

• Utama: APIYI – Harga terjangkau, akses cepat dari dalam negeri
• Cadangan: OpenRouter – Pilihan model melimpah, stabil untuk akses luar negeri
• Backup Terakhir: Login Resmi – Memastikan layanan selalu tersedia kapan saja

Konfigurasi Sinkronisasi Cloud

CC-Switch mendukung sinkronisasi konfigurasi ke penyimpanan cloud:

1. Buka Settings → Storage
2. Pilih folder sinkronisasi cloud (Dropbox, OneDrive, iCloud Drive)
3. CC-Switch akan secara otomatis menyinkronkan konfigurasi Provider Anda

Dengan cara ini, Anda bisa berbagi konfigurasi API yang sama di berbagai perangkat.

Konfigurasi Lanjutan Proxy Lokal

Setelah mengaktifkan proxy lokal, CC-Switch akan:

1. Menjalankan server proxy di mesin lokal
2. Secara otomatis mengubah konfigurasi CLI agar mengarah ke proxy lokal tersebut
3. Server proxy akan meneruskan permintaan ke Provider yang sebenarnya

Keunggulan:

• Semua permintaan melewati satu pintu masuk, sehingga mudah dipantau
• Failover otomatis; jika satu Provider mati, sistem akan beralih secara otomatis
• Pencatatan log permintaan untuk memudahkan pelacakan masalah (troubleshooting)

# Alur permintaan dalam mode proxy
Claude Code → localhost:8080 → Proxy CC-Switch → APIYI → Claude API

Fitur Claude Rectifier

Fitur Claude Rectifier yang hadir di versi v3.10.0 digunakan untuk memperbaiki masalah kompatibilitas pada API pihak ketiga:

• Memperbaiki format thinking signature secara otomatis
• Meningkatkan kompatibilitas dengan API non-resmi
• Mengurangi munculnya pesan kesalahan terkait "format error"

Pertanyaan Umum (FAQ) CC-Switch

# Metode 1: Tutup terminal saat ini dan buka kembali
# Metode 2: Masukkan /exit di Claude Code untuk keluar, lalu jalankan kembali
claude  # Jalankan kembali

# Hapus konfigurasi kustom dan pulihkan ke resmi
rm ~/.claude/settings.json
claude  # Login kembali ke akun resmi

Perbandingan CC-Switch vs Konfigurasi Manual

🎯 Saran Pemilihan: Jika kamu sering perlu berpindah di antara beberapa API Provider, atau menggunakan beberapa alat pemrograman AI sekaligus, CC-Switch dapat meningkatkan efisiensimu secara drastis. Dipadukan dengan APIYI apiyi.com, kamu bisa mendapatkan pengalaman terbaik dengan biaya rendah dan kenyamanan tinggi.

Perbandingan Alat Terkait CC-Switch

Selain CC-Switch, ada beberapa alat serupa lainnya:

Kombinasi Rekomendasi: CC-Switch (Manajemen Konfigurasi) + APIYI (Proksi API) = Solusi dengan rasio performa-harga terbaik

Referensi

Kesimpulan

CC-Switch adalah alat ampuh untuk mengelola konfigurasi asisten pemrograman AI yang mengatasi masalah-masalah berikut:

1. Konfigurasi rumit: Antarmuka visual menggantikan pengeditan JSON secara manual.
2. Peralihan sulit: Berpindah antar berbagai Provider dengan satu klik.
3. Alat terfragmentasi: Manajemen terpadu untuk Claude Code, Codex, OpenCode, dan Gemini CLI.
4. Tidak bisa cek kecepatan: Pengujian latensi bawaan untuk memilih Provider tercepat.
5. Konfigurasi hilang: Pencadangan otomatis + sinkronisasi cloud, konfigurasi tidak akan pernah hilang.

Bagi pengembang yang sering menggunakan alat pemrograman AI, kombinasi CC-Switch + APIYI adalah solusi yang direkomendasikan:

• CC-Switch: Menyediakan manajemen konfigurasi yang praktis.
• APIYI apiyi.com: Menyediakan layanan API yang stabil dan terjangkau.

Kunjungi APIYI apiyi.com untuk mendaftarkan akun, dapatkan API Key, lalu tambahkan Provider di CC-Switch untuk mulai menikmati pengalaman pemrograman AI yang lancar.

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