Gemini CLI nedir? Kurulum (Windows, Mac), hâlâ ücretsiz mi, API anahtarı, MCP ve Antigravity CLI'ye geçiş

Gemini CLI'ı kurar (Node.js 20 ya da üstüyle `npm install -g @google/gemini-cli`), proje klasöründe iş verirsin; ajan dosyaları okur, onayınla değiştirir ve komut çalıştırır. Google'ın açık kaynak (Apache 2.0) terminal ajanı. Önemli değişiklik: Google 18 Haziran 2026'da kişisel Google hesabıyla girişi kapattı, yani eski "günde 1.000 ücretsiz istek" bilgisi artık geçerli değil. Şimdi ücretli Gemini API anahtarı, Vertex AI ya da kurumsal Code Assist lisansı gerekiyor; tüketici kullanıcılarını Google, Antigravity CLI'ye yönlendiriyor. Aracı kurmak ücretsiz. Arayüz İngilizce; Türkçe desteği için resmî kaynak yok.

Ne yapar: Terminalde dosya okuyan, değiştiren Google kodlama ajanı
Giriş: Ücretli API anahtarı, Vertex AI, kurumsal lisans
Kurulum: npm install -g @google/gemini-cli
Nerede: Terminal: Windows, Mac, Linux
Türkçe: Arayüz İngilizce; yanıt dili belgede yok
Güncel sürüm: 0.64.0 (13 Ekim 2026)
Ücretsiz mi: Yazılım evet; Google hesabıyla giriş kapandı

Son gelişmeler

28 Ekim 2026Gemini 4 Argon: Fiyatı, Kimde Açık, Ücretsiz mi?

Tüm YZ Gündemi

Gemini CLI ne işe yarar? Kodsuz kullanabilir miyim?

18 Haziran 2026'dan beri kişisel Google hesabıyla (ücretsiz Code Assist, Google AI Pro ve Ultra dahil) Gemini CLI'ya giriş yapamazsın. Google tüketici kullanıcılarını Antigravity CLI'ye yönlendiriyor. Gemini CLI kurumsal Code Assist lisansıyla ve ücretli API anahtarlarıyla çalışmaya devam ediyor. GitHub'daki README ve kota belgesi hâlâ eski ücretsiz kotayı yazıyor; ona güvenme.

Kodsuz kullanabilir miyim?

Hayır. Gemini CLI bir komut satırı aracı: terminal denen, bilgisayara komutu yazıyla verdiğin pencerede çalışır. Bulut sürümü ya da kendi arayüzü yok. Görsel bir editör arıyorsan Google'ın duyurusunda Antigravity uygulaması anılıyor.

Gemini CLI'yı bir proje klasöründe açıp ne istediğini düz cümleyle yazarsın. Araç ajan gibi çalışır: yani tek cevap vermek yerine dosyaları okur, değişiklik önerir, komut çalıştırır. Dosya değiştiren ya da komut çalıştıran her adımda önce sana gösterip onay ister.

Projeni terminalde okutup düzenletmekNe alırsın: Onayından sonra düzenlenen dosyalar, çalışan komutlarAyrı kurulum gerekir npm ile kurmak (Windows, Mac, Linux)Ne alırsın: gemini komutuAyrı kurulum gerekir MCP sunucusu bağlamakNe alırsın: Ajanın kullanabildiği yeni araçlarAyrı kurulum gerekir

Yerleşik araçlar: dosya işlemleri, kabuk komutları, web sayfası getirme ve Google Arama (README).
Genişletme: MCP sunucuları, eklentiler (extensions) ve ajan becerileri (skills).
Başsız kullanım: betik ya da CI içinde tek komutla çalıştırma.
Proje bağlamı: klasördeki GEMINI.md dosyası, aracın o proje için kalıcı talimatı olur.

Kime yarar: terminal kullanmaktan çekinmeyen geliştiriciler, site ve otomasyon işi yapanlar. Terminali hiç kullanmadıysan önce görsel bir araç düşün.

