gemini cli dizinini nasıl değiştiririm?

Google’un açık kaynaklı Gemini CLI’si—Gemini’yi kabuğunuza getiren terminal tabanlı yapay zeka ajanı—çıkışından bu yana hızla olgunlaştı ve artık zengin yapılandırma, proje bağlam dosyaları (GEMINI.md / .gemini), özel eğik çizgi komutları ve çalışma alanı dizini kontrollerini destekliyor. Proje GitHub’da (resmî depo) aktif olarak evriliyor, cömert kotalarla herkese açık önizleme aşamasına girdi ve diğer geliştirici araçlarına (düzenleyici entegrasyonları ve CI/Actions) entegre ediliyor. Ancak ekipler ölçeklendikçe veya sürücüler arası ya da kısıtlayıcı ortamlarda (konteynerler, şirket tarafından yönetilen dizüstü bilgisayarlar, Cloud Shell, Windows sistemleri) çalıştığınızda, hızla pratik bir soruyla karşılaşırsınız: Gemini dosyalarını nerede depoluyor ve Gemini’nin okuduğu/yazdığı dizinleri nasıl değiştirebilirsiniz?

Gemini CLI nedir?

Gemini CLI, Gemini modellerinin gücünü doğrudan terminalinize getiren Google’ın açık kaynaklı komut satırı yapay zeka ajanıdır. Kod yardımı, dosya ve proje inceleme, kabuk komutlarını çalıştırma (korumalarla birlikte) ve Google Search, Model Context Protocol (MCP) uzantıları ile Gemini ile birlikte sunulan medya üretim araçları gibi araçların entegrasyonuna yönelik etkileşimli ajan yetenekleri sağlar. CLI hafif, betiklenebilir ve genişletilebilir olacak şekilde tasarlanmıştır; resmî depodan temin edilebilir ve kolay kurulum için paketlenmiştir. 

Dizin neden önemlidir

Gemini CLI yapılandırmayı (örneğin settings.json), sistem komutlarını veya bağlamı (GEMINI.md), önbelleğe alınmış kimlik bilgilerini, telemetri tanımlayıcılarını ve diğer kalıcı durumları .gemini dizini içinde depolar. Bu dizinin nerede bulunduğu şunları kontrol eder:

• CLI’ın hangi ayarları yüklediği (genel vs. proje özel),
• ajanın hangi “hafıza” dosyalarını okuyacağı,
• kimlik bilgilerinin nerede önbelleğe alınacağı (oturum açma davranışını etkiler),
• özel yapılandırma deposu sağlamak istediğinizde makinalar veya CI arasında çoğaltılabilirlik.

Dizini anlamak ve (gerekirse) değiştirmek, çoklu proje iş akışlarında, CI’da, konteynerli dağıtımlarda ve merkezi yapılandırma depolarına sahip ekiplerde yardımcı olur. 

Gemini CLI varsayılan olarak yapılandırmayı nerede saklar?

Varsayılan olarak CLI bir .gemini dizini kullanır. Çoğu kullanıcı kurulumu için bu ~/.gemini’ye (ana dizininizdeki .gemini klasörü) karşılık gelir. CLI ayrıca proje düzeyinde .gemini dosyalarını (ör. proje kökünde .gemini/settings.json) destekler; bunlar, o proje klasöründe çalışırken kullanıcı ayarlarını geçersiz kılar. Sistem düzeyindeki ayarlar, uygulanabilir olduğunda işletim sistemi özel konumlardan okunur (örneğin Linux’ta /etc/ veya Windows’ta %PROGRAMDATA%). Tipik yollar:

• Linux / macOS: ~/.gemini/ (örneğin /home/alice/.gemini veya /Users/alice/.gemini).
• Windows: %USERPROFILE%\.gemini (ör. C:\Users\Alice\.gemini).
  .gemini içinde genellikle settings.json, GEMINI.md, commands/ ve yerel önbellekleri bulursunuz. CLI ayrıca proje düzeyindeki .gemini/ klasörlerini (proje kökü) proje ayarlarını okumak için kullanır. 

Bu varsayılan önemlidir: geçmişte yapılandırma dizini, ana dizindeki .gemini olarak sabit kodlanmıştır.

