Politika ve belgelerin kontrol tarihi: 5 Kasım 2026. Terminal örneklerinin tamamı Bash kullanır; macOS, Linux ve Bash kullanan geliştirme ortamları için uygundur.

Max, Ultra veya Team satın aldıktan sonra hediye API kredilerini kendi programlarınızda ve ajanlarınızda kullanabilmek için önce bir Claude Console kuruluşuna bağlamanız gerekir.

Tüm süreci şu sırayla tamamlayabilirsiniz:

Uygunluğu doğrula → Console kuruluşunu bağla → hediye bakiyeyi görüntüle → API anahtarı oluştur → küçük bir istek gönder → kuruluşu ve kullanım kayıtlarını doğrula → claude -p yapılandır.

En önemli nokta, abonelik hesabının, Console kuruluşunun, API anahtarının ve gerçek isteğin faturalandırma yolunun birbiriyle eşleşmesidir. Modelden yanıt almak yalnızca isteğin başarılı olduğunu gösterir. Hangi kuruluşun ve hangi bakiyenin kullanıldığını doğrulamak için ek kontrol gerekir.

1. Önce ne kadar kredi alabileceğinizi ve kimin talep edebileceğini doğrulayın

Mevcut aylık API kredisi programındaki tutarlar şöyle:

Plan veya koltukAylık hediye API kredisiKredinin yatırıldığı yer
Max100 ABD dolarıBağlı tek bir Console kuruluşu
Ultra200 ABD dolarıBağlı tek bir Console kuruluşu
Team StandardKoltuk başına 20 ABD dolarıEkibin ortak havuzu
Team PremiumKoltuk başına 100 ABD dolarıEkibin ortak havuzu
Team ekibinin tamamıEn fazla 500 ABD dolarıAynı kuruluşun ortak bakiyesi

Örneğin 3 Standard ve 2 Premium koltuk için nominal aylık hediye tutarı:

3 × 20 + 2 × 100 = 260 ABD doları

10 Premium koltuk da ekip genelindeki aylık 500 ABD doları sınırına tabidir.

Talep öncesinde iki koşul sağlanmalıdır: plan aktif ve sorunsuz durumda olmalı; yeni aboneler uygun bir planda en az yedi günü tamamlamış olmalıdır. iOS veya Android üzerinden alınan abonelikler de programa katılabilir, ancak krediler web üzerinden talep edilir. Önce Claude Platform hesabına ödeme kartı eklemek gerekmez.

Resmî aylık kredi politikası · Platformda talep ve kredilerin uygulanması

Her iki taraftaki yetkileri de kontrol edin:

NeredeTalep için gereken rol
Max / Ultra aboneliği tarafındaAbonenin kendisi
Team aboneliği tarafındaPrimary Owner veya Owner
Krediyi alacak Console kuruluşundaOwner, Admin veya Billing

Buradaki yedi gün, API credits talep etme uygunluğuna ilişkin bir koşuldur; Ultra otomatik doğrulamasının tamamlanma süresini göstermez.

2. Web üzerinden Console kuruluşunu bağlayıp kredileri talep edin

Max ve Ultra için şu sayfayı açın:

Team için Owner veya Primary Owner şu sayfayı açar:

Şu adımları izleyin:

  1. API credits bölümünü bulun.
  2. Link organization düğmesine basın.
  3. Kredileri alacak Claude Console kuruluşunu seçin. Henüz bir kuruluşunuz yoksa sayfadaki akışı izleyerek oluşturabilirsiniz.
  4. Kuruluş adını ve gerçek kullanım amacını kontrol edin.
  5. İlgili koşulları okuyup bağlantıyı onaylayın.
  6. Console içindeki Billing sayfasını açıp kredilerin yatırıldığını kontrol edin.

Bağlantı kurmadan önce doğru kuruluşu seçtiğinizden emin olun. Mevcut kurallara göre bir plan yalnızca bir Console kuruluşuna bağlanabilir; bir Console kuruluşu da bu hediyeyi yalnızca bir plandan alabilir. Bağlantıyı daha sonra kendiniz değiştiremezsiniz; destekle iletişime geçmeniz gerekir.

