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

Adres: https://agentvera.dev/blog/cline-cli-nasil-kullanilir/ · Yayın: 2026-11-15

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.

**Kısaca:**

- npm install -g cline ile kur, cline auth ile bir Cline hesabına giriş yap ya da kendi sağlayıcı anahtarını ekle, sonra bir projede cline çalıştırıp işi anlat. Tab, Plan ile Act arasında geçiş yapar.
- Onay soruları varsayılan olarak kapalı: --auto-approve true gelir, tek seferlik ya da pipe ile beslenen çalıştırmalar yolo modunda çalışır. Cline’ın her araçtan önce sormasını istiyorsan --auto-approve false ver.
- CLI ücretsiz; çıkarımı Cline kredisi, ClinePass (Kasım 2026 itibarıyla aylık 9,99 $) ya da kendi API anahtarlarınla ödersin. Kurallar .clinerules/ ya da AGENTS.md’ye, MCP sunucuları cline_mcp_settings.json’a gider.

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](https://cline.bot "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

```bash
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

```bash
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:

```bash
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ış

```bash
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:

| 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:

```bash
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:

```bash
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](/blog/claude-md-nasil-yazilir/ "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:

```bash
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](https://cline.bot/pricing "Cline fiyatları") 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](/ "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](/ajanlar/cline/ "AgentVera’da Cline CLI") şö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](/ozellikler/mcp-yoneticisi/ "MCP yöneticisi") sunucular Cline’a onun MCP ayar dosyası üzerinden ulaşır; AgentVera da [token bütçeleri](/ozellikler/token-butcesi/ "Token bütçesi") için Cline’ın token kullanımını okur.
- **Paneller ve inceleme.** Cline’ı [çalışma alanı](/ozellikler/calisma-alani/ "Çalışma alanı") ızgarasında diğer ajanların yanında çalıştır ve değişikliklerini [kod incelemesiyle](/ozellikler/kod-incelemesi/ "Kod incelemesi") 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](/indir/ "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](https://docs.cline.bot/cli/cli-reference "Cline CLI başvuru kılavuzu"), [CLI’a genel bakış](https://docs.cline.bot/usage/cli-overview "Cline CLI’a genel bakış"), [yetkilendirme](https://docs.cline.bot/getting-started/authorizing-with-cline "Cline ile yetkilendirme"), [Cline kuralları](https://docs.cline.bot/customization/cline-rules "Cline kuralları"), [MCP](https://docs.cline.bot/mcp/mcp-overview "Cline MCP"), [CLI değişiklik günlüğü](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md "Cline 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.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz plan aynı anda 2 ajan çalıştırır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/