goose kodlama aracısı rehberi: kurulum, model kaynağı, API ayarları ve maliyet

goose, terminalde veya masaüstü uygulamasında dosyaları okuyabilen, değiştirebilen ve komut çalıştırabilen açık kaynaklı (Apache-2.0) bir yapay zekâ kodlama aracısıdır. Başlamak için üç adım yeterlidir: yükleyin, bir model kaynağı (provider) seçin ve ona görev vermek üzere bir çalışma oturumu açın. Kendisi ücretsizdir; ücret, bağladığınız modelden kaynaklanır.Bu eğitim, 1 Ekim 2026 tarihli resmi belgelere dayanarak kurulumu, üç ücretlendirme yolunu, OpenAI uyumlu bir uç noktaya nasıl bağlanacağınızı (en sık karşılaşılan /v1 tuzağı dâhil) ve yaygın işlemleri açıklar. En son sürüm, 23 Eylül 2026'da yayımlanan v1.52.0'dır.

Önce adları netleştirelim. Bu sayfa, goose-docs.ai üzerindeki kodlama aracısını ele alır; kod deposu aaif-goose/goose adresindedir, daha önce block/goose olarak adlandırılıyordu ve Nisan 2026'da Linux Foundation bünyesindeki Agentic AI Foundation'a taşındı. Bu, goose.ai değildir — o, fiyatları da bununla ilgisiz olan başka bir barındırılan çıkarım hizmetidir. goose'un şu anda Geleneksel Çince arayüzü yoktur; aşağıdaki menü adları İngilizce asıllarıyla verilmiştir.

kurulum

Resmi olarak masaüstü sürümü (goose Desktop) ve komut satırı sürümü (goose CLI) sunulur; ikisi de aynı ayarları okur.

# goose Desktop(macOS)
brew install --cask block-goose

# goose CLI（macOS / Linux / Windows 的 Git Bash）
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

# 只安裝、先不進入設定
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# 或用 Homebrew 裝 CLI
brew install block-goose-cli

Windows'ta masaüstü sürümünü resmi web sitesinden indirebilirsiniz; CLI için aynı kurulum komutunu Git Bash içinde çalıştırmanız önerilir (PowerShell de kullanılabilir). Homebrew paketi hâlâ block-goose adını taşır; bu, yeniden adlandırmanın kurulum paketlerine tamamen yansımadığını gösterir ve projenin hâlâ Block'un elinde olduğu anlamına gelmez.

İlk başlatma: bir model kaynağı seçin

goose Desktop'ı ilk kez açtığınızda karşınıza bir karşılama ekranı çıkar; CLI ise otomatik olarak yapılandırma moduna girer (daha sonra değiştirmek için goose configure komutunu çalıştırabilirsiniz). Kurulum sayfasında üç seçenek listelenir:

• OpenRouter Login — OpenRouter hesabınızla giriş yaparak modeli otomatik olarak yapılandırır.
• Tetrate Agent Router Service Login — Tetrate ile giriş yaparsınız; belgeler, goose üzerinden ilk otomatik doğrulamada $10 ücretsiz kredi alınacağını ve bunun yeni ve mevcut kullanıcılar için geçerli olduğunu belirtir.
• Manual Configuration — provider'ı kendiniz seçer ve anahtarı girersiniz. OpenAI uyumlu bir uç noktaya (örneğin Kunavo) bağlanmak için bu yolu kullanın.

Üç ücretlendirme yolu: önce doğru olanı seçin, sonra yapılandırın

ACP yoluna ilişkin açıklama goose'un ACP providers belgelerinden alınmıştır. Bu belgeler ayrıca ACP'nin oturum kimliği ile goose'un oturum kimliğinin farklı olduğunu ve telemetri alanlarının eşleşmeyebileceğini hatırlatır. Zaten aboneliğiniz varsa ve yalnızca API maliyetinden tasarruf etmek istiyorsanız önce bu yolu inceleyin.

OpenAI uyumlu bir uç noktaya bağlanma: Host URL'sine /v1 eklemeyin

En çok kişinin takıldığı yer burasıdır. goose, tek parça bir base URL kullanmaz; onu "ana bilgisayar" ve "yol" olarak ikiye ayırır. providers belgelerine göre OPENAI_HOST "özel uç nokta URL'sidir (varsayılan api.openai.com)", OPENAI_BASE_PATH "ana bilgisayara eklenen istek yoludur (varsayılan v1/chat/completions)"; bir proxy'ye bağlanırken OPENAI_HOST, "proxy'nin kök adresi (yol içermeden)" olarak ayarlanmalıdır. Kunavo örneği:

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com      ← 只寫網域，不加 /v1
Organization ID   （留空）
Project           （留空）

# 或用環境變數（CLI 也讀）
export OPENAI_API_KEY=sk-kn-...
export OPENAI_HOST=https://api.kunavo.com
# OPENAI_BASE_PATH 不要設：預設就是 v1/chat/completions

goose Desktop'taki konum Settings → Models → Configure providers → OpenAI; CLI'da ise goose configure → Configure Providers → OpenAI yoludur. Organization ID ve Project, OpenAI'nin kendi hesapları içindir; boş bırakabilirsiniz. Host URL'sini https://api.kunavo.com/v1 olarak yazarsanız istek /v1/v1/chat/completions hâline gelir. Belgeler de "404 genellikle OPENAI_BASE_PATH değerinin proxy'niz için yanlış olduğu anlamına gelir" der — sorun yolun yanlış olmasıdır, anahtarın yanlış olması değil. Buna karşılık 401 "No api key passed in" hatası görürseniz anahtar okunmamıştır; örneğin anahtarı config.yaml dosyasına yazmak buna neden olabilir (goose bunu yok sayar).

