Claude Agent SDK Kredisi: 15 Haziran’da claude -p, GitHub Actions ve Üçüncü Taraf Agent Araçları İçin Ne Değişiyor

15 Haziran 2026’da Anthropic, headless Claude’un ekonomisini değiştiriyor. claude -p, Claude Agent SDK çağrıları, Claude Code GitHub Actions ve Agent SDK üzerine kurulu üçüncü taraf uygulamalar artık normal Claude abonelik limitlerinden düşmeyecek; bunun yerine ayrı bir aylık Agent SDK kredisinden düşecek (Anthropic Help Center).

Bu kulağa faturalandırmayla ilgili küçük bir dipnot gibi geliyor. Değil. Cron işleriniz, CI inceleyicileriniz, yerel script’leriniz, Zed tarzı agent entegrasyonlarınız ya da claude -p etrafına sarılmış CLI araçlarınız varsa, “planıma dahil” çizgisinin “dolar kredisine göre ölçülüyor” çizgisine dönüştüğü yer burası.

Benim görüşüm: bu doğru ürün sınırı, ama Anthropic’in geçiş süreci fazla geliştiriciyi bozuk zihinsel modeller ve Reddit başlıkları üzerinden bunu keşfetmeye bırakıyor. Etkileşimli kodlama ile otomatik agent’lar farklı iş yükleri. Aynı kotayı paylaşmamalılar. Ama ekibiniz abonelikle kimliği doğrulanmış Claude Code etrafında sessiz sedasız otomasyon kurduysa, 15 Haziran bir fiyat duyurusu değil, bir migrasyon son tarihi.

Yeni Krediye Aslında Ne Taşınıyor

Anthropic’in yardım makalesi sınır konusunda açık. 15 Haziran’dan itibaren Claude abonelik planlarındaki Agent SDK ve claude -p kullanımı, etkileşimli kullanım limitlerinden ayrı yeni bir aylık Agent SDK kredisinden düşecek (Anthropic Help Center). Agent SDK dokümanları da genel bakış sayfasının en üstünde aynı uyarıyı yineliyor (Claude Docs).

Yeni kredi kapsamına girenler:

Plan kredileri dolar bazlı:

Anthropic ayrıca kredilerin kullanıcı başına olduğunu, havuzlanmadığını; fatura döngüsüyle yenilendiğini; kullanılmayan kredinin devretmediğini; kredinin bir kez talep edilmesi gerektiğini ve sonra otomatik yenilendiğini söylüyor (Anthropic Help Center).

Bu son kısım ekipler için önemli. 20 uygun mühendisi olan bir Team hesabı tek bir ortak otomasyon kovası elde etmiyor. Her kişi kendi kredisini alıyor. Paylaşılan bir GitHub Action tek bir kullanıcı olarak kimlik doğruluyorsa, darboğaz o kullanıcının kredisi.

Pratik Kırılma: claude -p Artık “Sadece CLI Kullanımı” Değil

İnsanları şaşırtacak komut claude -p.

Anthropic’in CLI referansı --print / -p seçeneğini “etkileşimli mod olmadan yanıtı yazdır” diye tanımlıyor; --output-format json, --output-format stream-json, --max-turns, --json-schema ve --max-budget-usd gibi otomasyona uygun bayraklarla birlikte (Claude Code CLI reference). Bu da onu script’ler için mükemmel bir yapıştırıcı yapıyordu:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

15 Haziran’dan sonra bu, abonelikle kimliği doğrulanmış bir hesapta Agent SDK kredisi kullanımıdır. Etkileşimli Claude Code kullanımı değildir. Normal sohbet kullanımı değildir. Plan kotanıza açılmış ücretsiz bir yan kapı değildir.

