Gemini CLI hâlâ ücretsiz mi?

Kişisel hesaplar için hayır. Google’ın duyurusuna göre 18 Haziran 2026’da ücretsiz katman ve Google One kullanıcıları Antigravity CLI’a taşındı. Gemini CLI; ücretli Gemini API anahtarları, Vertex AI ve Gemini Code Assist Standard ya da Enterprise lisanslarıyla çalışmaya devam ediyor.

GEMINI.md ile AGENTS.md arasındaki fark ne?

İkisi de proje talimatları içeren Markdown dosyaları. Gemini CLI varsayılan olarak GEMINI.md’yi okur. Ekibin kuralları zaten AGENTS.md’de tutuyorsa settings.json içinde context.fileName değerini ["AGENTS.md", "GEMINI.md"] gibi bir listeye çevir; Gemini CLI ikisini de okur.

Gemini CLI’ın sormadan komut çalıştırmasını nasıl engellerim?

Her araç çağrısından önce soran varsayılan onay modunda kal. auto_edit dosya düzenlemelerini onaylar ama diğer araçlardan önce yine sorar; yolo ise her şeyi onaylar, bu yüzden onu yalnızca güvendiğin bir sandbox içinde kullan.

Gemini CLI’ın yaptığı bir değişikliği nasıl geri alırım?

settings.json içinde checkpointing’i aç. Gemini CLI her dosya düzenlemesinden önce bir anlık görüntü kaydeder, /restore da dosyalarını geri getirir. Checkpointing kapalıyken bile /rewind (ya da iki kez Esc) konuşmada ve dosya değişikliklerinde geriye gitmeni sağlar.

Eski bir Gemini CLI oturumuna nasıl devam ederim?

En son oturuma devam etmek için Gemini CLI’ı --resume latest ile başlat ya da gemini --list-sessions çalıştırıp bir oturumu numarasıyla aç. Oturum içindeyken /resume kayıtlı konuşmalara göz atıp birini seçmeni sağlar.

Gemini CLI nasıl kullanılır? Adım adım rehber

Gemini CLI’ı kullanmak için npm ya da Homebrew ile kurarsın, bir proje klasöründe gemini yazarsın, nasıl giriş yapacağını seçersin ve istediğini düz bir dille anlatırsın. Gemini dosyalarını okur, düzenleme ve kabuk komutu önerir; varsayılan olarak her birini çalıştırmadan önce sorar.

Başlamadan önce önemli bir uyarı. 18 Haziran 2026’dan beri Gemini CLI ücretsiz katman ve Google One kullanıcılarına hizmet vermiyor. Google bu kullanıcıları Antigravity CLI’a taşıdı. Gemini CLI; ücretli bir Gemini API anahtarı, Vertex AI ya da Gemini Code Assist Standard veya Enterprise lisansıyla çalışmaya devam ediyor. Bu rehber kurulumu, girişi, GEMINI.md’yi, ayarları, MCP’yi, onay modlarını, slash komutlarını, checkpointing’i ve oturumlara devam etmeyi anlatıyor. Buradaki her şey Ekim 2026 itibarıyla Google’ın resmi Gemini CLI belgelerine dayanıyor.

Gemini CLI nedir?

Gemini CLI, Google’ın terminal için açık kaynak kodlama ajanı. Gemini modellerini çalıştırır, onu başlattığın klasördeki dosyaları okuyup düzenler, kabuk komutu çalıştırır, web’de arama yapar, MCP sunucularına bağlanır ve proje talimatlarını GEMINI.md’den alır. Bir otomatik tamamlama aracı değil, bir kodlama ajanı: ona bir görev verirsin, adım adım üzerinden geçer. Diğer ajanlarla yan yana karşılaştırma için Gemini CLI mı Claude Code mu ve Codex mu Gemini CLI mı yazılarına bak.

1. Adım: Gemini CLI’ı kur

Gemini CLI için Node.js gerekir. Kurulumuna uyan yolu seç:

Yöntem	Komut
Kurmadan dene	`npx @google/gemini-cli`
npm (her platform)	`npm install -g @google/gemini-cli`
macOS, Linux (Homebrew)	`brew install gemini-cli`
macOS (MacPorts)	`sudo port install gemini-cli`

npm’de üç sürüm kanalı var: @latest (kararlı, haftalık), @preview (haftalık, kararlıdan önde) ve @nightly. Çoğu kişi kararlı sürümde kalmalı. Sonradan güncellemek için gemini update çalıştır ya da paket yöneticinle yeniden kur. Kurulumu kontrol et:

gemini --version

2. Adım: giriş yöntemini seç

Bir projeye geç ve başlat:

cd projem
gemini

İlk açılışta Gemini CLI nasıl kimlik doğrulamak istediğini sorar. Üç seçenek var:

Sign in with Google: tarayıcıyı açar. Haziran 2026 değişikliğinden sonra bu seçenek Gemini Code Assist Standard ya da Enterprise lisansı olan kurumlar için; başlamadan önce GOOGLE_CLOUD_PROJECT değişkenine Google Cloud proje kimliğini ver.
Gemini API anahtarı: Google AI Studio’da bir anahtar oluştur ve GEMINI_API_KEY olarak ayarla. Ücretli anahtarda kullanım token başına faturalanır.
Vertex AI: Google Cloud kullanan ekipler için. GOOGLE_API_KEY ve GOOGLE_GENAI_USE_VERTEXAI=true ayarla ya da Cloud kimlik bilgilerini kullan.

export GEMINI_API_KEY="anahtarin"
gemini

Yöntemi sonradan /auth ile değiştirebilirsin. Gemini CLI’ı ücretsiz kişisel bir hesapla kullanıyorsan Google’ın duyurusu seni Antigravity CLI’a yönlendiriyor; Gemini CLI mı Claude Code mu yazısı bu geçişi ayrıntılı anlatıyor. Bir anahtarla uzun oturumlar çalıştırmadan önce güncel fiyatlar için Google’ın Gemini API fiyatlandırmasına bak.

3. Adım: ilk görevin

Küçük ama gerçek bir işle başla:

Ödeme modülünün nasıl yapılandırıldığını açıkla, sonra iade endpoint’ine
girdi doğrulaması ekle ve testleri çalıştır.

Gemini ihtiyaç duyduğu dosyaları okur, her düzenlemeyi ve komutu sana gösterir ve onayını bekler. İlk günden işe yarayan birkaç kısayol:

@yol/dosya bir dosyayı (ya da bütün bir klasörü) prompt’a ekler.
!git status bir kabuk komutunu doğrudan çalıştırır. Tek başına ! kabuk modunu açıp kapatır.
gemini -p "README.md’yi özetle" etkileşimli arayüz olmadan tek bir prompt çalıştırır ve yanıtı yazdırır. Sonucu bir betik okuyacaksa --output-format json ekle.
/copy son yanıtı panoya kopyalar.

4. Adım: bir GEMINI.md yaz

GEMINI.md, Gemini CLI’ın yükleyip her prompt’la birlikte gönderdiği talimatları içeren bir Markdown dosyası: nasıl build alınır ve test edilir, kod stili, nelere dokunulmaz. /init çalıştırırsan Gemini projenden ilk sürümü üretir. Kısa ve somut tut:

# Proje: billing-service

## Komutlar
- Kurulum: npm ci
- Test: npm test (bir işin bittiğini söylemeden önce çalıştır)

## Stil
- TypeScript, 2 boşluk girinti, yalnızca katı eşitlik.
- Yeni endpoint’ler src/routes altına gider ve test ister.

## Yapma
- src/generated içindeki dosyaları düzenleme.

Gemini CLI bağlam dosyalarını katmanlar halinde yükler ve birleştirir:

Genel: ~/.gemini/GEMINI.md, her proje için kişisel varsayılanların.
Çalışma alanı: proje klasöründeki ve üst klasörlerindeki GEMINI.md dosyaları.
Anında: bir araç alt klasördeki bir dosyaya dokunduğunda Gemini o klasördeki ve üstlerindeki GEMINI.md dosyalarını da alır.

Uzun bir dosyayı içe aktarmalarla bölebilirsin, örneğin @./docs/style-guide.md satırıyla. Modelin gerçekte ne aldığını görmek için /memory show çalıştır; /memory list hangi dosyaların yüklendiğini gösterir. Oturum ortasında bir dosyayı düzenlediysen /memory reload ile yeniden yükle.

Repoda zaten bir AGENTS.md varsa onu kopyalamana gerek yok. Ayarlarda context.fileName değerini ["AGENTS.md", "GEMINI.md"] yap. Tek bir kural setini birkaç ajanla nasıl kullanacağını CLAUDE.md nasıl yazılır yazısı anlatıyor.

5. Adım: settings.json

Gemini CLI ayarlarını JSON dosyalarından okur:

kullanıcı ayarların için ~/.gemini/settings.json;
çalışma alanı ayarları için proje içinde .gemini/settings.json.

JSON’u elle düzenlemek yerine /settings çalıştırıp çoğu seçeneği CLI içindeki bir düzenleyiciden değiştirebilirsin. Küçük bir örnek:

