Gemini CLI Kurulumu: Google’ın Yapay Zekâsını Bilgisayarınızda Ücretsiz Kullanmak İçin Adım Adım Rehber

Her ay ChatGPT ya da Claude’a 20 dolar vermeden önce bilmeniz gereken bir seçenek var: Google’ın Gemini CLI aracı. Kişisel Google hesabınızla giriş yapıyorsunuz, günde 1.000 isteğe kadar ücretsiz kullanıyorsunuz. Kredi kartı girmiyorsunuz.

Bu yazıda sıfırdan, bilgisayarında hiçbir şey kurmamış biri için her tıklamayı ve her komutu tek tek yazdım. Sonunda kodunuzu, dosyalarınızı ve projelerinizi analiz ettirebileceğiniz, düzenletebileceğiniz bir yapay zekâ asistanı bilgisayarınızda çalışıyor olacak.

Kontrol tarihi: 1 Ekim 2026. Rakamlar ve koşullar Google’ın resmî Gemini CLI sayfalarından alındı, kaynaklar yazının sonunda.

Önce şunu bilmeniz gerekiyor

Gemini CLI, Gemini sohbet sitesinin aynısı değil. Tarayıcıda açılan bir sayfa değil, bilgisayarınıza kurduğunuz bir program. Fark şu: Sohbet sitesine bir dosya yükleyip soru soruyorsunuz. Gemini CLI ise bilgisayarınızdaki bir klasörün içinde çalışıyor, o klasördeki dosyaları kendisi okuyabiliyor ve sizden onay alarak dosya oluşturup düzenleyebiliyor.

Bir de şu var: Gemini CLI siyah bir pencerenin içinde çalışıyor. Bu pencereye terminal deniyor. Terminal, bilgisayara fareyle değil yazıyla komut verdiğiniz yer. Korkutucu görünüyor ama bu rehberde sadece üç dört satırı kopyalayıp yapıştıracaksınız. Kod yazmıyorsunuz, ezberlemeniz gereken bir şey yok.

“Ücretsiz” kelimesine dair dürüst bir not: Ücretsiz, sınırsız demek değil. Günlük bir hakkınız var. Bu hakkın ne kadar olduğunu ve dolunca ne olduğunu yazının “Sınırlar” bölümünde anlattım.

Ne gerekiyor?

1. Kişisel bir Google hesabı. Gmail adresiniz yeterli. Şirket ya da okul hesabıyla giriş farklı çalışıyor, o yüzden bu rehber için kişisel hesap kullanın.
2. Bir bilgisayar. Google’ın belirttiği sistemler: macOS 15 ve üzeri, Windows 11 (24H2 ve üzeri), Ubuntu 20.04 ve üzeri.
3. En az 4 GB RAM. Günlük kullanım için bu yeterli, çok yoğun kullanım için 16 GB öneriliyor.
4. Node.js 20 ya da daha yeni bir sürüm. Bu, Gemini CLI’nin çalışması için gereken bir yardımcı program. Adım 2’de kontrol edip gerekirse kuracağız.
5. İnternet bağlantısı.

Adım 1: Terminali açın

Mac’te:

1. Klavyede Command ve Boşluk tuşlarına aynı anda basın.
2. Açılan arama kutusuna Terminal yazın.
3. Enter‘a basın. Beyaz ya da siyah bir pencere açılacak. Bu terminal.

Windows’ta:

1. Başlat düğmesine tıklayın.
2. cmd yazın.
3. Çıkan Komut İstemi‘ne tıklayın. Siyah bir pencere açılacak. Bu terminal.

Bu pencereyi kapatmayın, rehber boyunca açık kalacak.

Adım 2: Node.js’i kontrol edin

Terminale aşağıdaki satırı yazın (ya da kopyalayıp yapıştırın) ve Enter‘a basın:

node -v

İki ihtimal var:

• v20 ya da daha büyük bir sayı çıkarsa (örneğin v22.11.0), Node.js zaten kurulu. Adım 3’e geçin.
• “komut bulunamadı” gibi bir yazı çıkarsa ya da sayı v20’den küçükse, Node.js’i kurmanız gerekiyor.

Node.js’i kurmak için:

1. Tarayıcınızdan nodejs.org adresine girin.
2. LTS yazan büyük indirme düğmesine tıklayın. LTS, kararlı sürüm demek.
3. İnen dosyayı açın ve çıkan pencerede İleri ya da Devam düğmelerine basarak kurulumu bitirin.
4. Terminal penceresini kapatıp Adım 1’deki gibi yeniden açın. Bu önemli, açık kalan eski pencere yeni kurulumu görmüyor.
5. node -v komutunu tekrar yazın. Şimdi v20 ya da üstü görmelisiniz.

