Gemini CLI Yapılandırma Eğitimi

📋 Hazırlık Adımları

Başlamadan önce lütfen şunlara sahip olduğunuzdan emin olun:

Koze hesabı oluşturduğunuzdan ve giriş yaptığınızdan emin olun
API Yönetimi sayfasında bir API Anahtarı oluşturduğunuzdan emin olun
Gemini CLI'yı yüklediğinizden emin olun (npm install -g @anthropic-ai/gemini-cli veya Resmi Depo'ya bakın)

🚀 Yöntem 1: Gemini API aracılığıyla erişim (Önerilen)

Terminalde aşağıdaki ortam değişkenlerini ayarlayın:

# Koze Gemini proxy adresini dışa aktarın GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Koze API Anahtarınızı ayarlayın
export GEMINI_API_KEY='API anahtarınız'

# Kullanılacak modeli belirtin
export GEMINI_MODEL='gemini-2.5-pro'

Kimlik doğrulama yöntemi:Başlangıçta Gemini API Anahtarını Kullan seçeneğini seçin. API Anahtarı girmeniz istenirse, sadece Enter tuşuna basın ve boş bırakın.

💡 Başlangıçta otomatik olarak Google giriş sayfasına yönlendiriliyorsanız, lütfen ~/.gemini/settings.json dosyasını silin ve yeniden başlatın.

🔧 İkinci Yöntem: Code Assist API aracılığıyla erişim

Bazı özel senaryolar için uygun başka bir erişim yöntemi:

# Code Assist uç noktasını ayarlayın

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Erişim Token'ını ayarlayın (Koze API Anahtarınızı kullanarak)

export GOOGLE_CLOUD_ACCESS_TOKEN='API anahtarınız'

# GCA modunu etkinleştirin

export GOOGLE_GENAI_USE_GCA='true'

# Modeli belirtin

export GEMINI_MODEL='gemini-2.5-pro'

Kimlik doğrulama yöntemi:Başlangıçta Google ile giriş yap seçeneğini seçin.

⚠️ Not: Gemini CLI konsolu "Kullanıcı bilgisi alınamadı: 401 Yetkisiz" hatası gösterebilir, bu normaldir ve kullanımı etkilemez.



🎯 Adım 3: Gemini CLI'yı Başlatın

Yapılandırmadan sonra, terminalde başlatın:

gemini

📌 Ortam Değişkenlerini Kalıcı Hale Getirin

Ortam değişkenlerini shell yapılandırma dosyasına yazmanız önerilir (örnek olarak 1. yöntemi kullanarak):

# Zsh user

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=

export GEMINI_MODEL=

EOF source ~/.zshrc



📌 Mevcut Modeller







Model Adı

Açıklama








gemini-2.5-pro

Gemini 2.5 Pro, yüksek performanslı modellerin en yeni nesli




gemini-2.5-flash

Gemini 2.5 Flash, daha hızlı ve daha fazla maliyet etkin




gemini-2.0-flash

Gemini 2.0 Flash







⚠️ Sıkça Sorulan Sorular (SSS)







Sorun

Çözüm








Başlangıçtan sonra otomatik olarak Google Girişine yönlendirme

~/.gemini/settings.json dosyasını silin ve tekrar deneyin




401 Yetkisiz hatası

Bu bir Normal bir uyarıdır ve kullanımı etkilemez; dikkate almayın.




Model mevcut değil

Mevcut planınızın Gemini modellerini içerip içermediğini Koze Model Lobisinde kontrol edin.

Model Adı	Açıklama
`gemini-2.5-pro`	Gemini 2.5 Pro, yüksek performanslı modellerin en yeni nesli
`gemini-2.5-flash`	Gemini 2.5 Flash, daha hızlı ve daha fazla maliyet etkin
`gemini-2.0-flash`	Gemini 2.0 Flash

Sorun	Çözüm
Başlangıçtan sonra otomatik olarak Google Girişine yönlendirme	`~/.gemini/settings.json` dosyasını silin ve tekrar deneyin
401 Yetkisiz hatası	Bu bir Normal bir uyarıdır ve kullanımı etkilemez; dikkate almayın.
Model mevcut değil	Mevcut planınızın Gemini modellerini içerip içermediğini Koze Model Lobisinde kontrol edin.