# Antigravity CLI nasıl kullanılır? Google agy için pratik rehber

Adres: https://agentvera.dev/blog/antigravity-cli-nasil-kullanilir/ · Yayın: 2026-11-05

Antigravity CLI rehberi: agy kurulumu, giriş, AGENTS.md, model ve effort seçimi, modlar ve izinler, MCP sunucuları ve Gemini CLI’dan geçişte nelerin taşındığı.

**Kısaca:**

- Antigravity CLI (agy), 18 Haziran 2026’da Google AI Pro, Ultra ve ücretsiz bireysel kullanıcılar için Gemini CLI’ın yerini alan, Google’ın terminal ajanı.
- Tek bir betikle kurulur; projede agy yazıp Google hesabınla giriş yaparsın. Proje kuralları AGENTS.md ya da GEMINI.md’de kalır, ikisini de olduğu gibi okur.
- MCP sunucuları settings.json’dan mcp_config.json’a taşınır, eklentiler agy plugin import gemini ile plugine dönüşür, --approval-mode yerine --mode gelir.

Antigravity CLI, Google’ın terminalde çalışan kodlama ajanı. Tek bir betikle kuruyorsun, proje klasöründe `agy` yazıp başlatıyorsun, Google hesabınla giriş yapıyorsun ve ne istediğini anlatıyorsun. Dosyalarını okuyor, düzenleme ve komut öneriyor; varsayılan modda bir şeyi değiştirmeden önce soruyor.