Adım 3: Gemini CLI’yi kurun

Terminale şu satırı yapıştırın ve Enter‘a basın:

npm install -g @google/gemini-cli

Bu satır, Gemini CLI’yi internetten indirip bilgisayarınıza kuruyor. Birkaç dakika sürebilir. Yazılar akacak, bu normal. Bittiğinde terminalde tekrar yazı yazabileceğiniz boş bir satır göreceksiniz.

Mac’te bu komut izin hatası verebilir. Hata mesajında “permission” ya da “EACCES” kelimesini görürseniz, komutun başına sudo ekleyip yeniden deneyin:

sudo npm install -g @google/gemini-cli

Mac şifrenizi isteyecek. Şifreyi yazarken ekranda hiçbir şey görünmez, bu normal. Yazıp Enter’a basın.

Mac ya da Linux’ta Homebrew kullanıyorsanız alternatif olarak şu komut da çalışıyor:

brew install gemini-cli

Terminalden hâlâ çekiniyorsanız

Claude masaüstü uygulamanız varsa kurulumu ona yaptırabilirsiniz. Uygulamanın Code sekmesinde yeni bir oturum açın ve şu mesajı yapıştırın:

Bilgisayarıma Google'ın Gemini CLI aracını kurmanı istiyorum. Ben kod bilmiyorum. Önce Node.js'in 20 ya da daha yeni bir sürümünün kurulu olup olmadığını kontrol et, değilse kur. Sonra npm install -g @google/gemini-cli komutuyla Gemini CLI'yi kur. Her adımda ne yaptığını bana tek cümleyle Türkçe anlat. Bitince kurulumun çalıştığını doğrula.

Claude arada izin isteyebilir. Kurulumla ilgiliyse onaylayın. Kurulum bittikten sonra Gemini CLI’yi yine bir terminalde başlatacaksınız, o kısım Adım 4 ve 5’te.

Kısa bir ara

Buraya kadar bilgisayarınıza ücretsiz bir yapay zekâ asistanı kurdunuz. Yapay zekâyı tek bir araç için değil, işinizi ve içerik üretiminizi baştan sona değiştirecek bir düzen olarak sıfırdan ve sırayla öğrenmek isterseniz kursuma bekliyorum. Tek ödeme, ömür boyu erişim: https://dijitalburak.com/yapay-zeka-egitimi/

Şimdi kullanmaya geçelim.

Adım 4: Bir deneme klasörü açın ve Gemini CLI’yi orada başlatın

Gemini CLI, başlattığınız klasörün içinde çalışıyor. Bu yüzden önce kendinize güvenli, boş bir deneme klasörü açın. Kendi önemli dosyalarınızın olduğu bir klasörde ilk denemeyi yapmayın.

1. Masaüstünde boş bir yere sağ tıklayıp Yeni Klasör seçin.
2. Adını gemini-deneme koyun. Türkçe karakter ve boşluk kullanmayın.
3. Klasörün içine bir metin dosyası atın. Örneğin içine birkaç satır not yazdığınız notlar.txt dosyası. Birazdan Gemini’ye bunu okutacağız.

Şimdi terminale dönün ve klasörün içine girin.

Mac’te:

cd ~/Desktop/gemini-deneme

Windows’ta:

cd %USERPROFILE%\Desktop\gemini-deneme

Windows’ta masaüstünüz OneDrive’ın içindeyse bu komut klasörü bulamayabilir. O durumda klasörün üstüne sağ tıklayıp Yol olarak kopyala seçin, terminale cd yazıp bir boşluk bırakın, kopyaladığınız yolu yapıştırıp Enter’a basın.

Şimdi Gemini CLI’yi başlatın:

gemini

İlk açılışta size bir seçenek listesi gelecek. Öncesinde ek bir soru (örneğin görünüm tercihi) çıkarsa varsayılan seçeneği onaylayıp Enter’la geçin.

Adım 5: Google hesabınızla giriş yapın

1. Seçenekler arasından Sign in with Google yazanı ok tuşlarıyla seçip Enter‘a basın.
2. Tarayıcınız kendiliğinden açılacak ve bir Google giriş sayfası gelecek.
3. Kişisel Google hesabınızı seçin.
4. Gemini CLI’nin hesabınıza erişmesi için izin isteyen ekranda izin verin.
5. Tarayıcıda giriş tamamlandı yazısını görünce terminal penceresine dönün.

Giriş bilgileriniz bilgisayarınızda saklanıyor, bir sonraki açılışta tekrar giriş yapmanız gerekmiyor. Terminalde yazı kutusu belirdiyse hazırsınız.

