Claude Code'da Claude Haiku 5.5 Nasıl Kullanılır ve Alt Ajan Modeliniz Olarak

Claude Code'da Claude Haiku 5.5'i kullanmak için claude update ile v2.1.293 veya sonraki bir sürüme güncelleyin, ardından claude --model claude-haiku-5-5 ile bir oturum başlatın veya bir oturumun içinde /model claude-haiku-5-5 komutunu çalıştırın. Çoğu kişi için daha büyük kazanç, onu bir alt ajan olarak çalıştırmaktır: bir alt ajan dosyasına model: haiku yazın ve Sonnet 5.5 veya Opus 5.5'in ona aramaları, test çalıştırmalarını ve özetleri iletmesine izin verin. Bir API anahtarıyla, 100 bin tokene kadar olan istemler için milyon giriş/çıkış tokenı başına 0,10 dolar/0,50 dolar, bunun üzerindeki istemler için ise 0,50 dolar/2,50 dolardır.

Aşağıda: kurulum, haiku takma adı tuzağı, çaba, alt ajan dosyaları, 100 bin token fiyat adımı ve Sonnet veya Opus'un ne zaman lider olması gerektiği. Modelin kendisi için Claude Haiku 5.5 nedir başlıklı yazıyı okuyun. Kodunuz API'leri çağırıyorsa, bir Haiku alt ajanının sizin için çalıştırabileceği test senaryolarını Apidog tutar.

Claude Code'da Claude Haiku 5.5'e bir bakış

Adım 1: Claude Code'u güncelleyin

Haiku 5.5, Claude Code v2.1.293 veya sonraki bir sürüme ihtiyaç duyar. Değişiklik günlüğü girişi bunu "şimdi Anthropic API'sindeki varsayılan Haiku modeli" olarak adlandırıyor.

claude update

Claude Code Ücretsiz planda değildir. Ücretsiz kullanıcılar Claude.ai uygulamalarında Haiku 5.5'i seçebilir, ancak Claude Code için Pro, Max, Team, Enterprise veya bir Anthropic API anahtarı gereklidir. claude.com/pricing'e göre, Pro yıllık faturalandırıldığında ayda 17 dolar veya aylık 20 dolar, Max ise 100 dolardan başlar.

Adım 2: Ana model olarak Haiku 5.5'i seçin

claude --model claude-haiku-5-5

Çalışan bir oturum içinde, /model claude-haiku-5-5 aynı işlemi yapar. Kaydedilmiş model ayarınız haiku ise, Haiku 4.5 üzerinde kaydedilen bir oturum Haiku 5.5 üzerinde devam eder.

haiku takma adı yalnızca Anthropic API'sinde Haiku 5.5 anlamına gelir

Herhangi bir bulut sağlayıcısında, bir alt ajan dosyasında /model haiku ve model: haiku size Haiku 4.5 verir. Bunun yerine tam kimliği oraya sabitleyin: Google Cloud'da ve AWS'deki Claude Platformu'nda claude-haiku-5-5, Foundry'de dağıtım adınız ve Amazon Bedrock'ta us.anthropic.claude-haiku-5-5 gibi bir çıkarım profili kimliği. Veya takma adı ANTHROPIC_DEFAULT_HAIKU_MODEL (Adım 5) ile işaretleyin.

Adım 3: Bir çaba seviyesi seçin

Haiku 5.5, çaba kontrolüne sahip ilk Haiku modelidir: Claude Code'da medium ile başlayan low, medium, high, xhigh ve max.

claude --model claude-haiku-5-5 --effort high

Bir oturumda, /effort low mevcut model için bir seviye kaydeder. Anthropic'in istem rehberi, kısa araç görevleri ve yüksek hacimli istekler için low, çoğu iş için medium ve daha uzun ajan görevleri için high'ı önerir. Değerlendirmelerinizin bir kazanç gösterdiği işler için xhigh ve max'ı saklayın.

Düşünme açık kalır. Claude Code'da Haiku 5.5'te kapatamazsınız; alwaysThinkingEnabled: false ve MAX_THINKING_TOKENS=0'ın etkisi yoktur. (Ham Mesajlar API'si onu high veya altında devre dışı bırakabilir.) Daha az düşünme tokenı istediğinizde çabayı düşürün.

Adım 4: Haiku 5.5'i bir alt ajan olarak çalıştırın

Anthropic, Haiku 5.5'in "kodlama işlerinde bir alt ajan olarak Opus 5.5 ve Sonnet 5.5 ile iyi eşleştiğini" söylüyor. Alt ajanlar, .claude/agents/ (proje) veya ~/.claude/agents/ (tüm projeler) içinde YAML önyazılı Markdown dosyalarıdır. Yalnızca name ve description gereklidir ve alt ajan belgeleri model için sonnet, opus, haiku, fable, tam bir model kimliği veya inherit'i kabul eder. Alt ajan rehberimiz kapsamları ve araçları kapsar.

