Claude Planınız ile Claude Agent SDK Nasıl Kullanılır?

Anthropic, 15 Haziran 2026'dan itibaren Claude Agent SDK'yı mevcut Claude aboneliğinizle kullanmanıza izin veriyor. Önceden Agent SDK ile geliştirme yapmak için Claude Pro veya Max aboneliğinizden ayrı, kullandıkça öde faturalandırmalı bir API anahtarı gerekiyordu. Artık aylık Claude planınız, Agent SDK kullanımı için ayrı bir kredi bakiyesi içeriyor. API anahtarı gerekmez.

Apidog'u bugün deneyin

Özel bir aracı oluşturmak istiyorsanız (dağıtım botu, araştırma asistanı, ön eleme aracı gibi) ancak sadece prototip için Anthropic'e ayrı bir fatura kartı tanımlamak istemiyorsanız, bu önemli bir değişiklik. Pro aboneliği ayda 20 dolarlık Agent SDK kredisiyle geliyor. Max 20x için 200 dolar, Team Premium koltukları için 100 dolar kredi sağlanıyor.

15 Haziran 2026'da ne değişti?

Kısa hali: Agent SDK kullanımı artık Claude planınıza bağlı aylık krediden düşülüyor. Daha önce bu kullanım, Anthropic API üzerinden ayrı bir konsol bakiyesiyle faturalandırılıyordu.

Planlara 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

Dikkat etmeniz gereken kurallar:

• Enterprise Standard koltuk üyeleri kredi almaz. API anahtarı kullanmaları veya Premium koltuğa yükseltmeleri gerekir.
• Krediler kullanıcı başına verilir ve devredilemez. Kendi kredinizi ekip arkadaşınızın kredisiyle birleştiremezsiniz.
• Kullanılmayan krediler devretmez. Fatura döneminin sonunda kalan bakiye sıfırlanır.
• Bir defalık katılım gerekir. Krediyi bir kez talep etmeden hesabınızda etkinleşmez. Sonrasında her ay otomatik yenilenir.
• API anahtarıyla kimlik doğrulayanlar bu krediyi kullanmaz. ANTHROPIC_API_KEY ile çalışıyorsanız eski faturalandırma modelindesiniz.

Kredi neleri kapsar?

Anthropic, Agent SDK kredisinin kapsamını ayrı tanımlıyor. Faturanızın değişip değişmeyeceği bu ayrıma bağlı.

Agent SDK kredisi tarafından kapsananlar:

• Python veya TypeScript projelerinizden yapılan Claude Agent SDK çağrıları
• Claude Code içindeki claude -p komutu
• Claude Code GitHub Actions entegrasyonu
• Agent SDK ile kimlik doğrulayan üçüncü taraf uygulamalar

Kapsanmayanlar:

• Etkileşimli Claude Code oturumları
• Claude web veya mobil uygulamasındaki konuşmalar
• Claude Cowork oturumları

Yani Agent SDK kredisi, özellikle programatik, otomatikleştirilmiş veya etkileşimli olmayan işler içindir. Normal Claude Code kullanımınız, Anthropic'in 13 Temmuz'a kadar %50 artırdığı mevcut plan limitleri içinde kalır.

Pratik sonuç: Claude Code ile günlük kodlama limitlerinizi tüketmeden SDK tabanlı özel araçlar geliştirebilirsiniz.

Kredi bittiğinde ne olur?

Aylık kredi sabit bir dolar tutarıdır. Bu tutarı aştığınızda davranış, ek kullanım ayarınıza bağlıdır:

• Ek kullanım etkinse: Aşım, planınızın ödeme yöntemine standart API oranlarıyla kullandıkça öde şeklinde faturalandırılır.
• Ek kullanım kapalıysa: İstekler, fatura döngüsü sıfırlanana kadar durur.

Prototip geliştirirken ek kullanımı kapalı tutmak daha güvenlidir. Böylece beklenmedik fatura oluşmaz. Üretim otomasyonları kesintisiz çalışmalıysa ek kullanımı etkinleştirin.

Kredi her zaman önce kullanılır. Aylık hakkınız bitmeden aşım ücreti ödemezsiniz.

Agent SDK kredisi nasıl etkinleştirilir?

Kredi varsayılan olarak aktif değildir. Bir kez etkinleştirmeniz gerekir.

1. Aboneliğin sahibi olan Claude hesabına giriş yapın.
   • Pro/Max için kendi kullanıcı hesabınız
   • Team/Enterprise için ilgili koltuk hesabı