Şirket ya da okul hesabıyla giriş yaparsanız ek olarak bir Google Cloud projesi tanımlamanız isteniyor. Bu rehberin kapsamı dışında, kişisel hesapla devam edin.

Adım 6: İlk komutlarınızı verin

Yazı kutusuna Türkçe yazabilirsiniz. Aşağıdakileri sırayla deneyin. Her birini kopyalayıp yapıştırın ve Enter’a basın.

Örnek 1: Klasörü tanıyın. Gemini’ye klasörde ne olduğunu sorun:

Bu klasörde hangi dosyalar var? Bana basit bir dille anlat.

Örnek 2: Bir dosyayı okutun. Dosya adının başına @ işareti koyarsanız Gemini o dosyanın içeriğini okuyor:

@notlar.txt Bu dosyayı özetle ve içindeki yapılacakları madde madde yaz.

Örnek 3: Dosya oluşturtun. Bu komut klasörünüze yeni bir dosya ekliyor:

Bu klasöre bugunun-plani.txt adında bir dosya oluştur ve içine örnek bir günlük yapılacaklar listesi yaz.

Gemini dosya oluşturmadan ya da değiştirmeden önce çoğu zaman size onay soruyor. Ekrana ne yapmak istediğini yazıyor ve bir seçim sunuyor. Okuyun, mantıklıysa onaylayın, emin değilseniz reddedin.

Örnek 4: Kod yazdırın. Kod bilmeniz gerekmiyor, ne istediğinizi anlatmanız yeterli:

Bu klasörde tek sayfalık basit bir web sayfası oluştur. Üstte "Merhaba" yazsın, altında benim adım ve bir iletişim düğmesi olsun. Dosyanın adı index.html olsun.

Örnek 5: Bir şeyi anlatmasını isteyin. Elinizde anlamadığınız bir kod ya da dosya varsa:

@index.html Bu dosyada ne yazıyor? Kod bilmeyen birine anlatır gibi açıkla.

Bir komutun sonucu beğenmediyseniz yeniden yazmanıza gerek yok. “Daha kısa yaz”, “rengi mavi yap” gibi bir sonraki mesajla düzelttirebilirsiniz.

Gemini CLI’nin işinize yarayan komutları

Bu komutlar yazı kutusuna / işaretiyle başlayarak yazılıyor. Hepsi Google’ın resmî komut listesinden:

Komut	Ne yapar
/help	Yardım sayfasını ve kullanılabilir komutları gösterir
/auth	Giriş yöntemini değiştirmenizi sağlar
/stats	O oturumda ne kadar kullandığınızı gösterir
/clear	Konuşmayı temizleyip yeni bir oturum başlatır
/copy	Gemini’nin son cevabını panoya kopyalar
/init	Bulunduğunuz klasörü inceleyip Gemini için bir bilgi dosyası (GEMINI.md) hazırlar
/quit	Gemini CLI’den çıkar

Bunlara ek olarak iki işaret var: @ dosya ya da klasör içeriğini mesaja ekler, ! işareti ise bir terminal komutunu doğrudan çalıştırır. Başlangıç için sadece @ yeterli.

Adım 7: Çıkın ve bir dahaki sefere tekrar açın

Çıkmak için yazı kutusuna şunu yazıp Enter’a basın:

/quit

Bir dahaki sefer kullanmak istediğinizde:

1. Terminali açın (Adım 1).
2. Çalışmak istediğiniz klasöre cd ile girin (Adım 4).
3. gemini yazıp Enter’a basın.

Giriş yapmanız gerekmeyecek.

Yeni sürümleri almak istediğinizde şu komut yeterli:

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

Sınırlar: Dürüst olalım

Günlük bir hakkınız var. Google’ın resmî sayfasına göre kişisel Google hesabıyla günde 1.000 model isteği ücretsiz. Dakikada 60 istek sınırı da var. Burada “istek” sizin yazdığınız mesaj sayısı değil, Gemini’nin arka planda yaptığı çağrı sayısı. Karmaşık bir iş tek mesajla başlasa da birden fazla isteğe mâl olabilir. Dolayısıyla günde 1.000 mesaj yazabileceğiniz anlamına gelmiyor.

Limit dolunca ne olacağını resmî sayfa anlatmıyor. Sayfada yalnızca daha yüksek günlük hak için ücretli planlara (Google AI Pro ve Google AI Ultra) geçebileceğiniz yazıyor. Bu rakamlar zamanla değişebiliyor. Güncel durum için Google’ın Gemini CLI kota sayfasına bakın.

