--- title: Gemini CLI | RunAPI description: Gemini CLI’yi RunAPI’nin yerel Gemini API’siyle yapılandırın, istekleri doğrulayın ve önceki ayarlarınızı geri yükleyin. url: https://runapi.ai/tr/docs/resources/tool-integrations/gemini-cli.md canonical: https://runapi.ai/tr/docs/resources/tool-integrations/gemini-cli locale: tr --- > HTML sürümü: https://runapi.ai/tr/docs/resources/tool-integrations/gemini-cli > Ajanlar için site dizini: https://runapi.ai/llms.txt # Gemini CLI ## Genel Bakış Gemini CLI bir terminal ajanıdır. Bu kılavuz model sağlayıcısını RunAPI’nin yerel Gemini API’sine değiştirir; MCP ile RunAPI araçları eklemek ayrı bir adımdır. ## Başlamadan önce [Resmî kurulum kılavuzunu][1] izleyin. [Kimlik doğrulama kılavuzuyla](https://runapi.ai/tr/docs/guides/authentication.md) özel bir standart API anahtarı oluşturun ve [model kataloğundan](https://runapi.ai/tr/models) Gemini yerel model kimliğini kopyalayın. Anahtarınızı asla commit etmeyin. [1]: https://geminicli.com/docs/get-started/installation/ ```shell npm install -g @google/gemini-cli ``` ## RunAPI'yi yapılandırın Geçerli kabuğunuzda bu değişkenlerle başlayın. Temel URL, `/v1beta` içermeyen HTTPS API köküdür; SDK `POST /v1beta/models/{model}:streamGenerateContent?alt=sse` ekler. HTTP yalnızca localhost için kullanılabilir. ```shell export GOOGLE_GEMINI_BASE_URL=https://runapi.ai export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID ``` Kalıcı kullanım için aynı üç değişkeni depolarınızın dışında `~/.gemini/.env` dosyasına kaydedin. `chmod 600 ~/.gemini/.env` ile erişimi kısıtlayın. Gemini CLI, geçerli dizinden üst dizinlere doğru `.env` arar, ardından `~/.gemini/.env` ve `~/.env` dosyalarını kontrol eder; çakışan dosyalara dikkat edin. Diğer ayarları koruyarak bu iki ayarı `~/.gemini/settings.json` dosyasına birleştirin. API anahtarıyla kimlik doğrulamak için `gemini-api-key` kullanın; önbellekteki Google oturumunu kullanmayın. Anahtar varsayılan olarak `x-goog-api-key` içinde gönderilir. ```json { "security": { "auth": {"selectedType": "gemini-api-key"} }, "model": {"name": "YOUR_RUNAPI_MODEL_ID"} } ``` ## Bir model seçin Etkileşimli oturumda `GEMINI_MODEL`, `--model YOUR_RUNAPI_MODEL_ID` veya `/model` kullanın. `auto`, `pro` ve `flash` takma adlarından kaçının: RunAPI’de bulunmayan Google model kimliklerine çözümlenebilirler. İç seçim, sınıflandırma ve döngü algılama da flash veya flash-lite yardımcı modellerini isteyebilir; kullanılabilirliklerini ayrıca kontrol edin. ## Doğrula Bunu güvendiğiniz bir depoda çalıştırın. Etkileşimli oturumda `/about` veya `/stats` ile modeli kontrol edip RunAPI kullanım kayıtlarında eşleşen `streamGenerateContent` isteğini doğrulayın. Başarılı CLI yanıtı tek başına isteği hangi uç noktanın aldığını kanıtlamaz. ```shell gemini --version gemini -p "Describe this repository in one sentence." ``` ## RunAPI araçlarını ekleyin MCP araç ekler, model sağlayıcısı eklemez. Bu komut yerel sunucuyu kaydeder; ayrı kimlik doğrulama ve doğrulama adımları için [Local MCP](https://runapi.ai/tr/docs/resources/mcp/local.md) kılavuzunu izleyin. ```shell gemini mcp add runapi npx -y @runapi.ai/mcp ``` ## Sorun giderme İstekler hâlâ Google’a gidiyorsa çakışan `.env` dosyalarını, `security.auth.selectedType` ayarını, önbellekteki oturumu ve Google/Vertex kimlik doğrulama ortam değişkenlerini kontrol edin. `Invalid auth method selected` görürseniz ayarlarda `gateway` yerine `gemini-api-key` seçip yeniden başlatın. `401` durumunda anahtarı ve varsa `GEMINI_API_KEY_AUTH_MECHANISM` geçersiz kılmasını kontrol edin; varsayılan olarak `x-goog-api-key` kullanılır. `404` için temel URL’den `/v1beta` bölümünü kaldırıp desteklenen Gemini yerel model kimliğini yeniden kopyalayın. Yardımcı model kullanılamıyorsa istenen tam kimliği kontrol edin; ana model seçimi tüm CLI özelliklerini garanti etmez. RunAPI, `countTokens` veya `embedContent` sunmaz. `countTokens` başarısız olduğunda Gemini CLI yerel token tahminine dönebilir; tahminler kullanım kayıtlarından farklı olabilir. localhost dışında HTTPS kullanın ve sertifika doğrulamasını kapatmayın. ## RunAPI'yi Kaldır Üç değişkeni kabuğunuzdan ve kaydedilmiş `.env` dosyalarından kaldırın, önceki `security.auth.selectedType` ve model ayarını geri yükleyin ve özel anahtarı RunAPI’de iptal edin. Ayrı eklenen MCP sunucusunu yalnızca araçlarına artık ihtiyacınız yoksa kaldırın. ```shell unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL ``` ## Sonraki adımlar [LLM API hızlı başlangıcı](https://runapi.ai/tr/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/tr/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/tr/docs/api/gemini/stream-generate-content.md), [model kataloğu](https://runapi.ai/tr/models) veya [Local MCP](https://runapi.ai/tr/docs/resources/mcp/local.md) ile devam edin. --- ## RunAPI hakkında daha fazlası - [Ana sayfa](https://runapi.ai/tr/.md) - [Model Kataloğu](https://runapi.ai/tr/models.md) - [Fiyatlandırma](https://runapi.ai/tr/pricing.md) - [Sağlayıcılar](https://runapi.ai/tr/models) - [Dokümantasyon](https://runapi.ai/tr/docs/guides) - [SDK'lar](https://runapi.ai/tr/sdk.md) - [CLI](https://runapi.ai/tr/cli.md) - [MCP Sunucusu](https://runapi.ai/tr/mcp.md) - [x402](https://runapi.ai/tr/x402.md) - [Claude Code ve Cursor](https://runapi.ai/tr/claude-code-vs-cursor.md) - [Cursor API kurulumu](https://runapi.ai/tr/cursor-api-setup.md) - [RunAPI ve OpenRouter](https://runapi.ai/tr/openrouter-alternative.md) - [Kurumsal](https://runapi.ai/tr/contact.md) - [İletişim](https://runapi.ai/tr/contact.md) - [Şartlar](https://runapi.ai/tr/terms.md) - [Gizlilik](https://runapi.ai/tr/privacy.md) - [Ajanlar için site dizini](https://runapi.ai/llms.txt) İletişim: contact@runapi.ai ## Yapılandırılmış veriler ```json [ { "@context": "https://schema.org", "inLanguage": "tr", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/tr", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/tr/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "tr", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/tr", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/tricon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "tr", "@type": "TechArticle", "headline": "Gemini CLI", "description": "Gemini CLI’yi RunAPI’nin yerel Gemini API’siyle yapılandırın, istekleri doğrulayın ve önceki ayarlarınızı geri yükleyin.", "url": "https://runapi.ai/tr/docs/resources/tool-integrations/gemini-cli", "mainEntityOfPage": "https://runapi.ai/tr/docs/resources/tool-integrations/gemini-cli" } ] ```