Benzer terminal aracı: Claude Code rehberi

Benzer terminal aracı: Codex rehberi

Gemini CLI nasıl kurulur? Windows, Mac ve Linux

Önce Node.js (aracın çalışması için gereken ücretsiz yazılım altyapısı) 20 ya da üstü olmalı. Belge önerilen sistemi macOS 15+, Windows 11 24H2+ ve Ubuntu 20.04+ olarak yazıyor; kabuk olarak Bash, Zsh ya da PowerShell olur. İnternet bağlantısı şart.

Kur› npm install -g @google/gemini-cli

Başlat› gemini

Kur› brew install gemini-cli

Kur› sudo port install gemini-cli

Kısıtlı ortamlar için: Node.js'i ayrı bir ortama kurup aracı içine yüklersin.

Kur

› conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

Çalıştır› npx @google/gemini-cli

Docker ya da Podman kuruluysa araç komutlarını izole bir kapta çalıştırabilirsin. Bu, aracı Docker ile kurmak değil; zaten kurulu aracın komutlarını yalıtmaktır. Çalışma klasörün kabın içine aynı yolla bağlanır.

Korumalı alanda tek sorgu› gemini -s -p "analyze the code structure"

Node.js'i kur. Terminalde node --version ile sürümün 20 ya da üstü olduğunu doğrula.
Aracı kur. Yukarıdaki sekmelerden birini seç.
Kurulduğunu doğrula. gemini --version sürümü yazar.
Başlat ve giriş yöntemini seç. Proje klasöründe gemini yaz. Giriş seçenekleri için "Hâlâ ücretsiz mi?" bölümüne bak.

Windows'ta chmod gibi Unix komutları yoktur; araç böyle bir komut çalıştırmaya kalkarsa hata verir. Belge bunun için icacls komutunu ya da WSL (Windows'ta Linux ortamı) kullanmayı öneriyor.

Donanım

Hafif kullanım için 4 GB+ RAM; uzun oturumlar ve büyük projeler için 16 GB+ RAM (belgenin önerisi). Belge ekran kartından söz etmiyor; model Google'ın sunucusunda çalışıyor.

Güncel sürüm

Son kararlı sürüm 0.64.0 (13 Ekim 2026). Haftalık kararlı, haftalık önizleme ve günlük nightly kanalı var; çoğu kişi için kararlı olanı önerilir. Güncellemek için: npm install -g @google/gemini-cli@latest

Maliyet

Yazılım ücretsiz. Ödediğin şey modele erişim; sunucu işletmen gerekmiyor ama kurulum, güncelleme ve anahtar yönetimi sende.

Kaldırmak istersen

npm ile kurduysan: npm uninstall -g @google/gemini-cli
Homebrew: brew uninstall gemini-cli. MacPorts: sudo port uninstall gemini-cli.
npx ile denediysen kurulum kalmaz; önbelleği silmek istersen npm'in _npx klasörünü sil.
Ayarların ve geçmişin ~/.gemini klasöründe durur; kalmasını istemiyorsan elle sil.

Kaynak: Gemini CLI kurulum, kaldırma ve SSS belgeleri; npm kaydı; 15.10.2026.

Gemini CLI mı, Antigravity CLI mı? Eski ayarları taşımak

Google 19 Mayıs 2026'da çalışmalarını tek ürün olan Antigravity altında birleştirdiğini duyurdu. Terminal kısmı Antigravity CLI (komutu agy). Google, bu aracın Gemini CLI'nın en önemli özelliklerini koruduğunu (ajan becerileri, kancalar, alt ajanlar, eklentiler) ama birebir aynı olmadığını yazıyor. Gemini CLI'nın tüketici kullanımı 18 Haziran 2026'da bitti; kurumsal lisans ve ücretli API anahtarıyla erişim sürüyor.

agy komutunu açEski yapılandırmayı bulursa aktarılacakları soran bir liste çıkar.

Taşınacakları seçEklentiler, ayarlar ve oturum bilgisi.