Platformda talep ve kredilerin uygulanması

Team üyelerinin ayrı ayrı talepte bulunması gerekmez. Yetkili sorumlu kuruluşu bağlar; daha sonra bu kuruluşun API anahtarlarını kullanan üyeler ortak bakiyeyi tüketir.

Talep seçeneğini göremiyorsanız önce planı, abonelik süresini, oturum açtığınız hesabı ve her iki taraftaki rolleri kontrol edin; ardından resmî desteğe başvurun.

3. Bakiye nereden görüntülenir, hangi alanlar izlenir?

Talep işlemi sonrasında şu sayfayı açın:

Önce Promotional credits bölümüne bakın ve şunları kaydedin:

  • Bu sefer yatırılan hediye tutarı;
  • Ekranda görünen kullanılabilir bakiye;
  • Son kullanma tarihi;
  • Şu anda seçili olan Console kuruluşu.

Ardından satın alınmış bakiyeyi ve Auto-reload ayarlarını ayrı ayrı kontrol edin.

Aylık hediye krediler satın alınmış kredilerden önce kullanılır. Kullanılmayan kısım ilgili dönemin sonunda sona erer ve devretmez. Yıllık planlarda da krediler aylık yatırılır. Önemli bir ayrıntı: otomatik yükleme, satın alınmış bakiyeye göre tetiklenir. Hediye krediler hâlâ dururken bile yükleme yapılabilir.

Platformda talep ve kredilerin uygulanması

Hesapları uzlaştırırken şu üç tür sayıyı birbirinden ayırın:

GöstergeHangi soruyu yanıtlar?
Billing içindeki bakiye, hediye kayıtları ve son kullanma tarihiNe kadar kaldı, nereden geldi, ne zaman sona erecek?
İstek yanıtındaki usageBu istek kaç token kullandı?
Usage / Cost raporları veya CLI maliyet tahminiTüketim nerede oluştu, yaklaşık veya gerçek maliyeti ne kadar?

usage doğrudan dolar bakiyesi değildir. CLI içindeki total_cost_usd de tutarın hediye kredilerden düşüldüğünü kanıtlamaz. Mevcut Cost Analytics maliyet alanları credits uygulanmadan önceki tutarı gösterir; raporlar da gecikmeli güncellenebilir.

Kullanım ve maliyet analitiği

4. Doğru workspace içinde API anahtarı oluşturun

Şu sayfayı açın:

Kişisel alıştırma için şu yolu izleyebilirsiniz:

  1. Console içinde seçili kuruluşun hediye kredileri alan kuruluş olduğunu doğrulayın.
  2. Create key düğmesine basın.
  3. monthly-credit-demo gibi kolay tanınan bir ad yazın.
  4. İhtiyacınıza göre bir son kullanma tarihi belirleyin.
  5. Linked account alanında kendi hesabınızı seçerek personal key oluşturun.
  6. Erişim izniniz bulunan normal bir API workspace seçin ve yalnızca bu workspace kapsamındaki anahtarı oluşturun.
  7. Oluşturma sırasında gösterilen anahtarı saklayın; kuruluşu, workspace ve anahtar adını not edin.

Anahtarın tamamı yalnızca oluşturulduğu anda gösterilir. Kişisel geliştirme için personal key yeterlidir. Ortak hizmetler veya üretim sistemleri için kuruluşun yönetim gereksinimlerine göre service account kullanılabilir.

API anahtarı oluşturma

İki yetki ayrıntısına daha dikkat edin:

  • Kredi talep edebilmek, anahtar oluşturabileceğiniz anlamına gelmez. Billing rolü ağırlıklı olarak fatura ve kullanım yönetir; anahtar oluşturmak için uygun kuruluş ve workspace yetkileri gerekir.
  • Workspace oluşturmak için kuruluş yöneticisi olmak gerekir. Normal üyeler zaten erişim izni aldıkları workspace seçmelidir. Düğme kullanılamıyorsa yöneticiden rolü ve üyeliği kontrol etmesini isteyin.

