Panduan pengaturan

Panduan pengaturan penyedia

Lihat langkah penyiapan dan pemecahan masalah berdasarkan alat.

Panduan pengaturan penyedia/Konfigurasi Gemini CLI

Konfigurasi Gemini CLI

Gemini CLI adalah alat AI terminal dari Google. Alat ini cocok untuk menggunakan Gemini di baris perintah untuk tanya jawab, pemahaman kode, dan bantuan proyek.

Apa itu alat ini dan untuk apa kegunaannya

Google GeminiAlat terminalLogin GoogleGemini API Key

Pilih metode autentikasi terlebih dahulu

MetodeCocok untuk siapaDeskripsi
Login GooglePengguna Individu dan PemulaJalankan Gemini dan masuk sesuai petunjuk
Gemini API KeyPengguna yang Sudah Memiliki Kunci Google AI StudioMasukkan Kunci ke dalam GEMINI_API_KEY
Vertex AIPengguna Perusahaan atau Proyek CloudKonfigurasikan sesuai proyek dan izin Google Cloud

Cara Menguji API Key

Pengujian sementara di PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" gemini

Langkah Selanjutnya Setelah Pengujian Berhasil

  1. Pertama, jalankan Gemini CLI di direktori kosong; jangan langsung membuka proyek penting.
  2. Ajukan hanya satu pertanyaan singkat yang tetap untuk memastikan model dapat menjawab dengan normal.
  3. Kemudian biarkan membaca berkas pengujian dan mintalah secara jelas untuk tidak memodifikasi berkas tersebut.
  4. Jika Anda ingin menggunakan API Key dalam jangka panjang, simpan metode autentikasi ke lingkungan lokal atau konfigurasi sesuai dokumentasi resmi Gemini CLI.
  5. Jika Anda telah berganti penyedia AI atau CC-Switch, lakukan pengujian lagi setelah membuka kembali terminal.
GejalaPemeriksaan prioritasPenanganan
Masih Memerlukan Login GoogleApakah metode autentikasi saat ini adalah alur login Google?Selesaikan autentikasi terlebih dahulu sesuai petunjuk dari Gemini CLI sendiri; jangan mencampuradukkan pemecahan masalah API Key dan alur login
Kunci Tidak ValidApakah GEMINI_API_KEY berasal dari Google AI Studio / Gemini?Jangan memasukkan Kunci OpenAI atau Claude ke dalam Gemini
Model Tidak TersediaApakah nama model berasal dari daftar Gemini?Jangan memasukkan nama model OpenAI / Claude ke dalam Gemini CLI

Hal yang Perlu Diperhatikan dalam Konfigurasi Penyedia AI

Gemini CLI dan penyedia yang kompatibel dengan OpenAI bukanlah hal yang sama. Ikuti tutorial penyedia hanya jika mereka secara eksplisit mencantumkan metode konfigurasi untuk Gemini CLI, Google Gemini, atau Vertex AI.

Jangan memasukkan Base URL OpenAI biasa ke dalam Gemini CLI. OpenAI, Claude, dan Gemini adalah tiga protokol yang berbeda. Jika penyedia menyediakan alamat terpisah di backend, Anda harus memasukkan alamat yang sesuai dengan alat tersebut.
Dokumentasi resmi Gemini CLI Lihat titik masuk pemasangan, perintah, dan konfigurasi.
Dokumentasi Autentikasi Gemini CLI Periksa login Google, Gemini API Key, dan Vertex AI.