2. Claude Agent SDK plan ayarlarına gidin. Bu bağlantı Anthropic'in resmi destek makalesinde yer alır.
3. Krediyi talep edin.

Team planında birden fazla koltuk varsa her kullanıcı bunu ayrı ayrı yapmalıdır. Yöneticiler, kullanıcılar adına kredi talep edemez.

Python veya TypeScript ile SDK kurulumu

Agent SDK hem Python hem TypeScript için kullanılabilir. İkisi de plan tabanlı kimlik doğrulama için ham API anahtarı yerine Claude Code CLI oturumunu kullanır.

Python

Kurulum:

pip install claude-agent-sdk

Önce Claude Code'a giriş yapın:

claude login

Bu komut, planınıza bağlı kimlik bilgilerini yerel olarak saklar. Python SDK bunları otomatik kullanır. Plan tabanlı kullanım için ANTHROPIC_API_KEY ayarlamayın.

Minimal bir aracı örneği:

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)

Bu çağrı daha önce ANTHROPIC_API_KEY ve ayrı API faturalandırması gerektiriyordu. Artık plan kredinizden düşülür.

TypeScript

Kurulum:

npm install @anthropic-ai/claude-agent-sdk

Claude Code ile giriş yapın:

claude login

Minimal TypeScript 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);

CI runner, Docker container veya uzak geliştirme ortamı gibi yerlerde SDK Claude Code kimlik bilgilerini otomatik bulamayabilir. Bu durumda kimlik bilgilerini ortam değişkenleriyle sağlayabilirsiniz. Anthropic, değişken adlarını Agent SDK belgelerinde yayınlıyor.

Claude Code girişiniz SDK kurulumundan önce yapılandırma hatası veriyorsa, geçersiz custom3p kurumsal yapılandırma düzeltmesi yaygın nedeni kapsar.

claude -p ile etkileşimsiz iş akışları

Agent SDK kredisini kod yazmadan kullanmanın bir yolu da Claude Code içindeki claude -p komutudur.

-p, Claude Code'u etkileşimsiz moda alır. Komutu verirsiniz, deponuz üzerinde çalışır ve çıkar. Sohbet oturumu açılmaz. Bu mod; CI pipeline'ları, cron işleri ve Git hook'ları için uygundur.

Örnek: staged diff üzerinde güvenlik ve kırıcı değişiklik kontrolü yapan pre-commit hook.

#!/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 yaklaşım, otonom döngüler için /goal komutu ve çalıştırmalar arasında bağlamı korumak için AGENTS.md dosyaları ile iyi çalışır.

GitHub Actions entegrasyonu

Claude Code GitHub Actions entegrasyonu da SDK kredisi kapsamındadır.

Claude'u PR incelemelerine, issue ön elemesine veya sürüm notu üretimine bağladıysanız, bu workflow çalıştırmaları artık GitHub App'i kuran kullanıcının Agent SDK kredisinden düşülür.

Bu, otomasyonun sürekli çalıştığı ve faturanın API anahtarına yazıldığı Claude Code üzerine kurulu GitHub ön eleme botu Clawsweeper gibi projeler için kullanışlıdır.

Gerçek aracılar oluşturma: SDK + Apidog

Agent SDK'nın asıl değeri, yalnızca metin üretmeyen; gerçek API'lere bağlanan, veritabanlarını sorgulayan veya dağıtım yapan aracılarda ortaya çıkar.

Bunun güvenilir çalışması için aracının çağırdığı her API'nin açık bir sözleşmesi olmalıdır. Aksi halde aracı endpoint yapılarını tahmin eder ve siz zamanınızı hatalı payload'ları düzeltmeye harcarsınız.

Apidog bu iş akışına şu şekilde oturur:

1. API sözleşmesini önce Apidog'da tanımlayın. Endpoint'leri, request/response şemalarını ve örnek payload'ları belirleyin.
2. OpenAPI çıktısını dışa aktarın. Bunu aracınıza bağlam olarak verin.
3. SDK ile aracı gerçek endpoint'lere bağlayın. Aracı, doğruluğu tanımlı şemalara göre API çağrısı yapar.
4. Apidog CLI ile doğrulayın. Her aracı çalıştırmasında API'nin sözleşmeye uygun yanıt verdiğini test edin.

MCP sunucuları üzerinden başka araçları yöneten aracılar için Apidog ile MCP sunucu test iş akışı da kullanılabilir. Böylece aracınızın çağırdığı araçlar için uçtan uca test kapsamı elde edersiniz.

Daha geniş yaklaşım için tasarım odaklı API iş akışı kılavuzuna bakabilirsiniz. Aracının doğrulayabileceği bir sözleşme olduğunda, JSON şema hatalarını kovalamak yerine daha iyi API sözleşmeleri yazmaya odaklanırsınız.

