Davet et, 1 ay ücretsiz Pro kazanNasıl çalışır?

Cline CLI nasıl kullanılır? Terminalde Cline için adım adım rehber

Cline CLI nasıl kullanılır: npm ile kurulum, giriş ya da kendi anahtarın, Plan ve Act geçişi, --json ile arayüzsüz çalıştırma, oturumlar, kurallar ve MCP tek rehberde.

Solviera Teknoloji 7 dk okuma

Cline CLI’ı kullanmak için npm install -g cline ile kurarsın, cline auth ile giriş yapar ya da bir sağlayıcı anahtarı eklersin, sonra bir projenin içinde cline çalıştırıp işi anlatırsın. Çoğu kodlama CLI’ının aksine Cline, araç çağrılarını varsayılan olarak kendisi onaylar; önem verdiğin bir depoda --auto-approve false vermeyi unutma.

Bu rehber, Kasım 2026 itibarıyla Cline CLI 3.0’ı (sürüm 3.0.74) anlatıyor: kurulum, giriş, Plan ve Act, onaylar, --json ile arayüzsüz çalıştırma, oturumlar, modeller, kurallar, MCP ve maliyet.

Cline CLI nedir?

Cline bir VS Code eklentisi olarak başladı ve en çok kullanılan açık kodlama ajanlarından biri. Cline CLI aynı ajanı terminale taşıyor. Mayıs 2026’da çıkan 3.0 sürümü, Cline’ın yeni SDK’sı üzerinde yeni bir terminal arayüzüyle baştan yazıldı; yani 2.x CLI için yazılmış rehberler artık güncel değil.

Cline belirli bir modele bağlı değil. Kredili bir Cline hesabı, bir ClinePass aboneliği ya da Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, Ollama veya LM Studio üzerinden yerel bir model ve otuzdan fazla başka sağlayıcı için kendi anahtarını kullanabilirsin.

1. Adım: CLI’ı kur

npm install -g cline

Resmi tek kurulum yolu bu. macOS, Linux ve Windows için hem arm64 hem x64’te hazır ikili dosyalar geliyor; dokümantasyon ile paket en düşük sürüm konusunda farklı şeyler söylediği için garantiye almak adına Node 22 kullan. Sonradan güncellemek için cline update yeterli. En yeni derlemeyi istiyorsan npm install -g cline@nightly nightly kanalını kurar.

2. Adım: giriş yap ya da anahtar ekle

cline auth

Bu komut etkileşimli bir kurulum açar. cline auth cline tarayıcıdan bir Cline hesabına giriş yapar. Sağlayıcıyı soru sormadan ayarlamak için, örneğin bir sunucuda:

cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5

Cline anahtarları ortam değişkenlerinden de okur (ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, CLINE_API_KEY ve diğerleri). Kaydedilen kimlik bilgileri ~/.cline/data/settings/providers.json dosyasına gider.

3. Adım: etkileşimli görünümde çalış

cd my-project
cline

İşi kendi cümlelerinle anlat ya da doğrudan bir görevle başlat: cline -i "add tests for the price formatter". İşe yarayan tuşlar ve komutlar:

  • Tab, Plan ile Act arasında geçiş yapar. Plan modu okur ve tartışır ama dosya düzenleyemez; varsayılan olan Act modu değişiklikleri yapar. cline -p Plan modunda başlatır.
  • Shift+Tab otomatik onayı açar ya da kapatır.
  • @file mesaja bir dosya (ya da görsel) ekler.
  • /model ve /settings kurulumu değiştirir; /mcp sunucuları yönetir; /compact uzun bir konuşmayı kısaltır; /undo son değişikliği geri alır; /history geçmiş oturumları açar.
  • Ctrl+C o anki turu durdurur; çıkmak için iki kez bas ya da Ctrl+D kullan.

Büyük işler için iyi bir alışkanlık: Plan modunda başla, adımlarda anlaş, sonra Act’e geç.

4. Adım: Cline’ın kendi başına ne kadar iş yapacağına karar ver

İnsanları en çok şaşırtan ayar bu. Cline CLI’da durum şöyle:

DurumNe olur
cline (etkileşimli)Sen kapatmadıkça --auto-approve açıktır
cline --auto-approve falseHer araçtan önce Approve tool …? [y/N] diye sorar
cline "task" (tek seferlik) ya da pipe ile girdiYolo modunda çalışır
cline -yYolo modu; Cline’ın kendi yardım metni bunu sandbox dışında tehlikeli diye niteliyor