---

Gemini CLI'nin yapılandırma dizinini nasıl değiştirir veya yeniden yönlendirirsiniz?

Birden fazla pratik yol vardır — en basitinden (istediğiniz klasörde çalışın) daha sağlam seçeneklere (ortam değişkenleri veya dosya sistemi yönlendirmeleri). Yaklaşımı, çalışma zamanını kontrol edip etmediğinize (yerel geliştirme makinesi vs. CI), hangi işletim sisteminde olduğunuza ve geçici mi kalıcı mı bir değişiklik istediğinize göre seçin.

1) Proje düzeyinde .gemini kullanın (proje başına ayarlar için önerilir)

Proje bazlı ayarlar istiyorsanız, proje kökünüzde bir .gemini alt dizini oluşturun ve settings.json, GEMINI.md ve diğer proje dosyalarını buraya koyun. Gemini CLI, bu proje dizinindeyken proje ayarlarını tercih eder:

your-project/├─ .gemini/│  ├─ settings.json│  └─ GEMINI.md└─ src/

Kabuk konumunuz your-project/ iken gemini’yi başlatın; CLI, .gemini dosyalarını bu ağaçtan alacaktır (proje bağlamını bulmak için yukarı doğru arar). Bu, proje bazlı yapılandırma için en güvenli ve açık yöntemdir. 

2) Belgelenmiş ortam değişkenlerini kullanın (desteklendiğinde)

Gemini CLI kod tabanı ve belgeleri, davranışı değiştirmek için kullanılan çeşitli ortam değişkenlerine atıfta bulunur. Bunlardan bazıları sistem ayarları veya özel dosya geçersiz kılmaları için tasarlanmıştır:

• GEMINI_API_KEY, GEMINI_MODEL vb. genellikle kimlik doğrulama ve model seçimi için kullanılır.
• Kod tabanında ve belgelerde GEMINI_CLI_SYSTEM_SETTINGS_PATH (sistem ayarları yolunu geçersiz kılmak için kullanılır) gibi değişkenlere ve GEMINI_CONFIG_DIR gibi sabitlere (kodda kullanılan varsayılan .gemini adı) referanslar vardır. Bazı topluluk talepleri ve PR’lar, kullanıcıların tüm yapılandırma dizinini taşımak için bir GEMINI_CONFIG_DIR ortam değişkeni eklenmesini veya dikkate alınmasını önerir. 

Örnek (bash / macOS / Linux):

# Temporary for this shell sessionexport GEMINI_CONFIG_DIR="$HOME/custom_gemini_dir"​# Or override system settings path if your install supports it:export GEMINI_CLI_SYSTEM_SETTINGS_PATH="/etc/my-gemini/system.settings.json"​# Then rungemini

PowerShell (Windows):

$env:GEMINI_CONFIG_DIR = 'C:\Users\you\CustomGemini'gemini

Önemli uyarı: en son topluluk tartışmaları ve konulara göre, GEMINI_CONFIG_DIR bazı yerlerde talep edilmiş ve kodda referans verilmiştir — ancak özellikle Windows’ta platforma özgü hatalar ve tutarsız davranışlar bildirilmiştir. Bu, ortam değişkeni tabanlı yeniden yönlendirmenin her platformda veya sürümde her zaman güvenilir olmayabileceği anlamına gelir. Buna güveniyorsanız, kurulu sürümünüz için Gemini CLI sürüm notlarını ve depo sorunlarını kontrol edin. 

3) Oturum içinde Gemini'nin çalışma alanına dizinler ekleyin

Gemini’nin ek dizinlerden haberdar olmasını istiyorsanız (dosyaları bağlam olarak okuyabilmesi için), etkileşimli /directory komut seti vardır. Örneğin:

/directory add path/to/another/project/directory list

Bu, yapılandırma dizinini taşımaz, ancak ajanın çalışma alanı bağlamına diğer dizinlerden dosyalar eklemesine izin verir. Global yapılandırmanızı değiştirmeden ajanın diğer depolara başvurmasını istediğinizde faydalıdır. 

4) Bir sembolik bağlantı veya dosya sistemi bağlaması oluşturun (pratik çözüm)

