# Goose nasıl kullanılır? Goose CLI için adım adım rehber

Adres: https://agentvera.dev/blog/goose-nasil-kullanilir/ · Yayın: 2026-11-10

Açık kaynak yapay zekâ ajanı Goose nasıl kullanılır: CLI kurulumu, goose configure, mod seçimi, MCP eklentileri, AGENTS.md ve recipe’ler tek rehberde.

**Kısaca:**

- Goose CLI’ı tek bir curl komutuyla (ya da brew install block-goose-cli ile) kur, goose configure ile sağlayıcı ve model seç, sonra projede goose session çalıştırıp işi anlat.
- Goose auto modunda başlar ve araçları sormadan çalıştırır. Gerçek bir depoda işe koyulmadan önce /mode ile ya da GOOSE_MODE ayarlayarak approve veya smart_approve moduna geç.
- Proje kuralları AGENTS.md ya da .goosehints dosyasına gider, MCP sunucuları ~/.config/goose/config.yaml içindeki eklentilerdir, goose run --recipe de bir işi YAML dosyasından tekrarlar.

Goose’u kullanmak için CLI’ı `curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash` ile kurarsın, sağlayıcı ve model seçmek için `goose configure` sorularını yanıtlarsın, sonra bir projede `goose session` çalıştırıp ne istediğini anlatırsın. **Goose auto modunda başlar; yani sen approve moduna geçene kadar komutları sormadan çalıştırır.**

Bu rehber, Kasım 2026 itibarıyla (sürüm 1.58) Goose CLI’ın her adımını anlatıyor: kurulum, ayarlar, modlar, oturumlar, eklentiler, talimat dosyaları ve recipe’ler; ayrıca en çok zaman kaybettiren hatalar.

## Goose nedir?

Goose, kendi makinende çalışan genel amaçlı bir yapay zekâ ajanı. CLI, macOS, Linux ve Windows için masaüstü uygulaması ve API olarak geliyor; hepsi Rust ile yazılmış. Belirli bir modele bağlı değil: Anthropic, OpenAI, Gemini, OpenRouter ya da yerel bir model gibi bir sağlayıcıyı sen getirirsin, araç çağrılarını, düzenlemeleri ve kabuk işlerini Goose yapar.

