CLI Referans

Claude Code CLI Kılavuzu

Tüm komut ve parametrelerin detaylı açıklaması

📝 Basit Anlatım (Herkes İçin)

Claude Code, terminalde (komut satırında) çalışan bir yapay zeka asistanıdır. Kod yazmanıza, dosya düzenlemenize ve projelerinizi yönetmenize yardımcı olur.

Nasıl Başlatılır?

  • claude → Sohbet modunu açar
  • claude "sorunuz" → Direkt soru sorar
  • claude -p "soru" → Cevabı yazdırır ve çıkar

Oturum Devam Ettirme

  • claude -c → Son konuşmaya devam
  • claude -r → Eski oturumları listele
  • claude -r abc123 → Belirli oturumu aç

🔧 Teknik Detaylar (Geliştiriciler İçin)

Temel Parametreler

Parametre Açıklama Örnek
-p, --print Cevabı yazdır ve çık (pipe için ideal) claude -p "Merhaba"
-c, --continue Son konuşmaya devam et claude -c
-r, --resume [id] Oturum seç veya ID ile devam et claude -r abc123
-d, --debug [filter] Debug modu (opsiyonel filtreleme) claude -d "api,hooks"
-v, --version Versiyon numarasını göster claude -v
-h, --help Yardım menüsünü göster claude -h

Model & Agent Ayarları

Parametre Açıklama Örnek
--model <model> Kullanılacak model (sonnet, opus, haiku) --model opus
--fallback-model Ana model meşgulse alternatif model --fallback-model haiku
--agent <agent> Oturum için özel agent kullan --agent reviewer
--agents <json> Özel agent'lar tanımla (JSON) --agents '{"test":...}'

İzinler & Güvenlik

Parametre Açıklama Risk
--permission-mode İzin modu: default, acceptEdits, plan, delegate, dontAsk, bypassPermissions Orta
--allowedTools İzin verilen araçlar listesi Düşük
--disallowedTools Yasaklı araçlar listesi Düşük
--dangerously-skip-permissions Tüm izin kontrollerini atla (sandbox için) Yüksek ⚠️
--add-dir <dirs> Ek dizinlere erişim izni ver Orta

Sistem Prompt Ayarları

Parametre Açıklama Örnek
--system-prompt Varsayılan yerine özel sistem promptu --system-prompt "Sen bir Python uzmanısın"
--append-system-prompt Varsayılana ek prompt ekle --append-system-prompt "Türkçe cevap ver"

Giriş/Çıkış Formatları

Parametre Açıklama Değerler
--input-format Giriş formatı (sadece --print ile) text, stream-json
--output-format Çıkış formatı (sadece --print ile) text, json, stream-json
--json-schema Yapılandırılmış çıktı için JSON şeması {"type":"object",...}
--include-partial-messages Kısmi mesajları dahil et (stream için) -

MCP & Plugin Sistemi

Parametre Açıklama Örnek
--mcp-config <configs> MCP sunucu konfigürasyonu yükle --mcp-config server.json
--strict-mcp-config Sadece belirtilen MCP'yi kullan -
--plugin-dir <paths> Ek plugin dizinleri yükle --plugin-dir ./my-plugins
--disable-slash-commands Tüm skill'leri devre dışı bırak -

Oturum & Bütçe Kontrolü

Parametre Açıklama Örnek
--session-id <uuid> Belirli oturum ID'si kullan --session-id abc-123-def
--fork-session Devam ederken yeni oturum ID'si oluştur --resume abc --fork-session
--no-session-persistence Oturumu kaydetme (--print ile) -
--max-budget-usd <$> Maksimum harcama limiti (USD) --max-budget-usd 5.00

Alt Komutlar (Subcommands)

claude doctor

Auto-updater sağlık kontrolü yapar

claude install [target]

Native build kur (stable, latest, versiyon)

claude mcp

MCP sunucularını yapılandır ve yönet

claude plugin

Plugin'leri yönet

claude setup-token

Uzun süreli auth token ayarla

claude update

Güncellemeleri kontrol et ve kur

Kullanışlı Örnekler

# Opus modeli ile başlat

claude --model opus

# Sadece okuma ve git izni ver

claude --allowedTools "Read Bash(git:*)"

# JSON çıktı al

claude -p "3 ülke say" --output-format json

# Plan modunda başlat

claude --permission-mode plan

# Bütçe limitli (5 USD)

claude -p "Analiz yap" --max-budget-usd 5

Hızlı Referans Kartı

Başlatma

  • claude → Sohbet
  • claude -p → Tek seferlik
  • claude -c → Devam
  • claude -r → Oturum seç

Model

  • --model sonnet → Hızlı
  • --model opus → Güçlü
  • --model haiku → Ekonomik

Çıktı

  • --output-format text
  • --output-format json
  • --output-format stream-json