Topluluk tepkisinin sert olmasının nedeni bu. Güncel bir r/ClaudeCode başlığında geliştiriciler kredinin token/model bazlı olup olmadığını, $200’ın gerçekçi olarak ne kadar dayanacağını, opt-in gerekip gerekmediğini, prompt caching’in nasıl sayıldığını ve GitHub Actions’ın dahil olup olmadığını soruyor (Reddit). Bir yorumcunun “oh… I didn’t realise it was GH actions too” demesi tam da riskin kendisi: insanlar bu değişikliği SDK kütüphaneleriyle eşleştirdi, her headless Claude Code iş akışıyla değil.

Token sorusunun yanıtı fiilen evet: Anthropic, kredi aşımı kullanımının, kullanım kredileri etkinse standart API tarifeleriyle kullanım kredilerine aktığını söylüyor. Güncel Claude API fiyatlandırma sayfası Fable 5 için milyon token başına $10 input / $50 output, Opus 4.8 için $5 / $25, Sonnet 4.6 için $3 / $15 ve Haiku 4.5 için $1 / $5 listeliyor (Claude API pricing). Kesin yakım model, turn sayısı, tool kullanımı, cache okuma, cache yazma ve agent’ın ne kadar repository bağlamı yüklediğine bağlı.

$20 ya da $200’ı “saat”e çevirmeyin. Yanlış birim bu. Gerçek işlerinizin token ve maliyet izlerini çıkarın.

GitHub Actions: Aynı YAML, Farklı Bütçe

Claude Code GitHub Actions doğrudan kapsam içinde. Anthropic’in GitHub Actions dokümanları action’ın Claude Agent SDK üzerine kurulduğunu ve @claude mention’larına yanıt verebildiğini, PR oluşturabildiğini, özellik geliştirebildiğini, bug düzeltebildiğini veya özel otomasyon çalıştırabildiğini söylüyor (Claude Code GitHub Actions docs). Dokümanlar ayrıca her Claude etkileşiminin API token’ı tükettiği konusunda uyarıyor ve maliyet yönetimi için --max-turns, timeout’lar ve concurrency kontrolleri öneriyor.

Bu rehberlik artık daha da önemli.

Şunun gibi zamanlanmış günlük bir rapor:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

iki olası faturalandırma hikâyesine sahip:

1. Bir Claude Platform API anahtarı kullanıyorsa, Anthropic hiçbir şeyin değişmediğini söylüyor. Normal kullandıkça öde API faturalandırması olarak kalır.
2. Abonelikle kimliği doğrulanmış Agent SDK kredisi kullanıyorsa, artık önce kullanıcı başına Agent SDK kredisini, ardından etkinse kullanım kredilerini tüketir.

Action kurulum dokümanları hâlâ doğrudan API kullanımı için ANTHROPIC_API_KEY seçeneğini ve Bedrock ile Vertex AI için bulut sağlayıcı seçeneklerini öne çıkarıyor (Claude Code GitHub Actions docs). Üretim CI için bu, bir repo otomasyonunu tek bir insan aboneliğine bağlamaktan daha temiz. Anthropic de yönetici rehberliğinde aynı şeyi söylüyor: ölçekte üretim otomasyonu, öngörülebilir kullandıkça öde faturalandırma için API anahtarıyla Claude Platform kullanmalı (Anthropic Help Center).

Benim önerim: bir iş akışı kod merge edebiliyor, PR’lara yorum bırakabiliyor veya bir zamanlamayla gözetimsiz çalışabiliyorsa, onu açık bütçeleri olan bir API anahtarına alın. Abonelik Agent SDK kredisini kişisel otomasyon, denemeler ve yerel araçlar için saklayın.

Üçüncü Taraf Agent Araçları: Zed Tarzı Soru

Kafa karıştıran durum üçüncü taraf araçlar. Geliştiriciler şunu soruyor: Bir editör, yerel harness ya da kodlama asistanı Agent SDK üzerinden entegre oluyor ve Claude aboneliğimle kimlik doğrulamama izin veriyorsa, yeni krediyi mi kullanır?