Beceri klasörünü taşıProje becerilerini elle yeni klasöre al.

Antigravity CLI ayrı bir üründür; kota ve fiyatı Gemini CLI'dan farklı olabilir.

Eklentileri elle içe aktar› agy plugin import gemini

Konu	Gemini CLI	Antigravity CLI
Genel beceri klasörü	~/.gemini/skills/	~/.gemini/antigravity-cli/skills/
Proje beceri klasörü	.gemini/skills/	.agents/skills/
MCP ayarı	settings.json içinde	ayrı mcp_config.json dosyası
Uzak MCP adresi anahtarı	url ya da httpUrl	serverUrl
GEMINI.md ve AGENTS.md	Okunur	Aynen okunur

Proje beceri klasörü otomatik taşınmaz: .gemini/skills/ içindekileri .agents/skills/ altına kendin almalısın. Antigravity belgesi bazı özel temaların ve deneysel görsel ayarların taşınmayabileceğini de söylüyor.

Antigravity CLI'nin fiyatı ve ücretsiz kotası bu rehberde yer almıyor; güncel bilgi için antigravity.google/pricing sayfasına bak.

Kaynak: Google Developers Blog (19.05.2026), Antigravity belgeleri "Migrating from Gemini CLI" ve "Antigravity CLI overview"; 15.10.2026.

Gemini CLI nasıl kullanılır? İlk komutlar, MCP ve eklenti ekleme

Proje klasörüne gir. Terminalde cd ile çalışmak istediğin klasöre geç.
Başlat. gemini yaz. İlk açılışta giriş yöntemini sorar.
İsteğini yaz. Örneğin projenin ne yaptığını özetletmek ya da bir dosya için test yazdırmak.
Onay ver ya da reddet. Dosya değiştirecek ya da komut çalıştıracak adımlarda araç farkı veya komutu gösterir; Allow once gibi seçeneklerle karar verirsin.

Resmî rehberden: test yazdırma"Write unit tests for Login.js."Örnek, Gemini CLI hızlı başlangıç belgesinden ve İngilizce. Türkçe yazınca anlayıp anlamadığı resmî kaynakta yazmıyor; denemeden önemli işte güvenme, yapılan değişikliği kendin oku.

Resmî README'den: depo özeti"Give me a summary of all of the changes that went in yesterday"Bir Git deposunun klasöründe çalıştırılır; dünün değişikliklerini özetletir.

Komut	Ne yapar
gemini	Etkileşimli oturumu başlatır
gemini -p "soru"	Tek seferlik sorgu; yanıtı yazıp çıkar
gemini -r latest	Son oturumu sürdürür
gemini --sandbox	Araç komutlarını korumalı alanda çalıştırır
gemini update	Son sürüme günceller
/stats model	Oturumun token kullanımını ve kota bilgisini gösterir
/mcp list	Bağlı MCP sunucularını listeler
/help	Bütün slash komutlarını gösterir

MCP sunucusu nasıl eklenir?

MCP, yapay zekâ araçlarının dış servislere (GitHub, veritabanı gibi) bağlanma standardı. Gemini CLI'da komutla ya da ayar dosyasıyla eklenir.

Komutla ekle (resmî örnek)› gemini mcp add github npx -y @modelcontextprotocol/server-github

Listele› gemini mcp list

Resmî MCP rehberi başka bir yolu da gösteriyor: ~/.gemini/settings.json dosyasına mcpServers bloğu yazmak. Örnekte GitHub'ın MCP sunucusu Docker ile çalışıyor, erişim jetonu ortam değişkeninden okunuyor.

~/.gemini/settings.json

› {
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server:latest"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}" }
    }
  }
}

Gemini CLI'yı yeniden başlat; /mcp list ile "Connected" yazdığını gör. Araçlar görünmüyorsa /mcp reload komutunu dene. Jetonu ayar dosyasına açık yazma, ortam değişkeninden okut; GitHub jetonuna yalnız gereken izinleri ver.

Eklenti (extension) nasıl kurulur?