Explore'u ucuz bir kaşif ile değiştirin

Dahili Explore alt ajanı, Haiku değil, ana konuşmanın modeli üzerinde çalışır. Bir Opus 5.5 oturumunda, her Explore araması Opus üzerinde çalışır. Explore adında bir kullanıcı veya proje alt ajanı, dahili olanı geçersiz kılar ve kendi model'ini tutar:

---
name: Explore
description: Hızlı salt okunur kod tabanı araması. Dosyaları, sembolleri ve çağrı sitelerini düzenlemeden bulmak için kullanın.
tools: Read, Grep, Glob
model: haiku
effort: low
---

Kod tabanını arar ve bulduklarınızı raporlarsınız. Satır numaralarıyla birlikte dosya yollarını ve her eşleşmenin kısa bir özetini döndürün. Dosyaları asla düzenlemeyin.

Bunu .claude/agents/Explore.md olarak kaydedin. Modelini onaylamak için çalışırken /tasks komutunu çalıştırın. Bir bulut sağlayıcısında, Adım 2'deki tam kimlik için haiku'yu değiştirin.

Her alt ajanı Haiku'ya zorlayın

Explore dahil her alt ajanı Haiku üzerinde çalıştırmak için, bir ayarlar dosyasının env bloğundaki her iki değişkeni de ayarlayın:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

Yalnızca CLAUDE_CODE_SUBAGENT_MODEL bir varsayılandır: bir alt ajanın kendi model alanı yine de kazanır ve Explore hareket etmez.

Adım 5: Arka plan çalışmasını Haiku 5.5'e yönlendirin

ANTHROPIC_DEFAULT_HAIKU_MODEL, haiku veya claude --resume için geçmiş oturumları özetleme gibi arka plan işlevleri için kullanılacak modeli ayarlar. Eski ANTHROPIC_SMALL_FAST_MODEL, ortam değişkeni referansına göre kullanım dışıdır; kabuk profiliniz hala ayarlıyorsa onu değiştirin.

Anthropic API'sinde hiçbir şey ayarlamanıza gerek yoktur. Google Cloud'da, arka plan görevleri varsayılan olarak Sonnet'e; Foundry'de, birincil modele; Bedrock'ta, Sonnet'e veya birincil modele ayarlanmıştır. Hesabınızda Haiku 5.5 etkinleştirildiğinde, onu sabitleyin:

# Google Cloud'un Ajan Platformu
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock (çıkarım profili kimliği)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

Uzun oturumlardaki 100K fiyat adımı

Haiku 5.5'in fiyatı istem uzunluğuna bağlıdır ve Claude Code, her adımda konuşmayı istem olarak gönderir. Bir oturumun bağlamı 100K tokenı geçtiğinde, her istek 0,10$/0,50$ yerine 0,50$/2,50$ olarak faturalandırılır, bu da kısa istem oranının beş katıdır. Belgeler, önbelleğe alınmış tokenların bu sınıra dahil olup olmadığını belirtmez, bu yüzden dahil olduklarını varsayarak bütçe yapın.

Otomatik sıkıştırma sizi kurtarmaz: Haiku 5.5 varsayılan olarak yaklaşık 967K tokenda sıkıştırılır, bu nedenle bir oturum fiyat adımının çok üzerine çıkabilir. Token başına ödeme yaptığınızda iki alışkanlık yardımcı olur:

1. Daha erken sıkıştırın. /autocompact 100k, Claude Code'un kabul ettiği en düşük pencereyi ayarlar, böylece oturum 1M yerine sınıra yakın sıkıştırılır.
2. Büyük işleri alt ajanlara itin. Bir alt ajanın kendi bağlamı vardır, bu nedenle test günlükleri ve arama sonuçları ana konuşmadan uzak durur.

100K'nın üzerinde bile, 0,50$/2,50$ Sonnet 5.5'in 2$/10$'ının dörtte biridir. Ücretli bir planda, oturumlar bunun yerine kullanım limitlerini kullanır ve Anthropic, Haiku 5.5'in bunlara karşı nasıl sayıldığını yayınlamamıştır. Haiku 5.5 fiyatlandırma dökümümüz aritmetiği açıklar.

Max ve Team aboneleri: Anthropic'in API kredileri belgelerine göre yeni aylık API kredileri (Max 5x'te 100$, Max 20x'te 200$, Team'de havuzlanmış 500$'a kadar) etkileşimli Claude Code'u kapsamaz.

Sonnet 5.5 veya Opus 5.5'i ne zaman lider olarak tutmalı

Anthropic, Sonnet 5.5 ve Opus 5.5'in "karmaşık ajansal kodlama görevleri için daha iyi seçenekler olmaya devam ettiğini" belirtiyor. Anthropic tarafından Claude Code'da maksimum çabayla çalıştırılan Terminal-Bench 4.0'da, Haiku 5.5 %39,2 puan alırken Sonnet 5.5 %70,6 puan aldı. Başlatma tabloları deneme başına maliyeti de ekler:

