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

Adres: https://agentvera.dev/blog/gemini-cli-nasil-kullanilir/ · Yayın: 2026-10-25

Gemini CLI nasıl kullanılır: kurulum, Haziran 2026 değişikliğinden sonra giriş seçenekleri, GEMINI.md, settings.json, MCP sunucuları ve checkpoint ile geri alma.

**Kısaca:**

- Gemini CLI’ı npm, Homebrew ya da MacPorts ile kur veya npx ile kurmadan dene; sonra proje klasöründe gemini yaz ve bir giriş yöntemi seç.
- 18 Haziran 2026’dan beri ücretsiz katman ve Google One kullanıcıları Antigravity CLI’a taşındı; Gemini CLI artık ücretli Gemini API anahtarı, Vertex AI ve Code Assist Standard ya da Enterprise ile çalışıyor.
- Proje kuralları GEMINI.md’ye, ayarlar .gemini/settings.json’a gider; MCP sunucuları gemini mcp add ile eklenir, checkpointing ve /restore dosya düzenlemelerini geri alır.

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ı](/sozluk/kodlama-ajani/ "Kodlama ajanı nedir"): 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](/blog/gemini-cli-mi-claude-code-mu/ "Gemini CLI mı Claude Code mu") ve [Codex mu Gemini CLI mı](/blog/codex-mu-gemini-cli-mi/ "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:

```bash
gemini --version
```

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

Bir projeye geç ve başlat:

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

```bash
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](/blog/gemini-cli-mi-claude-code-mu/ "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](https://ai.google.dev/gemini-api/docs/pricing "Gemini API fiyatlandırması") bak.

## 3. Adım: ilk görevin

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

```text
Ö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:

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

1. **Genel:** `~/.gemini/GEMINI.md`, her proje için kişisel varsayılanların.
2. **Çalışma alanı:** proje klasöründeki ve üst klasörlerindeki `GEMINI.md` dosyaları.
3. **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](/blog/claude-md-nasil-yazilir/ "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:

```json
{
  "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](/blog/yapay-zeka-kodlama-ajani-guvenligi/ "Yapay zeka kodlama ajanı güvenliği") yazısı anlatıyor.

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

[MCP](/sozluk/mcp/ "MCP nedir") sunucuları Gemini’ye ek araçlar verir: belge araması, tarayıcı, GitHub, veritabanın. Kabuktan bir tane ekle:

```bash
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](/blog/mcp-sunucusu-nedir/ "MCP sunucusu nedir") yazısını oku. Her sunucu [bağlam penceresine](/sozluk/baglam-penceresi/ "Bağlam penceresi nedir") 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ç:

```json
{
  "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](/blog/git-worktree-paralel-gelistirme/ "Git worktree ile paralel geliştirme")’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](/ajanlar/gemini-cli/ "AgentVera’da Gemini CLI") sayfasına bak.

- **[Çalışma alanı](/ozellikler/calisma-alani/ "Ç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](/ozellikler/mcp-yoneticisi/ "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](/ozellikler/akislar/ "Akışlar"):** bir ajanın sonucunu sıradakine aktar; örneğin Gemini yazsın, başka bir ajan incelesin.
- **[Kod incelemesi](/ozellikler/kod-incelemesi/ "Kod incelemesi"):** bir ajanın değişikliklerini tur sonunda otomatik olarak inceletebilirsin.
- **Worktree’ler:** [Git panelinden](/ozellikler/git-ve-github/ "Git ve GitHub") 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](/indir/ "AgentVera’yı indir") ve kendi reponda dene. Ücretsiz bir Google hesabı kullanıyorsan AgentVera [Antigravity](/ajanlar/antigravity/ "AgentVera’da 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](/blog/codex-cli-nasil-kullanilir/ "Codex CLI nasıl kullanılır") yazısını oku.

## Sık sorulanlar

**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.

---

**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/