Eklenti; istemler, MCP sunucuları, özel komutlar, temalar, kancalar (hooks), alt ajanlar ve ajan becerilerini tek pakette toplar. GitHub adresiyle kurulur; resmî galeri geminicli.com/extensions/browse adresinde.

Resmî örnek› gemini extensions install https://github.com/gemini-cli-extensions/workspace

Kurulu eklentiler› gemini extensions list

Eklenti komut ve MCP sunucusu taşıyabildiği için kaynağını bilmediğin eklentiyi kurma.

Dosyalarıma zarar verir mi?

Dosya değiştiren ve komut çalıştıran araçlar varsayılan olarak onay ister.
Dosya değişikliğinden önce otomatik anlık kayıt (checkpointing) ayarla açılabilir; açıksa /restore ile eski duruma dönersin.
--sandbox ile komutlar izole kapta çalışır; güvenilen klasörler (trusted folders) ayarıyla hangi klasörde araç çalışacağını sınırlarsın.

Onay modları

--approval-mode ile default, auto_edit, yolo ya da plan seçilir. yolo bütün eylemleri onaysız çalıştırır; ne yaptığını bilmiyorsan kullanma.

Kaynak: Gemini CLI hızlı başlangıç, komut sayfası, MCP kurulum rehberi, eklentiler, araçlar ve checkpointing belgeleri; README; 15.10.2026.

Gemini CLI hâlâ ücretsiz mi? Google hesabıyla giriş, API anahtarı ve kurumsal lisans

Yazılımın kendisi ücretsiz ve Apache 2.0 lisanslı. Asıl soru modele nasıl eriştiğin: Gemini CLI kendi başına yapay zekâ taşımaz, Google'ın modellerine bağlanır ve bu erişimin ücreti giriş yöntemine göre değişir.

Kişisel Google hesabı (ücretsiz Code Assist, AI Pro, AI Ultra)Yok	18 Haziran 2026'da kapandı. "Login with Google" seçeneğiyle artık giriş yok; Google bu kullanıcıları Antigravity CLI'ye yönlendiriyor.
Gemini API anahtarı (ücretli)Var	Kullandıkça öde. Google, Gemini CLI'nın ücretli API anahtarlarıyla erişilebilir kalacağını yazıyor. Fiyat ve kota Gemini API sayfasında; bu rehber rakam vermiyor.
Gemini API anahtarı (ücretsiz)Net değil	Çelişkili. Kota belgesi günde 250 istek ve yalnız bir hızlı model diyor, README günde 1.000 istek diyor, Google'ın duyurusu yalnız ücretli anahtarları anıyor. Çalışıp çalışmadığını kendin dene.
Vertex AI (Google Cloud)Var	Kullandıkça öde, Google Cloud faturasıyla. Kota belgesi "Express mode" için ilk 90 gün faturalamasız kullanım diyor; bunun bugün geçerli olup olmadığı resmî kaynakta net değil.
Gemini Code Assist Standard / Enterprise (kurumsal)Kısmen	Kurumsal lisansla çalışmaya devam ediyor. Ama Google yeni Standard ve Enterprise aboneliklerinin 9 Ekim 2026'dan sonra satın alınamayacağını, yenilemelerin 2027'de duracağını duyurdu.

Giriş yöntemi	Günlük istek sınırı (belgeye göre)
Code Assist Standard (kurumsal)	1.500 istek / kullanıcı / gün
Code Assist Enterprise (kurumsal)	2.000 istek / kullanıcı / gün
Gemini API anahtarı (ücretli)	Plana göre değişir
Vertex AI	Hesabına göre değişir

Kota belgesinde hâlâ duran Google hesabı satırları (1.000, 1.500, 2.000 istek) ve README'deki dakikada 60 istek bilgisi artık geçerli değil. Bu rehber ücretsiz limit rakamı vermez.

Hangi giriş yöntemini seçmeliyim?