Alıştırma anahtarını elle oluşturmak için Claude Code özel workspace seçmeyin. Resmî açıklamaya göre bu workspace anahtarlarını Claude Code oturum açma akışı yönetir.

Console rolleri ve yetkileri · Workspace yönetimi

Aşağıdaki örneklerin tamamı, oluşturulurken tek workspace seçilmiş bir anahtar kullanır. Mevcut API, workspace ile sınırlandırılmamış anahtarlar için ek bir workspace header ister. Bu iki anahtar türünün kullanımını karıştırmayın.

API kimlik doğrulaması ve sürümü

5. Geçici bir terminal ortamı hazırlayın

İlk denemeyi ayrı bir terminalde yapmanız ve anahtarı yalnızca mevcut oturumda tutmanız önerilir.

Önce Bash başlatın:

bash --noprofile --norc

Ardından şunları çalıştırın:

set +x
umask 077

unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN CLAUDE_CODE_OAUTH_TOKEN ANTHROPIC_BASE_URL
unset CLAUDE_CODE_USE_BEDROCK CLAUDE_CODE_USE_VERTEX
unset CLAUDE_CODE_USE_FOUNDRY CLAUDE_CODE_USE_ANTHROPIC_AWS
unset CLAUDE_CODE_EFFORT_LEVEL

mkdir -p "$HOME/claude-api-credit-demo"
cd "$HOME/claude-api-credit-demo"

Bu geçici ayarlar, alıştırmayı açıkça Anthropic birinci taraf API hizmetine yöneltmek içindir. Kuruluş tarafından yönetilen Claude Code yine de ağ geçidi veya sağlayıcı politikasına tabi olabilir. Beklenen yönlendirme oluşmuyorsa kontrol için yöneticiyle iletişime geçin.

Claude Code kimlik doğrulaması ve öncelikler

Sonra aşağıdaki satırı tek başına çalıştırın, yeni oluşturduğunuz anahtarı yapıştırıp Enter tuşuna basın. Girdi ekranda görünmez:

read -r -s -p 'Bağlı kuruluşun API anahtarını yapıştırın, Enter tuşuna basın: ' ANTHROPIC_API_KEY

Giriş tamamlandıktan sonra şunları çalıştırın:

printf '\n'
export ANTHROPIC_API_KEY

Gerçek anahtarı makaledeki örneklere, betik kaynak koduna veya komut geçmişine yazmayın. Doğrulamak için echo ile ekrana basmanız da gerekmez.

6. curl ile ilk küçük isteği gönderin

Bu bağlantı örneği sabit olarak claude-haiku-5-5 kullanır, çıktıyı sınırlar ve thinking özelliğini kapatır. Parametre birleşimi bu modele özeldir. Modeli değiştirirseniz desteklenen parametreleri yeniden kontrol edin.

Haiku 5.5 model belgeleri · Thinking parametreleri

Önce istek dosyasını oluşturun:

cat > request.json <<'JSON'
{
  "model": "claude-haiku-5-5",
  "max_tokens": 128,
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Yalnızca şunu yanıtla: API bağlantısı başarılı"
    }
  ]
}
JSON

Sonra isteği gönderin:

curl --disable --silent --show-error \
  --connect-timeout 10 --max-time 60 \
  --dump-header response.headers \
  --output response.json \
  --write-out 'HTTP %{http_code}\n' \
  --config - <<EOF
url = "https://api.anthropic.com/v1/messages"
request = "POST"
header = "Authorization: Bearer ${ANTHROPIC_API_KEY}"
header = "anthropic-version: 2026-10-21"
header = "content-type: application/json"
data-binary = "@request.json"
EOF

Bu komut iki dosya oluşturur:

  • response.json: içerik, durma nedeni ve token kullanımını içeren yanıt gövdesi;
  • response.headers: istek kimliği, kuruluş, workspace ve diğer bilgileri kontrol etmek için yanıt başlıkları.