Anthropic’in yardım makalesi kredinin “Claude aboneliğinizle Agent SDK üzerinden kimlik doğrulayan üçüncü taraf uygulamaları” kapsadığını söylüyor (Anthropic Help Center). Agent SDK genel bakışı da Anthropic’in önceden onaylanmadıkça üçüncü taraf geliştiricilerin claude.ai login veya rate limit sunmasına genelde izin vermediğini söylüyor ve geliştiricilere bunun yerine API anahtarıyla kimlik doğrulama yöntemlerini kullanmalarını belirtiyor (Claude Docs).

Bu da pratik bir kural veriyor:

• Araç Claude Platform API anahtarınızı kullanıyorsa, bu değişiklik ona ücretsiz aylık kredi sağlamaz. Hâlâ API faturalandırmasıdır.
• Araç onaylı, abonelikle kimliği doğrulanan bir Agent SDK uygulamasıysa, Agent SDK kredisinden düşer.
• Araç Anthropic’in onaylamadığı şekillerde Claude Code login, OAuth token’ları, gizli PTY’ler veya abonelik limitleri üzerinden tünel açmaya çalışıyorsa, onu kırılgan kabul edin.

Topluluk şimdiden bu belirsizliğin etrafında bir şeyler inşa ediyor. Bir r/ClaudeCode gönderisi, işi etkileşimli Claude Code içinde tuttuğunu ve SDK kredilerinden kaçındığını iddia eden hook tabanlı bir “drop-in -p replacement” anlatıyor (Reddit). Başka bir r/ClaudeAI gönderisi ise claude -p çıktısını taklit etmek için perde arkasında etkileşimli Claude Code başlatan yerel bir CLI olan clarp’ı anlatıyor (Reddit). Yazar bunu yerel uyumluluk olarak çerçeveliyor, yorumcular ise hemen hesap riski sorularını gündeme getiriyor.

Asıl tartışma bu: Bu meşru bir yerel iş akışı koruması mı, yoksa araç kılığına girmiş kota aşma mı? Ben şirket altyapısını bu wrapper’ların üzerine kurmazdım. Bugün çalışsalar bile, Anthropic’in aktif olarak kaldırmaya çalıştığı bir faturalandırma varsayımını kodluyorlar.

Kendi İş Akışlarınızı Bugün Nasıl Denetlersiniz

Bunu başarısız bir işi beklemeden yapın.

Önce claude -p ve Agent SDK import’larını arayın:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

Sonra CI içinde arayın:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

Her bulguyu sınıflandırın:

SDK kullanıcıları için maliyet takibini sonuç akışına bağlayın. Anthropic’in maliyet takip dokümanları total_cost_usd ve costUSD değerlerinin istemci tarafı tahminleri olduğunu, yetkili faturalandırma verisi olmadığını, ama geliştirme içgörüsü için yararlı olduğunu söylüyor (Claude Docs). Aynı sayfa SDK’nın adım başına token kullanımı, model başına kullanım, cache okuma token’ları, cache oluşturma token’ları ve kümülatif toplamları sunduğunu söylüyor.

Bunu bir yakım profili oluşturmak için kullanın:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

Kendi kullanıcılarınızı faturalandırmak için istemci tarafı maliyet tahminlerini kullanmayın. Anthropic, yetkili faturalandırma için Usage and Cost API veya Claude Console kullanılmasını açıkça söylüyor (Claude Docs).

Ayrıca sert durdurucular ekleyin. claude -p için --max-turns ve --max-budget-usd kullanın. GitHub Actions için workflow timeout’ları, GitHub concurrency kontrolleri ve dar prompt’lar kullanın. SDK agent’ları için tool’ları kısıtlayın. Salt okunur bir inceleyicide varsayılan olarak Bash, Edit ve Write olmamalı.

Opt-In ve Aşım Soruları