CLI ortam geçersiz kılmalarını kabul etmeyi reddediyorsa veya süreçler arası güvenilir bir çözüm istiyorsanız, dosya sistemi yönlendirmesi kullanın:

Unix/macOS'ta:

# move the original config foldermv ~/.gemini ~/gemini_backup​# create a symlink to your desired locationln -s /path/to/central/gemini-config ~/.gemini

Windows (PowerShell yönetici istemi):

# Move the original directoryMove-Item -Path $env:USERPROFILE\.gemini -Destination C:\GeminiConfigBackup​# Create a junction (administrator)New-Item -ItemType Junction -Path $env:USERPROFILE\.gemini -Target C:\CentralGeminiConfig

Bu yaklaşım, CLI’ın yerel desteğe ihtiyaç duymadan istediğiniz konumdan okumasını sağlar. Not: sembolik bağlantılar/junction’lar uygun dosya sistemi ayrıcalıkları gerektirir ve konteyner veya Windows ortamlarında farklı davranabilir. Dikkatle kullanın. (“Windows’a özgü notlar” bölümüne bakın.)

5) İşlem için etkin ana dizini değiştirin (container/CI hilesi)

CI, konteynerler veya geçici ortamlarda çalışırken, gemini süreci için $HOME (Unix) veya %USERPROFILE% (Windows) ortam değişkenini değiştirerek varsayılan ~/.gemini’nin kontrol ettiğiniz bir yola çözünmesini sağlayabilirsiniz:

# Run gemini with a custom HOME (bash)HOME=/ci/workspace/you gemini --some-command​# Or in a container DockerfileENV HOME=/app/userRUN mkdir -p /app/user/.geminiCOPY config /app/user/.gemini

Bu, CI çoğaltılabilirliği için yararlıdır ancak dikkatli olun: HOME’u değiştirmek diğer araçları ve kimlik doğrulama akışlarını (ör. Google OAuth önbellekleri) etkileyebilir, bu tekniği izole konteynerlere veya süreç düzeyi sarmalayıcılara sınırlayın.

CometAPI aracılığıyla Gemini CLI'yi nasıl kurup kullanabilirim?

Kısa cevap: iki pratik yolunuz var — (A) Gemini modellerini CometAPI üzerinden doğrudan çağırın (önerilir ve en basit), veya (B) resmî Gemini CLI’yi, Gemini-CLI’nin özel bir temel URL’yi destekleyen bir sürümünü kullanarak (bazı sürümler/PR’lar bunu ekler) ya da Gemini-CLI isteklerini CometAPI/OpenAI tarzı çağrılara çeviren küçük yerel bir proxy çalıştırarak CometAPI ile konuşturun. 

CometAPI nedir?

CometAPI, OpenAI tarzı bir HTTP API’nin arkasında yüzlerce üçüncü taraf modeli (Google’ın Gemini ailesi dâhil) sunan bir API toplama/ağ geçididir. Kaydolur, bir bearer API anahtarı alır, sonra https://api.cometapi.com/v1/chat/completions gibi uç noktalara çağrı yaparsınız. CometAPI, Authorization başlığında standart bearer belirteçler kullanır.

Neden CometAPI? Entegrasyonu kolaylaştırmak için resmî API’den daha düşük API fiyatları sunar. Gemini CLI Installation and Usage Guide:

Gemini modellerini CometAPI aracılığıyla doğrudan nasıl çağırırım? (Önerilir)

Amacınız yalnızca Gemini modellerini kullanmaksa ve Gemini CLI özelliklerine kesin olarak ihtiyaç duymuyorsanız, CometAPI’yi doğrudan çağırmak basit ve güvenilirdir.

export COMET_KEY="sk-xxxx"​curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \  -H "Authorization: Bearer $COMET_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-2.5-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Summarize the 3 key benefits of unit tests."}    ],    "max_tokens": 300  }' | jq .

Bu doğrudan çağrılar, CometAPI’yi betiklere, uygulamalara veya CI’a Gemini CLI’ye güvenmeden entegre etmenizi sağlar.

Gemini CLI'yi CometAPI'yi kullanacak şekilde ayarlayabilir miyim?

