Panduan pengaturan

Panduan pengaturan penyedia

Lihat langkah penyiapan dan pemecahan masalah berdasarkan alat.

CC-Switch Gemini

Halaman ini membahas penerapan Provider terkait Gemini ke Gemini CLI melalui CC Switch. Antarmuka dan metode autentikasi Gemini berbeda dari antarmuka yang kompatibel dengan OpenAI, sehingga Anda tidak bisa hanya mengisi Base URL OpenAI biasa dan menganggapnya dapat digunakan untuk Gemini.

Apa yang dijelaskan di halaman ini

Sangat disarankan untuk mengonfigurasi Gemini di CC Switch hanya jika provider secara jelas menyediakan antarmuka terkait Gemini / Google / Vertex, atau dokumentasinya secara eksplisit menyatakan dukungan untuk Gemini CLI.

Konfirmasi sebelum memulai

Hal yang perlu dikonfirmasiCara memeriksaAlasan
Gemini CLI dapat dimulai saat iniPertama, konfirmasikan bahwa Gemini CLI dapat dibuka di perangkat iniCC Switch hanya bertanggung jawab untuk pengalihan konfigurasi
Provider mendukung GeminiTerdapat entri terkait Gemini / Google / Vertex di backend atau tutorialAntarmuka yang kompatibel dengan OpenAI tidak sama dengan antarmuka Gemini
Jenis Key sudah benarKonfirmasikan bahwa Key sesuai dengan Gemini atau VertexJenis Key yang salah akan menyebabkan autentikasi gagal
Nama model berasal dari daftar GeminiSalin nama model Gemini dari backend providerJangan mencampur nama model Claude atau OpenAI

Cara mengisi kolom

PengaturanMetode PengisianPerhatian untuk Pemula
Nama ProviderTentukan tujuan secara jelasMisalnya, 'Provider Gemini' atau 'Google Gemini'
Target Tool / PresetPilih preset terkait Gemini atau Google / VertexJangan memilih preset yang kompatibel dengan OpenAI
Base URLSalin alamat antarmuka yang sesuai untuk GeminiJika backend hanya menyediakan alamat OpenAI, jangan memaksakan untuk mengisinya dulu
API KeySalin Key yang sesuai dengan Gemini / VertexJenis Key harus sesuai dengan Base URL
Nama ModelSalin daftar model GeminiNama model biasanya berbeda dari OpenAI dan Claude

Terapkan ke Gemini

  1. Buka CC Switch dan buka area manajemen Provider.
  2. Tambahkan Provider Gemini baru, atau pilih Provider Gemini yang sudah dikonfigurasi.
  3. Pilih preset terkait Gemini CLI sebagai alat target.
  4. Isi Base URL, API Key, dan nama model yang sesuai untuk Gemini.
  5. Setelah menyimpan, jalankan Apply / Switch.
  6. Buka kembali terminal, lalu lakukan pengujian minimal menggunakan Gemini CLI.

Uji apakah berfungsi

Alasan paling umum kegagalan konfigurasi Gemini adalah mengisi alamat yang kompatibel dengan OpenAI di Gemini, atau jenis Key yang tidak cocok dengan alamat antarmuka.

Uji minimal Gemini
gemini "Please reply only: CC-Switch Gemini is active"
Jika Gemini CLI masih memerlukan login Google, ikuti petunjuk Gemini CLI terlebih dahulu; CC Switch hanya dapat menyinkronkan konfigurasi Provider yang didukungnya dan tidak dapat melewati persyaratan login dari alat target itu sendiri.