Yang perlu disiapkan
- Gemini CLI versi terbaru. Salah satu cara memasangnya:
npm install -g @google/gemini-cli(butuh Node.js). Versi lama belum membacaGOOGLE_GEMINI_BASE_URL, jadi perbarui dulu kalau sudah terpasang. - Akun MaCloud AI dengan saldo (top up mulai Rp 10.000) atau paket coding.
- API key dari tab API Key di konsol, dan nama model Gemini dari halaman model, misalnya
gem-3.8-flash.
Langkah singkat
- Buat API key di konsol dan salin.
- Tulis tiga variabel di
~/.gemini/.env(contoh di bawah), atau set sebagai environment variable. - Buka terminal baru di folder proyek, jalankan
gemini. - Kalau ditanya cara masuk, pilih Use Gemini API Key.
- Kirim pesan pendek, lalu cek tab Pemakaian di konsol.
Setting lewat file ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL=https://api.macloudai.com
GEMINI_API_KEY=sk-...
GEMINI_MODEL=gem-3.8-flashFile ini dibaca setiap kali gemini dijalankan. Letaknya ~/.gemini/.env di macOS / Linux dan %USERPROFILE%\.gemini\.env di Windows.
Atau lewat environment variable
export GOOGLE_GEMINI_BASE_URL=https://api.macloudai.com
export GEMINI_API_KEY=sk-...
export GEMINI_MODEL=gem-3.8-flash
gemini$env:GOOGLE_GEMINI_BASE_URL="https://api.macloudai.com"
$env:GEMINI_API_KEY="sk-..."
$env:GEMINI_MODEL="gem-3.8-flash"
geminiBase URL untuk Gemini CLI adalah https://api.macloudai.com tanpa /v1. Gemini CLI menambahkan path-nya sendiri.
Cara cek dan atasi error
| Gejala | Penyebab biasa |
|---|---|
| Diminta login akun Google | Pilih Use Gemini API Key, atau jalankan /auth di dalam Gemini CLI untuk mengganti cara masuk |
| Error 401 / API key not valid | Key salah, ada spasi, atau variabel belum terbaca (buka terminal baru) |
| Error 403 | Saldo habis dan kuota paket hari ini juga habis |
| Request tidak muncul di tab Pemakaian | Versi Gemini CLI terlalu lama sehingga base URL diabaikan; perbarui Gemini CLI |
Mau atur Gemini CLI, Claude Code dan Codex dari satu tempat? Lihat panduan CC Switch.
Pertanyaan umum
Q1Apakah perlu akun Google AI Pro?
Tidak. Gemini CLI memakai API key dan saldo atau paket MaCloud AI. Tidak perlu langganan Google atau kartu kredit.
Q2Model apa yang bisa dipakai?
Model Gemini yang ada di halaman model. Tulis namanya persis di GEMINI_MODEL, atau ganti di dalam Gemini CLI.
Q3Kenapa base URL tidak pakai /v1?
Gemini CLI memakai format Gemini, yang alamatnya tanpa /v1. Alamat dengan /v1 hanya untuk tool format OpenAI seperti Codex.
Q4Apakah paket coding bisa dipakai di Gemini CLI?
Bisa. Paket menempel ke akun, jadi Gemini CLI memakai kuota paket yang sama dengan Claude Code dan Codex.
Panduan lain
- Cara pakai Claude API di Indonesia tanpa kartu kredit
- Cara pakai Claude Code dengan bayar Rupiah (tanpa kartu kredit)
- Cursor dengan API key sendiri (Claude/GPT, bayar Rupiah)
- Cara bikin bot WhatsApp yang dijawab AI (Python + OpenAI SDK)
- Cara pakai API GPT (format OpenAI) dengan bayar QRIS
- Cara setting Cline di VS Code pakai Claude API bayar Rupiah
- Otomasi n8n dengan AI: OpenAI node + base URL, contoh UMKM
Cara menghitung biaya API AI (token) dalam dolar dan Rupiah
Paket coding bulanan: pilih Pemula, Menengah atau Pro- Cara pakai CC Switch untuk Claude Code, Codex dan Gemini CLI
- Cara pakai Codex CLI dengan bayar Rupiah (tanpa kartu kredit)