Neden Token Yönetimi Önemli?

Claude Code, terminal üzerinden çalışan bir yapay zeka kodlama aracıdır. Dosyalarınızı okur, komutlar çalıştırır, hata ayıklar ve doğrudan kod tabanınızla etkileşime girer. Ancak tüm bu gücün bir sınırı var: bağlam penceresi (context window).

Her gönderdiğiniz mesaj, her alınan yanıt, okunan dosya ve çalıştırılan komutun çıktısı bu pencereye eklenir. 200.000 tokenlık limit doldukça kalite düşer, yanıtlar yavaşlar ve daha önce yapılan kararlar unutulur. Bu duruma "bağlam çürümesi" (context rot) denir.

Context'i Temiz Tutmak

Token verimliliği, pahalı kaynaklara sahip olmakla değil, elimizdeki kaynakları doğru kullanmakla ilgilidir. İşte token tüketimini kontrol altında tutmanın temel prensipleri:

1. Her Sesi Ölçün

Optimizasyon yapamadan önce neyin ne kadar token tükettiğini bilmeniz gerekir. /context komutu bunu tam olarak gösterir.

# Token dağılımını görüntüle
/context

# Örnek çıktı:
System prompt:   18.400 tokens  (9%)
Tool definitions: 14.200 tokens  (7%)
CLAUDE.md files:  4.800 tokens  (2%)
Skills:           2.100 tokens  (1%)
Conversation:    44.200 tokens (22%)
──────────────────────────────────────────
Total:           83.700 / 200.000 tokens

# Kümülatif maliyet raporu
/cost

2. /compact ile Konuşmayı Sıkıştır

Büyük bir görevi tamamladıktan sonra, bir sonrakine geçmeden önce /compact komutunu çalıştırın. Bu, konuşma geçmişini bir özete indirger ve bağlamda önemli olan kararları korur.

3. Görev Geçişlerinde /clear Kullanın

/clear komutu tüm konuşma geçmişini siler ve temiz bir sayfa açar. Farklı bir göreve (ör. auth kodlamasından CSS styling'e) geçerken kullanın.

4. CLAUDE.md Dosyasını Sadeleştirin

CLAUDE.md dosyası her oturumun başında otomatik olarak yüklenir ve her mesajda context'e eklenir. Şişirilmiş bir CLAUDE.md, her turda token çalar. Yalnızca gerçekten gerekli bilgileri tutun.

5. @ Referansları ile Dosya Hedefleyin

Claude'un kodu keşfetmesine izin vermek yerine doğrudan dosyayı referans gösterin. Bu, %30-40 token tasarrufu sağlayabilir.

# ❌ Verimsiz: Claude kodu arar
"auth kodundaki bug'ı bul"

# ✅ Verimli: Doğrudan hedefleme
"@src/api/auth.js dosyasındaki refresh token bug'ını düzelt"

# MCP sunucularını ihtiyaç dışında devre dışı bırakın
# Linear MCP: ~14K token harcıyor (7% context)

Temel Slash Komutları

Claude Code v1.0.86 ile birlikte yeni izleme komutları eklendi. Aşağıda kullanım sıklığı ve önem düzeyine göre gruplandırılmış komutların listesi bulunmaktadır:

Skills: Yeniden Kullanılabilir AI İş Akışları

Skills (Beceriler), Claude Code'un en güçlü özelliklerinden biridir. Bir skill, Claude'un belirli bir görev için izlemesi gereken ayrıntılı talimatları içeren bir SKILL.md dosyasıdır.

Skills'in mimarisi aşamalı açıklanma (progressive disclosure) prensibi üzerine kuruludur: Yalnızca YAML frontmatter (isim + açıklama) her oturumda yüklenir. İçeriğin geri kalanı siz skill'i çağırana dek context'e eklenmez.

Yerleşik (Bundled) Skills

Claude Code, her oturumda hazır kullanılabilecek yerleşik skilllerle gelir:

Skill vs Slash Command Farkı

Claude Code 2.1 ile skills ve slash commands büyük ölçüde birleştirildi. Her ikisi de /skill-adı söz dizimiyle çağrılır. Temel fark şudur:

Kendi Skill'inizi Yazın

Kişisel skill'ler ~/.claude/skills/ klasörüne, proje bazlı skill'ler ise .claude/skills/ klasörüne kaydedilir. Her skill iki parçadan oluşur:

Skill Yükleme ve Compaction Kuralları

Skill'lerin compaction (sıkıştırma) sonrasında nasıl davrandığını anlamak önemlidir:

Skill Çağırma

# Manuel çağırma
/summarize-changes

# Veya doğal dil ile (autoInvoke: true ise otomatik)
"son değişikliklerime bak ve commit mesajı öner"

# Kişisel skill listesini görüntüle
/help

# Bir skill'i kaldır (proje bazlı)
rm -rf .claude/skills/skill-adi

Altın Kurallar

Aşağıdaki alışkanlıklar, Claude Code deneyiminizi köklü biçimde değiştirecektir: