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

Adres: https://agentvera.dev/blog/gemini-cli-mi-claude-code-mu/ · Yayın: 2026-10-23

Gemini CLI nedir, nasıl kurulur, Haziran 2026 Antigravity değişikliğinden sonra nasıl giriş yapılır? GEMINI.md, MCP, sandbox ve Claude Code ile karşılaştırma tablosu.

**Kısaca:**

- 18 Haziran 2026’dan beri Gemini CLI ücretsiz katman ve Google One kullanıcılarına hizmet vermiyor; bu kullanıcılar Antigravity CLI’a (agy) taşındı.
- Gemini CLI ücretli Gemini API anahtarları, Vertex AI ve Gemini Code Assist Standard ya da Enterprise lisanslarıyla çalışmaya devam ediyor ve Apache 2.0 lisanslı açık kaynak.
- Güçlü yanı Seatbelt, Docker ya da Podman, gVisor ve LXC gibi sandbox seçenekleri; Claude Code ise plan modu, hook’lar, skill’ler ve alt ajanlar sunuyor.

**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](/blog/claude-code-mu-codex-mi/ "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.

```bash
# 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:

```bash
# 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:

| Yöntem | Ne ayarlarsın | 18 Haziran 2026 sonrası durum |
| --- | --- | --- |
| Google ile giriş | Tarayıcıdan giriş; ücretli Code Assist lisansı için ayrıca `GOOGLE_CLOUD_PROJECT` | Code Assist Standard ve Enterprise’da çalışır; kişisel ve Google One hesapları Antigravity’ye taşındı |
| Gemini API anahtarı | Google AI Studio’dan `GEMINI_API_KEY` | Ücretli anahtarlar çalışmaya devam ediyor |
| Vertex AI | `GOOGLE_CLOUD_PROJECT` ve `GOOGLE_CLOUD_LOCATION`; ayrıca ADC (`gcloud auth application-default login`), servis hesabı ya da `GOOGLE_API_KEY` | Çalışmaya devam ediyor |

```bash
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:

```json
{
  "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](/blog/claude-md-nasil-yazilir/ "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.

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

Ya da komut satırından ekle:

```bash
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](/blog/mcp-sunucusu-nedir/ "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).

```bash
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](/blog/yapay-zeka-kodlama-ajani-guvenligi/ "Yapay zeka kodlama ajanı güvenliği") yazısında anlattık.

## Bir bakışta Gemini CLI ve Claude Code

| | Gemini CLI | Claude Code |
| --- | --- | --- |
| Firma, modeller | Google, Gemini modelleri | Anthropic, Claude modelleri |
| Kaynak | Açık kaynak, Apache 2.0 | Kapalı |
| Kurulum | `npm install -g @google/gemini-cli`, `brew install gemini-cli` | `curl -fsSL https://claude.ai/install.sh \| bash`, Homebrew, WinGet |
| Şu an kimler kullanabilir | Ücretli Gemini API anahtarları, Vertex AI, Code Assist Standard/Enterprise | Claude ücretli planları ya da Anthropic API |
| Talimat dosyası | `GEMINI.md` (`context.fileName` ile değiştirilebilir) | `CLAUDE.md` |
| MCP | settings.json’da `mcpServers`, `gemini mcp add` | `.mcp.json`, `claude mcp add` |
| Sandbox | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Bash aracı için isteğe bağlı sandbox |
| Onay modları | `default`, `auto_edit`, `plan`, bayrakla YOLO | Varsayılan, düzenlemeleri kabul et, plan, atla |
| Geri alma | Checkpointing ve `/restore` | Checkpoint’ler ve rewind |
| Arayüzsüz | `gemini -p`, JSON ve stream-JSON çıktı | `claude -p`, JSON ve stream-JSON çıktı |
| Ekstralar | Eklentiler, yerleşik web araması | Hook’lar, skill’ler, alt ajanlar, eklentiler |

## 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](/ajanlar/gemini-cli/ "AgentVera’da Gemini CLI"), [Antigravity CLI](/ajanlar/antigravity/ "AgentVera’da Antigravity") ve [Claude Code](/ajanlar/claude-code/ "AgentVera’da Claude Code") Yeni ajan penceresinde yer alıyor; henüz kurulu olmayan bir CLI “Kurulu değil” olarak görünür.

| İhtiyaç | AgentVera’da |
| --- | --- |
| Giriş | Gemini CLI kendi Google girişini ya da `GEMINI_API_KEY`’i kullanır; AgentVera bunun yerine geçmez |
| Model seçmek | Gemini CLI’ın varsayılanı için boş bırak ya da bir model seç, `--model` ile geçirilir |
| İzinler | Her ajan için Sorsun, Otomatik ya da Tam yetki; Gemini CLI’da Otomatik `--approval-mode auto_edit`, Tam yetki `--approval-mode yolo` |
| Oturumları korumak | Her Gemini ajanı kendi `--session-id`’siyle başlar, `--resume` ile yeniden açılır |
| İşi kontrol etmek | Bir tur bittiğinde [otomatik kod incelemesi](/ozellikler/kod-incelemesi/ "Otomatik kod incelemesi") |
| Ajanları zincirlemek | [Akışlar](/ozellikler/akislar/ "Akışlar"): Gemini CLI kaynak ya da hedef olabilir (Pro ve Team) |

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](/indir/ "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.

## Sık sorulanlar

**Gemini CLI nedir?** Gemini CLI, Google’ın terminal için açık kaynaklı (Apache 2.0) yapay zeka ajanı. Gemini modelleriyle çalışır; 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 okur. `gemini` komutuyla başlatılır.

**Gemini CLI hâlâ ücretsiz mi?** Kişisel hesaplar için hayır. Google’ın duyurusuna göre 18 Haziran 2026’dan itibaren ücretsiz katman ve Google One kullanıcıları (Google AI Pro ve Ultra dahil) 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 CLI nasıl kurulur?** `npm install -g @google/gemini-cli` komutunu çalıştır ya da kurmadan denemek için `npx @google/gemini-cli` kullan. macOS ve Linux’ta `brew install gemini-cli` ile de kurulur. Sonra `gemini` yaz ve nasıl giriş yapacağını seç.

**Gemini CLI, CLAUDE.md ya da AGENTS.md okur mu?** Varsayılan olarak GEMINI.md’yi okur. settings.json’daki `context.fileName` ayarıyla başka dosyaları da okutabilirsin, örneğin `["AGENTS.md", "GEMINI.md"]`. Böylece tek bir AGENTS.md hem Gemini CLI’a hem Claude Code’a hem de diğer ajanlara yeter.

**Gemini CLI mı Claude Code mu kullanmalıyım?** Şirketin Gemini’yi zaten Google Cloud üzerinden alıyorsa Gemini CLI iyi oturur ve sandbox seçenekleri güçlü. Claude aboneliğin varsa ve plan modu, hook’lar, skill’ler ve alt ajanlar istiyorsan Claude Code daha uygun. Pek çok ekip ikisini birden çalıştırıp birine diğerini inceletiyor.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/