๐ Langkah-Langkah Persiapan
Sebelum memulai, pastikan Anda telah:
- Mendaftarkan akun Koze dan masuk
- Membuat Kunci API di halaman Manajemen API
- Menginstal Gemini CLI (
npm install -g @anthropic-ai/gemini-cliatau lihat Repositori Resmi)
๐ Metode 1: Akses melalui API Gemini (Direkomendasikan)
Atur variabel lingkungan berikut di terminal:
# Atur ekspor alamat proxy Koze Gemini GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'
# Atur Kunci API Koze Anda
export GEMINI_API_KEY='kunci API Anda'
# Tentukan model yang akan digunakan
export GEMINI_MODEL='gemini-2.5-pro'
Metode autentikasi:Pilih Gunakan Kunci API Gemini saat memulai. Jika diminta memasukkan Kunci API, tekan Enter saja dan biarkan kosong.
๐ก Jika Anda secara otomatis dialihkan ke halaman login Google saat startup, harap hapus
~/.gemini/settings.jsondan mulai ulang.
๐ง Metode Kedua: Akses melalui API Code Assist
Metode akses lain, cocok untuk beberapa skenario khusus:
# Siapkan endpoint Code Assist
export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'
# Siapkan Token Akses (menggunakan Kunci API Koze Anda)
export GOOGLE_CLOUD_ACCESS_TOKEN='kunci API Anda'
# Aktifkan mode GCA
export GOOGLE_GENAI_USE_GCA='true'
# Tentukan modelnya
export GEMINI_MODEL='gemini-2.5-pro'
Metode autentikasi:Pilih โ ๏ธ Catatan: Konsol CLI Gemini mungkin menampilkan "Gagal mengambil info pengguna: 401 Tidak Diizinkan", yang normal dan tidak memengaruhi penggunaan.Masuk dengan saat memulai Google.
๐ฏ Langkah 3: Luncurkan CLI Gemini
Setelah konfigurasi, luncurkan di terminal:
gemini
๐ Menyimpan Variabel Lingkungan
Disarankan untuk menulis variabel lingkungan ke file konfigurasi shell (menggunakan metode 1 sebagai contoh):
# Pengguna Zsh
cat >> ~/.zshrc << < EOF <
export GOOGLE_GEMINI_BASE_URL=
export GEMINI_API_KEY=
ekspor GEMINI_MODEL=
EOF source ~/.zshrc
๐ Model yang Tersedia
| Nama Model | Deskripsi |
|---|---|
gemini-2.5-pro |
Gemini 2.5 Pro, generasi terbaru dari model berkinerja tinggi |
gemini-2.5-flash |
Gemini 2.5 Flash, lebih cepat dan lebih banyak hemat biaya |
gemini-2.0-flash |
Gemini 2.0 Flash |
โ ๏ธ Pertanyaan yang Sering Diajukan (FAQ)
| Masalah | Solusi |
|---|---|
| Pengalihan otomatis ke Login Google setelah startup | Hapus ~/.gemini/settings.json dan coba lagi |
| Prompt 401 Tidak Diizinkan | Ini adalah prompt normal dan Tidak memengaruhi penggunaan; abaikan saja. |
| Model tidak tersedia | Periksa di Lobi Model Koze apakah paket Anda saat ini mencakup model Gemini. |