Gemini CLI’ı kişisel bir hesapla kullanıyorduysan yolun buraya çıktı. Google [19 Mayıs 2026 tarihli geliştirici blog yazısında](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ "Gemini CLI’dan Antigravity CLI’a geçiş") Gemini CLI’ın **18 Haziran 2026** itibarıyla Google AI Pro ve Ultra abonelerine ve bireyler için Gemini Code Assist’in ücretsiz kullanıcılarına hizmet vermeyeceğini duyurdu. Bu rehber kurulumu, girişi, proje talimatlarını, model ve effort seçimini, modları ve izinleri, MCP’yi, önemli komutları, Gemini CLI’dan geçişi ve Google’ın açıkladığı limitleri anlatıyor. Buradaki her şey Kasım 2026 itibarıyla [Google’ın Antigravity belgelerine](https://antigravity.google/docs/getting-started?tab=cli "Antigravity hızlı başlangıç") dayanıyor.

## Antigravity CLI nedir, kimin için?

Antigravity CLI, Google’ın ajan odaklı geliştirme platformu Antigravity’nin terminal istemcisi. Google’a göre Go ile yazıldı ve ajan altyapısını Antigravity 2.0 masaüstü uygulamasıyla paylaşıyor; ajana gelen iyileştirmeler iki tarafa da yansıyor. Gemini CLI kullanıcılarının bildiği yapı taşları duruyor: agent skill’ler, hook’lar, alt ajanlar ve artık “plugin” adını alan eklentiler.

Şu durumdaysan senin için:

- Gemini CLI’ı kişisel Google hesabı, Google AI Pro ya da Ultra ile kullanıyordun;
- terminalde Gemini modelleriyle (planına göre başka modellerle de) çalışan bir [kodlama ajanı](/sozluk/kodlama-ajani/ "Kodlama ajanı nedir") istiyorsun;
- Antigravity’yi masaüstünde kullanıyorsun ve aynı ajanı SSH üzerinden ya da betiklerde de istiyorsun.

Gemini Code Assist Standard ya da Enterprise lisansı veya ücretli Gemini API anahtarı olan ekipler Gemini CLI’da kalabilir; o yol için [Gemini CLI nasıl kullanılır](/blog/gemini-cli-nasil-kullanilir/ "Gemini CLI nasıl kullanılır") rehberine bak. Google eksikleri saklamıyor: blog yazısı ilk günden birebir özellik eşitliği olmayacağını açıkça söylüyor.

## Kurulum

| Sistem | Komut |
| --- | --- |
| macOS, Linux | `curl -fsSL https://antigravity.google/cli/install.sh \| bash` |
| Windows (PowerShell) | `irm https://antigravity.google/cli/install.ps1 \| iex` |
| Windows (CMD) | `curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd` |

macOS ve Linux’ta program `~/.local/bin/agy` konumuna, Windows’ta `AppData\Local\agy\bin` altına kuruluyor. Kontrol et:

```bash
agy --version
```

## Giriş

Projene geç ve başlat:

```bash
cd projem
agy
```

İlk açılışta renk şeması, görüntü modu (Alt-Screen ya da Inline) ve klasöre güvenip güvenmediğin soruluyor. Ardından tarayıcı açılıyor ve Google hesabınla giriş yapıyorsun. Free, Pro ve Ultra planlarındaki kişisel hesaplar çalışıyor; iş hesapları Gemini Enterprise üzerinden giriyor. Oturum anahtarı işletim sisteminin anahtar zincirinde (Keychain, Secret Service ya da Windows Credential Manager) saklanıyor, sonraki açılışlarda tarayıcı açılmıyor.

Diğer seçenekler:

- **SSH üzerinden:** `agy` bir adres yazdırıyor. Kendi bilgisayarında aç, giriş yap ve verilen kodu terminale yapıştır.
- **Gemini API anahtarı:** `~/.gemini/antigravity-cli/settings.json` içinde `"modelProvider": "gemini"` ayarla ve `GEMINI_API_KEY` değişkenini tanımla. Bu ayar olmadan anahtar tek başına işe yaramıyor.
- **Google Cloud kimlik bilgileri:** `gcloud auth application-default login` çalıştır ve `AGY_ADC_AUTH=true` ayarla.

`/logout` kayıtlı girişi siler.

## İlk görev

```text
Ödeme modülünün yapısını açıkla, sonra iade endpoint'ine girdi doğrulaması
ekle ve testleri çalıştır.
```

İlk günden işe yarayan birkaç kısayol: `@` dosya yolu önerir, istemin başındaki `!` doğrudan kabuk komutu çalıştırır, `?` yardımı ve slash komutlarını gösterir. Betikler için `agy -p "README.md dosyasını özetle"` tek bir istemi arayüzsüz çalıştırıp cevabı yazdırır; çıktıyı başka bir program okuyacaksa `--output-format json` ekle. `agy -i "istem"` etkileşimli arayüzü ilk istemle açar.

## Proje talimatları: AGENTS.md ya da GEMINI.md

Antigravity, `agy`’yi başlattığın klasörde ve repo köküne kadar üst klasörlerde `AGENTS.md` ya da `GEMINI.md` dosyasını okur. İkisi de her zaman etkin ve frontmatter istemez. Global kurallar `~/.gemini/AGENTS.md` ya da `~/.gemini/GEMINI.md` içine yazılır. Kurallar birbirinin yerine geçmez, toplanır.

```markdown
# Proje: billing-service

## Komutlar
- Kurulum: npm ci
- Test: npm test (bir işi bitti demeden önce çalıştır)

## Yapma
- src/generated içindeki dosyalara dokunma.
```

Daha ince kontrol için `.agents/rules/` klasörüne Markdown dosyaları koyabilirsin. Her biri `trigger` alanlı bir frontmatter ister: `always_on`, `model_decision`, `glob` (ajan eşleşen dosyalara dokunduğunda devreye girer) ya da `manual`. Trigger yoksa ya da geçersizse kural sessizce yok sayılıyor; CLI kural anmayı desteklemediği için `manual` kurallar orada çalışmıyor. Dosyaları kısa tut: her dosya 24.000 bayttan sonra kesiliyor, global ve `always_on` kurallar da 20.000 tokenlık ortak bir bütçeyi paylaşıyor.

Codex ya da başka bir ajan zaten `AGENTS.md` okuyorsa Antigravity aynı dosyayı kullanır. Claude Code ile tek bir kural setini nasıl paylaşacağını [CLAUDE.md nasıl yazılır](/blog/claude-md-nasil-yazilir/ "CLAUDE.md nasıl yazılır") yazısında bulabilirsin.

## Modeller ve effort

Modeli tek bir çalıştırma için `--model` ile (`agy models` listeyi verir) ya da oturum içinde `/model` ile seçiyorsun. Google’ın model sayfası Gemini 3.8 Flash ve Gemini 3.1 Pro gibi Gemini modellerinin yanında Claude ve GPT-OSS modellerini de listeliyor; hangilerini göreceğin planına bağlı.

Effort, modelin ne kadar derin düşüneceğini belirler. `/effort` bir gösterge açar ve seçimini varsayılan olarak kaydeder; `--effort low` yalnızca o çalıştırma için geçerli. Seviyeler `low`, `medium`, `high`, `xhigh` ve `max`; ama çoğu model yalnızca low ile high arasını sunuyor, sabit bütçeli modeller ise bu ayarı yok sayıyor.

## Modlar ve izinler

| Mod | Ne olur |
| --- | --- |
| `default` | Dosya oluşturmadan ya da değiştirmeden önce diff gösterir, terminal komutlarından önce sorar |
| `accept-edits` | Çalışma alanındaki düzenlemeleri onaylar, komutlardan önce yine sorar |
| `auto` | Düzenlemeleri onaylar, komutları terminal sandbox’ında çalıştırır; riskli işlemler yine sorulur |
| `plan` | Kod yazmadan önce inceler ve adımları çıkarır |

`--mode=accept-edits` (ya da `auto`, `plan`) ile başlatabilir, Shift+Tab ile geçiş yapabilir ya da `~/.gemini/antigravity-cli/settings.json` içinde `"agentMode"` ayarlayabilirsin. `auto` için sandbox ve kişisel hesap gerekiyor (macOS ve Linux’ta v1.3.5+, Windows’ta v1.4.4+); iş hesaplarında yok. `--sandbox` oturumu terminal sandbox’ında çalıştırır.

Ayrıntılı kurallar aynı ayar dosyasında `allow`, `ask` ve `deny` listeleri olarak durur; örneğin `command(git)` ya da `mcp(sql/execute_mutation)`. Deny, ask’ten; ask de allow’dan önce gelir. `/permissions` bunları arayüzde düzenler. `--dangerously-skip-permissions` her şeyi onaylar; yalnızca atılabilir bir ortamda kullan. Nedenini [yapay zeka kodlama ajanı güvenliği](/blog/yapay-zeka-kodlama-ajani-guvenligi/ "Yapay zeka kodlama ajanı güvenliği") yazısı anlatıyor.

## MCP sunucuları

[MCP](/sozluk/mcp/ "MCP nedir") sunucuları kendi dosyalarında duruyor: tüm projeler için `~/.gemini/config/mcp_config.json`, tek bir çalışma alanı için `.agents/mcp_config.json`.

```json
{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}
```

Uzak sunucular Streamable HTTP kullanmak zorunda; eski HTTP+SSE taşıması ve `httpUrl` desteklenmiyor. `/mcp` durum, yeniden yükleme ve loglarla bir yönetici açar. İzin vermediğin araçlar Ask modunda çalışır.

## Bilmeye değer komutlar

| Komut | Ne yapar |
| --- | --- |
| `/model`, `/effort` | Modeli ve düşünme seviyesini değiştirir |
| `/permissions` | Allow, ask ve deny kurallarını yönetir |
| `/config` ya da `/settings` | Ayarlar ekranını açar |
| `/mcp` | MCP sunucu yöneticisi |
| `/plan` | Araştırır, soru sorar, gözden geçirilebilir bir plan çıkarır |
| `/resume` | Bu klasördeki eski bir konuşmayı seçer |
| `/rewind`, `/undo` | Konuşmada geri gider |
| `/fork`, `/clear` | Konuşmayı dallandırır ya da sıfırdan başlar |
| `/usage`, `/credits` | Model kotaları ve AI kredileri |
| `/plugin` | Plugin kurar, açar ya da listeler |

Kabuktan `agy -c` bu klasördeki son konuşmaya devam eder, `--conversation <id>` belirli bir konuşmayı açar. `--add-dir` çalışma alanına başka bir klasör ekler.

## Gemini CLI’dan geçiş

Gemini CLI ayarları olan bir makinede `agy`’yi ilk çalıştırdığında bir kontrol listesi neyi taşımak istediğini soruyor: eklentiler, global ayarlar, oturum anahtarları ve görünüm ayarları. Google’ın [geçiş rehberine](https://antigravity.google/docs/cli/gcli-migration "Gemini CLI geçişi") göre neyin taşındığı, neyin taşınmadığı:

- **Olduğu gibi kalan:** projedeki `GEMINI.md` ve `AGENTS.md`, `~/.gemini/GEMINI.md` ve `~/.gemini/skills/` içindeki global skill’ler.
- **Dönüştürülen:** eklentiler `agy plugin import gemini` ile plugine dönüşüyor; içlerindeki komutlar skill oluyor.
- **Elle taşınacak:** çalışma alanı skill’leri `.gemini/skills/` yerine `.agents/skills/` klasörüne; MCP sunucuları `~/.gemini/settings.json` dosyasından `mcp_config.json` dosyasına, `url` ya da `httpUrl` alanı da `serverUrl` olarak.
- **Garanti olmayan:** bazı özel temalar ve görsel katmanlar.
- **Bayraklar:** `--approval-mode` yok, yerine `--mode` var. Yolo modu da yok.

## Limitler ve fiyat

Google’ın [plan sayfası](https://antigravity.google/docs/plans "Antigravity planları") CLI’ı her plana dahil ediyor ve kotaları rakam vermeden anlatıyor: Ultra en yüksek kotaya sahip ve beş saatte bir yenileniyor; Pro yüksek bir kotayı haftalık limite ulaşana kadar beş saatte bir yeniliyor; diğer planlarda kota haftalık yenileniyor. Limitler ajanın yaptığı iş miktarına göre işliyor. Pro ve Ultra’da kota bittiğinde AI kredileri Gemini Enterprise tüketim fiyatlarıyla devreye girebiliyor; bir ayarla bunu kapatabiliyorsun. Nerede olduğunu `/usage` ve `/credits` gösteriyor.

## Claude Code ve Codex ile yan yana

Antigravity çoğu zaman kullandığın ajanlardan yalnızca biri. Birkaç alışkanlık işleri düzenli tutar:

- **Tek kural dosyası.** Antigravity ve Codex ikisi de `AGENTS.md` okuyor; Claude Code `CLAUDE.md` okuyor ve bu dosya `AGENTS.md`’ye yönlendirebilir.
- **Her ajana bir worktree.** Her ajana kendi [git worktree’sini](/blog/git-worktree-paralel-gelistirme/ "Git worktree ile paralel geliştirme") ver ki aynı dosyaları düzenlemesinler.
- **Her yerde aynı MCP sunucuları.** Her aracın kendi ayar dosyası var; aynı sunucuyu üç kez eklemen gerekiyor.

AgentVera’yı biz geliştiriyoruz: Antigravity CLI’ı Claude Code, Codex, Gemini CLI ve diğer ajanlarla yan yana, her birini kendi kurulumun ve girişinle gerçek bir terminalde çalıştıran macOS, Windows ve Linux masaüstü uygulaması. Antigravity özelinde ([ayrıntılar](/ajanlar/antigravity/ "AgentVera’da Antigravity")):

- **[Çalışma alanı](/ozellikler/calisma-alani/ "Çalışma alanı"):** Antigravity, proje başına ajan ızgarasında bir kutu; uygulama yeniden açıldığında kendi konuşmasına döner.
- **İzinler:** ajan başına Sor, Otomatik (`--mode=accept-edits`) ya da Tam erişim (`--dangerously-skip-permissions`).
- **Model ve effort:** ajanı oluştururken model ve low, medium ya da high effort seç.
- **Talimatlar:** agy’nin ek talimat bayrağı yok; kuralları `AGENTS.md` ya da `GEMINI.md` içinde tut.
- **[MCP yöneticisi](/ozellikler/mcp-yoneticisi/ "MCP yöneticisi"):** bir kez kurduğun sunucular açılışta Antigravity’ye, kendi `mcp_config.json` dosyanın yanına eklenir.
- **Worktree’ler:** [Git panelinden](/ozellikler/git-ve-github/ "Git ve GitHub") bir worktree aç, Antigravity’yi orada, Claude Code’u başka birinde başlat.

Izgara, worktree’ler, kod incelemesi ve MCP yöneticisi ücretsiz planda. Google ve Anthropic ajanlarının karşılaştırması için [Gemini CLI mı Claude Code mu](/blog/gemini-cli-mi-claude-code-mu/ "Gemini CLI mı Claude Code mu") yazısını oku ya da [AgentVera’yı indir](/indir/ "AgentVera’yı indir").

## Özetle

Betikle kur, `agy` çalıştır, Google ile giriş yap ve mevcut `AGENTS.md` ya da `GEMINI.md` dosyanı koru. MCP sunucularını `mcp_config.json` dosyasına taşı, eklentileri `agy plugin import gemini` ile içe aktar, `default` ya da `accept-edits` modunda başla ve uzun oturumlardan önce `/usage` ile kotana bak.

## Sık sorulanlar

**Antigravity CLI ücretsiz mi?** Free, Pro ya da Ultra planındaki kişisel bir Google hesabıyla giriş yapabilirsin. Google’ın plan sayfasına göre diğer planların kotası haftalık yenileniyor; Pro ve Ultra daha büyük kotayı beş saatte bir yeniliyor. Google kesin rakam yayımlamıyor.

**Antigravity CLI GEMINI.md dosyamı okuyor mu?** Evet. agy’yi başlattığın klasörde ve repo köküne kadar üst klasörlerde AGENTS.md ile GEMINI.md’yi, ayrıca ~/.gemini/GEMINI.md gibi global dosyaları okur. Gemini CLI’dan gelirken bir şey değiştirmen gerekmez.

**Antigravity CLI’da MCP sunucuları nereye yazılıyor?** Ayrı bir mcp_config.json dosyasına: tüm projeler için ~/.gemini/config/mcp_config.json, tek bir çalışma alanı için .agents/mcp_config.json. Uzak sunucular serverUrl alanını kullanır ve Streamable HTTP konuşmalıdır.

**--approval-mode ve yolo yerine ne geldi?** default, accept-edits, auto ve plan değerlerini alan --mode bayrağı. Oturumda Shift+Tab modlar arasında geçiş yapar. Tüm izin sorularını atlamak için --dangerously-skip-permissions var; bunu yalnızca yalıtılmış bir ortamda kullan.

**Gemini CLI’da kalabilir miyim?** Gemini Code Assist Standard ya da Enterprise lisansın veya ücretli bir Gemini API anahtarın varsa evet. Google AI Pro, Ultra ve ücretsiz bireysel kullanıcılar 18 Haziran 2026’da Antigravity CLI’a taşındı.

---

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