medium seviyesinde, ikisi de deneme başına yaklaşık aynı maliyete sahip ve Sonnet daha yüksek puan alıyor. Haiku'nun token fiyatı uzun kabuk işlerine yansımaz, bu yüzden zor kodlama oturumları için onu lider yapmayın.

Bilgisayar kullanımı farklı bir hikaye anlatıyor. OSWorld 2.1'de, medium seviyesindeki Haiku 5.5, deneme başına 0,13$ maliyetle %53,3 puan alırken, low seviyesindeki Sonnet 5.5, 0,68$ maliyetle %57,9 puan aldı. Haiku 5.5 karşılaştırmalı test dökümümüz her bir satırı içerir ve Sonnet 5.5 Claude Code rehberi lider model tarafını kapsar.

Pratik bir ayrım: ana model olarak Sonnet 5.5 veya Opus 5.5, Explore, test çalıştırıcıları, günlük okuyucular ve doküman getiriciler için Haiku 5.5.

Örnek: Apidog testlerinizi çalıştıran bir Haiku alt ajanı

Test çalıştırmaları ayrıntılı ve tekrarlayıcıdır, Haiku için iyi bir eşleşme. Apidog CLI, kaydedilmiş Apidog test senaryolarınızı terminalden çalıştırır, böylece bir alt ajan bunları çalıştırabilir ve kısa bir rapor geri verebilirken lider modelin bağlamı temiz kalır.

---
name: api-test-runner
description: Bir API uç noktası değiştiğinde projenin Apidog test senaryolarını Apidog CLI ile çalıştırır, ardından başarısız olan isteklerle birlikte geçme ve kalma sayılarını raporlar.
tools: Bash, Read
model: haiku
effort: low
---

Değişen uç noktayı kapsayan senaryo için bu depoda (README) belgelenen Apidog CLI test komutunu çalıştırın. Geçme ve kalma sayılarını raporlayın.
Her hata için istek adını, beklenen sonucu ve gerçek sonucu verin. Kodu düzenlemeyin. Başarısız bir çalıştırmayı birden fazla kez tekrar denemeyin.

Auth ve çalıştırma komutu dahil CLI kurulumu, Claude Code'da Apidog CLI'dadır. Alt ajanın çalıştıracağı senaryoları oluşturmak için Apidog'u indirin.

Bir uygulamayı Haiku 4.5'ten taşımak

Uygulamanız API aracılığıyla Haiku 4.5'i çağırıyorsa, Claude Code geçişi başlatabilir:

/claude-api migrate this project to claude-haiku-5-5

Kırıcı değişiklikler bekleyin: manuel budget_tokens düşünme, varsayılan olmayan temperature veya top_p, herhangi bir top_k ve asistan ön doldurma hepsi Haiku 5.5'te 400 hatası döndürür. Haiku 5.5 vs Haiku 4.5 rehberi her düzeltmeyi listeler. Düzenlemeden sonra, eski ve yeni isteği Apidog'da bir çift olarak kaydedin, ANTHROPIC_API_KEY'i bir ortam değişkeni olarak saklayın ve yeni bir refusal durdurmasının veya tokenlardaki bir sıçramanın üretime ulaşmak yerine bir testi başarısız kılması için stop_reason ve usage üzerinde doğrulama yapın.

SSS

Haiku 5.5, Claude Code'daki varsayılan model mi? Hayır. Anthropic API'sinde varsayılan Haiku modelidir, bu da haiku takma adının onu işaret ettiği anlamına gelir. Ana modeliniz olarak --model veya /model ile seçin.

Haiku 5.5'i Ücretsiz planda Claude Code'da kullanabilir miyim? Hayır. Claude Code ücretli bir plan veya bir API anahtarı gerektirir. Ücretsiz kullanıcılar Claude.ai uygulamalarında Haiku 5.5'i seçebilir; Claude Haiku 5.5'i ücretsiz olarak nasıl kullanacağınızı görün.

Neden model: haiku bana Haiku 4.5 veriyor? Bedrock, Google Cloud, Foundry veya AWS'deki Claude Platformu'nda veya v2.1.293 öncesi bir sürümdesiniz. Tam kimliği sabitleyin veya ANTHROPIC_DEFAULT_HAIKU_MODEL'i ayarlayın.

Token tasarrufu için düşünmeyi kapatabilir miyim? Claude Code'da hayır. Bunun yerine çabayı düşürün; low en ucuz ayardır.

Bir sonraki adımınız

claude update'i çalıştırın, Haiku Explore geçersiz kılmasını ekleyin ve mevcut lider modelinizi bir hafta boyunca kullanın. Ardından projenizin API'leri varsa test çalıştırıcı alt ajanını ekleyin. Modeli kendi kodunuzdan çağırmak için Haiku 5.5 API rehberi ile başlayın. Apidog ücretsizdir ve bu alt ajana çalıştırılacak gerçek testler verir.