{
  "general": {
    "defaultApprovalMode": "auto_edit",
    "checkpointing": { "enabled": true }
  },
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Model, tek bir çalıştırma için -m / --model ile seçilir. auto (varsayılan), pro, flash ve flash-lite takma adları, tam model adlarını ezberlemeden hız ve derinliğe göre seçim yapmanı sağlar; oturum içinde /model ile değiştirirsin.

6. Adım: onay modları ve sandbox

Sen aksini söylemedikçe Gemini CLI araç çalıştırmadan önce sorar. Davranışı --approval-mode bayrağı belirler:

Mod	Ne olur
`default`	Her araç çağrısından önce sorar
`auto_edit`	Dosya düzenlemelerini otomatik onaylar, kabuk komutu gibi diğer araçlardan önce yine sorar
`plan`	Salt okuma: Gemini bakıp plan yapabilir ama hiçbir şeyi değiştiremez
`yolo`	Her araç çağrısını onaylar; yalnızca yalıtılmış bir ortam için

Eski --yolo bayrağı hâlâ var ama --approval-mode=yolo lehine kullanımdan kaldırılıyor. auto_edit ya da plan modunu ayarlarda varsayılan yapabilirsin; yolo yalnızca komut satırından açılır.

Sandbox varsayılan olarak kapalı. Araçları yalıtılmış bir ortamda çalıştırmak için --sandbox (ya da -s) ile başlat: macOS’ta Seatbelt ya da bir Docker veya Podman konteyneri. auto_edit ya da yolo’yu düzenli kullanacaksan önce sandbox’ı aç. Onayların tek başına neden yetmediğini yapay zeka kodlama ajanı güvenliği yazısı anlatıyor.

7. Adım: MCP sunucularını bağla

MCP sunucuları Gemini’ye ek araçlar verir: belge araması, tarayıcı, GitHub, veritabanın. Kabuktan bir tane ekle:

gemini mcp add github npx -y @modelcontextprotocol/server-github

HTTP sunucusu için komut yerine --transport http ve bir URL ver. --env ANAHTAR=deger ortam değişkeni geçirir, --scope user ise sunucuyu yalnızca bu projede değil her projede kullanılabilir yapar. gemini mcp list neyin ayarlı olduğunu gösterir, gemini mcp remove <ad> bir sunucuyu siler.

Bunlar arka planda settings.json içindeki mcpServers bölümüne yazılır, yani orada da düzenleyebilirsin. Oturum içinde /mcp sunucuları ve araçlarını listeler, /mcp auth OAuth kullanan sunuculara giriş yapar, /mcp reload onları yeniden başlatır. Konuya yeniysen MCP sunucusu nedir yazısını oku. Her sunucu bağlam penceresine araç açıklamaları ekler, bu yüzden yalnızca kullandıklarını tut.

8. Adım: bilmeye değer slash komutları

Komut	Ne yapar
`/init`	Proje için bir `GEMINI.md` üretir
`/memory show`	Modelin aldığı talimatları gösterir
`/settings`	Ayar düzenleyicisini açar
`/model`	Modeli değiştirir
`/auth`	Giriş yöntemini değiştirir
`/mcp`	MCP sunucularını ve araçlarını listeler
`/tools`	Gemini’nin kullanabileceği araçları listeler
`/stats`	Oturum, model ve araç kullanımı
`/compress`	Token tasarrufu için konuşmayı bir özetle değiştirir
`/clear`	Ekranı temizler ve baştan başlar
`/resume`	Kayıtlı oturumlara göz atar ve devam eder
`/rewind`	Konuşmada geri gider (iki kez Esc de olur)
`/restore`	Dosyaları bir checkpoint’ten geri yükler
`/directory`	Çalışma alanına başka klasörler ekler
`/help`	Tüm komutları listeler

Kendi komutlarını da yazabilirsin. ~/.gemini/commands/ içindeki bir .toml dosyası kişisel bir slash komutu olur; proje içindeki .gemini/commands/ klasörüne koyduğun ise repoyu kullanan herkesle paylaşılır. /commands list hepsini gösterir.

9. Adım: checkpointing ve geri alma

Checkpointing, Gemini CLI’ın güvenlik ağı ve varsayılan olarak kapalı. settings.json içinde aç:

{
  "general": {
    "checkpointing": { "enabled": true }
  }
}

Bundan sonra dosya değiştiren bir aracı her onayladığında Gemini önce projenin bir anlık görüntüsünü ~/.gemini/history/ altındaki ayrı bir gölge git deposuna kaydeder. Senin git geçmişine dokunmaz. Checkpoint listesini görmek için /restore, dosyalarını ve konuşmayı o ana döndürmek için /restore <id> çalıştır. Gemini ardından asıl araç çağrısını yeniden önerir; tekrar çalıştırabilir, değiştirebilir ya da atlayabilirsin.

Checkpointing kapalıyken bile /rewind (ya da iki kez Esc) daha önceki bir prompt’a dönmeni ve konuşmayı, kod değişikliklerini ya da ikisini birden geri almayı seçmeni sağlar.

10. Adım: oturumlara devam et

Gemini CLI oturumlarını proje bazında kaydeder:

gemini --resume latest (ya da -r latest) en son oturuma devam eder.
gemini --list-sessions kayıtlı oturumları numaralarıyla gösterir; gemini --resume 3 bunlardan birini açar.
Oturum içinde /resume konuşmalara göz atmanı, kaydetmeni ve yeniden açmanı sağlar.

Yeni bir prompt’u hemen de verebilirsin: gemini -r latest "tip hatalarını kontrol et".

Daha iyi sonuç için ipuçları

Büyük işlerden önce commit at. Checkpoint’ler iyi; bir git commit’i daha iyi ve her araçla çalışır.
Nasıl doğrulanacağını söyle. “npm test çalıştır ve hataları düzelt”, “çalışsın” demekten daha iyi sonuç verir.
Büyük değişikliklerde plan modunu kullan. Gemini bir şeyi düzenlemeden önce etrafa bakıp bir plan önersin.
Dosyaları @ ile göster. Gemini’nin onları bulmasını beklemekten hızlı, bağlamı da odaklı tutar.
İşler arasında sıkıştır ya da temizle. /compress bir özet tutar, /clear baştan başlar. İkisi de token kazandırır.
Her worktree’ye tek ajan. Birden fazla ajan çalıştırıyorsan her birine kendi git worktree’sini ver ki birbirinin üzerine yazmasınlar.

Tek terminal yetmediğinde

Gemini CLI çoğu zaman bir ekibin kullandığı birkaç ajandan biri. Bir işte Gemini’yi, başka bir işte Codex ya da Claude Code’u çalıştırmak ya da bir ajanın işini başka bir ajana kontrol ettirmek istediğinde tek terminal kalabalıklaşır.

AgentVera; macOS, Windows ve Linux için Gemini CLI’ı (ve diğer CLI ajanlarını) gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Her Gemini ajanı kendi Google girişini ya da GEMINI_API_KEY değerini kullanır; hangisi olacağını terminal ilk açılışta sorar. Ayrıntılar için AgentVera’da Gemini CLI sayfasına bak.

Çalışma alanı: her proje için 1×1’den 5×4’e kadar bir ajan ızgarası. Her Gemini ajanı kendi oturumuyla başlar ve uygulama yeniden açılınca o oturuma döner.
Ajan başına izinler: ajanı oluştururken Sorsun, Otomatik veya Tam yetki seç.
Talimatlar: Gemini CLI’ın ek talimat için bir bayrağı yok, bu yüzden AgentVera’daki Rol alanı ona ulaşmaz. Kuralları GEMINI.md ya da AGENTS.md dosyasına yaz.
MCP yöneticisi: AgentVera’da kurduğun sunucular açılışta Gemini’ye bağlanır ve kendi Gemini ayarlarınla ada göre birleştirilir.
Akışlar: bir ajanın sonucunu sıradakine aktar; örneğin Gemini yazsın, başka bir ajan incelesin.
Kod incelemesi: bir ajanın değişikliklerini tur sonunda otomatik olarak inceletebilirsin.
Worktree’ler: Git panelinden bir worktree oluştur ve içinde bir ajan başlat.

Izgara, worktree’ler, kod incelemesi ve MCP yöneticisi ücretsiz planda; akışlar Pro ve Team’de. AgentVera’yı indir ve kendi reponda dene. Ücretsiz bir Google hesabı kullanıyorsan AgentVera Antigravity’yi de destekliyor.

Toparlarsak

Gemini CLI’ı kur, gemini yaz ve Haziran 2026’dan sonra hâlâ çalışan bir giriş seç: ücretli bir API anahtarı, Vertex AI ya da bir Code Assist lisansı. /init çalıştır ve GEMINI.md’yi kısa tut, varsayılanları /settings ile belirle, MCP sunucularını yalnızca ihtiyaç duyduğunda ekle. Kurulumuna güvenene kadar varsayılan onay modunda kal, /restore düzenlemeleri geri alabilsin diye checkpointing’i aç ve kaldığın yerden devam etmek için --resume latest kullan. OpenAI’ın ajanıyla karşılaştırmak istersen Codex CLI nasıl kullanılır yazısını oku.