Goose’u Block geliştirdi ve Aralık 2025’te MCP ve AGENTS.md ile birlikte Linux Foundation çatısı altındaki [Agentic AI Foundation](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation "Agentic AI Foundation")’a devretti. Nisan 2026’da depo [aaif-goose/goose](https://github.com/aaif-goose/goose "GitHub’da Goose") adresine, belgeler de [goose-docs.ai](https://goose-docs.ai "Goose belgeleri") adresine taşındı. `block/goose` ve `block.github.io/goose` adreslerine giden eski bağlantılar hâlâ yönlendiriyor. Apache-2.0 lisansıyla yayımlanıyor ve yaklaşık haftada bir yeni sürüm çıkıyor.

## 1. Adım: CLI’ı kur

macOS’ta, Linux’ta ya da Windows’ta Git Bash içinde:

```bash
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
```

macOS’ta bunun yerine Homebrew de kullanabilirsin. Paket adlarında hâlâ “block” geçiyor:

```bash
brew install block-goose-cli        # CLI
brew install --cask block-goose     # desktop app
```

Windows PowerShell’de:

```powershell
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"; .\download_cli.ps1
```

Windows’taki çalıştırılabilir dosya `%USERPROFILE%\.local\bin` klasörüne iner; bu klasörü `PATH`’e eklemen gerekebilir. Sonradan `goose update` ile güncellersin. CLI ve masaüstü uygulaması tek bir yapılandırmayı paylaşır; birinde ayarladığın sağlayıcılar ve eklentiler diğerinde de görünür.

## 2. Adım: goose configure çalıştır

İlk çalıştırmada `goose configure` kendiliğinden açılır. Üç yolun var: OpenRouter’a giriş yapmak, Tetrate Agent Router Service’e giriş yapmak ya da bir sağlayıcı seçip anahtarını yapıştırarak ve bir model adı girerek elle ayarlamak. Sürüm 1.54’ten beri hangi modda başlamak istediğini de sorar.

Anahtarlar sisteminin anahtar zincirine (macOS’ta Anahtar Zinciri) kaydedilir. Anahtar zinciri yoksa ya da `GOOSE_DISABLE_KEYRING` ayarladıysan bunun yerine düz metin bir `secrets.yaml` dosyasına yazılır. Anahtarları ortam değişkeni olarak da verebilirsin:

```bash
export ANTHROPIC_API_KEY=...
export GOOSE_PROVIDER=anthropic
export GOOSE_MODEL=claude-sonnet-5-5
```

`config.yaml` içine yazılan bir anahtar yok sayılır. Sağlayıcıyı değiştirmek, eklenti eklemek ya da açıp kapatmak veya mod ve araç izinleri ayarlarını açmak için `goose configure`’u istediğin zaman yeniden çalıştırabilirsin.

Zaten Claude Code ya da ChatGPT Plus/Pro için ödeme yapıyorsan [ACP sağlayıcılarına](https://goose-docs.ai/docs/guides/acp-providers "Goose ACP sağlayıcıları") bak: Goose’un API anahtarı yerine bu girişi kullanmasını sağlarlar.

## 3. Adım: bir oturum başlat

```bash
cd my-project
goose session -n checkout-fix
```

İşi sade bir dille anlat. Oturum içinde işine yarayacak tuşlar ve komutlar:

- `Ctrl+J` yeni satır ekler; `Ctrl+C` o anki isteği durdurur, boş satırdaysa çıkar.
- `/mode`, `/model`, `/extension` ve `/builtin` oturumdan çıkmadan ayarları değiştirir.
- `/compact` konuşma uzayınca onu kısaltır; `/clear` baştan başlar.
- `/status` oturumu, kimliğiyle birlikte gösterir.

Sonra kaldığın yere dönmek için `goose session -r -n checkout-fix` çalıştır. `goose session list` tüm oturumları gösterir, `--fork` da bir oturumu kopyalar; böylece aslını kaybetmeden başka bir yön deneyebilirsin.

## 4. Adım: asıl işten önce mod seç

Goose’un dört modu var:

| Mod | Ne yapar |
|---|---|
| `auto` (varsayılan) | Her aracı sormadan çalıştırır |
| `approve` | Her araç çağrısından önce sorar |
| `smart_approve` | Yalnızca riskli bulduğu çağrılarda sorar |
| `chat` | Araç yok; yalnızca konuşma |

Oturum içinde `/mode approve` ile geçebilir, `GOOSE_MODE` ayarlayabilir ya da `goose configure` içinde varsayılan bir mod seçebilirsin. Daha ince kontrol için `goose configure` içinde araç bazında izin ver; izinler `permission.yaml` dosyasına kaydedilir. Önemsediğin bir depoda `approve` ya da `smart_approve` ile başla, kuruluma güvendikçe gevşet.

## 5. Adım: eklentiler ve MCP sunucuları

Goose araçlarını eklentilerden alır ve her MCP sunucusu bir eklentidir. Developer eklentisi (kabuk ve dosya düzenleme) varsayılan olarak açıktır. Yerleşik diğer eklentiler arasında Computer Controller, Memory ve Auto Visualiser var.

Kalıcı olarak eklemek için `goose configure` → **Add Extension** yolunu izle ve bir komut satırı (stdio) ya da uzak (Streamable HTTP) sunucu seç. Tek bir oturum için:

```bash
goose session --with-extension "memory:npx -y @modelcontextprotocol/server-memory"
goose session --with-streamable-http-extension https://example.com/mcp
```

Kaydedilen eklentiler `~/.config/goose/config.yaml` içinde `extensions:` altında durur (Windows: `%APPDATA%\Block\goose\config\config.yaml`). SSE sunucuları artık desteklenmiyor; Streamable HTTP kullan.

## 6. Adım: AGENTS.md ve .goosehints

Goose, çalışma klasöründen git köküne kadar her seviyede önce `AGENTS.md`’yi, sonra `.goosehints`’i okur; alt klasörlerde çalıştıkça iç içe olanları da alır. `~/.config/goose/.goosehints` konumundaki genel dosya her projede geçerlidir.

Projende zaten bir `CLAUDE.md` varsa onu kopyalamana gerek yok:

```bash
export CONTEXT_FILE_NAMES='["AGENTS.md", ".goosehints", "CLAUDE.md"]'
```

Dosyayı kısa tut: kullandığın teknolojiler, testlerin nasıl çalıştırıldığı, nelere dokunulmayacağı ve “bitti”nin ne anlama geldiği. Dosyaya neyin girmesi gerektiğini [CLAUDE.md nasıl yazılır](/blog/claude-md-nasil-yazilir/ "CLAUDE.md ve AGENTS.md nasıl yazılır") yazısı anlatıyor.

## 7. Adım: goose run ve recipe’ler

Sohbet açmadan tek seferlik işler için `goose run` kullan:

```bash
goose run -t "add a unit test for the price formatter"
goose run -i task.md --output-format json
```

Recipe, bir işi talimatları, eklentileri ve parametreleriyle birlikte saklayan bir YAML dosyasıdır; böylece bir ekip arkadaşın ya da zamanlanmış bir iş onu tekrarlayabilir:

```bash
goose run --recipe release-notes.yaml --params version=2.4.0
goose schedule add --schedule-id weekly-notes --cron "0 0 9 * * 1" --recipe-source release-notes.yaml
```

`goose recipe validate`, bir dosyayı paylaşmadan önce kontrol eder. Bilmeye değer iki komut daha: `goose review` git diff’in için yapay zekâ incelemesi ister, `goose info -v` de sürümü ve yapılandırmanın, oturumların ve logların nerede olduğunu gösterir.

## Sık yapılan hatalar

- **auto modunu açık bırakmak.** Varsayılan mod kabuk komutlarını sormadan çalıştırır. Gerçek bir depodaki ilk işten önce modu değiştir.
- **Eski belgeleri izlemek.** 2025 tarihli eğitimler `block/goose` ve `block.github.io` adreslerini gösteriyor. Komutların çoğu hâlâ çalışıyor ama güncel belgeler goose-docs.ai’de.
- **Anahtarları config.yaml’a yazmak.** Goose onları orada yok sayar. Anahtar zincirini, `goose configure`’u ya da ortam değişkenlerini kullan.
- **Kullanımdan kaldırılan CLI sağlayıcılarını kullanmak.** Claude Code ya da ChatGPT girişiyle çalıştırmak için bunun yerine bir ACP sağlayıcısı kur.
- **Uzun oturumlar.** Otomatik sıkıştırma bağlamı kontrol altında tutar, ama her iş için yeni ve adlandırılmış bir oturum yanıtları daha keskin tutar.

## Goose’u diğer CLI’ların yanında AgentVera’da çalıştırmak

Goose’un kendi masaüstü uygulaması var; kullandığın tek ajan Goose ise bu yetebilir. İş, Goose aynı projede Claude Code, Codex ya da Gemini CLI ile yan yana çalıştığında zorlaşır. [AgentVera](/ "AgentVera") bu CLI’ları kendi kurulumların ve anahtarlarınla, gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. [Goose desteği](/ajanlar/goose/ "AgentVera’da Goose") şöyle çalışır:

- **Her ajana adlandırılmış bir oturum.** Her Goose ajanı kendi oturum adını alır; AgentVera sonraki açılışlarda oturumu `goose session --resume --name` ile yeniden açar, böylece konuşma uygulama yeniden başlasa da kaybolmaz.
- **Senin sağlayıcın ve anahtarların.** Goose, `goose configure`’daki sağlayıcıyı kullanmaya devam eder. Ayarlar → Hesaplar bölümünden Goose ajanları için API anahtarıyla çalışan hesaplar (Anthropic, OpenAI, OpenRouter, Google) ekleyebilirsin.
- **Model, efor ve rol.** Seçtiğin model `--model` ile, efor seviyesi `GOOSE_THINKING_EFFORT` ile, ajanın rolü de `--system` ile verilir.
- **MCP ve tarayıcı.** AgentVera’nın [MCP yöneticisindeki](/ozellikler/mcp-yoneticisi/ "MCP yöneticisi") sunucular `--with-extension` ya da `--with-streamable-http-extension` olarak verilir; yani onları her CLI için bir kez ayarlarsın.
- **Bölmeler, worktree’ler ve inceleme.** Goose’u [çalışma alanı](/ozellikler/calisma-alani/ "Çalışma alanı") ızgarasında diğer ajanların yanında, her biri kendi git worktree kopyasında çalıştır ve değişikliklerini kod incelemesiyle kontrol et.

Ücretsiz plan 18 ajana kadar, MCP, Git, Docker, SSH, kod incelemesi ve token tasarrufu içerir. Pro aylık 9,99 $; daha önce hiç deneme kullanmadıysan uygulamaya ilk girişin Pro’yu kart istemeden 7 gün açar. Denemek için [AgentVera’yı indir](/indir/ "AgentVera’yı indir").

## Toparlarsak

Goose’a başlamak üç komut alır: kurulum, `goose configure`, `goose session`. En önemli ayarlar hemen ardından gelir: auto modundan approve moduna geç, ihtiyacın olan eklentileri ekle ve projeye bir `AGENTS.md` ver. Bir iş tekrarlanmaya başlayınca onu recipe olarak kaydet.

Kaynaklar: [Goose kurulumu](https://goose-docs.ai/docs/getting-started/installation "Goose’u kur"), [CLI komutları](https://goose-docs.ai/docs/guides/goose-cli-commands "Goose CLI komutları"), [izinler](https://goose-docs.ai/docs/guides/managing-tools/goose-permissions "Goose izin modları"), [eklentiler](https://goose-docs.ai/docs/getting-started/using-extensions "Eklentileri kullanmak"), [hints dosyaları](https://goose-docs.ai/docs/guides/context-engineering/using-goosehints ".goosehints kullanmak"), [sürümler](https://github.com/aaif-goose/goose/releases "Goose sürümleri").

## Sık sorulanlar

**Goose ücretsiz mi?** Evet. Goose, Apache-2.0 lisanslı açık kaynak bir yazılım ve ücretsiz. Kullandığı token’lar için model sağlayıcına ödeme yaparsın ya da Ollama, LM Studio veya Docker Model Runner üzerinden yerel bir modeli token maliyeti olmadan çalıştırırsın.

**Goose’u şu an kim geliştiriyor?** Goose’u Block geliştirdi ve Aralık 2025’te Linux Foundation çatısı altındaki Agentic AI Foundation’a (AAIF) devretti. Nisan 2026’dan beri kod github.com/aaif-goose/goose adresinde, belgeler de goose-docs.ai’de.

**Goose, Claude Code ya da ChatGPT aboneliğimi kullanabilir mi?** Evet, ACP sağlayıcıları üzerinden. Bunlar Goose’un mevcut bir Claude Code ya da ChatGPT Plus/Pro girişini kullanmasını sağlar. Bu işi eskiden yapan CLI sağlayıcıları, ACP sağlayıcıları lehine kullanımdan kaldırıldı.

**Goose AGENTS.md ya da CLAUDE.md okur mu?** Goose, çalışma klasöründen git köküne kadar her seviyede önce AGENTS.md’yi, sonra .goosehints’i okur. CLAUDE.md ya da .cursorrules dosyalarını da yüklemesi için onları CONTEXT_FILE_NAMES ortam değişkenine ekle.

**Goose komut çalıştırmadan önce onay ister mi?** Varsayılan olarak istemez. Varsayılan mod auto’dur ve araçları sormadan çalıştırır. approve modu her araç çağrısından önce sorar, smart_approve yalnızca riskli olanlarda sorar, chat modu da araçları kapatır.

---

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