Agent SDK projeleriniz için sözleşme katmanı istiyorsanız Apidog'u ücretsiz indirebilirsiniz.

Ne zaman ayrı API anahtarı kullanmalısınız?

Plan tabanlı kredi çoğu geliştirici için iyi varsayılandır. Ancak bazı durumlarda ayrı API anahtarı daha uygundur:

• Tahmin edilebilir bütçeye ihtiyaç duyan üretim araçları: Plan kredileri sabit tutarlıdır. Daha yüksek veya sınırsız ölçek gerekiyorsa, kullanıma dayalı API anahtarı daha temiz faturalandırma sağlar.
• Çoklu organizasyon erişimi: API anahtarları tek bir kullanıcı koltuğuna bağlı değildir. Ekip ortak bir faturalandırma kaynağı istiyorsa API anahtarı daha uygundur.
• Enterprise Standard koltukları: Bu koltuklar Agent SDK kredisi almaz. SDK kullanımı için API anahtarı gerekir.

Ücretsiz Claude API erişim kılavuzu, Pro plan veya ücretli API anahtarı gerektirmeyen kullanım yollarını kapsar.

Başlamadan önce kontrol listesi

• [ ] Planınızın uygun olduğunu doğrulayın: Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise kullanıma dayalı veya Enterprise Premium koltuk
• [ ] Agent SDK kredisi için bir defalık katılımı tamamlayın
• [ ] Ek kullanımı açıp açmayacağınıza karar verin
  • Prototip: kapalı
  • Üretim: açık
• [ ] SDK'yı planınıza bağlamak için claude login çalıştırın
• [ ] Python veya TypeScript SDK paketini kurun
• [ ] Minimal bir aracı oluşturun
• [ ] ANTHROPIC_API_KEY ayarlamadan çalıştığını doğrulayın
• [ ] İlk çalıştırmalardan sonra hesap ayarlarında kredi bakiyesini kontrol edin

Sıkça Sorulan Sorular

Plan kredisinin çalışması için eski ANTHROPIC_API_KEY değerini kaldırmam gerekir mi?

SDK, Claude Code'un yerel kimlik bilgilerini kullandığında plan tabanlı faturalandırmaya geçmek için claude login yeterlidir. Ortamınızda başka araçlar için ANTHROPIC_API_KEY varsa bırakabilirsiniz; SDK, plan kimlik doğrulaması mevcutsa onu kullanır.

Krediye karşı bir “istek” olarak ne sayılır?

Kredi istek sayısı olarak değil dolar olarak tanımlanır. Her SDK çağrısı, Anthropic'in API kullanım oranlarına göre ücretlendirilir. Model çağrısı, bağlam token'ları ve araç kullanımı maliyeti kredi bakiyenizden düşülür. Ek bir istek başı ücret yoktur.

Kredimi ekip arkadaşımla paylaşabilir miyim?

Hayır. Krediler kullanıcı başınadır ve devredilemez. Her Team veya Enterprise koltuğunun kendi kredi havuzu vardır.

Eski Anthropic API konsol bakiyeme ne olur?

Aynı kalır. Plan kredisi ayrı bir faturalandırma mekanizmasıdır. API konsolundaki ön ödemeli bakiye, API anahtarıyla çalışan işler için kullanılmaya devam eder.

Agent SDK, Claude Code ile aynı mı?

Hayır. Claude Code, Anthropic'in resmi CLI ve IDE uzantılarıdır. Agent SDK ise özel aracılar oluşturmak için kullanılan Python/TypeScript kütüphanesidir. Kredi; SDK'yı, claude -p komutunu, GitHub Actions entegrasyonunu ve üçüncü taraf Agent SDK uygulamalarını kapsar. Etkileşimli Claude Code normal plan kullanımında kalır.

GitHub Actions faturam değişir mi?

Resmi Claude Code GitHub Actions entegrasyonunu kullanıyorsanız ve krediyi kurulumu yapan kullanıcı talep ettiyse, bu çalıştırmalar artık API anahtarı faturalandırması yerine SDK kredisinden düşülür.

Kredi Agent SDK ve claude -p dışında çalışır mı?

Hayır. Kapsam şunlarla sınırlıdır: Python/TypeScript Agent SDK, claude -p, Claude Code GitHub Actions entegrasyonu ve üçüncü taraf Agent SDK uygulamaları. Diğer Claude kullanımları, isteğin kaynağına göre normal plan limitlerinize veya API anahtarınıza döner.