Gemini CLI nedir? Gemini CLI mı Claude Code mu?

Gemini CLI, Google’ın terminalde çalışan açık kaynaklı (Apache 2.0) yapay zeka kodlama ajanı. Gemini modelleriyle dosya okur ve 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. Claude Code aynı işi Claude modelleri ve CLAUDE.md ile yapar. Ama 2026’nın asıl haberi bir özellik değil: 18 Haziran 2026’dan beri Gemini CLI ücretsiz kişisel hesaplara hizmet vermiyor. Ücretsiz katman ve Google One kullanıcıları Antigravity CLI’a taşındı; Gemini CLI artık ücretli API anahtarları, Vertex AI ve Code Assist iş lisansları için.

Bu yazıda Gemini CLI’ın bugün ne olduğunu, nasıl kurulup giriş yapıldığını, GEMINI.md, MCP ve sandbox’ın nasıl çalıştığını ve Claude Code ile nasıl karşılaştırıldığını anlatıyoruz. Benchmark yok; her model sürümünde değişiyorlar. Diğer büyük karşılaştırma için Claude Code mu Codex mi yazısına bak.

Gemini CLI nedir?

Gemini CLI, Google’ın komut satırı kodlama ajanı. Proje klasöründe gemini yazarsın ve konuşmaya başlarsın. Yerleşik araçlarıyla dosya okur ve yazar, kabuk komutu çalıştırır, web sayfası çeker ve Google’da arama yapar. Etkileşimli ya da -p ile arayüzsüz çalışır; yani betiklerden ve CI’dan çağırabilirsin.

# etkileşimli
gemini

# tek seferlik, betikler için JSON çıktıyla
gemini -p "son commit'teki değişiklikleri özetle" --output-format json

# model seç ve bağlama başka bir klasör ekle
gemini -m gemini-2.5-flash --include-directories ../shared

Kaynak kodu GitHub’da Apache 2.0 lisansıyla açık. Kararlı sürümler haftalık çıkıyor; değişiklikleri erken görmek isteyenler için preview ve nightly kanalları da var.

Haziran 2026 değişikliği: Antigravity CLI

Google, bireysel kullanıcılar için Gemini CLI’ın yerini Antigravity CLI’ın aldığını duyurdu. Google’ın geliştirici blogu ve Gemini CLI README’sine göre:

• 18 Haziran 2026’dan itibaren Gemini CLI, Google AI Pro ve Ultra kullanıcılarına ve ücretsiz bireysel Gemini Code Assist’e hizmet vermeyi bıraktı.
• Gemini Code Assist Standard ya da Enterprise kullanan kuruluşlar, Google Cloud üzerinden Code Assist for GitHub ve ücretli Gemini API anahtarları için erişim değişmedi.
• README ayrıca Gemini CLI’ın Google’ın en yeni modelleri için optimize edilmediğini söylüyor ve onlar için Antigravity’yi öneriyor.

Antigravity CLI agy komutuyla çalışır. Mevcut Gemini CLI kurulumlarını algılar, GEMINI.md ve AGENTS.md dosyalarını okur, agent skill’lerini, hook’ları ve alt ajanları korur, Gemini CLI eklentilerini agy plugin import gemini ile Antigravity eklentilerine çevirir. Google bire bir özellik eşliği olmayacağını söylüyor; bir ekibi taşımadan önce geçiş rehberine bak.

Gemini CLI’ı ücretsiz olduğu için kullanıyorduysan önemli kısım bu. Yazının geri kalanı ücretli anahtar ya da iş lisansıyla kullanılan Gemini CLI için geçerli ve büyük kısmı Antigravity’ye de taşınıyor.

Kurulum

Gemini CLI bir Node.js paketi:

# kurmadan dene
npx @google/gemini-cli

# global kur
npm install -g @google/gemini-cli

# ya da Homebrew ile
brew install gemini-cli

Sürüm kanalları npm etiketleriyle seçilir: @latest (kararlı, haftalık), @preview (haftalık) ve @nightly.

Giriş seçenekleri

