Penggunaan CC-Switch-CLI
CC-Switch-CLI adalah alat pengalih provider untuk command line, cocok untuk server tanpa antarmuka grafis, lingkungan SSH, atau bagi mereka yang perlu beralih provider dengan cepat antara Claude Code, Codex, Gemini CLI, OpenCode, dan OpenClaw.
Untuk siapa alat ini cocok
Jika Anda pengguna desktop biasa, prioritaskan penggunaan antarmuka grafis CC Switch; jika Anda sudah terbiasa dengan terminal atau perlu mengelola konfigurasi secara batch, silakan baca halaman ini. Blok kode berikut hanya berisi perintah, dengan penjelasan diletakkan di luar blok kode agar penjelasan tidak ikut tersalin bersama perintah.
Instalasi dan Memulai
Pengguna macOS / Linux dapat mengikuti dokumentasi resmi untuk menggunakan skrip instalasi atau paket Releases; pengguna Windows disarankan mengunduh paket kompresi yang sesuai dari Releases, lalu menjalankannya di direktori program setelah diekstrak.
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch.\cc-switch.exeMenjalankan cc-switch secara langsung akan membuka antarmuka interaktif, yang cocok bagi pemula untuk melihat menu terlebih dahulu; perintah-perintah berikut cocok jika Anda sudah tahu apa yang ingin dilakukan dan ingin mengeksekusinya secara langsung.
Pemeriksaan Lingkungan
| Hal yang perlu dikonfirmasi | Cara memeriksa | Alasan |
|---|---|---|
| Versi CC Switch atau CLI sudah terinstal | Terminal ini dapat mengenali perintah terkait | Perintah konfigurasi apa pun akan gagal jika belum terinstal. |
| CLI target sudah terinstal | Claude Code, Codex, dan Gemini CLI setidaknya dapat dijalankan secara terpisah | CC-Switch-CLI tidak menginstalkan alat target untuk Anda |
| Informasi provider lengkap | Siapkan Base URL, API Key, dan nama model | Konfigurasi command-line tidak memiliki petunjuk visual, dan hilangnya satu item dapat dengan mudah menyebabkan kegagalan. |
| Verifikasi terlebih dahulu di direktori pengujian | Jangan langsung beralih secara massal di proyek aktif | Lebih mudah untuk melakukan rollback jika konfigurasi salah |
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider currentPerintah Provider
Provider adalah konfigurasi provider. Sebelum menambahkan Provider, siapkan terlebih dahulu Base URL, API Key, dan nama model dari dasbor provider; saat mengedit atau beralih, konfirmasikan nomor ID terlebih dahulu menggunakan perintah list.
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>< id> perlu diganti dengan nomor yang terlihat di dalam cc-switch provider list. Jangan langsung mengeksekusi < id> apa adanya.Manajemen Berdasarkan Aplikasi
Jika Anda hanya ingin melihat konfigurasi untuk alat target tertentu, Anda dapat menambahkan --app. Ini sangat berguna untuk troubleshooting Claude Code, Codex, dan Gemini CLI secara terpisah.
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider listcc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider currentSetelah memastikan bahwa aplikasi target dan provider saat ini tidak ada masalah, lakukan pengalihan. Setelah pengalihan selesai, mulai ulang terminal, lalu gunakan alat target untuk mengirim pertanyaan pengujian yang paling singkat.
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"Sinkronisasi MCP
MCP tidak diperlukan oleh setiap pemula. Hanya gunakan jika Anda sudah menggunakan MCP di Claude Code, Codex, atau Gemini CLI, dan membutuhkan sinkronisasi lintas alat. Untuk pertama kali, disarankan masuk ke menu TUI terlebih dahulu untuk memeriksa area MCP, dan jangan langsung menyalin perintah lanjutan dari tutorial lama.
cc-switch cc-switch --app codexAlur Konfigurasi
- Pertama, konfirmasikan alat target yang ingin Anda alihkan: Claude Code, Codex, Gemini CLI, atau CLI lainnya.
- Siapkan Base URL, API Key, dan nama model dari dasbor provider.
- Tambahkan atau pilih Provider di CC-Switch-CLI.
- Terapkan Provider ke alat target.
- Setelah membuka ulang terminal, lakukan pengujian dengan pertanyaan sesingkat mungkin pada CLI target.
- Setelah dipastikan berhasil, terapkan Provider yang sama ke alat target lainnya.
| Skenario | Rekomendasi |
|---|---|
| Penggunaan desktop lokal | Prioritaskan antarmuka grafis CC Switch; kolom isian dan status lebih intuitif |
| Server jarak jauh / SSH | Gunakan CC-Switch-CLI; periksa perintah versi saat ini sebelum beroperasi |
| Pengalihan konfigurasi secara batch | Verifikasi keberhasilan terlebih dahulu di proyek pengujian, baru terapkan ke proyek aktif |
| Beberapa orang berbagi satu perangkat | Jangan menuliskan Key Anda ke konfigurasi publik; periksa cakupan file konfigurasi terlebih dahulu |
Pemecahan Masalah bagi Pemula
| Gejala | Pemeriksaan prioritas | Solusi |
|---|---|---|
| Perintah tidak ditemukan | Periksa apakah sudah terinstal dan apakah sudah ditambahkan ke PATH | Buka ulang terminal, atau kembali ke petunjuk instalasi resmi untuk mengonfirmasi lokasi instalasi |
| Alat target tidak berubah setelah dialihkan | Apakah terminal sudah dibuka ulang dan apakah alat target yang benar sudah dipilih | Tutup jendela terminal saat ini lalu buka kembali, kemudian uji lagi |
| 401 / Unauthorized | Apakah Key lengkap dan apakah masa berlakunya belum habis | Salin kembali Key, pastikan tidak ada spasi tambahan |
| model not found | Apakah nama model disalin secara persis dari dasbor | Isi ulang sesuai dengan daftar model provider |