Kabuk komutları için bir izin ya da engel listesi yok. Bir komutu engellemek için bir PreToolUse hook’u ekle (7. adım). Gerçek bir depoda --auto-approve false ile başla ya da her değişikliği kolayca çöpe atabileceğin temiz bir branch’te çalış.

5. Adım: arayüzsüz çalıştırma ve CI

--json verdiğinde, içine pipe ile bir şey aktardığında ya da çıktısını yönlendirdiğinde Cline etkileşimli görünüm olmadan çalışır:

git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'

--json her satıra bir JSON olayı yazar ve son metni, bitiş nedenini ve token kullanımını içeren bir run_result ile biter. Bilmeye değer diğer bayraklar: -c çalışma klasörünü belirler, --worktree bir git worktree’de çalıştırır, -t saniye cinsinden zaman aşımı koyar, --data-dir de durumu yalıtılmış bir klasörde tutar.

CI’da npm ile kur, gizli bilgi deposundan aldığın bir anahtarla cline auth çalıştır, sonra görevi başlat. Tek seferlik çalıştırmaların her şeyi onayladığını unutma; job’a yalnızca ihtiyaç duyduğu izinleri ver.

6. Adım: oturumlar ve modeller

cline history, geçmiş oturumları devam ettirebileceğin ya da silebileceğin bir seçicide listeler. Birini doğrudan açmak için:

cline history --json --limit 10
cline --id <session-id>

Oturumlar ~/.cline/data/sessions/ altında durur. cline history export <session-id> -o session.html bir oturumu sayfa olarak kaydeder.

Tek bir çalıştırma için model seçmek istiyorsan sağlayıcı için -P, model için -m kullan; --thinking none, low, medium, high ya da xhigh değerlerini alır. Etkileşimli görünümde /model kullan. Cline hesabıyla ve model seçmeden çalışırsan 3.0.73 sürümünden bu yana varsayılan model Claude Sonnet 5.5.

7. Adım: kurallar, hook’lar ve MCP sunucuları

Kurallar. Proje kurallarını .clinerules/ ya da .cline/rules/ içine, genel kuralları ~/.cline/rules içine koy. Cline proje kökündeki AGENTS.md’yi de okur; yani Codex ya da başka ajanlar için zaten tuttuğun dosya olduğu gibi çalışır. İçine ne yazacağını CLAUDE.md ve AGENTS.md rehberimiz anlatıyor.

Skill’ler ve hook’lar. Skill’ler .cline/skills/ ya da .agents/skills/ içinde durur ve /skill-name olarak çalışır; cline skill add <owner/repo> yeni bir tane kurar. Hook’lar, olayın adını taşıyan çalıştırılabilir betiklerdir, örneğin .cline/hooks/PreToolUse.sh; riskli komutları engellemenin yolu da bunlar.

MCP. Sunucuları komut satırından ekle:

cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yes

Bunlar ~/.cline/data/settings/cline_mcp_settings.json dosyasında mcpServers altına kaydedilir. cline mcp bir menü açar, cline mcp remove <name> de bir sunucuyu siler.

Cline CLI’ın maliyeti (Kasım 2026 itibarıyla)

SeçenekFiyatNotlar
Cline CLIÜcretsizAracın kendisi
Cline kredisiKullandıkça ödeapp.cline.bot üzerinden alınır; bazı ücretsiz modeller küçük bir kotayla gelir
ClinePassAylık 9,99 $Seçili açık modellerde daha yüksek limitler
Kendi anahtarınSağlayıcının fiyatıAnthropic, OpenAI, OpenRouter, yerel modeller ve daha fazlası
EnterpriseÖzelSSO, SLA, rol tabanlı erişim, merkezi faturalama

Karar vermeden önce Cline’ın fiyat sayfasına bak.

Sık yapılan hatalar

  • Otomatik onayın varsayılan olarak açık olması. Kuruluma güvenene kadar --auto-approve false ile kapat.
  • 2.x rehberlerini izlemek. 3.0’daki baştan yazım komutları ve bayrakları değiştirdi. Emin değilsen kendi sürümünde cline --help çalıştır; -y gibi bazı bayraklar çevrimiçi başvuru kılavuzunda yok.
  • Arayüzsüz çalıştırmada OAuth. OAuth sağlayıcıları arayüzsüz çalıştırmalarda asla tarayıcı açmaz. O makinede önce bir kez cline auth <provider> çalıştır.
  • Takılı kalan arka plan süreçleri. cline doctor kurulumu kontrol eder, cline doctor fix de eskimiş süreçleri durdurur.
  • .clineignore yolun sonunda. Cline’ı belirli dosyalardan uzak tutmak için bir PreToolUse hook’u kullan.