Tek başına denemek istiyorsan: Google AI Studio'dan bir API anahtarı al, GEMINI_API_KEY ortam değişkenine yaz, gemini komutunu başlat ve Use Gemini API key seçeneğini seç. Kotasına AI Studio'dan bak.
Şirket ya da okul hesabıyla çalışıyorsan: Google Cloud projen ve Gemini Code Assist lisansın olmalı; GOOGLE_CLOUD_PROJECT ortam değişkenini ayarlarsın. Yöneticine sor.
Cloud altyapın varsa: Vertex AI; GOOGLE_CLOUD_PROJECT ve GOOGLE_CLOUD_LOCATION gerekir.
Betik ya da CI için: belge API anahtarı ya da Vertex AI öneriyor.

API anahtarını bu oturum için tanımla (macOS/Linux)› export GEMINI_API_KEY="ANAHTARIN"

Aynısı Windows PowerShell'de› $env:GEMINI_API_KEY="ANAHTARIN"

API anahtarı bir şifre gibidir: kimseyle paylaşma, bir Git deposuna yazma. Belge anahtarı proje klasöründeki .gemini/.env dosyasında ya da işletim sisteminin anahtar kasasında saklamayı öneriyor.

Kalan kotanı görmek için araçta /stats model komutunu kullanırsın. TL fiyat yok: ücretler dolarla ve Google'ın fatura sayfalarından belirlenir. Ödeme yöntemi, vergi ve iptal adımları resmî kaynakta net değil; ilgili Google hesabı ya da Cloud konsolundan bak.

Kaynak: Google Developers Blog duyurusu (19.05.2026); Gemini Code Assist kullanımdan kaldırma sayfaları (güncelleme 09.10.2026); geminicli.com üst uyarısı; kota, kimlik doğrulama ve SSS belgeleri; 15.10.2026.

Gemini CLI lisansı, verilerim ve Türkçe

Lisans

Apache 2.0 açık kaynak lisansı. Kullanma ve değiştirme koşulları lisans metninde; ayrıca Google hizmetlerinin şartları geçerli. Bu hukuki görüş değildir.

Verilerim Google'a gider

Araç bilgisayarında çalışır ama istemlerin ve okuttuğun dosyalar Google'ın modeline gönderilir; yerel model seçeneği belgede yok. Hassas dosyaları okutmadan önce düşün.

Hangi şart geçerli?

Ücretsiz Gemini API anahtarı: Gemini API "Unpaid Services" şartları.
Ücretli Gemini API anahtarı: Gemini API "Paid Services" şartları.
Vertex AI ve Code Assist Standard/Enterprise: Google Cloud şartları.
Google'ın planlar sayfası ücretsiz API katmanındaki verinin ürünleri geliştirmek için kullanılabileceğini yazıyor; ücretli API'yi gizlilik için öneriyor.

Kullanım istatistikleri

Varsayılan olarak açık. Araç adlarını, sürelerini ve yapılandırmayı toplar; istemlerin, yanıtların, dosya içeriklerinin ve kişisel bilginin toplanmadığını belge söylüyor. Kapatmak için settings.json dosyasında privacy.usageStatisticsEnabled değerini false yap.

Üçüncü taraf araçlar

Gemini CLI'nın giriş oturumunu başka bir yazılımla (Claude Code, OpenClaw, OpenCode gibi) kullanmak şartların ihlali sayılıyor ve hesabın askıya alınmasına yol açabilir. Başka araçla Gemini kullanmak istiyorsan resmî yol API anahtarı.

Güvenlik

GitHub güvenlik bildirimleri listesi 15.10.2026'da boş döndü; bu "açık yok" demek değildir. Araç komut çalıştırabilir: onay ekranlarını oku, güvenmediğin klasörde ve projede korumalı alan kullan. Açık bildirmek için Google g.co/vulnz adresini gösteriyor.