En önemli çözümlenmemiş operasyonel soru opt-in. Anthropic, kredinin bir defalık opt-in olduğunu; Claude hesabınız üzerinden bir kez talep edilip sonra otomatik yenilendiğini söylüyor. Team ve Enterprise yöneticileri için uygun kullanıcıların 15 Haziran 2026’dan önce ayrıntılar ve talimatlar içeren bir e-posta alması bekleniyordu (Anthropic Help Center).

Güncel bir r/Anthropic başlığı bariz devam sorusunu soruyor: opt-in yapmazsanız ne olur? claude -p normal abonelik limitlerine karşı çalışmaya devam mı eder, talep edene kadar durur mu, yoksa kullanım kredilerine mi düşer? Makale bu fallback’i net söylemiyor (Reddit).

Bu yüzden tahmin edilmiş bir fallback üzerine tasarım yapmayın. Uygunsanız krediyi talep edin. Admin iseniz kullanıcılara nereden talep edeceklerini ve hangi otomasyonların bunu kullanmasına izin verildiğini söyleyin. Paylaşılan iş akışları çalıştırıyorsanız, onları bir API anahtarına taşıyın.

Aşım konusunda Anthropic daha net. Agent SDK kullanımı önce aylık krediyi tüketir. Sonrasında kullanım, yalnızca kullanım kredileri etkinse standart API tarifeleriyle kullanım kredilerine geçer. Kullanım kredileri etkin değilse, Agent SDK istekleri kredi yenilenene kadar durur (Anthropic Help Center).

Bu harcama kontrolü açısından iyi. Aynı zamanda otomasyonunuzun güvenli şekilde kapanabileceği anlamına geliyor. Buna göre inşa edin. CI, “Agent SDK credit exhausted” durumunu flaky model hatası değil, faturalandırma/konfigürasyon hatası olarak göstermeli. Yerel script’ler net bir mesaj yazdırıp sıfır olmayan çıkış koduyla çıkmalı. Uzun çalışan agent’lar her pahalı turn’den önce işi checkpoint etmeli.

Geliştiriciler İçin Son Söz

Bu değişiklik claude -p’nin ölümü değil. Bir headless agent döngüsünün, IDE’de oturan bir insanla aynı maliyet profiline sahipmiş gibi davranmanın sonu.

Bireysel geliştiriciler için yeni kredi yararlı. Pro kullanıcısı script’ler için aylık $20 alan kazanıyor. Max 20x kullanıcısı $200 alıyor. Bu, düşünülmüş otomasyon için yeterli; sınırsız, sürekli açık agent’lar için değil.

Ekipler için yanıt sıkıcı ve doğru: üretim otomasyonu için API anahtarları kullanın. Abonelik Agent SDK kredilerini kişisel tutun. Maliyet logging’i ekleyin. Turn’leri sınırlayın. Görev frontier model gerektirmiyorsa Haiku veya Sonnet tercih edin. Yeni sınırın etrafından dolaşan wrapper araçlarını altyapı değil, deney olarak görün.

15 Haziran ayrımı gerçek bir problemi çözüyor: gece çalışan script’iniz etkileşimli kodlama için ihtiyaç duyduğunuz kotayı sessizce yememeli. Başka bir problem yaratıyor: Claude insan döngünün içinde değilken çalıştığında geliştiriciler artık API kullanıcısı gibi düşünmek zorunda.

Bu adil bir takas. Ama yalnızca sayaç ısırmaya başlamadan önce denetim yaparsanız işe yarar.

Claude Fable 5’i kendileri denemek isteyen okurlar OneHop üzerinden kullanabilir: drop-in endpoint, liste fiyatının yaklaşık %30 altında, yeni hesaplara $10 ücretsiz ve kart gerektirmez. Claude Fable 5 on OneHop sayfasına bakın veya $10 ücretsiz başlayın.

Ek okuma: Claude Fable 5 ile başlangıç.