Cline CLI’ı diğer CLI’ların yanında AgentVera’da çalıştırmak

Tek kullandığın ajan Cline ise kendi arayüzü sana yetebilir. İş, Cline aynı projede Claude Code, Codex ya da Gemini CLI’ın yanında çalışınca zorlaşıyor. AgentVera, bu CLI’ları kendi kurulumların ve anahtarlarınla gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Cline desteği şöyle çalışıyor:

  • Her ajana bir oturum. AgentVera, Cline’ın oluşturduğu oturumu cline history --json ile bulur ve sonraki açılışlarda cline --id <id> ile yeniden açar; böylece konuşma uygulama yeniden başlasa da kaybolmaz.
  • Model ve efor. Seçtiğin model --model ile, efor seviyesi de --thinking ile aktarılır.
  • Her ajana bir hesap. Ayarlar → Hesaplar bölümünden Anthropic, OpenAI ya da OpenRouter anahtarları ekleyebilirsin; her Cline hesabı kendi sağlayıcı dosyasını alır, geri kalan her şey ortak kalır.
  • MCP ve token’lar. AgentVera’nın MCP yöneticisindeki sunucular Cline’a onun MCP ayar dosyası üzerinden ulaşır; AgentVera da token bütçeleri için Cline’ın token kullanımını okur.
  • Paneller ve inceleme. Cline’ı çalışma alanı ızgarasında diğer ajanların yanında çalıştır ve değişikliklerini kod incelemesiyle kontrol et.

Ücretsiz plan aynı anda 2 ajan çalıştırır; MCP, Git, Docker, SSH, kod incelemesi ve token tasarrufu içerir. Pro aylık 9,99 $ ve ajan sınırı yok; daha önce hiç deneme kullanmadıysan uygulamaya ilk girişin Pro’yu kart istemeden 7 gün açar. Denemek için AgentVera’yı indir.

Toparlarsak

Cline CLI’a başlamak üç komut alıyor: npm install -g cline, cline auth ve cline. Asıl önemli kararlar hemen ardından geliyor: gerçek işte otomatik onayı kapat, büyük işlerde harekete geçmeden önce plan yap, projenin kurallarını AGENTS.md ya da .clinerules/ içinde tut ve CI’daki tek seferlik çalıştırmalara yalnızca ihtiyaç duydukları erişimi ver.

Kaynaklar: Cline CLI başvuru kılavuzu, CLI’a genel bakış, yetkilendirme, Cline kuralları, MCP, CLI değişiklik günlüğü.

Sık sorulanlar

Cline CLI ücretsiz mi?

CLI’ın kendisi ücretsiz. Ödediğin şey model: app.cline.bot üzerinden alınan Cline kredisi, bir ClinePass aboneliği (Kasım 2026 itibarıyla aylık 9,99 $, seçili açık modeller için) ya da Anthropic, OpenAI, OpenRouter ve birçok başka sağlayıcıdan kendi API anahtarın. Bazı ücretsiz modeller küçük bir kotayla gelir.

Cline CLI dosyaları düzenlemeden önce sorar mı?

Varsayılan olarak hayır. --auto-approve varsayılanda true, cline "task" gibi tek seferlik bir çalıştırma da yolo modunda çalışır. Her araç için evet/hayır sorusu almak istiyorsan --auto-approve false ile başlat ya da etkileşimli görünümde otomatik onayı Shift+Tab ile aç kapat.

Bir Cline CLI oturumuna nasıl geri dönerim?

Geçmiş bir oturumu listeden seçmek için cline history, doğrudan açmak için cline --id <session-id> çalıştır. cline history --json oturumları kimlikleriyle birlikte listeler; betiklerde işine yarar.

Cline CLI AGENTS.md okur mu?

Evet. Kendi kural klasörlerinin (projede .clinerules/ ya da .cline/rules/, genel olarak ~/.cline/rules) yanında Cline, proje kökündeki AGENTS.md’yi ve ayrıca .cursorrules ile .windsurfrules dosyalarını da okur.

Claude Code ya da ChatGPT aboneliğimi Cline CLI ile kullanabilir miyim?

Cline, sağlayıcıları arasında bir Claude Code sağlayıcısı ve ChatGPT (openai-codex) girişi sunuyor. Bir aboneliği başka bir araç üzerinden kullanmadan önce sağlayıcının kendi koşullarına bak.

Ajanlarını bir masaya topla.

AgentVera’yı ücretsiz indir; kurulu CLI’ların hazır.

Diğer yazılar