gemini’yi ilk çalıştırdığında nasıl kimlik doğrulayacağını sorar. Dokümanlardaki seçenekler:

export GEMINI_API_KEY="anahtarin"
gemini

Workspace ve kuruluş hesapları bir Google Cloud projesi ister. Google’ın kota sayfası kimlik doğrulama türüne göre günlük istek sayıları listeliyordu; bu rakamların bir kısmı Haziran değişikliğinden önceye ait. Bir blog yazısındaki sayıya değil, güncel sayfaya ve Cloud konsoluna bak.

GEMINI.md: proje talimatları

GEMINI.md, Gemini CLI’ın CLAUDE.md karşılığı. Katmanlar halinde yüklenir:

1. Global: her yerde geçerli kurallar için ~/.gemini/GEMINI.md.
2. Çalışma alanı: çalışma alanı klasörlerindeki ve üst klasörlerindeki GEMINI.md dosyaları.
3. Anında: bir araç bir yola dokunduğunda Gemini CLI o yolun yakınındaki GEMINI.md dosyalarını da alır.

Uzun bir dosyayı bölüp parçaları @dosya.md ile içe aktarabilirsin. Oturum içinde /memory show birleşik bağlamı gösterir, /memory reload dosyaları yeniden okur.

Tek dosyayı diğer ajanlarla paylaşmak için ~/.gemini/settings.json ya da projedeki .gemini/settings.json içinde aradığı dosya adını değiştir:

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Claude Code CLAUDE.md’yi okur ve @AGENTS.md ile AGENTS.md’yi içe aktarabilir. İki ayar da yerindeyse tek bir AGENTS.md iki ajanı da yönetir. İçine ne yazılacağını CLAUDE.md nasıl yazılır yazısında anlattık.

Gemini CLI’da MCP

Gemini CLI, settings.json içinde mcpServers altında tanımlanan MCP sunucularına bağlanır. Sunucu yerel bir komut (command, args, env, cwd) ya da uzak bir adres (SSE için url, streamable HTTP için httpUrl) olabilir.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
    }
  }
}

Ya da komut satırından ekle:

gemini mcp add -s user -t http docs https://example.com/mcp

-s kapsamı (varsayılan project, ya da user), -t taşıma türünü (stdio, sse ya da http) seçer. Oturum içinde /mcp sunucuları ve araçlarını listeler, /mcp auth OAuth isteyen sunucularda girişi yapar. Claude Code tarafı neredeyse aynı: claude mcp add, proje sunucuları .mcp.json içinde. Protokole yeniysen MCP sunucusu nedir yazısıyla başla.

Sandbox ve onaylar

Gemini CLI’ın en güçlü olduğu yer burası. Sandbox varsayılan olarak kapalı; --sandbox (-s), GEMINI_SANDBOX ortam değişkeni ya da ayarlarda tools altında "sandbox": true ile açarsın.

• macOS: Seatbelt (sandbox-exec), varsayılan profil permissive-open; diğer profiller SEATBELT_PROFILE ile.
• Konteyner: ghcr.io/google/gemini-cli imajıyla Docker ya da Podman.
• Diğerleri: yerel Windows sandbox’ı, gVisor (runsc) ve LXC (deneysel).

gemini --sandbox
GEMINI_SANDBOX=docker gemini

Onay modları sandbox’tan ayrı. default düzenleme ve komutlardan önce sorar, auto_edit dosya düzenlemelerini sormadan uygular, plan salt okunurdur. Her şeyi onaylayan YOLO sadece komut satırından, --yolo ya da --approval-mode=yolo ile açılır. Ayarlardan checkpointing’i açarsan /restore dosyaları bir araç çalışmadan önce alınan anlık görüntüye döndürür.

Claude Code’da izin modları (sor, düzenlemeleri kabul et, plan, atla) ve Bash aracı için isteğe bağlı bir sandbox var. Gemini CLI daha fazla sandbox altyapısı arasından seçim sunuyor. Hangisini kullanırsan kullan kural aynı: bir ajana konteyner ya da atılabilir bir worktree dışında tam yetki verme. Tehditleri yapay zeka kodlama ajanı güvenliği yazısında anlattık.