Hangi modeli kullanacağını siz seçmiyorsunuz. Resmî sayfaya göre istekler Gemini model ailesi içinde Gemini CLI’nin belirlediği modellere gidiyor. “Bütün Gemini modelleri istediğim gibi, istediğim kadar” demek doğru olmaz.

Gizlilik: istemleriniz kullanılabilir. Kişisel Google hesabıyla kullandığınızda, yazdıklarınız, aldığınız cevaplar ve kodlarınız Google’ın ürünlerini geliştirmek için, model eğitimi dahil, kullanılabiliyor. Bunu kapatmak için Gemini CLI’de /privacy komutunu yazıp gizlilik bildirimine bakın ve Google’ın anlattığı vazgeçme adımlarını izleyin. Pratik kural: parola, müşteri bilgisi, kimlik numarası ve gizli iş dosyalarını bu araca vermeyin.

Dosyalarınız değişebilir. Gemini CLI klasörünüzdeki dosyaları düzenleyebilir ya da silebilir. Önemli dosyaların olduğu bir klasörde ilk denemeyi yapmayın, çalışmadan önce yedek alın ve onay isteyen ekranları okuyarak onaylayın.

Ücretli araçların yerine geçtiğini söylemiyorum. Gemini CLI, ChatGPT ya da Claude’la aynı araç değil. Cevapların kalitesini onlarla karşılaştırmadım. Hedefim, 20 dolar ödemeden ciddi bir yapay zekâ asistanını denemenizi sağlamak. Sizin işinize yarayıp yaramadığını birkaç gün kullanarak göreceksiniz.

Hata alırsanız. Terminalde kırmızı bir hata çıkarsa, hatayı olduğu gibi kopyalayıp başka bir yapay zekâya (“bu hatayı bana basitçe açıkla ve çözümünü adım adım yaz” diye) yapıştırın. Kurulum hatalarının büyük çoğunluğu böyle çözülüyor.

Hızlı özet

Adım	Ne yapıyorsunuz	Süre
1	Terminali açın (Mac: Command + Boşluk, Terminal. Windows: cmd)	1 dakika
2	node -v ile kontrol edin, gerekirse nodejs.org’dan LTS kurun	1 ila 5 dakika
3	npm install -g @google/gemini-cli	2 ila 5 dakika
4	gemini-deneme klasörü açın, cd ile girin, gemini yazın	2 dakika
5	Sign in with Google ile giriş yapın	1 dakika
6	İlk komutları deneyin	sizin hızınız
7	/quit ile çıkın	5 saniye

Sık sorulan sorular

Gerçekten ücretsiz mi?

Kişisel Google hesabıyla günlük 1.000 isteğe kadar evet. Daha fazlası için ücretli plan gerekiyor.

Kredi kartı istiyor mu?

Bu rehberdeki adımlarda hiçbir yerde kart bilgisi girmediniz. Giriş sadece Google hesabıyla yapıldı.

Windows’ta çalışır mı?

Evet, Google’ın desteklediği sistemler arasında Windows 11 (24H2 ve üzeri) var.

Türkçe yazabilir miyim?

Evet, komutları Türkçe yazabilirsiniz.

Kod bilmeden işime yarar mı?

Yarar. Dosya özetletme, klasör düzenletme, basit bir web sayfası hazırlatma gibi işler kod bilmeden yapılıyor. Kodla ilgili işlerde ise ne istediğinizi anlatmanız yeterli.

Google hesabı olmadan kullanabilir miyim?

Bu rehberdeki yol Google hesabıyla giriş. Gemini CLI bir API anahtarıyla da çalışıyor ama bu ayrı bir kurulum, kotaları farklı ve rehberin kapsamı dışında.

Nasıl silerim?

Gemini CLI’yi kaldırmak için terminale npm uninstall -g @google/gemini-cli yazın.

Kısacası: Terminali açın, üç komut yapıştırın, Google hesabınızla giriş yapın ve gemini yazın. İlk denemeniz için Adım 6’daki ilk örnekle başlayın.

Kaynaklar

• Gemini CLI resmî GitHub sayfası: https://github.com/google-gemini/gemini-cli
• Kurulum gereksinimleri: https://geminicli.com/docs/get-started/installation/
• Giriş yöntemleri: https://geminicli.com/docs/get-started/authentication/
• Komut listesi: https://geminicli.com/docs/reference/commands/
• Kota ve fiyatlandırma: https://geminicli.com/docs/resources/quota-and-pricing/
• Kullanım şartları ve gizlilik bildirimi: https://geminicli.com/docs/resources/tos-privacy/