Gemini CLI

Genel Bakış

Tür: Kodlama aracıBirincil yol: Gemini-nativeDestek seviyesi: En iyi çaba uyumluluk

Google Gemini CLI, Gemini modelleriyle etkileşim kurmak için kullanılan bir komut satırı aracıdır. TokenLab, Gemini CLI’yı 300’den fazla modele erişimle kullanmanıza olanak tanıyan uyumlu bir uç nokta (endpoint) sağlar.

Bu entegrasyonu deneysel kabul edin: Gemini CLI şu anda TokenLab benzeri özel Base URL iş akışını kararlı bir resmi yapılandırma olarak belgelemiyor. Desteklenen bir TokenLab terminal kurulumu istiyorsanız Codex CLI, Claude Code veya OpenCode kullanın.

Sistem Gereksinimleri

Node.js: Sürüm 20.0+
OS: Windows 10/11, macOS 10.15+, Ubuntu 20.04+ veya Debian 10+

Kurulum

npm install -g @google/gemini-cli

Kurulumu doğrulayın:

gemini --version

Yapılandırma

Adım 1: API Anahtarınızı Alın

TokenLab Dashboard sayfasına giriş yapın
API Keys bölümüne gidin
API anahtarınızı oluşturun ve kopyalayın (format: sk-...)

Adım 2: Ortam Değişkenlerini Ayarlayın

Geçici (mevcut oturum):

export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"

Kalıcı yapılandırma: Kabuk (shell) yapılandırma dosyanıza ekleyin:

Bash
Zsh
Fish

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
source ~/.bashrc

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
source ~/.zshrc

set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"

Değişikliklerin etkili olması için yapılandırmadan sonra terminalinizi yeniden başlatın.

Bilinen kısıtlama: Bazı durumlarda, önbelleğe alınmış bir Google oturumu varsa Gemini CLI, GOOGLE_GEMINI_BASE_URL değişkenini dikkate almayabilir. Bağlantı sorunları yaşıyorsanız, CLI önbelleğini temizlemeyi veya yeni bir terminal oturumu başlatmayı deneyin.

Temel Kullanım

Gemini CLI’yı proje dizininizden başlatın:

cd your-project
gemini

İlk çalıştırmada şunları yapacaksınız:

Bir tema seçin
Güvenlik bildirimini onaylayın
Çalışma dizinine güvenin

Mevcut Modeller

Model	Açıklama
`gemini-2.5-pro`	En yetenekli Gemini modeli
`gemini-3.5-flash`	Çoğu görev için hızlı ve verimli
`gemini-3.1-flash-lite`	Guncel hafif Gemini modeli

Yaygın Komutlar

Bir soru sorun:

> What is the best way to structure a React app?

Kodu analiz edin:

> Explain the code in src/main.ts

Kod oluşturun:

> Create a Python function to parse JSON files

Değişiklikleri gözden geçirin:

> Review the recent git changes and suggest improvements

Yapılandırmayı Doğrulayın

# Ortam değişkenlerini kontrol edin
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# Bağlantıyı test edin
gemini

Sorun Giderme

Bağlantı Hatası

GOOGLE_GEMINI_BASE_URL değişkeninin https://api.tokenlab.sh olarak ayarlandığını doğrulayın
Not: Gemini uç noktası için /v1 son eki yoktur
Ağ bağlantısını kontrol edin

Kimlik Doğrulama Başarısız

GEMINI_API_KEY ortam değişkeninin ayarlandığını doğrulayın
Anahtarın sk- ile başladığını kontrol edin
Anahtarın TokenLab panelinde aktif olduğundan emin olun

Model Mevcut Değil

Gemini modellerinin uygunluğunu tokenlab.sh/en/models adresinden kontrol edin
Farklı bir Gemini model varyantı deneyin

En İyi Uygulamalar

Proje dizininde kullanın

Daha iyi bağlam anlayışı için Gemini CLI’yı her zaman proje kök dizininizden çalıştırın.

Dizinlere dikkatle güvenin

Yalnızca size ait olan dizinlere güvenin. Gemini CLI dosyaları okuyabilir ve değiştirebilir.

Üretilen kodu gözden geçirin

Yapay zeka tarafından oluşturulan kodu projenize işlemeden (commit) önce her zaman gözden geçirin.

Uyumluluk matrisi

Kodlama araçları

Native SDK'lar

Framework'ler ve platformlar

Sohbet uygulamaları

Genel Bakış

Sistem Gereksinimleri

Kurulum

Yapılandırma

Adım 1: API Anahtarınızı Alın

Adım 2: Ortam Değişkenlerini Ayarlayın

Temel Kullanım

Mevcut Modeller

Yaygın Komutlar

Yapılandırmayı Doğrulayın

Sorun Giderme

En İyi Uygulamalar

​Genel Bakış

​Sistem Gereksinimleri

​Kurulum

​Yapılandırma

​Adım 1: API Anahtarınızı Alın

​Adım 2: Ortam Değişkenlerini Ayarlayın

​Temel Kullanım

​Mevcut Modeller

​Yaygın Komutlar

​Yapılandırmayı Doğrulayın

​Sorun Giderme

​En İyi Uygulamalar

Genel Bakış

Sistem Gereksinimleri

Kurulum

Yapılandırma

Adım 1: API Anahtarınızı Alın

Adım 2: Ortam Değişkenlerini Ayarlayın

Temel Kullanım

Mevcut Modeller

Yaygın Komutlar

Yapılandırmayı Doğrulayın

Sorun Giderme

En İyi Uygulamalar