Gemini CLI nedir? Kurulumu, ücretsiz kullanım sınırı ve alternatifleri

Gemini CLI hakkında internette dolaşan birçok yazı hâlâ "Google hesabınla giriş yap, günde 1.000 istek ücretsiz" diyor. Bu bilgi eskidi. Google Ads verisine göre Ekim 2026'da Türkiye'de "gemini cli" ayda ortalama 5.400, "gemini code assist" ise 1.300 kez aranıyor; yani çok kişi bu aracı kurmaya çalışıyor ve güncel durumu görmüyor.

Bu yazı aracın ne olduğunu, kurulum komutlarını, API anahtarının nasıl girildiğini, hangi hesapların hâlâ çalıştığını ve ücretsiz bir yol arıyorsan ne yapacağını anlatıyor. Bilgiler Google'ın GitHub deposundan ve resmi duyurusundan, Ekim 2026 itibarıyla alındı. Sıfırdan Sistem, Google ile bağlantılı değildir.

Gemini CLI nedir, ne işe yarar?

Gemini CLI, bilgisayarındaki klasörü okuyup dosya yazan, komut çalıştıran ve Google'ın Gemini modelleriyle çalışan, terminalde çalışan açık kaynaklı bir yapay zeka kodlama ajanıdır. Lisansı Apache 2.0 ve GitHub'da google-gemini/gemini-cli deposunda yayınlanıyor. Claude Code ve Codex ile aynı türden bir kodlama ajanıdır; fark, arkasındaki model ve hesap yapısıdır.

Deponun anlattığı yetenekler şunlar:

• GEMINI.md: projeye özel kalıcı talimat dosyası, davranışı projene göre ayarlar.
• MCP: yeni yetenekler için MCP sunucuları bağlanabilir.
• Eklentiler: kendi komutlarını yazıp paylaşabileceğin uzantı sistemi.

Aracın hikâyesinde bir kırılma var: deponun ana sayfası Google hesabıyla girişi ücretsiz kotayla anlatıyordu, ama 18 Haziran 2026'da bu kapı kapandı. Aşağıdaki bölüm tam olarak neyin değiştiğini anlatıyor.

Gemini CLI ücretsiz mi, sınırı ne?

Gemini CLI artık kişisel Google hesabıyla ücretsiz değil: Google'ın GitHub duyurusuna göre 18 Haziran 2026'dan itibaren ücretsiz bireysel hesaplar, Google AI Pro ve Google AI Ultra abonelikleri araca erişemiyor. Duyuru, Gemini Code Assist lisansı olan kurumsal kullanıcıların ve API anahtarı ile girenlerin bu değişiklikten etkilenmediğini belirtiyor.

Deponun ana sayfasında hâlâ Google ile girişte dakikada 60 ve günde 1.000 istek yazan bir satır duruyor. Duyuru bu hesaplar için erişimin kapandığını söylediğine göre, o satırı geçerli bir ücretsiz kota gibi okuma. API anahtarının ücretsiz ve ücretli katmanlarındaki güncel sayıları anahtarı aldığın Google AI Studio sayfasından kontrol et; bu yazı olmayan bir sayıyı yazmıyor.

Ücretsiz yol arayanlar için dürüst cevap: Gemini CLI için resmi, süresiz ve sınırsız bir ücretsiz kapı Ekim 2026'da yok. Google'ın önerdiği alternatif Antigravity CLI ve bu yazının alternatifler bölümünde.

Gemini CLI nasıl kurulur?

Gemini CLI'ı kurmanın en kısa yolu terminale npm install -g @google/gemini-cli yazmaktır; Node.js kuruluysa komut Mac, Linux ve Windows'ta aynı çalışır. Ekim 2026 itibarıyla Google'ın deposu dört yol veriyor:

1. Node.js kur. npm yolunu seçtiysen önce Node.js gerekir.
2. Komutu çalıştır. Tablodan birini terminale yapıştır.
3. Giriş yolunu belirle. Aşağıdaki API anahtarı ya da kurumsal Code Assist hesabı.
4. Proje klasörüne geç. cd klasorun ile ajanın çalışacağı klasöre gir ve gemini yaz.

Kurulum komutu çalışsa da giriş aşamasında kişisel hesabın reddedildiğini görebilirsin; bu bir kurulum hatası değil, yukarıdaki erişim değişikliğidir.

Gemini CLI API key nasıl alınır ve girilir?

API anahtarı almak için aistudio.google.com/apikey adresinden anahtar üretir, sonra GEMINI_API_KEY adlı ortam değişkenine yazarsın; CLI bu değişkeni görünce anahtarla giriş yapar. Depo üç giriş yolu sayıyor: tarayıcıdan Google ile giriş (kişisel hesaplar için artık kapalı), Gemini API anahtarı ve Vertex AI.