Anahtar curl komutuna standart girdiden iletilir; doğrudan komut satırı argümanlarına konmaz. --disable ilk sıradadır; böylece mevcut .curlrc bu küçük testin davranışını değiştirmez.

Mevcut resmî API sürümü 2026-10-21 olup API anahtarını Authorization: Bearer ile kabul eder. Tek workspace kapsamlı anahtarda workspace seçim başlığı atlanabilir.

API kimlik doğrulaması ve sürümü

Yanıt gövdesini görüntüleyin:

python3 -m json.tool response.json

Özellikle şunları kontrol edin:

  1. HTTP durumunun 200 olup olmadığı.
  2. content içinde metin içeriği bulunup bulunmadığı.
  3. stop_reason alanının normal bitişi mi, max_tokens sınırına ulaşmayı mı gösterdiği.
  4. usage içinde gerçekte kaç girdi, çıktı ve önbellek token bildirildiği.

Ardından kontrol edilecek yanıt başlıklarını çıkarın:

python3 - <<'PY'
from pathlib import Path

wanted = {
    "request-id",
    "anthropic-organization-id",
    "anthropic-workspace-id",
}

for line in Path("response.headers").read_text(
    errors="replace"
).splitlines():
    name, sep, value = line.partition(":")
    if sep and name.lower() in wanted:
        print(name.lower() + ":", value.strip())
PY

Dönen kuruluş ve workspace kimliklerini Console kayıtlarıyla eşleştirin. İstek başarılıysa, kuruluş doğruysa ve kullanım kaydı beklenen workspace içinde görünüyorsa çağrının doğrulama zinciri tamamlanır.

7. Aynı krediyi Python SDK ile kullanın

API hizmetini kendi programınıza bağlayacaksanız resmî Python SDK kullanabilirsiniz. Mevcut belgeler Python 3.10 veya üstünü gerektirir.

Alıştırma dizininde sanal ortam oluşturun:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade anthropic

call_api.py dosyasını oluşturun:

import json
import os
import anthropic

with anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://api.anthropic.com",
    timeout=30.0,
    max_retries=0,
) as client:
    raw = client.messages.with_raw_response.create(
        model="claude-haiku-5-5",
        max_tokens=128,
        thinking={"type": "disabled"},
        output_config={"effort": "low"},
        messages=[
            {"role": "user", "content": "Yalnızca şunu yanıtla: API bağlantısı başarılı"}
        ],
    )

    message = raw.parse()

    for name in (
        "request-id",
        "anthropic-organization-id",
        "anthropic-workspace-id",
    ):
        print(name + ":", raw.headers.get(name, "(döndürülmedi)"))

    print("model:", message.model)
    print("stop_reason:", message.stop_reason)

    for block in message.content:
        if block.type == "text":
            print(block.text)

    print(json.dumps(message.usage.model_dump(), ensure_ascii=False))

Çalıştırın:

python call_api.py

raw.parse() zaten alınmış yanıtı ayrıştırır; ikinci bir model isteği göndermez. İlk doğrulamada bir çalıştırmayı bir istekle eşleştirebilmek için örnekte otomatik yeniden denemeler kapatılmıştır. Üretim sisteminde yeniden denemeleri daha sonra iş gereksinimlerinize göre tasarlayabilirsiniz.

Python SDK belgeleri

8. claude -p komutunu bu kredileri kullanacak şekilde yapılandırın

Resmî açıklama önemli bir kapsam koşulunu açıkça belirtir:

claude -p veya Agent SDK komutunu kendiniz çalıştırır ve bağlı Console kuruluşunun API anahtarını kullanırsanız bu aylık hediye kredilerden yararlanabilirsiniz.

Claude aboneliğiyle oturum açıyorsanız tüketim yine abonelik planından karşılanır. Claude Code GitHub Action, IDE uzantısı veya Claude masaüstü uygulaması tarafından başlatılan çalıştırmalar, -p içerseler bile bu kapsam koşulundan yararlanamaz.

