Panduan Pengguna Gemini CLI - Google AI di Terminal Anda

Gemini CLI adalah tool AI baris perintah open-source yang disediakan oleh Google yang menghadirkan kemampuan Gemini langsung ke terminal Anda. Ini menawarkan cara ringan untuk mengakses Gemini, memberikan jalur paling langsung dari prompt ke model. Dengan mengonfigurasi proxy, Anda dapat menggunakan layanan Gemini CLI bahkan di lingkungan jaringan yang terbatas.

Mengapa Memilih Gemini CLI?#

• Gemini 2.5 Pro yang Kuat: Akses ke jendela konteks 1 juta token
• Tool Bawaan: Google Search grounding, operasi file, perintah Shell, web scraping
• Dapat Diperluas: Mendukung MCP (Model Context Protocol) untuk integrasi kustom
• Terminal-First: Dirancang untuk developer yang bekerja di command line
• Open Source: Lisensi Apache 2.0

Instalasi#

Instal Cepat#

Jalankan Langsung dengan npx (Tanpa Instalasi)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Instal Global dengan npm#

npm install -g @google/gemini-cli

Instal dengan Homebrew (macOS/Linux)#

brew install gemini-cli

Persyaratan Sistem#

• Node.js versi 20 atau lebih tinggi
• macOS, Linux, atau Windows

Mengonfigurasi Proxy#

Mengatur Environment Variable#

Sebelum menggunakan proxy, konfigurasikan environment variable berikut:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Tip: Tambahkan environment variable ini ke .bashrc, .zshrc, atau file konfigurasi shell Anda sehingga variabel tersebut otomatis disetel setiap kali Anda memulai terminal.

Mulai Cepat#

Penggunaan Dasar#

Mulai di Direktori Saat Ini#

gemini

Sertakan Beberapa Direktori#

gemini --include-directories ../lib,../docs

Gunakan Model Tertentu#

gemini -m gemini-2.5-flash

Mode Skrip Non-Interaktif#

Dapatkan respons teks sederhana:

gemini -p "Explain the architecture of this codebase"

Dapatkan output JSON terstruktur:

gemini -p "Explain the architecture of this codebase" --output-format json

Contoh Cepat#

Mulai Proyek Baru#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Analisis Kode yang Ada#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Fitur Utama#

Pemahaman dan Generasi Kode#

• Menelusuri dan mengedit codebase besar
• Menghasilkan aplikasi baru dari PDF, gambar, atau sketsa menggunakan kemampuan multimodal
• Debug masalah dan troubleshooting menggunakan bahasa natural

Automasi dan Integrasi#

• Mengotomatiskan tugas operasional seperti men-query pull request atau menangani rebase kompleks
• Menghubungkan kemampuan baru menggunakan server MCP
• Berjalan secara non-interaktif dalam skrip untuk automasi alur kerja

Fitur Lanjutan#

• Mendapatkan informasi real-time menggunakan Google Search bawaan
• Checkpoint percakapan untuk menyimpan dan memulihkan sesi kompleks
• File konteks kustom (GEMINI.md) untuk menyesuaikan perilaku pada proyek Anda

Perintah Umum dan Contoh#

Menjelajahi Codebase#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Bekerja dengan Kode yang Ada#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Mengotomatiskan Alur Kerja#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Interaksi dengan Sistem#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

Integrasi GitHub#

Gunakan Gemini CLI GitHub Action untuk mengintegrasikan Gemini CLI langsung ke alur kerja GitHub Anda:

• Pull Request Reviews: Review kode otomatis dengan umpan balik dan saran kontekstual
• Issue Triage: Secara otomatis memberi label dan memprioritaskan issue GitHub berdasarkan analisis konten
• On-Demand Help: Sebut @gemini-cli di issues dan pull request untuk bantuan debugging, penjelasan, atau delegasi tugas
• Custom Workflows: Membangun workflow otomatis, terjadwal, dan on-demand yang disesuaikan dengan kebutuhan tim Anda

Pemecahan Masalah#

Jika Anda menemui masalah selama penggunaan, pertimbangkan hal berikut:

1. Periksa Environment Variable#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Periksa Koneksi Jaringan#

curl -I https://crazyrouter.com/

3. Periksa Pesan Error#

Pesan error biasanya menunjukkan masalahnya. Masalah umum meliputi:

• Format API key tidak valid
• Masalah konektivitas jaringan
• Konfigurasi proxy yang salah

4. Format Proxy SOCKS#

Jika menggunakan proxy SOCKS, pastikan formatnya benar:

socks5://<user>:<pass>@<proxy>:<port>

5. Laporkan Bug#

Gunakan perintah bawaan untuk melaporkan masalah:

/bug

Versi Rilis#

Preview#

Versi preview baru dirilis setiap hari Selasa pukul 23:59 UTC:

npm install -g @google/gemini-cli@preview

Stable#

Versi stable baru dirilis setiap hari Selasa pukul 20:00 UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Versi nightly dirilis setiap hari pada pukul 00:00 UTC:

npm install -g @google/gemini-cli@nightly

Penggunaan MCP Server#

Konfigurasikan MCP server di ~/.gemini/settings.json untuk memperluas Gemini CLI dengan tool kustom:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Pricing melalui Crazyrouter#

Akses model Gemini dengan harga diskon:

Semua harga sudah termasuk diskon 45% dibandingkan tarif resmi.

Sumber Daya Terkait#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

Butuh bantuan? Hubungi support atau cek dokumentasi Crazyrouter untuk informasi lebih lanjut.