Bazı Gemini CLI sürümleri/PR’ları, Gemini API temel URL’sini geçersiz kılmak için ortam değişkenleri ekler. Kurulu gemini’niz, özel bir Gemini temel URL’sini yapılandırmayı ve CometAPI anahtarını kullanmayı destekliyorsa, onu CometAPI’ye yönlendirebilir ve CometAPI anahtarını GEMINI_API_KEY olarak ayarlayabilirsiniz (CLI, Gemini API anahtarı kimlik doğrulaması için GEMINI_API_KEY adlı bir anahtar değişkeni bekler).

Örnek:

# example env — *check your gemini-cli docs for exact var names*export GEMINI_API_KEY="sk-xxxxx"                    # CometAPI keyexport GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com/v1"  # if supportedgemini   # run the CLI; it will use the configured base URL

Sorun giderme: yaygın sorunlar ve çözümler

Sorun: Gemini başka bir depodaki dosyaları göremiyor

1. Başlatırken gemini --include-directories /path/to/repo deneyin. Ya da oturum içinde: /directory add /path/to/repo. 
2. Depo bir ağ bağlamasında ise, izinleri ve CLI süreç kullanıcısının dosyaları okuyabildiğini kontrol edin.
3. .gemini’yi taşımak için sembolik bağlantı kullandıysanız, CLI’ın GEMINI.md ve settings.json için sembolik bağlantıyı takip ettiğini doğrulayın (bazı sürümler güvenlik nedeniyle belirli sembolik bağlantıları takip etmez). 

Sorun: gemini Windows'ta ~/.gemini oluşturamıyor (EPERM)

Bu genellikle sürecin %USERPROFILE%’a yazma izninin olmadığı anlamına gelir. Çözümler:

• Terminali Yönetici olarak çalıştırın veya klasör izinlerini ayarlayın.
• Sembolik bağlantı ile özel bir yapılandırma konumu ayarlayın veya desteklendiğinde ortam değişkeni ile ayarlayın (gelecekteki GEMINI_CONFIG_DIR desteğini takip edin). 

Sorun: cd kabuk modunda çalışma dizinini değiştirmiyor

Bu bazı platformlarda kabul edilmiş bir sorundur. Öneri: kabuk komutlarını Gemini CLI süreci dışından çalıştırmaya geçin veya /directory add ile dizinler ekleyin.

Sorun: CometAPI model adları beklentilerimle eşleşmiyor

/v1/models uç noktasını çağırın ve JSON’u inceleyin. Model kimlikleri çoğu zaman tam varyant dizelerini içerir (ör. gemini-2.5-flash-preview-04-17). İsteğinizde tam dizeyi kullanın.

Sonuç

Gemini CLI’nın varsayılan tasarımı makul ve keşfedilebilir davranışı tercih eder: kullanıcı düzeyi varsayılanlar için global ~/.gemini ve depo bazlı geçersiz kılmalar için proje .gemini. Topluluk, aracı çok kullanıcılı, konteynerli ve kurumsal ortamlara daha dost hâle getirmek için daha fazla yerel yapılandırılabilirlik (açık ortam değişkenleri veya bayraklar) talep ediyor.

Gemini CLI dizini nasıl değiştirilir: 

Genel bakış: Gemini CLI, kullanıcı genelinde yapılandırma ve bağlam dosyalarını bir .gemini dizininde saklar (genellikle ~/.gemini). CLI’ın kullandığı dizini şu yollarla etkileyebilirsiniz: (1) geçerli çalışma dizininde proje düzeyindeki .gemini’ye güvenmek, (2) desteklendiğinde ortam değişkenleri veya CLI seçeneklerini kullanmak, (3) etkileşimli bir oturum içinde çalışma alanı dizinleri eklemek veya (4) yerel seçenekler eksik olduğunda dosya sistemi tekniklerini (sembolik bağlantılar, bağlama bağlantıları veya home/profil değişkenlerini değiştirme) kullanmak.

Başlamak için Playground içinde Gemini 3 Pro gibi Gemini modellerinin yeteneklerini keşfedin ve ayrıntılı talimatlar için API rehberini inceleyin. Erişimden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI entegrasyona yardımcı olmak için resmî fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ Gemini modellerinin ücretsiz denemesi !