Resmî aylık kredi politikası

Bu nedenle bu bölümü kendiniz açtığınız bağımsız bir işletim sistemi terminalinde uygulayın ve önceki adımlarda yapılandırdığınız API anahtarını kullanmaya devam edin.

Önce sürümü kontrol edin:

claude --version

Bu makale Haiku 5.5 tam model kimliğini kullanır. Resmî gereksinim Claude Code v2.1.293 veya üstüdür. CLI kurulu değilse veya eskiyse kendi kurulum yönteminize uygun resmî kurulum ve güncelleme talimatlarını izleyin.

Claude Code kurulumu ve güncellemesi · Claude Code model yapılandırması

Önce kimlik doğrulama kaynağını inceleyebilirsiniz:

claude auth status

Mevcut JSON çıktısındaki authMethod alanı api_key, claude.ai veya third_party gibi kimlik kaynaklarını ayırt etmeye yardımcı olur.

Ancak api_key yalnızca bu kimlik doğrulama kaynağının tanındığını belirtir. Tek başına anahtarın geçerli olduğunu, doğru kuruluşa ait olduğunu veya hediye bakiyenin yatırıldığını kanıtlamaz.

Claude Code CLI başvuru kaynağı

Ardından en küçük görevi çalıştırın:

claude --bare -p 'Yalnızca şunu yanıtla: API bağlantısı başarılı' \
  --model claude-haiku-5-5 \
  --effort low \
  --tools '' \
  --max-turns 1 \
  --max-budget-usd 0.10 \
  --output-format json \
  --no-session-persistence > claude-result.json

Parametrelerin her biri neyi kontrol eder?

ParametreBu alıştırmadaki işlevi
--bareOAuth / sistem keychain verilerini okumaz; hooks, skills, eklenti, MCP ve diğer otomatik keşifleri atlar
-pEtkileşimsiz çalışır, sonucu yazdırıp çıkar
--modelGünlük oturumdaki model seçimini devralmak yerine modeli açıkça belirtir
--effort lowDaha düşük akıl yürütme çabası ister
--tools ''Yerleşik araçları kapatır; ilk aşamada yalnızca metin çağrısını doğrular
--max-turns 1Ajan tur sayısını sınırlar
--max-budget-usd 0.10İstemci maliyet tahmini için eşik belirler
--output-format jsonİncelenebilir yapılandırılmış sonuç saklar
--no-session-persistenceBu oturumu sonradan sürdürmek için kaydetmez

--bare açıkça verilen ayarları ve bulut platformu kimlik bilgilerini yine destekler; dolayısıyla önceki ortam kontrolü önemini korur. Burada ek MCP, eklenti veya dizin verilmez.

Ayrıca --max-budget-usd istemci maliyet tahminine dayanır; faturanın kesinlikle aşmayacağı katı bir üst sınır değildir. --max-turns da token sınırı anlamına gelmez. Görevi büyütmeden önce Console harcama kontrollerini de ayarlayın.

Claude Code programatik çalıştırma · Claude Code CLI başvuru kaynağı

Sonucu görüntüleyin:

python3 - <<'PY'
import json
from pathlib import Path

data = json.loads(Path("claude-result.json").read_text())

print("is_error:", data.get("is_error"))
print("result:", data.get("result"))
print("estimated_cost_usd:", data.get("total_cost_usd"))
print("usage:", data.get("usage"))
PY

Bir alan dönmezse onu bilinmeyen olarak bırakın; otomatik olarak sıfır yazmayın. Komut başarısız çıkarsa standart hatayı ve sonuç dosyasını da inceleyin. Ayrıştırma adımının çıktı üretmemesi, hiç istek yapılmadığı anlamına gelmez.

9. Tüketim yolunun doğru olduğu nasıl doğrulanır?