Daha temiz bir başka yol, onu listede bağımsız bir provider hâline getirmektir. goose, custom_providers klasöründeki JSON tanım dosyalarını okur. Kunavo, canlı fiyat listesinden oluşturulmuş bir dosya sağlar; bu dosyada yalnızca araç çağrılarını destekleyen modeller bulunur ve anahtarın kendisi değil, yalnızca anahtar değişkeninin adı yazılıdır:

# macOS / Linux:goose 會讀這個資料夾裡所有 JSON
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# 檔案裡只有變數名稱，金鑰另外設定
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Windows'ta klasör yolu %APPDATA%\Block\goose\config\custom_providers\ olarak belirlenmiştir. Dosyayı yerleştirdikten sonra goose Desktop'taki Configure providers bölümünde Kunavo görünür. Anahtar, ortam değişkeni yerine sistem anahtar zincirine kaydedilebilir. goose kaynak koduna göre kimliği gpt-5 veya gpt-6 ile başlayan modeller /v1/responses yolunu, diğerleri /v1/chat/completions yolunu kullanır; Kunavo her ikisini de sunar. Elle oluşturmak da mümkündür: Configure providers → Add Custom Provider bölümünde tür olarak OpenAI Compatible seçin ve API URL'si alanına https://api.kunavo.com/v1 yazın. Tam İngilizce yapılandırma sayfası goose integration guide adresindedir.

Açık uyarı: Yukarıdaki yapılandırma goose'un belgeleri ve kaynak kodu okunarak hazırlanmıştır. Kunavo, kendi uç noktasını goose ile gerçekten çalıştırmamıştır — çalışma oturumu, akış veya araç gidiş-dönüşü test edilmemiştir. Şu anda çalışan yolunuzu koruyun ve önce dosya okuyup yazabilen küçük bir görev vererek deneyin.

Yaygın işlemler

• Çalışma oturumu açma:goose session ( -n 名稱 ile adlandırılabilir), ardından goose session --resume -n 名稱 ile devam edin; goose session list geçmişi listeler.
• Yetkilendirme modunu değiştirme: Çalışma oturumunda /mode yazın; auto, approve, chat ve smart_approve seçeneklerinden birini seçebilirsiniz. Her adımda önce size sormasını istiyorsanız approve kullanın.
• Model seçme:goose configure özel bir model adı giremez; listede bulunmayan kimlikler için goose Desktop'a girin veya config.yaml içinde GOOSE_MODEL değerini ayarlayın.
• Proje açıklama dosyaları: goose varsayılan olarak .goosehints ve AGENTS.md'yi okur (CONTEXT_FILE_NAMES tarafından kontrol edilir). Proje kurallarını bu dosyalara yazarsanız başka bir aracıya geçtiğinizde de taşıyabilirsiniz.
• Araç çağrılarını desteklemeyen modelleri seçmeyin: Belgeler, bu modellerin "yalnızca sohbet tamamlama yapabildiğini" ve uzantıların da devre dışı bırakılması gerektiğini belirtir.

Bir çalışma oturumu yaklaşık ne kadar tutar?

Aşağıdaki, yalnızca açıklama amaçlı bir token hesabıdır; gerçek görev maliyeti veya fatura üst sınırı değildir. Bir aracı çalışma oturumunun birden çok tur boyunca toplam 400.000 önbelleğe alınmamış giriş token'ı gönderdiğini ve 25.000 çıkış token'ı aldığını varsayalım (aracı her turda bağlamı yeniden gönderdiği için giriş miktarı özellikle yüksektir). Birim fiyatlar, Kunavo fiyat listesindeki güncel milyon token başına fiyatlardan alınmıştır.

Önbellek hakkında: goose belgeleri, Anthropic, Amazon Bedrock, Databricks, OpenRouter veya LiteLLM provider'ları üzerinden Claude kullanıldığında Anthropic'in cache_control işaretlerinin otomatik olarak eklendiğini belirtir. Genel OpenAI provider'ı üzerinden kullanılan Claude bu listede yer almaz; goose bu işaretleri eklemez. Bu nedenle yukarıdaki tabloda önbellek indirimi olmadığı varsayılmıştır; bu ihtiyatlı bir tahmindir. Kunavo fiyat listesindeki tutarlar üst sınır değil, faturalandırma tabanıdır: upstream bir ücret bildirdiğinde fatura, "fiyat listesi tutarı" ile "upstream ücreti × geçerli çarpan" değerlerinden yüksek olanıdır.

Tayvan'da ödeme

Kunavo ön ödemeli yükleme ve token bazlı ücretlendirme kullanır; aylık ücret yoktur. Minimum yükleme $10’dır. Ödeme Stripe üzerinden yapılır; Tayvan’da kredi kartları (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ve Link kullanılabilir; JKOPay ve LINE Pay kullanılabilir yöntemler arasında değildir. Ayrıntılar için faturalama bilgilerine bakın; hazır olduğunuzda hesap oluşturabilir ve anahtar üretebilirsiniz. Diğer aracıları karşılaştırmak için İngilizce goose alternatives ve goose vs Claude Code sayfalarına bakabilirsiniz.

Sık sorulan sorular

1 Ekim 2026 tarihinde doğrulandı: goose'un kurulum, providers, ACP providers, CLI komutları ve ortam değişkenleri belgeleri (aaif-goose/goose main dalı) ile GitHub API'sindeki sürüm ve arşiv durumu. Kunavo, kendi uç noktasını goose ile gerçekten çalıştırmamıştır; fiyatlar canlı fiyat listesinden alınmış, tutar örneklerinin tümü yalnızca açıklama amaçlı token hesaplarıdır.