Gemini CLI Nedir? Açık Kaynak AI Agent Kullanım Kılavuzu

Gemini CLI, 25 Haziran 2025’te Google tarafından duyurulan ücretsiz, açık kaynak (Apache 2.0) bir yapay zekâ aracıdır. Yapay zeka ile kod yazmak, görevler otomatikleştirmek ve kendi akıllı asistanınızı geliştirmek mi istiyorsunuz? Gemini CLI, açık kaynaklı ve güçlü yapısıyla tam da bu noktada devreye giriyor.

Gemini CLI Nedir?

Geleneksel yapay zekâ asistanları genellikle web tarayıcılarında çalışırken, Gemini CLI doğrudan terminalinize entegre olarak doğal dilde komutlar alır ve sonuçları anında döndürür. Böylece kod yazma, hata ayıklama, içerik üretimi ve araştırma gibi görevlerde tarayıcı odaklı etkileşim ihtiyaçlarını ortadan kaldırır.

Gemini CLI’nin en önemli avantajlarından biri, açık kaynak olmasıdır. GitHub’da tamamen incelenebilir kod bazıyla sunulur; geliştiriciler diledikleri gibi katkıda bulunabilir, hataları düzeltebilir veya ihtiyaçlarına göre özelleştirebilirler. Kullanmak için tek gereken, sisteminize Node.js (v18+) ve npm/yarn kurmak ile kişisel bir Google hesabıdır. Google hesabıyla ücretsiz “Gemini Code Assist” lisansı alındıktan sonra dakikada 60, günde 1.000 API isteğine kadar kısıtlamasız erişim sağlanır.

Aracın beynini, Google’ın Gemini 2.5 Pro modeli oluşturur. Bu model, 1 milyon token’a kadar (yaklaşık 30.000 satır kod veya uzun dokümanlar) bağlamı aynı anda işleyebilir. Geniş bağlam penceresi sayesinde; büyük kod tabanlarını, proje dökümantasyonlarını ve uzun sohbet geçmişlerini tek seferde kavrayarak tutarlı ve bağlamsal açıdan zengin yanıtlar üretebilir.

Kurulum ve İlk Adım Yöntemleri Nedir?

Ön Koşullar: Sisteminizi Hazırlayın

1. Node.js
   • Sürüm 18 veya üzeri olmalıdır.
   • Mevcut sürümünüzü kontrol etmek için: node -v
   • Yüklü değilse resmi Node.js sitesinden uygun paketi indirip kurabilirsiniz.
2. Paket Yöneticisi
   • npm (Node.js ile birlikte gelir) veya tercihe göre yarn kullanılabilir.
   • npm sürümünüzü kontrol etmek için: npm -v
3. İşletim Sistemi
   • Windows 10+, macOS 10.15+ veya modern bir Linux dağıtımı (Ubuntu, Fedora, vb.) üzerinde çalışır.
4. Google Hesabı
   • İlk kimlik doğrulaması için kişisel bir Google hesabı gereklidir. Kurumsal/Workspace hesaplarında ek yapılandırma gerekebilir.

Kurulum Yöntemleri

Gemini CLI’yi iki temel yolla kurabilirsiniz:

REKLAM

a) NPX ile Tek Seferlik Çalıştırma

npx https://github.com/google-gemini/gemini-cli

• Komut doğrudan GitHub’dan paketi indirir ve çalıştırır.
• Her kullanımda en güncel versiyonu otomatik yükler.

b) Global Kurulum (Önerilen)

npm install -g @google/gemini-cli

• gemini komutunu her dizinden kullanabilmenizi sağlar.
• Linux/macOS’ta izin hatası yaşarsanız sudo ekleyebilirsiniz.

c) Homebrew Üzerinden (macOS/Linux)

brew install gemini-cli

• Homebrew kullananlar için hızlı ve temiz kurulum seçeneği.