Küçük testten sonra şu sırayla kontrol edin:

  1. Anahtarın aidiyeti doğru: hediye krediyi alan Console kuruluşunda oluşturulmuş.
  2. Workspace doğru: anahtar oluşturulurken hedef workspace seçilmiş; API yanıtının verdiği kimlikler de eşleşiyor.
  3. Çağrı kanalı doğru: birinci taraf API veya resmî koşullara uyarak kendiniz çalıştırdığınız claude -p.
  4. Kullanım kaydı doğru: Console içinde ilgili workspace üzerinde bu kullanıma ait kayıt görünüyor.
  5. Bakiye kayıtları doğru: Promotional credits, satın alınmış bakiye, yatırma ve son kullanma kayıtları birlikte uzlaştırılmış.

Kuruluşta hem hediye hem satın alınmış bakiye varsa platform kurala göre önce hediye bakiyeyi kullanır. Her isteğe ayrıca “hediye krediyi kullan” parametresi eklemeniz gerekmez.

Raporlar gecikmeli güncellenebilir; küçük isteğin maliyeti de çok düşük olabilir. Arayüzde henüz belirgin değişim görünmüyorsa sırf değişiklik görmek için peş peşe yeniden çalıştırmayın.

Platformda talep ve kredilerin uygulanması

10. Yaygın sorunlar nasıl incelenir?

BelirtiÖnce kontrol edilecekler
API credits bölümü görünmüyorPlan, yedi günlük uygunluk, açık hesap ve her iki taraftaki roller
Kredi alınabiliyor ama Create key kullanılamıyorConsole rolü, workspace üyeliği ve oluşturma yetkileri
HTTP 401Anahtarın doğruluğu, geçerliliği ve mevcut shell ortamına export edilmesi
HTTP 403Anahtar, workspace, model veya kaynak erişim yetkileri
HTTP 400Somut hata türü; istek parametreleri, sürüm, workspace ve ilgili harcama sınırları
HTTP 402 / billing_errorKuruluşun faturalandırma durumu, bakiyesi ve ödeme durumu
HTTP 404Model kimliği, endpoint ve kaynağın kullanılabilirliği
HTTP 429İstek / token hız sınırlarını ilgili harcama üst sınırlarından ayırın; somut hatayı ve yanıt bilgilerini okuyun
stop_reason değeri max_tokensÇıktı sınırına ulaşılmış; istek başarılı olabilir ama içerik tamamlanmamış olabilir
curl çalışıyor, CLI çalışmıyorCLI sürümü, API anahtarının ortamda ayarlanması, sağlayıcı / ağ geçidi yönlendirmesi ve kuruluş politikası
CLI çalışıyor ama hediye bakiye belirgin azalmıyorKapsam koşulları, doğru kuruluş, rapor gecikmesi veya ekranın gösterim hassasiyeti

Her hatayı “bakiye yetersiz” diye açıklamayın. Tersine, bakiyenin kalması da kuruluş harcama sınırının, workspace bütçesinin veya hız limitlerinin kaldırıldığı anlamına gelmez.

API hataları · Hız ve harcama sınırları

Team sorumluları projelere uygun workspace ve üye yetkileri atamalı, harcama bildirimlerini de ayarlamalıdır. Default Workspace şu anda ayrı bir workspace harcama sınırını desteklemez. Proje bazlı bütçe gerektiğinde yönetici uygun bir normal API workspace oluşturmalıdır.

Workspace yönetimi · Hız ve harcama sınırları

Alıştırmayı bitirince mevcut oturumdaki anahtarı kaldırıp geçici Bash ortamından çıkabilirsiniz:

unset ANTHROPIC_API_KEY
exit

Böylece alt shell içindeki geçici ortam ayarları sona erer; üst terminalin önceki ortamı korunur.

Tam örnekleri aşağıdan indirip kendi alıştırma dizininizde inceleyebilir ve kullanabilirsiniz. Kod sözdizimi ve çevrimdışı akış kontrollerinden geçti; okuyucu hesaplarıyla gerçek model isteği çalıştırılmadı.