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 -pPlan modunda başlatır.Shift+Tabotomatik onayı açar ya da kapatır.@filemesaja bir dosya (ya da görsel) ekler./modelve/settingskurulumu değiştirir;/mcpsunucuları yönetir;/compactuzun bir konuşmayı kısaltır;/undoson değişikliği geri alır;/historygeçmiş oturumları açar.Ctrl+Co anki turu durdurur; çıkmak için iki kez bas ya daCtrl+Dkullan.
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:
| Durum | Ne olur |
|---|---|
cline (etkileşimli) | Sen kapatmadıkça --auto-approve açıktır |
cline --auto-approve false | Her araçtan önce Approve tool …? [y/N] diye sorar |
cline "task" (tek seferlik) ya da pipe ile girdi | Yolo modunda çalışır |
cline -y | Yolo 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çenek | Fiyat | Notlar |
|---|---|---|
| Cline CLI | Ücretsiz | Aracın kendisi |
| Cline kredisi | Kullandıkça öde | app.cline.bot üzerinden alınır; bazı ücretsiz modeller küçük bir kotayla gelir |
| ClinePass | Aylık 9,99 $ | Seçili açık modellerde daha yüksek limitler |
| Kendi anahtarın | Sağlayıcının fiyatı | Anthropic, OpenAI, OpenRouter, yerel modeller ve daha fazlası |
| Enterprise | Özel | SSO, 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 falseile 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;-ygibi 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 doctorkurulumu kontrol eder,cline doctor fixde eskimiş süreçleri durdurur. .clineignoreyolun sonunda. Cline’ı belirli dosyalardan uzak tutmak için birPreToolUsehook’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 --jsonile bulur ve sonraki açılışlardacline --id <id>ile yeniden açar; böylece konuşma uygulama yeniden başlasa da kaybolmaz. - Model ve efor. Seçtiğin model
--modelile, efor seviyesi de--thinkingile 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üğü.