Arayüz diliNet değil	Dil seçeneği resmî belgede yok; belgelerin hepsi İngilizce.
Türkçe yanıtNet değil	Resmî kaynak Türkçe desteğinden söz etmiyor. Türkçe yazıp sonucu kendin kontrol et.
Türkiye'den erişimNet değil	Kurulum belgesi desteklenen konumlara gönderme yapıyor; Türkiye'nin bu listede olup olmadığını resmî belge netleştirmiyor, kurmadan önce kontrol et.
TL fiyatYok	Resmî TR fiyat sayfası yok.

Gemini CLI hataları: giriş, 429, komut bulunamadı

Belirti	Çözüm
Google hesabıyla giriş çalışmıyor	18 Haziran 2026'dan beri kişisel hesaplarda giriş kapalı. Ücretli API anahtarı ya da Vertex AI kullan ya da Antigravity CLI'ye geç.
named user ... Standard edition hatası	GOOGLE_CLOUD_PROJECT ya da GOOGLE_CLOUD_PROJECT_ID tanımlıysa kurumsal abonelik kontrolü zorlanır. Bireyselsen bu değişkenleri kaldır; kurumsalsan yöneticinden lisans iste.
API error: 429 Resource exhausted	İstek sınırı aşıldı. Kullanımı AI Studio ya da Cloud panelinde kontrol et, istekleri seyrelt ya da kota artışı iste.
gemini komutu bulunamadı	npm'in genel dizini PATH'te mi bak; npm install -g @google/gemini-cli@latest ile yeniden kur.
Şirket ağında sertifika hatası	NODE_USE_SYSTEM_CA=1 dene; olmazsa NODE_EXTRA_CA_CERTS ile şirket kök sertifikasının yolunu ver.

Kaynak: Gemini CLI sorun giderme ve SSS belgeleri; Google kullanımdan kaldırma sayfası; 15.10.2026.

Sık sorulan sorular

Gemini CLI nedir, ne işe yarar?

Google'ın terminalde çalışan açık kaynak yapay zekâ ajanı. Bir proje klasöründe dosyaları okur, onayınla değiştirir ve komut çalıştırır; MCP, eklenti ve becerilerle genişler.

Gemini CLI hâlâ ücretsiz mi?

Yazılım ücretsiz ve açık kaynak. Ama kişisel Google hesabıyla giriş ve onunla gelen ücretsiz kota 18 Haziran 2026'da kapandı. Şimdi ücretli API anahtarı, Vertex AI ya da kurumsal lisans gerekiyor; ücretsiz API anahtarının durumu belgelerde çelişkili.

Gemini CLI nasıl kurulur?

Node.js 20 ya da üstü kuruluyken terminale npm install -g @google/gemini-cli yaz; macOS ve Linux'ta brew install gemini-cli de olur. Sonra gemini yazarak başlatılır.

Gemini CLI Windows'ta çalışır mı?

Evet. Belge önerilen sistem olarak Windows 11 24H2 ve üstünü, kabuk olarak PowerShell'i sayıyor. Node.js 20+ gerekir.

Gemini CLI'ya MCP nasıl eklenir?

gemini mcp add komutuyla ya da ~/.gemini/settings.json dosyasına mcpServers bloğu yazarak. Bağlantıyı gemini mcp list ile kontrol edersin.

Gemini CLI ile Antigravity CLI aynı şey mi?

Hayır. Antigravity CLI, Google'ın Gemini CLI'nın yerine önerdiği ayrı bir terminal aracı (komutu agy). Google eklenti, beceri ve MCP ayarlarını taşıyan bir geçiş aracı sunuyor.

Gemini CLI hangi işlerde, hangi setlerde?

Claude Code ile başlangıç Basit bir tanıtım sitesi kurmak

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Ücretsiz Gemini API anahtarının bugün Gemini CLI'da çalışıp çalışmadığı (belgeler çelişiyor) · Antigravity CLI'nin fiyatı ve kotası · Türkiye'den erişim · Türkçe arayüz ve Türkçe yanıt · TL fiyat · iptal ve abonelik adımları · Vertex AI Express modunun bugünkü durumu · yayımlanmış güvenlik bildirimi olmaması (liste boş döndü, güvence değil). Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.