Gemini CLI Kullanıcı Rehberi - Terminalinizde Google AI

Gemini CLI, Google tarafından sunulan ve Gemini’nin gücünü doğrudan terminalinize getiren açık kaynak bir komut satırı AI aracıdır. Gemini’ye erişmek için hafif bir yol sunar ve istemden modele en doğrudan yolu sağlar. Bir proxy yapılandırarak, ağ kısıtlamaları olan ortamlarda bile Gemini CLI hizmetlerini kullanabilirsiniz.

Neden Gemini CLI’yi Tercih Etmelisiniz?#

• Güçlü Gemini 2.5 Pro: 1 milyon token bağlam penceresine erişim
• Yerleşik Araçlar: Google Search grounding, dosya işlemleri, Shell komutları, web scraping
• Genişletilebilir: Özel entegrasyonlar için MCP (Model Context Protocol) desteği
• Terminal-Öncelikli: Komut satırında çalışan geliştiriciler için tasarlandı
• Açık Kaynak: Apache 2.0 Lisansı

Kurulum#

Hızlı Kurulum#

npx ile Anında Çalıştır (Kurulum Gerektirmez)#

# Resmi depoyu kullan
npx https://github.com/google-gemini/gemini-cli

npm ile Global Kurulum#

npm install -g @google/gemini-cli

Homebrew ile Kurulum (macOS/Linux)#

brew install gemini-cli

Sistem Gereksinimleri#

• Node.js sürüm 20 veya üzeri
• macOS, Linux veya Windows

Proxy Yapılandırma#

Ortam Değişkenlerini Ayarlama#

Proxy’yi kullanmadan önce aşağıdaki ortam değişkenlerini yapılandırın:

Linux / macOS#

# API Anahtarını Ayarla
export GEMINI_API_KEY=sk-your-api-key-here

# API Proxy URL’sini Ayarla
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/"

İpucu: Bu ortam değişkenlerini .bashrc, .zshrc ya da kabuk yapılandırma dosyanıza ekleyin ki her terminal başlatışınızda otomatik olarak ayarlansınlar.

Hızlı Başlangıç#

Temel Kullanım#

Geçerli Dizinle Başlat#

gemini

Birden Fazla Dizini Dahil Et#

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

Belirli Bir Model Kullan#

gemini -m gemini-2.5-flash

Etkileşimsiz Script Modu#

Basit bir metin yanıtı al:

gemini -p "Explain the architecture of this codebase"

Yapılandırılmış JSON çıktı al:

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

Hızlı Örnekler#

Yeni Bir Proje Başlat#

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

Mevcut Kodu Analiz Et#

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

Ana Özellikler#

Kodu Anlama ve Üretme#

• Büyük kod tabanlarını sorgulama ve düzenleme
• Multimodal yetenekler kullanarak PDF, görseller veya eskizlerden yeni uygulamalar üretme
• Doğal dil kullanarak hata ayıklama ve sorun giderme

Otomasyon ve Entegrasyon#

• Pull request sorgulama veya karmaşık rebase işlemlerini yönetme gibi operasyonel görevleri otomatikleştirme
• MCP sunucularını kullanarak yeni yetenekler bağlama
• İş akışı otomasyonu için script’lerde etkileşimsiz çalıştırma

Gelişmiş Özellikler#

• Yerleşik Google Search ile gerçek zamanlı bilgi alma
• Karmaşık oturumları kaydedip geri yüklemek için konuşma checkpoint’leri
• Projenize özel davranış için özel bağlam dosyaları (GEMINI.md)

Yaygın Komutlar ve Örnekler#

Kod Tabanını Keşfet#

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

Mevcut Kod ile Çalış#

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

İş Akışlarını Otomatikleştir#

> 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

Sistemle Etkileşim#

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

GitHub Entegrasyonu#

Gemini CLI’yi GitHub iş akışlarınıza doğrudan entegre etmek için Gemini CLI GitHub Action kullanın:

• Pull Request İncelemeleri: Bağlamsal geri bildirim ve önerilerle otomatik kod incelemeleri
• Issue Sınıflandırma: İçerik analizine göre GitHub issue’larını otomatik etiketleme ve önceliklendirme
• İsteğe Bağlı Yardım: Hata ayıklama, açıklamalar veya görev delegasyonu için issue ve pull request’lerde @gemini-cli etiketleyin
• Özel İş Akışları: Ekibinizin ihtiyaçlarına göre otomatik, zamanlanmış ve isteğe bağlı iş akışları oluşturun

Sorun Giderme#

Kullanım sırasında sorunlarla karşılaşırsanız aşağıdakileri kontrol edin:

1. Ortam Değişkenlerini Kontrol Edin#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Ağ Bağlantısını Kontrol Edin#

curl -I https://crazyrouter.com/

3. Hata Mesajlarını Kontrol Edin#

Hata mesajları genellikle sorunun nedenini gösterir. Yaygın sorunlar şunlardır:

• Geçersiz API anahtarı formatı
• Ağ bağlantı sorunları
• Yanlış proxy yapılandırması

4. SOCKS Proxy Formatı#

SOCKS proxy kullanıyorsanız formatın doğru olduğundan emin olun:

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

5. Hata Bildirme#

Sorunları bildirmek için yerleşik komutu kullanın:

/bug

Sürüm Yayınları#

Preview#

Yeni preview sürümleri her Salı UTC 23:59’da yayınlanır:

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

Stable#

Yeni stable sürümleri her Salı UTC 20:00’de yayınlanır:

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

Nightly#

Nightly sürümleri her gün UTC 00:00’da yayınlanır:

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

MCP Sunucu Kullanımı#

Gemini CLI’yi özel araçlarla genişletmek için MCP sunucularını ~/.gemini/settings.json içinde yapılandırın:

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

Crazyrouter Üzerinden Fiyatlandırma#

Gemini modellerine indirimli fiyatlarla erişin:

Tüm fiyatlar resmi tarifelere göre %45 indirim içermektedir.

İlgili Kaynaklar#

• Crazyrouter Fiyatlandırma Sayfası
• Gemini CLI GitHub Deposu
• Google AI Dokümantasyonu

Yardıma mı ihtiyacınız var? Daha fazla bilgi için destekle iletişime geçin veya Crazyrouter dokümantasyonunu inceleyin.