İlk Çalıştırma ve Tema Seçimi

Kurulum tamamlandıktan sonra terminalde şu komutu girin:

gemini

1. Renk Teması Seçimi:
   • CLI, çeşitli tema seçenekleri sunar.
   • Ok tuşlarıyla gezinip, Enter’la onaylayın.
2. Rehberli Başlangıç:
   • Kısa bir hoş geldin mesajı ve temel komut tanıtımı görünür.

Bu adım, aracı kolayca özelleştirmenizi sağlayarak uzun süreli kullanımda göz yorgunluğunu azaltır.

Kimlik Doğrulama: Google Oturumu

İlk çalıştırma sonrasında veya gemini auth login komutuyla:

gemini auth login

• Tarayıcınız açılır ve Google hesabınızla giriş yapmanız istenir.
• Başarılı giriş sonrası CLI’ya geri dönerek “Authentication successful” mesajı alırsınız.
• Ücretsiz “Gemini Code Assist” lisansıyla dakikada 60, günde 1.000 model isteği hakkı kazanırsınız

Kurulumu Doğrulama ve Hızlı Test

Aşağıdaki komutlarla her şeyin doğru kurulduğunu kontrol edin:

gemini --version

• Yüklü sürümü gösterir.

gemini "Merhaba, kendini tanıtır mısın?"

• Basit bir doğal dil isteğiyle yapay zekâ asistanınızın yanıtını test edin.

Sorunsuz bir yanıt alıyorsanız, terminaliniz üzerinden yapay zekâ destekli ilk sohbetinizi başlatmışsınız demektir.

Gemini CLI Temel Kullanım ve Komutları Nelerdir?

1. CLI’yi Başlatma

• Etkileşimli Mod (REPL) gemini Bu komut, sohbet benzeri etkileşimli bir terminal oturumu başlatır; yaptığınız her girdi anında işlenir.
• Tek Seferlik Sorgu gemini -p "Proje dizinindeki tüm JavaScript dosyalarını listele" -p, prompt’u geçirip yanıtı tek seferlik döndürür. Oturum açılmaya gerek kalmadan hızlı sorgular için idealdir.
• Piping (Borulama) echo "Count to five" | gemini Standart çıktıyı doğrudan CLI’ya besleyerek işlem yaptırabilirsiniz.

2. Slash Komutları (/)

Gemini CLI’nın en çok kullanılan komutları “slash” prefiksiyle başlar. Aşağıda en önemli birkaçını görebilirsiniz:

3. Context Komutları (@)

Projeye dair dosya ve klasörleri prompt’unuza dahil etmek için @ işaretini kullanabilirsiniz :

• Tek Dosya gemini -p "Bu fonksiyonun ne işe yaradığını açıkla" @./src/utils.js
• Klasör gemini -p "Tüm bileşenleri React 18’e uygun şekilde güncelle" @./src/components/

CLI, .gitignore’daki dosyaları otomatik es geçerek yalnızca izlenmesi gerekenleri işler.

4. Shell Komutları (!)

Doğrudan shell komutları çalıştırmak için:

• Tek Komut gemini > !ls -la
• Kalıcı Shell Modu gemini > !

[shell mode active]

$ git status $ npm test $ ! # tekrar ‘!’ yazarak çıkış

Shell tool, testler, build script’leri, linter’lar ve diğer CLI araçlarını kesintisiz kullanmanızı sağlar.

Gemini CLI, açık kaynak dünyasında yapay zeka agent’larıyla çalışma biçimimizi dönüştüren güçlü ve erişilebilir bir araç sunuyor. Geliştiriciler, araştırmacılar ve meraklı kullanıcılar için esnek, özelleştirilebilir ve topluluk destekli bu platform sayesinde AI çözümleri oluşturmak artık çok daha kolay. Siz de Gemini CLI’yi deneyerek, geleceğin yapay zekasına kendi katkınızı sunabilirsiniz.