Panduan Pengguna Gemini CLI - Google AI di Terminal Anda

Gemini CLI ialah alat AI baris perintah sumber terbuka yang disediakan oleh Google yang membawa keupayaan Gemini terus ke terminal anda. Ia menawarkan cara yang ringan untuk mengakses Gemini, menyediakan laluan paling terus dari prompt ke model. Dengan mengkonfigurasi proksi, anda boleh menggunakan perkhidmatan Gemini CLI walaupun dalam persekitaran yang terhad rangkaian.

Mengapa Memilih Gemini CLI?#

• Gemini 2.5 Pro yang Berkuasa: Akses kepada tetingkap konteks 1 juta token
• Alat Terbina Dalam: Google Search grounding, operasi fail, arahan Shell, web scraping
• Boleh Diluaskan: Menyokong MCP (Model Context Protocol) untuk integrasi tersuai
• Terminal-First: Direka untuk pembangun yang bekerja dalam baris perintah
• Sumber Terbuka: Lesen Apache 2.0

Pemasangan#

Pemasangan Pantas#

Jalankan Serta-Merta dengan npx (Tiada Pemasangan Diperlukan)#

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

Pemasangan Global dengan npm#

npm install -g @google/gemini-cli

Pasang dengan Homebrew (macOS/Linux)#

brew install gemini-cli

Keperluan Sistem#

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

Mengkonfigurasi Proksi#

Tetapkan Pemboleh Ubah Persekitaran#

Sebelum menggunakan proksi, konfigurasikan pemboleh ubah persekitaran 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 pemboleh ubah persekitaran ini ke .bashrc, .zshrc, atau fail konfigurasi shell anda supaya ia ditetapkan secara automatik setiap kali anda memulakan terminal.

Mula Pantas#

Penggunaan Asas#

Mula dalam Direktori Semasa#

gemini

Sertakan Berbilang Direktori#

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

Gunakan Model Tertentu#

gemini -m gemini-2.5-flash

Mod Skrip Tidak Interaktif#

Dapatkan respons teks ringkas:

gemini -p "Explain the architecture of this codebase"

Dapatkan output JSON berstruktur:

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

Contoh Pantas#

Mulakan Projek Baharu#

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

Analisis Kod Sedia Ada#

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

Ciri Utama#

Pemahaman dan Penjanaan Kod#

• Menyemak dan mengedit kod asas yang besar
• Menjana aplikasi baharu daripada PDF, imej, atau lakaran menggunakan keupayaan multimodal
• Nyahpepijat isu dan menyelesaikan masalah menggunakan bahasa semula jadi

Automasi dan Integrasi#

• Mengautomasikan tugas operasi seperti menyoal pull request atau mengendalikan rebase kompleks
• Menyambungkan keupayaan baharu menggunakan pelayan MCP
• Dijalankan secara tidak interaktif dalam skrip untuk automasi aliran kerja

Ciri Lanjutan#

• Dapatkan maklumat masa nyata menggunakan Google Search terbina dalam
• Checkpoint perbualan untuk menyimpan dan memulihkan sesi kompleks
• Fail konteks tersuai (GEMINI.md) untuk menyesuaikan tingkah laku bagi projek anda

Arahan Biasa dan Contoh#

Teroka Kod Asas#

> 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 Kod Sedia Ada#

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

Automasi Aliran 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 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 terus ke dalam aliran kerja GitHub anda:

• Semakan Pull Request: Semakan kod automatik dengan maklum balas dan cadangan berkonsep
• Triage Isu: Secara automatik melabel dan memprioritikan isu GitHub berdasarkan analisis kandungan
• Bantuan Atas Permintaan: Sebut @gemini-cli dalam isu dan pull request untuk bantuan nyahpepijat, penjelasan, atau delegasi tugas
• Aliran Kerja Tersuai: Bina aliran kerja automatik, berjadual, dan atas permintaan yang disesuaikan dengan keperluan pasukan anda

Penyelesaian Masalah#

Jika anda menghadapi masalah semasa penggunaan, pertimbangkan perkara berikut:

1. Semak Pemboleh Ubah Persekitaran#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Semak Sambungan Rangkaian#

curl -I https://crazyrouter.com/

3. Semak Mesej Ralat#

Mesej ralat biasanya menunjukkan masalahnya. Isu biasa termasuk:

• Format kunci API tidak sah
• Masalah kesambungan rangkaian
• Konfigurasi proksi yang salah

4. Format Proksi SOCKS#

Jika menggunakan proksi SOCKS, pastikan format adalah betul:

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

5. Laporkan Pepijat#

Gunakan arahan terbina dalam untuk melaporkan isu:

/bug

Versi Keluaran#

Preview#

Versi preview baharu dikeluarkan setiap hari Selasa pada 23:59 UTC:

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

Stable#

Versi stable baharu dikeluarkan setiap hari Selasa pada 20:00 UTC:

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

Nightly#

Versi nightly dikeluarkan setiap hari pada 00:00 UTC:

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

Penggunaan Pelayan MCP#

Konfigurasikan pelayan MCP dalam ~/.gemini/settings.json untuk meluaskan Gemini CLI dengan alat tersuai:

> @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

Harga melalui Crazyrouter#

Akses model Gemini pada kadar diskaun:

Semua harga termasuk diskaun 45% berbanding kadar rasmi.

Sumber Berkaitan#

• Halaman Harga Crazyrouter
• Repositori GitHub Gemini CLI
• Dokumentasi Google AI

Perlu bantuan? Hubungi sokongan atau semak dokumentasi Crazyrouter untuk maklumat lanjut.