Bir bakışta Gemini CLI ve Claude Code

Hangisini ne zaman kullanmalı?

Gemini CLI’ı kullan:

• Şirketin Gemini’yi zaten Google Cloud üzerinden alıyorsa ya da Code Assist Standard veya Enterprise lisansı varsa.
• Ajana bağlı gerçek bir sandbox altyapısı (Docker, gVisor, Seatbelt profilleri) istiyorsan.
• Ajanın kaynak kodunu okumak ya da değiştirmek istiyorsan; açık kaynak.
• Yerleşik Google Search desteğine ihtiyacın varsa.

Claude Code’u kullan:

• Claude aboneliğin varsa ve Claude modellerine göre ayarlanmış ajanı istiyorsan.
• Plan moduna, hook’lara, skill’lere ya da alt ajanlara dayanıyorsan.
• Aynı kurulumla terminalde, IDE eklentisinde, masaüstü uygulamasında ve web’de çalışmak istiyorsan.

Antigravity CLI’a bak: Gemini CLI’ı kişisel ya da Google One hesabıyla kullanıyorduysan Google seni artık oraya yönlendiriyor.

İkisini birlikte çalıştırmak

İki firmadan iki ajan çalıştırmak her ikilide olduğu gibi aynı sebeplerle yaygın: önemli değişikliklerde ikinci görüş, biri bitince ikinci bir kullanım havuzu ve işe uyan modeli seçmek. İşe yarayan kurulum:

1. Tek kural dosyası. Ortak kuralları AGENTS.md’ye yaz, Gemini’nin context.fileName ayarına ekle ve CLAUDE.md’den içe aktar.
2. Ayrı klasörler. Her ajana kendi git worktree’sini ve dalını ver; aynı dosyayı asla düzenlemesinler.
3. Ayrı MCP ayarı. Her araç kendi MCP ayarını tutar; aynı sunucuları ikisine de ekle ya da bir kez AgentVera’ya kaydet, o ikisine de aktarır.
4. Tek inceleyici. Birleştirmeden önce bir ajana diğerinin dalını incelet.

AgentVera’da Gemini CLI, Antigravity ve Claude Code

AgentVera; macOS, Windows ve Linux için bir masaüstü uygulaması. Terminal kodlama ajanlarını gerçek terminallerde, her proje için bir ızgarada ve mevcut girişlerinle çalıştırır. Gemini CLI, Antigravity CLI ve Claude Code Yeni ajan penceresinde yer alıyor; henüz kurulu olmayan bir CLI “Kurulu değil” olarak görünür.

Sınırları da açıkça söyleyelim. AgentVera’nın MCP sunucuları ve tarayıcısı Gemini CLI’a da ulaşır: her açılışta bağlanır ve senin mcpServers ayarınla isim bazında birleşir. Gemini CLI’ın ek talimat bayrağı yok, bu yüzden Rol ve talimatlar alanı ona ulaşmaz; AGENTS.md ya da GEMINI.md kullan. Tam yetki de hiç sormaz; onu worktree ya da konteynerdeki ajanlara sakla.

Izgara, worktree’ler ve kod incelemesi ücretsiz planda. AgentVera’yı indir, iki worktree’de Claude Code’un yanına bir Gemini CLI ya da Antigravity ajanı aç ve kendi reponda karşılaştır.

Kısa cevap

Gemini CLI, geniş sandbox seçenekleri olan yetenekli ve açık kaynaklı bir terminal ajanı; ama Haziran 2026’dan beri ücretli API anahtarları ve Google Cloud müşterileri için bir araç. Claude planındaysan ve hook’lar, skill’ler, alt ajanlar istiyorsan Claude Code daha güçlü seçim. Gemini CLI’ın ücretsiz katmanını kullanıyorduysan Antigravity CLI’a bak. Ve mümkünse tek bir AGENTS.md tut, iki ajan çalıştır.