Claude Code rehberi — kullandıkça öde anahtarıyla günlük kullanım: model değiştirme, maliyet hesaplama ve bağlam yönetimi

Claude Code kullanımı dört adımda özetlenebilir: proje klasöründe claude çalıştırın, bir kez /init çalıştırarak CLAUDE.md oluşturmasını sağlayın, görevi Çince açıklayıp dosya yolunu ekleyin ve önerdiği değişiklikleri inceleyerek kabul edip etmeyeceğinize karar verin. Terminalde çalışan bir programlama asistanıdır; dosyaları okur, değiştirir ve testleri çalıştırır, işe başlamadan önce izninizi ister. Pro veya Max aboneliğiyle giriş yaparak ya da kullanıma göre ücretlendirilen bir API anahtarı ayarlayarak kullanılabilir. Anahtar kullanıldığında her adım token bazında ücretlendirildiğinden günlük kullanımın üç odağı vardır: göreve göre model değiştirmek, bir oturumun maliyetini bilmek ve bağlamı kısa tutmak.

İnternetteki Claude Code eğitimlerinin neredeyse tamamı abonelikle giriş yapılacağını varsayar. Bu sayfa, aboneliği olmayan veya 5 saatlik kullanım penceresine takılmak istemeyen ve kullanıma göre ücretlendirilen anahtar kullanan kişiler içindir. Henüz kurmadıysanız önce Claude Code kurulum eğitimine bakın; kurup bağladıktan sonra buraya dönün.

İlk kullanım: dört işlem

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Her dosya değişikliğinden veya komut çalıştırmadan önce size sorar. Yön yanlışsa durdurmak için Esc tuşuna basın, ardından /rewind ile önceki kontrol noktasına dönün; kod ve konuşma birlikte geri alınır. /init tarafından oluşturulan CLAUDE.md yalnızca bir taslaktır; aşağıda onu nasıl kısaltacağınızı anlatan özel bir bölüm vardır.

API anahtarı kullanırken bir oturum nasıl ücretlendirilir?

Claude Code her istek gönderdiğinde sistem istemini, CLAUDE.md dosyasının içeriğini, tüm konuşmayı ve okunan dosya içeriğini yeniden gönderir; yeni içerik sona eklenir. Değişmeyen ön kısım önbellekten okunur: önbellek okuma, girdi fiyatının %10'u; önbelleğe yazma ise girdi fiyatının 1,25 katıdır. Bu nedenle bir oturumun maliyetinin büyük kısmı çoğu zaman “eski konuşmayı yeniden okumaktır”.

Aşağıdaki tablo Anthropic'in resmi maliyet belgesindeki örnek oturumu kullanır — 1.200 girdi, 5.300 çıktı, 940.000 önbellek okuma ve 50.000 önbellek yazma token'ı — ve Kunavo ücretleriyle dört modelin her birinde hesaplama yapar:

Claude Sonnet 5 üzerinde bu oturum faturasının yaklaşık 85%'ı önbellek okuma ve yazmadır. Başka bir deyişle maliyeti belirleyen, kaç karakter yazdığınız değil konuşmanın ne kadar uzadığıdır; sonraki “bağlam temizliği” bölümünün nedeni de budur.

Kendi rakamlarınızı görmek için Claude Code içinde /usage komutunu çalıştırın (/cost bunun takma adıdır); dört token türünü listeler. Yanındaki tutar ise Claude Code tarafından Anthropic liste fiyatlarıyla yerel olarak tahmin edilir. Kunavo kullanırken gerçek ücretlendirme için kullanım sayfasını esas alın; burada her modelin token sayıları (önbellek okuma ve yazma dahil) ve ücretlendirme tutarı bulunur.

Göreve göre model değiştirme

