Anthropic, mevcut Claude aboneliğinizde Claude Agent SDK'yı 15 Haziran 2026'dan itibaren çalıştırmanıza olanak tanıyor. Bundan önce, Agent SDK ile bir şey geliştirmek, Claude Pro veya Max için halihazırda ödediğinizin üzerine ölçülü, kullandıkça öde faturalandırması olan ayrı bir API anahtarı gerektiriyordu. 15 Haziran'dan itibaren, aylık Claude planınız Agent SDK kullanımı için özel bir kredi bakiyesi içeriyor. API anahtarı gerekmez.
Özel bir aracı (bir dağıtım botu, bir araştırma asistanı, bir ön eleme aracı) oluşturmak istediyseniz ancak sadece prototip geliştirmek için Anthropic'e ayrı bir fatura kartı vermek istemediyseniz, işte bu önemli bir değişiklik. Pro aboneliğiniz artık ayda 20 dolarlık Agent SDK kullanımıyla geliyor. Max 20x, 200 dolarla birlikte geliyor. Team Premium koltukları 100 dolarla birlikte geliyor.
15 Haziran 2026'da ne değişti
Kısa versiyonu: Agent SDK kullanımı artık Claude planınıza bağlı aylık bir krediden karşılanıyor. Daha önce, Anthropic API aracılığıyla ayrı bir konsol bakiyesiyle faturalandırılıyordu.
İşte Anthropic'in duyurusundan doğrudan alınan, plana göre kredi miktarları:
| Plan | Aylık Agent SDK kredisi |
|---|---|
| Pro | $20 |
| Max 5x | $100 |
| Max 20x | $200 |
| Team Standard (koltuk başına) | $20 |
| Team Premium (koltuk başına) | $100 |
| Enterprise (kullanıma dayalı) | $20 |
| Enterprise Premium koltuğu | $200 |
Önemli birkaç kural:
- Enterprise Standard koltuk üyeleri kredi almaz. Bir API anahtarı kullanmaları veya Premium koltuğa yükseltme yapmaları gerekir.
- Krediler kullanıcı başına ve devredilemezdir. Koltuğunuzun kredisi bir ekip arkadaşınızın kredisiyle birleştirilemez.
- Kullanılmayan krediler devredilmez. Fatura döneminizin sonunda kalan bakiye sıfırlanır.
- Bir defalık katılım gereklidir. Krediyi bir kez talep etmediğiniz sürece hesabınızda etkinleşmeyecektir. Bundan sonra, her ay otomatik olarak yenilenir.
- API anahtarı kullanıcıları kredi almaz. Bu, plana özeldir. Eğer
ANTHROPIC_API_KEYile kimlik doğrulaması yapıyorsanız, eski faturalandırma modelindesiniz demektir.
Kredinin neleri kapsadığı ve neleri kapsamadığı
Anthropic bunu dikkatlice ayırmıştır. Yakından okuyun; "kapsanan" ve "kapsanmayan" arasındaki çizgi, faturanızın gerçekten değişip değişmeyeceğini belirler.
Agent SDK kredisi tarafından kapsananlar:
- Kendi Python veya TypeScript projelerinizden yapılan Claude Agent SDK çağrıları
- Claude Code'daki
claude -pkomutu (etkileşimli olmayan mod, betikleştirilmiş aracı çalıştırmaları için kullanılır) - Claude Code GitHub Actions entegrasyonu
- Agent SDK kullanarak kimlik doğrulaması yapan üçüncü taraf uygulamalar
Kapsanmayanlar (bunlar hala normal Claude planınızdan karşılanır veya ayrı kalır):
- Etkileşimli Claude Code oturumları (günlük kullandığınız normal CLI)
- Claude web uygulaması veya mobil uygulamasındaki konuşmalar
- Claude Cowork oturumları
Başka bir deyişle, Agent SDK kredisi özellikle programatik, otomatikleştirilmiş veya etkileşimli olmayan iş yükleri içindir. Normal Claude Code çalışmalarınız, Anthropic'in yakın zamanda 13 Temmuz'a kadar %50 artırdığı planın mevcut kullanım limitleri dahilindedir. İki ayrı bütçe, iki ayrı amaç.
Bu, anlamlı bir tasarım seçimidir. Bu, Claude Code aracılığıyla günlük kodlama için kullandığınız bütçeyi tüketmeden SDK üzerine kurulu özel bir aracıyla deney yapabileceğiniz anlamına gelir.
Krediniz bittiğinde
Kredi, ayda sabit bir dolar miktarını kapsar. Bu miktarı aştığınızda ne olacağı tek bir ayara bağlıdır:
- Ek kullanım etkinleştirildiğinde: Aşım, kullandıkça öde şeklinde, planınızın ödeme yöntemine standart API oranlarından faturalandırılır.
- Ek kullanım devre dışı bırakıldığında: İstekler, döngü sıfırlanana kadar kredi limitinde durur.
Prototip çalışmaları için, ek kullanımı devre dışı bırakın. Net bir durma sinyali alacak ve beklenmedik faturalardan kaçınacaksınız. Çalışmaya devam etmesi gereken üretim düzeyindeki otomasyonlar için etkinleştirin.
Kredi her zaman önce kullanılır. Aylık hakkınız bitene kadar aşım ücreti ödemezsiniz.
Nasıl katılım sağlanır
Kredi varsayılan olarak etkin değildir. Katılım tek seferliktir ve faturalandırma döngüleri arasında geçerliliğini korur, ancak bunu bir kez yapmanız gerekir.
- Aboneliğin sahibi olan Claude hesabına giriş yapın (Pro/Max'teki kullanıcı hesabı veya Takım/Kurumsal'daki koltuk hesabı).
- Claude Agent SDK plan ayarlarına gidin (Anthropic'in resmi destek makalesinden bağlantılıdır).
- Krediyi talep edin. Bundan sonra, kredi her ay otomatik olarak yenilenir.
Bir Takım planında birden fazla koltuğunuz varsa, her kullanıcının bağımsız olarak talep etmesi gerekir. Yöneticiler, koltuk üyeleri adına talepte bulunamaz.
SDK'yı Python veya TypeScript'te kurma
Agent SDK hem Python hem de TypeScript'te mevcuttur. Her ikisi de planınıza aynı şekilde kimlik doğrulaması yapar: ham bir API anahtarı yerine Claude Code CLI aracılığıyla.
Python
Kurulum:
pip install claude-agent-sdk
Önce Claude Code'a giriş yaparak kimlik doğrulayın:
claude login
Bu, plana bağlı kimlik bilgilerini yerel olarak saklar. Python SDK bunları otomatik olarak alır; plan tabanlı kullanım için ANTHROPIC_API_KEY ayarlamazsınız.
Minimal bir aracı şöyle görünür:
from claude_agent_sdk import Agent
agent = Agent(
system_prompt="You are a code review assistant.",
)
response = agent.run("Review the diff in /tmp/patch.diff and flag concerns.")
print(response.text)
Aynı çağrı daha önce ANTHROPIC_API_KEY ve ölçülü API faturalandırması gerektiriyordu. Şimdi bunun yerine plan kredinizden düşülüyor.
TypeScript
Kurulum:
npm install @anthropic-ai/claude-agent-sdk
Aynı Claude Code girişiyle kimlik doğrulayın:
claude login
TypeScript'te minimal bir aracı:
import { Agent } from "@anthropic-ai/claude-agent-sdk";
const agent = new Agent({
systemPrompt: "You are a code review assistant.",
});
const response = await agent.run(
"Review the diff in /tmp/patch.diff and flag concerns."
);
console.log(response.text);
SDK'nın Claude Code kimlik bilgilerini otomatik olarak bulamadığı ortamlarda (CI çalıştırıcıları, Docker kapsayıcıları, uzak geliştirme kutuları), bunları ortam değişkenleri olarak ayarlayabilirsiniz. Anthropic, tam değişken adlarını Agent SDK belgelerinde yayınlamıştır.
SDK kurulumuna bile başlamadan Claude Code girişiniz yapılandırma hataları veriyorsa, geçersiz custom3p kurumsal yapılandırma düzeltmesi en yaygın nedeni kapsar.
claude -p iş akışı
Agent SDK kredisini kod yazmayı gerektirmeyen ikinci bir yolu daha var: Claude Code'daki claude -p komutu.
-p, Claude Code'u etkileşimli olmayan moda geçirir. Ona bir komut verirsiniz, deponuza karşı yürütülür ve çıkar. Karşılıklı oturum yok. Claude Code'u CI ardışık düzenlerine, cron işlerine ve Git kancalarına bu şekilde betiklersiniz.
Basit bir örnek: Claude'dan riskli değişiklikleri işaretlemesini isteyen bir pre-commit kancası.
#!/usr/bin/env bash
# .git/hooks/pre-commit
DIFF=$(git diff --cached)
claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:\n\n$DIFF"
15 Haziran'dan sonra yapılan her claude -p çağrısı, etkileşimli Claude Code bütçenizden değil, Agent SDK kredinizden düşülür. Bu da, günlük kodlama için ihtiyacınız olan limitleri tüketme endişesi duymadan onu otomatik iş akışlarına bağlayabileceğiniz anlamına gelir.
Bu, otonom döngüler için /goal komutu ve aracıyı çalıştırmalar arasında güvenilir bir şekilde yönlendirmek için AGENTS.md bağlam dosyaları ile iyi bir uyum sağlar.
GitHub Actions entegrasyonu
Claude Code GitHub Actions entegrasyonu, SDK kredisi tarafından kapsanan üçüncü iş yüküdür. Claude'u PR incelemelerine, sorun ön elemeye veya sürüm notu oluşturmaya entegre ettiyseniz, bu iş akışı çalıştırmaları artık GitHub Uygulamasını kuran kullanıcının Agent SDK kredisinden faturalandırılır.
Bu, otomasyonun sürekli çalıştığı ve faturanın Uygulamaya bağlı API anahtarına kesildiği Claude Code üzerine kurulu GitHub ön eleme botu Clawsweeper gibi projeler için kullanışlıdır.
Gerçek aracılar oluşturma: SDK'yı Apidog ile eşleştirme
Agent SDK'nın gerçek değeri, metne yanıt vermekten fazlasını yapan aracılar içindir; gerçek API'lere erişen, veritabanlarını sorgulayan, kod dağıtan aracılar. Bunun güvenilir bir şekilde çalışması için, aracının dokunduğu her harici API için tanımlanmış bir sözleşmeye ihtiyacı vardır. Olmadan, aracı istek şekillerini tahmin eder ve hata ayıklama sürenizi sanrısal yükleri düzeltmeye harcarsınız.
İşte Apidog'un iş akışına uyduğu yer:
- API sözleşmesini önce Apidog'da tanımlayın. Uç noktaları, istek/yanıt şemalarını ve örnek yükleri belirtin. Bu, doğruluk kaynağı haline gelir.
- OpenAPI'yi dışa aktarın ve bağlam olarak aracınıza iletin.
- Aracıyı gerçek uç noktalara bağlamak için SDK'yı kullanın. Aracı, doğru olduğunu bildiği şemaları kullanarak API'nizi çağırır.
- Apidog CLI ile doğrulayın. Her aracı çalıştırması, API'nin hala sözleşmenin vaat ettiklerini döndürdüğünü doğrulayabilir.
MCP sunucuları aracılığıyla diğer araçları yöneten aracılar için, Apidog ile MCP sunucu test iş akışı eşleşen kılavuzdur. Aracınızın çağırdığı araçlar üzerinde uçtan uca test kapsamı elde edersiniz.
Daha büyük resim, tasarım odaklı API iş akışı kılavuzunda yer alıyor: aracı, doğrulayacak bir sözleşmeye sahip olduğunda, bir geliştirici olarak zamanınız, aracı çıktısındaki JSON şema hatalarını kovalamak yerine daha iyi sözleşmeler ve kısıtlamalar yazmaya yöneliyor.
Agent SDK projelerinizi desteklemek için sözleşme katmanını istiyorsanız Apidog'u ücretsiz indirin.
Hala ayrı bir API anahtarı istediğinizde
Plan tabanlı kredi, çoğu geliştirici için doğru varsayılandır. Yine de bağımsız bir API anahtarının mantıklı olduğu durumlar vardır:
- Tahmin edilebilir bütçelere ihtiyaç duyan üretim aracılar. Plan kredileri sabit dolar miktarlarıyla sınırlıdır. Sınırsız ölçeklendirme gerektiren bir aracı çalıştırıyorsanız, kullanıma dayalı bir API anahtarı finans ve operasyonlara daha temiz bir faturalandırma hattı sunar.
- Çoklu organizasyon erişimi. API anahtarları tek bir kullanıcıya bağlı değildir. Bir ekip tek bir faturalandırma kaynağına ortak erişim istiyorsa, bu hala bir API anahtarı işidir.
- Enterprise Standard koltukları. Bunlar Agent SDK kredisi almaz. Eğer bir Enterprise Standard koltuğundaysanız ve SDK erişimine ihtiyacınız varsa, bir API anahtarı kullanmanız gerekir.
Ücretsiz Claude API erişim kılavuzu, ne bir Pro planı ne de ücretli bir API anahtarı gerektirmeyen Claude kullanım yollarını kapsar.
Başlamadan önce temiz bir kontrol listesi
- [ ] Planınızın uygun listede olduğunu onaylayın (Pro, Max 5x, Max 20x, Team Standard, Team Premium, Kurumsal kullanıma dayalı, Kurumsal Premium koltuk)
- [ ] Agent SDK kredisi için bir defalık katılımı talep edin
- [ ] Ek kullanımı etkinleştirip etkinleştirmeyeceğinize karar verin (prototipleme için kapalı, üretim için açık)
- [ ] SDK'yı planınıza karşı kimlik doğrulamak için
claude loginkomutunu çalıştırın - [ ] Python veya TypeScript SDK paketini kurun
- [ ] Minimal bir aracı oluşturun ve
ANTHROPIC_API_KEYayarlanmadan çalıştığını onaylayın - [ ] İlk birkaç çalıştırmadan sonra hesap ayarlarınızdaki kredi bakiyesini kontrol edin
Sıkça Sorulan Sorular
Plan kredisinin çalışması için eski ANTHROPIC_API_KEY anahtarımı kaldırmam gerekiyor mu? SDK, Claude Code'un yerel kimlik bilgilerini kullandığında, bu, SDK'yı plan tabanlı faturalandırmaya geçirmek için claude login komutunun yeterli olduğu anlamına gelir. Ortamınızda başka araçlar için ANTHROPIC_API_KEY ayarlanmışsa, bırakın; SDK, plan kimlik doğrulaması mevcut olduğunda onu tercih edecektir.
Krediye karşı bir "istek" olarak ne sayılır? Kredi, istekler olarak değil, dolar olarak ifade edilir. Her SDK çağrısı, Anthropic'in API kullanımı için yayınladığı aynı oranlardan faturalandırılır; kredi bakiyeniz, araç kullanımı ve bağlam belirteçleri dahil olmak üzere her model çağrısının maliyeti kadar azalır. Üzerine ayrıca bir istek başına ücret yoktur.
Kredimi bir ekip arkadaşımla paylaşabilir miyim? Hayır. Krediler kullanıcı başına olup devredilemez. Her Takım veya Kurumsal koltuğun kendi kredi havuzu vardır.
Eski Anthropic API konsol bakiyeme ne olur? Olduğu yerde kalır. Plan kredisi ayrı bir faturalandırma mekanizmasıdır. API konsolunuzda ön ödemeli bakiyeniz varsa, bu hala herhangi bir API anahtarı iş yükü için çalışır.
Agent SDK, Claude Code ile aynı mı? Hayır. Claude Code, Anthropic'in sunduğu resmi CLI ve IDE uzantılarıdır. Agent SDK, özel aracılar oluşturmak için bir programlama kütüphanesidir (Python veya TypeScript). Kredi, SDK'yı ve Claude Code'daki etkileşimli olmayan claude -p komutunu kapsar; etkileşimli Claude Code, normal plan kullanımınızda kalır.
GitHub Actions faturam değişecek mi? Eğer Action'ınız resmi Claude Code GitHub Actions entegrasyonunu kullanıyorsa ve kredi, kurulumu yapan kullanıcının hesabında talep edildiyse, bu çalıştırmalar artık herhangi bir API anahtarı faturalandırması yerine SDK kredisinden düşülür.
Kredi, Agent SDK ve claude -p dışında da çalışır mı? Kapsanan dört yüzey (Python/TS'deki SDK, claude -p, GitHub Actions, üçüncü taraf Agent SDK uygulamaları) için çalışmaz. Diğer tüm Claude kullanımları, isteğin nereden geldiğine bağlı olarak planınızın normal limitlerine veya API anahtarınıza geri döner.