1. Anahtarı al. aistudio.google.com/apikey sayfasından yeni anahtar oluştur.
2. Ortam değişkenine yaz. Mac ve Linux'ta export GEMINI_API_KEY="anahtarin", Windows PowerShell'de $env:GEMINI_API_KEY="anahtarin".
3. CLI'ı başlat. Aynı terminal penceresinde gemini yaz.

Vertex AI için depo GOOGLE_API_KEY ve GOOGLE_GENAI_USE_VERTEXAI=true değişkenlerini anıyor. Anahtarı bir dosyaya ya da sohbete yapıştırma; ortam değişkeni olarak sakla. Anahtar bir parola gibidir; bir dosyaya yazıp GitHub'a yüklersen başkası kullanabilir.

Gemini Code Assist ile farkı nedir?

Gemini CLI bir terminal aracıdır, Gemini Code Assist ise Google'ın kodlama yardımcısı için verdiği lisanstır; kurumsal Code Assist lisansı olanlar CLI'ı kullanmaya devam ediyor. Aralarındaki ilişki şu: araç aynı, girişin hangi hesapla yapıldığı değişiyor.

GEMINI.md dosyasına yazılacaklar diğer ajanlardaki talimat dosyalarıyla aynıdır: projenin ne yaptığı, çalıştırma ve test komutları, dokunulmaması gereken dosyalar ve dil kuralı. Dosyayı kısa tut ve emir kipinde yaz; "Yanıtları Türkçe ver" gibi tek satır, Türkçe çalışmak için yeterli. Aynı mantıkta bir AGENTS.md dosyası Codex ve Cursor tarafında da işe yarar.

Lisans ayrıntıları ve fiyatı için Google'ın Gemini Code Assist sayfasına bak; bu yazıda doğrulayamadığım bir fiyat yazmıyorum.

Gemini CLI ile neler yapılır, alternatifleri neler?

Gemini CLI ile klasördeki kodu anlamak, hata düzeltmek, dosya üretmek ve komut çalıştırmak gibi her kodlama ajanı işi yapılabilir; GEMINI.md ve MCP sayesinde kendi işine göre ayarlanır. Erişim kapandığı için ilk soru artık "hangi alternatif":

Karar için üç soru yeter:

1. Zaten bir Gemini API anahtarın var mı? Varsa Gemini CLI'ı o anahtarla kullanmak mantıklı; maliyet kullandığın kadar olur.
2. Kurumsal Code Assist lisansın var mı? Varsa duyuruya göre CLI çalışmaya devam ediyor, yeni bir şey yapman gerekmez.
3. İkisi de yoksa ve bütçe ayırabiliyorsan? Codex ya da Claude Code planlarını karşılaştır; en kolay başlangıç hesabın hangisinde açık olduğu.

Google'ın resmi önerisi Antigravity CLI: duyuruya göre "agent-first" birleşik bir terminal deneyimi, kurulumda skills, MCP sunucuları, ajan profilleri ve mevcut gemini.md bellek dosyalarını otomatik taşıyor. Duyurunun altındaki tartışmada kullanıcılar yeni aracın olgunluğunu ve eksik özelliklerini eleştiriyor. Fiyat ve kota için antigravity.google adresine bak.

Ücretli bir plan açmaya hazırsan kıyas için Claude Code, Codex ve Cursor karşılaştırması yazısına, kurulum için Claude Code kurulumu yazısına, MCP'nin ne yaptığı için MCP nedir yazısına bak.

Gemini CLI kimin için yanlış?

Gemini CLI, bedava deneyecek kişi için artık yanlış araç; bunun dışında kodlama ajanı kategorisinin genel sınırları geçerli. Şu durumlarda başka yol ara:

• Kişisel Google hesabıyla bedava denemek isteyen: erişim 18 Haziran 2026'dan beri kapalı. Antigravity CLI ya da başka bir ajanın ücretsiz katmanına bak.
• Müşteri ya da kişisel veri taşıyan klasör: içerik bir modele gider. KVKK yükümlülüklerini kontrol etmeden açma; yapay zeka veri gizliliği yazısı çerçeve veriyor.
• Hiç terminal istemeyen: CLI bu kişi için değil; masaüstü uygulaması olan bir ajan seç.
• Kota sürprizi istemeyen: API anahtarında harcama kullanıma bağlı. Harcamayı kullanımla birlikte izle.

Sıfırdan Sistem'in ajan paketleri .md talimat dosyalarıdır ve dosya okuyabilen kodlama ajanlarıyla çalışır; Gemini CLI de bunlardan biri, yalnız kapı ve doğrulama davranışı Claude'da en tutarlı sonucu verir.