Önce ~/.claude/settings.json içindeki env bölümünde her takma adı gerçek modele eşleyin. Bu dosyaya yazarsanız editör uzantıları ve arka plan işlemleri de okuyabilir; projeye yazılıp commit edilecek .claude/settings.json dosyasına yazmayın. Takma adlar mutlaka eşleşmelidir: Claude Code'un varsayılan modeli ve opus takma adı en yeni Opus'a yönelir; Kunavo henüz sunmuyorsa eşleme yapılmadığında ilk istek 404 döner. sonnet takma adı Sonnet 5.5'e yönelir ve Kunavo bu modeli sunmaz; ANTHROPIC_DEFAULT_SONNET_MODEL eksikse /model sonnet, opusplan yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar 404 döner. Aşağıdaki yapılandırma opus takma adını Claude Opus 5.5 (claude-opus-5-5) ile eşler; Claude Code v2.1.280 veya üzeri gerekir. Daha eski bir sürüm kullanıyorsanız önce claude update çalıştırın.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Ayarladıktan sonra geçiş tek satırdır:

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model seçimi sonraki yeni oturumlar için varsayılan olarak kaydeder; yalnızca bu sefer değiştirmek istiyorsanız, parametresiz /model komutunu çalıştırın ve menüde s tuşuna basın. Kunavo'da ANTHROPIC_DEFAULT_HAIKU_MODEL ayarını atlayamazsınız: ayar yapılmazsa haiku takma adı Kunavo'nun sunmadığı bir model adı ister (v2.1.293'ten itibaren Haiku 5.5); /model haiku ve haiku olarak ayarlanmış alt ajanlar 404 hatası verir. Bu ayar ayrıca Claude Code'un arka planda kendi başına oluşturduğu özet ve başlıklar için hangi modelin kullanılacağını belirler; en ucuz modeli seçmek tasarruf sağlar.

Kunavo'da Claude Opus 5.5 için fiyat $2,80 / $14,00, Claude Sonnet 5 için fiyat $1,40 / $7,00 seviyesindedir; Claude Haiku 4.5 için birim fiyat, Claude Sonnet 5 için olan birim fiyatın yaklaşık 1/2 kadarıdır; Claude Fable 5 için birim fiyat ise bu referans fiyatın 5 katıdır. Resmi fiyatlarla karşılaştırma: Claude Sonnet 5 Anthropic'in resmi fiyatından yaklaşık 30% daha ucuz, Claude Opus 5.5 Anthropic'in resmi fiyatından yaklaşık 30% daha ucuz, Claude Haiku 4.5 Anthropic'in resmi fiyatından yaklaşık 30% daha ucuz, Claude Fable 5 Anthropic'in resmi fiyatından yaklaşık 30% daha ucuz.

Model değiştirmeyi görevin ortasına değil, görevler arasına koyun.Her modelin önbelleği ayrıdır: görev ortasında /model yaptığınızda sonraki istek tüm konuşmayı önbelleksiz fiyatla yeniden okumak zorunda kalır; önbellek hâlâ geçerliyken Claude Code önce onayınızı ister. Önce /clear yapıp sonra geçin; yeniden okunan yalnızca kısa yeni konuşma olur. Düşünme token'ları çıktı fiyatından ücretlendirilir; basit görevlerde düşünme düzeyini düşürmek için /effort kullanabilirsiniz. Bu da görevin başında ayarlanmalıdır; çoğu modelde ortada effort değiştirmek önbelleği geçersiz kılar.

CLAUDE.md: Tekrar tekrar açıklamanız gerekenleri yazın

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md her oturumun başında yüklenir ve sonrasında her isteğe eklenir; çoğunlukla önbellek okuma fiyatından ücretlendirilir. Anthropic bir dosyanın 200 satırın altında tutulmasını önerir; uzadıkça bağlam maliyeti artar ve uyum azalır. Koddan anlaşılabilen şeyleri yazmayın; yalnızca insanlar için not bırakmak istiyorsanız <!-- --> içine alabilirsiniz, bağlama gönderilmeden önce çıkarılır.

Yaygın bir yanlış anlama daha vardır: oturumun ortasında CLAUDE.md dosyasını değiştirmek hemen etkili olmaz; yeni sürümün okunması için /clear, /compact veya yeniden başlatma gerekir.

Bağlam temizliği: Her adımı ucuz tutun

• İlgisiz görevler arasında /clear kullanın.Bu, yeni bir konuşma açar ve kendi başına maliyet oluşturmaz; eski konuşma daha sonra /resume ile bulunabilir.
• Aynı görev fazla uzadığında /compact kullanın.Korunacak noktaları ekleyebilirsiniz; örneğin /compact 保留測試輸出和改過的檔案. Bir özet isteği gönderir; önbellek hâlâ geçerliyken en ucuzdur. Uzun süre ara verdikten sonra compact kullanırsanız özet isteği tüm geçmişi önbelleksiz fiyatla yeniden okumak zorunda kalır.
• Yanlış yöne gittiyseniz /rewind.Geri alınan bölüm daha önce önbelleğe alınmış ön kısımdır; compact'tan daha ucuzdur.
• Anahtar modunda önbellek varsayılan olarak yalnızca 5 dakika yaşar.5 dakikadan uzun süre ayrılıp döndüğünüzde ilk adım tüm önceki metni girdi fiyatının 1,25 katıyla yeniden önbelleğe yazar. Toplantıya veya yemeğe gitmeden önce /compact ya da /clear ile bitirin.
• Bağlamı neyin doldurduğunu görmek için /context kullanın.Kunavo'da bu sayı yerel bir tahmindir; Kunavo şu anda /v1/messages/count_tokens sunmaz. Otomatik sıkıştırma ve oturumun kendisi etkilenmez.
• Kullanmadığınız MCP sunucularını /mcp içinde kapatın.Anthropic belgeleri, özel bir ANTHROPIC_BASE_URL ayarlandığında araç aramanın (tool search) devre dışı kaldığını ve MCP araç tanımlarının gecikmeli yüklenmek yerine her isteğe doğrudan eklendiğini belirtir.
• Görevi açıklarken dosya yolunu ekleyin.“Doğrulamayı biraz değiştir” her yerde arama yapmasına ve çok sayıda dosya okumasına neden olur; “src/api/user.ts doğrulamasını zod kullanacak şekilde değiştir” yalnızca gerekli olanı okur.

“Çalıştırabilir miyim?” sorusunu azaltmak için yalnızca okuma ve doğrulama komutlarını önceden onaylamanız önerilir. Tüm onayları tek seferde atlayan seçenek yalnızca tamamen gözden çıkarılabilir ortamlarda kullanılmalıdır; gerekçe --dangerously-skip-permissions açıklamasında (İngilizce) yer alır. Önbellek ücretlendirmesi için önbellek belgelerine bakın.

Harcama sınırı ve ödeme

Anahtar yönetimi sayfasında Claude Code için özel bir anahtar oluşturun ve aylık harcama sınırı belirleyin. Sınıra ulaşıldığında bu anahtarın istekleri 402 döndürür, ücretlendirme devam etmez; kontrolsüz döngü de yalnızca bu sınıra kadar harcar. Aynı sayfada IP beyaz listesi de ayarlanabilir.

Hesap ön ödemelidir: minimum yükleme $10, bakiye sona ermez ve başarısız istekler ücretlendirilmez. Tayvan'da uluslararası kredi kartları (Visa, Mastercard, Amex, JCB, UnionPay) veya Apple Pay ve Google Pay ile bakiye yüklenebilir; şu anda JKoPay ve LINE Pay gibi yerel kanallar yoktur. Ayrıntılar için Claude Code ücretleri sayfasına bakın.

Abonelik ne zaman daha hesaplıdır?

Her gün uzun süre etkileşim kuran ve ayda çok sayıda adım çalıştıran kişiler için sabit abonelik ücreti genellikle kullanıma göre ücretlendirmeden daha ucuzdur. Hesaplamak için tek bir bölme yeterlidir: aylık ücret ÷ adım başına maliyet = başa baş adım sayısı. Claude Sonnet 5 için adım başına yaklaşık $0,043 (önbellek hariç) varsayılırsa, ayda bu sayıdan az çalıştırmak kullanıma göre ücretlendirmeyi daha ucuz yapar; hiç çalışmadığınız aylar da $0'dır. Güncel plan ücretleri ve tam hesaplama Claude Code maliyetleri sayfasında yer alır; burada tekrarlanmamıştır.

Bu seçimin ödünleşimini de açıkça belirtelim: Kunavo üzerinden paylaşılan kapasite kullanılır; özel kota veya sözleşmeli SLA yoktur. Garantili kota ya da SLA'ya ihtiyaç duyan ekipler doğrudan Anthropic'ten satın almalıdır. Bağlantı ayarlarının tam açıklaması Claude Code entegrasyon belgelerinde (İngilizce) bulunur.

Sık sorulan sorular