Claude API Kimlik Doğrulama Yöntemleri ve Kurulumu
Anthropic API anahtarı, AWS IAM, Google ADC veya Microsoft Entra kullanarak Claude istemcisini yapılandırın. VPS üzerinde güvenli kimlik bilgisi yönetimi için gerekli adımlar.
Claude API kimlik doğrulama rotaları
Claude API kimlik doğrulaması tek bir karara dayanır: istemcinizin ağ üzerinden hangi kimlik bilgisini gönderdiği. Anthropic, doğrudan Claude API'ye ek olarak beş bulut platformunu listeler: Amazon Bedrock, AWS üzerinde Claude Platform, Google Cloud üzerinde Claude Modelleri (Google tarafından yönetilen), Google Cloud üzerinde Claude Modelleri (Anthropic tarafından yönetilen) ve Microsoft Foundry. Doğrudan Anthropic API, bir API anahtarını veya Authorization: Bearer başlığında kısa süreli bir belirteci kabul eder; ayrıca eski x-api-key başlığında API anahtarlarını kabul etmeye devam eder. Amazon Bedrock, AWS istek imzalama ve Bedrock API anahtarlarını destekler; bu kurulumda hiçbir Anthropic anahtarı bulunmaz. Google Cloud, kısa süreli bir Google erişim belirteci gönderir. Microsoft Foundry, Azure tarafından verilen bir anahtarı veya Microsoft Entra belirtecini kullanır. Aşağıdaki dört bölüm bu kimlik bilgisi kurulumlarını kapsar; Anthropic tarafından yönetilen AWS ve Google Cloud teklifleri, kendi bulut karşılıklarıyla birlikte açıklanmıştır.
Bu kılavuz, bir Linux sunucusunda çalışan bir servise SDK (yazılım geliştirme kiti) entegre etmek içindir. Bunun yerine Claude Code komut satırı aracını yapılandırıyorsanız değişkenler ve akış farklıdır: bkz. Claude Code'u Bedrock veya Vertex'e yönlendirme. Servis henüz mevcut değilse, önce bir VPS üzerinde ilk Claude API uygulaması ile oluşturun ve kimlik bilgisi için buraya geri dönün.
Aşağıdaki her şey, Ağustos 2026'da Anthropic platform belgelerine göre kontrol edilmiş ve 16 Ekim 2026'da her sağlayıcının belgelerine göre tekrar doğrulanmıştır; Bedrock model erişim detayları 19 Ekim 2026'da AWS belgelerine göre tekrar kontrol edilmiştir. Anthropic'in dört rotanın tamamı, API anahtarları ve API sürümleri için sayfaları 27 Ekim 2026'da tekrar kontrol edilmiştir. Microsoft Foundry, her iki Bedrock uç noktası, Google tarafından yönetilen rota, AWS üzerinde Claude Platform, kimlik doğrulama, Workload Identity Federation ve API sürümleri için Anthropic sayfaları, Ruby SDK'sının değişiklik günlüğü ile birlikte 10 Kasım 2026'da tekrar kontrol edilmiştir. Model tanımlayıcıları, fiyatlar, SDK sürümleri ve uç nokta yapıları sürekli değiştiğinden, bu kılavuz güncelliğini yitirebilecek değerleri yazdırmak yerine sağlayıcı sayfalarına bağlantı vermektedir.
Yol 1: Bir Anthropic API anahtarı
Bu doğrudan yoldur ve Anthropic'in gizli anahtarı sağladığı tek yöntemdir. İstekler Anthropic API sunucusundaki Messages uç noktasına gönderilir ve her istek üç başlık (header) taşır.
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'MODEL_ID kısmını Anthropic'in model genel bakış sayfasından güncel bir tanımlayıcı ile değiştirin. Sağlıklı bir yanıt, content dizisini ve usage nesnesini içeren bir JSON verisidir. Hatalı veya süresi dolmuş bir anahtar, authentication_error ile birlikte HTTP 401 hatası döndürür. Eksik bir anthropic-version başlığı ayrı bir hata türüdür; çünkü bu başlık her istekte zorunludur ve SDK'lar bunu sizin yerinize ayarlar. Ekim 2026 itibarıyla Anthropic belgeleri, anahtarı göndermenin ana yolu olarak Authorization: Bearer yöntemini sunmakta ve x-api-key yöntemini eski (legacy) olarak nitelendirmektedir. Ancak her ikisi de kabul edildiğinden yukarıdaki komut çalışmaya devam eder. Güncel SDK ana sürümleri anahtarı Authorization: Bearer olarak da gönderir; bu nedenle X-Api-Key değerini okuyan bir proxy veya ağ geçidi, yükseltme yapıldığında güncellenmelidir. Komuttaki 2023-06-01 sürümü hala kabul edilmektedir; Anthropic'in en yeni API sürümü 2026-10-21'tür. SDK sürümleri bunu varsayılan olarak gönderir ve temperature gibi bazı eski istek parametrelerini reddeder.
İstemci oluşturma süreci bu kurulumlar arasındaki en kısa olanıdır, çünkü oluşturulacak bir şey yoktur. Her resmi SDK, ANTHROPIC_API_KEY değerini ortam değişkenlerinden otomatik olarak okur.
import os
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model=os.environ["CLAUDE_MODEL"],
max_tokens=64,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)Model tanımlayıcısını anahtarın yanında ortam değişkenlerinde tutmak faydalıdır. Model isimleri sizin kontrolünüzde olmayan bir takvimle değişir; tek bir metin dizisini düzenlemek için kodu yeniden dağıtmak gereksiz bir iş yüküdür.
Anahtarlar, oluşturulma anında bir son kullanma tarihi seçtiğiniz Konsol üzerinden üretilir: 3 saat, 1 gün, 7 gün, 30 gün, özel bir süre veya Asla seçenekleri mevcuttur; bu seçenekler kuruluşunuzun maksimum geçerlilik politikasına tabidir. Son kullanma tarihi oluşturma anında sabittir ve daha sonra değiştirilemez. Anthropic, uzun ömürlü bir anahtarın süresi dolmadan önce anahtarı oluşturan kişiye e-posta gönderir, ancak kısa ömürlü bir anahtarın süresi dolduğunda herhangi bir uyarı e-postası gönderilmez. Süresi dolmuş bir anahtar 401 hatası döndürür ve yeniden etkinleştirilemez; bu durumda çözüm her zaman yeni bir anahtar oluşturmaktır.
Doğrudan API kullanımında seçilecek bir bölge yoktur ve fatura doğrudan Anthropic kuruluşunuza yansıtılır. Çalışma alanları (workspaces), bir anahtarı tek bir projeyle sınırlandırır; bu, tek bir servisin ne kadar harcama yaptığını görmenin en temiz yoludur. Bir sunucunun anahtarını oluştururken onu çalışma alanıyla sınırlandırın: Bir çalışma alanına atanmamış kişisel veya servis hesabı anahtarı, her istekte bir anthropic-workspace-id başlığı göndermek zorundadır; aksi takdirde API, invalid_request_error hatasıyla birlikte 400 yanıtı döner. Bir servis için servis hesabı anahtarı seçin; çünkü kişisel bir anahtar, onu oluşturan kişi kuruluştan ayrıldığında çalışmayı durdurur. Faturanın arkasındaki hesaplama mantığı için token başına API fiyatlandırmasının abonelikle karşılaştırması bölümüne bakın.
Buraya bir seçenek daha eklenmelidir, çünkü bu seçenek statik gizli anahtar ihtiyacını tamamen ortadan kaldırır. Workload Identity Federation, bir iş yükünün güvendiğiniz bir kimlik sağlayıcısından aldığı OpenID Connect (OIDC) token'ını, POST /v1/oauth/token adresinde kısa ömürlü bir Anthropic token'ı ile takas etmesine olanak tanır ve SDK bu token'ı süresi dolmadan önce yeniler. Hiçbir yerde sk-ant-api... dizisi oluşturulmaz veya kopyalanmaz. Bu yöntem, halihazırda bir platform kimliği taşıyan Kubernetes, GitHub Actions ve bulut sanal makineleri için uygundur. Standart bir VPS genellikle böyle bir sağlayıcıya sahip değildir; bu nedenle bu tür bir sistemde bir dosyada saklanan API anahtarı en gerçekçi çözümdür ve bu kılavuzun geri kalanı bu yaklaşımı esas alır.
Yol 2: Amazon Bedrock uzerinde AWS kimlik bilgileri
Bedrock üzerinde herhangi bir Anthropic anahtarı tutmazsınız. AWS kimlik bilgileri ile SDK, her HTTP isteğini AWS Signature Version 4 (SigV4) ile imzalar ve isteği yapan tarafın modeli çağırıp çağıramayacağına AWS karar verir.
pip install -U "anthropic[bedrock]"
aws sts get-caller-identityaws sts get-caller-identity, kimlik bilgilerinizin çözümlendiği kimliğin hesap numarasını ve ARN (Amazon Resource Name) bilgisini yazdırır. SigV4 kullanırken bu komutu diğer her şeyden önce çalıştırın. SigV4 için SDK; kurucu kimlik bilgilerini, ortam kimlik bilgilerini ve standart AWS kimlik bilgisi zincirini çözümler; bölge seçimi ise ayrı bir işlemdir. Python'ın AnthropicBedrock istemcisinde, api_key veya AWS_BEARER_TOKEN_BEDROCK aracılığıyla sağlanan bir Bedrock API anahtarı; eğer aws_access_key, aws_secret_key, aws_session_token veya aws_profile parametrelerini de gönderirseniz ValueError hatası döndürür. Bu açık argümanlar olmadan anahtar, AWS kimlik bilgisi zinciri yerine bearer kimlik doğrulamasını seçer. TypeScript istemcisi, Bedrock API anahtarına açık AWS kimlik bilgilerinden daha yüksek öncelik verir. STS komutu, bearer kimlik doğrulamasını test etmez.
İstemci oluşturma sürecinde değişen tek şey sınıf ve bir argümandır.
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-east-1")AnthropicBedrock, Bedrock'ın InvokeModel entegrasyonunu yönetir. Ekim 2026 itibarıyla Anthropic, Amazon Bedrock'taki Claude'u da belgelemektedir; Claude Opus 4.7 ve sonraki modeller için https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages adresindeki Messages API uç noktası, aynı paketten gelen bir AnthropicBedrockMantle istemcisi aracılığıyla erişilir. Bu uç nokta, AWS kimlik bilgilerini ve Bedrock bearer token'larını destekler; model erişim gereksinimleri aşağıda açıklandığı üzere iki uç nokta arasında farklılık gösterir.
pip install -U satırındaki yükseltmeyi izleyin. 27 Ekim 2026 itibarıyla en güncel SDK, Bedrock dahil olmak üzere varsayılan olarak 2026-10-21 API sürümünü gönderir. Anthropic, Claude Opus 4.6 ve öncesi için listelenen ARN sürümlü model kimliklerinin Bedrock üzerinde bu sürümü desteklemediğini ve 400 hatası döndürebileceğini belirtmektedir. Bir servis bu modellerden birini çağırıyorsa, SDK'yı mevcut sürümünde sabitleyin veya servisi öncelikle Claude 4.7 veya sonraki bir modele taşıyın.
Bölge seçimi burada sadece bir detay değildir. Bedrock uç noktaları bölge bazlıdır, sunulan Claude modelleri bölgeden bölgeye farklılık gösterir ve bölge, SigV4 imzasının bir parçasıdır; dolayısıyla bir bölge için hesaplanan imza, başka bir bölge tarafından reddedilir. AWS_REGION değerini servis ortamında açıkça ayarlayın, çünkü SDK'lar bu değer boş bırakıldığında ne yapılacağı konusunda ortak bir davranış sergilemez. Ekim 2026'da belgelendiği üzere, Python AnthropicBedrock istemcisi AWS_REGION veya AWS_DEFAULT_REGION değişkenlerini, ardından boto3 oturumunuzun veya AWS profilinizin (~/.aws/config dahil) bölgesini okur; hiçbir çözümleme yapılamazsa ValueError hatası verir. TypeScript istemcisi AWS_REGION değişkenini okur, ayarlanmadığında us-east-1 değerine döner ve bölge için ~/.aws/config değişkenini okumaz. AWS CLI'ın, bir Node sürecinin yanlış bölgeyi çağırdığı aynı makinede Claude modellerini başarıyla listeleyebilmesinin nedeni budur: CLI yapılandırma dosyanızı okumuş, istemci ise okumamıştır.
Bir EC2 örneğinde, bir IAM (kimlik ve erişim yönetimi) rolü eklersiniz ve diskte hiçbir gizli anahtar tutulmaz; çünkü örnek meta veri servisi SDK'ya geçici kimlik bilgileri sağlar. AWS dışındaki bir VPS'in ne örnek rolü ne de meta veri servisi vardır. Bu durumda, sunucuda duran ve Anthropic anahtarıyla aynı risk sınıfında olan uzun ömürlü bir IAM kullanıcısı erişim anahtarı çifti ile federasyon arasında seçim yaparsınız: kimlik sağlayıcınızda kimlik doğrulaması yapın, AWS STS'yi (güvenlik token servisi) çağırın ve döndürdüğü geçici kimlik bilgilerini kullanın. Bedrock ayrıca AWS_BEARER_TOKEN_BEDROCK aracılığıyla iletilen Bedrock API anahtarlarını da kabul eder ve AWS iki tür anahtar tanımlar. Kısa süreli bir anahtar 12 saate kadar veya onu oluşturan oturumun süresi kadar geçerlidir, oluşturan IAM kimliğinin izinlerini devralır ve AWS'nin üretim ortamları için önerdiği anahtar türüdür. Uzun süreli bir anahtar, oluştururken seçtiğiniz bir son kullanma tarihine kadar (örneğin --credential-age-days ile 30 veya 90 gün) geçerlidir veya bu API parametresi atlanırsa süresi dolmaz; Konsol bunun arkasında bir IAM kullanıcısı oluşturur ve AWS bunu yalnızca keşif amaçlı önerir. Uzun süreli bir anahtar yalnızca oluşturulduğu bölgede çalışır; başka bir bölgede kullanılması Credential should be scoped to a valid region hatası döndürür.
Fatura, Anthropic yerine AWS hesabınıza yansıtılır ki buraya gelmenizin asıl nedeni genellikle budur. Ekim 2026'da belgelendiği üzere, bölgesel uç noktalar küresel uç noktaya göre %10 daha maliyetlidir. AWS üzerindeki Claude Platform ayrı bir üründür: Anthropic tarafından işletilir, AWS tarafından AWS Marketplace üzerinden faturalandırılır ve SigV4 veya AWS Konsolu'nda oluşturulan bir API anahtarı ile (Claude Konsolu'ndan alınan anahtarlar burada çalışmaz) Anthropic'in beta olarak işaretlediği bir AnthropicAWS istemcisi aracılığıyla kimlik doğrulaması yapar. Bir Bedrock hatası, izin sorunu gibi göründüğü ancak öyle olmadığı için tanınmaya değerdir: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. Bu bir model yönlendirme sorunudur ve hiçbir kimlik bilgisi değişikliği bunu düzeltmeyecektir.
Rota 3: Vertex AI üzerinde Google kimlik bilgileri
Anthropic belgeleri artık bu rotayı, Google'ın Vertex AI'dan evrilen yeni ismi Agent Platform'un bir parçası olarak sunduğu Google Cloud üzerinde Claude Modelleri (Google yönetimli) olarak adlandırmaktadır. Aşağıda gösterilen aiplatform.googleapis.com ana bilgisayarı, anthropic[vertex] eklentisi ve AnthropicVertex sınıfı değişmemiştir.
Google Cloud, kimlik bilgilerini siz belirtmeden bulmak için Google kimlik doğrulama kütüphanelerinin izlediği sabit bir arama sırası olan Application Default Credentials (ADC) kullanır. ADC önce GOOGLE_APPLICATION_CREDENTIALS öğesini, ardından gcloud auth application-default login tarafından yazılan dosyayı ve son olarak meta veri sunucusu aracılığıyla eklenen hizmet hesabını kontrol eder.
pip install -U "anthropic[vertex]"
gcloud auth application-default loginBir iş istasyonunda oturum açma işlemi $HOME/.config/gcloud/application_default_credentials.json dosyasını yazar ve işlem tamamlanır. Bir sunucuda, insan kullanıcının kimlik bilgilerini saklamaktan kaçının; komut ayrıca hizmet hesabı kimliğine bürünmeyi de destekler. Google Cloud dışında Google meta veri sunucusu bulunmadığından, ADC'yi bir Workload Identity Federation yapılandırma dosyasına veya hizmet hesabı anahtar dosyasına yönlendirmek için GOOGLE_APPLICATION_CREDENTIALS kullanın. Hizmet hesabı anahtarı içeren bir JSON dosyası uzun ömürlü bir gizli bilgidir ve bu kılavuzun ilerleyen bölümlerinde açıklanan şekilde ele alınmalıdır. Google Cloud içinde, sanal makineye bir hizmet hesabı ekleyin; böylece korunması gereken bir dosya kalmaz. ADC'nin bulduğu kimlik, Agent Platform User (roles/aiplatform.user) gibi aiplatform.endpoints.predict iznini içeren bir IAM rolüne sahip olmalıdır.
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="my-project", region="global")SDK'nın altına inip ham HTTP kullanırsanız iki şey değişir. Model tanımlayıcısı istek gövdesinden çıkarak URL yoluna taşınır ve anthropic_version başlık kısmından gövdeye alınır. 27 Ekim 2026 itibarıyla Anthropic belgeleri, orada vertex-2023-10-16 veya daha yeni API sürümü olan 2026-10-21 kullanımını kabul etmektedir. Kimlik bilgisi, standart bir Google erişim belirtecidir. Aşağıdaki komutta gcloud auth print-access-token, ADC yerine gcloud CLI'ın kendi oturum açma bilgilerini kullanır, bu nedenle testi yaptığınız makinede önce gcloud auth login veya gcloud init komutunu çalıştırın.
curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Bölge, birinci sınıf bir argümandır. global kullanılabilirlik için dinamik yönlendirme yapar, us ve eu çok bölgeli tanımlayıcılardır ve us-east5 gibi bir isim tek bir bölgeyi sabitler. Ekim 2026 itibarıyla Anthropic, yalnızca Claude Sonnet 4.6 ve öncesi için tek bölgeli uç noktaları belgelemektedir; daha yeni modeller küresel veya çok bölgeli uç noktaları kullanır. Ekim 2026'da belgelendiği üzere, çok bölgeli ve bölgesel uç noktalar küresel uç noktalardan %10 daha maliyetlidir. Faturalandırma Google Cloud projesi üzerinden gerçekleşir, bu nedenle kota ve faturalar Google'a aittir.
27 Ekim 2026 itibarıyla Anthropic, Google Cloud üzerinde ikinci bir hizmeti daha belgelemektedir ve bunun istek yapısı farklıdır. Google Cloud üzerinde Claude Modelleri (Anthropic yönetimli) seçeneğinde Anthropic, Claude API'sini claude.googleapis.com adresinde, AnthropicGoogleCloud istemcisi aracılığıyla kendisi işletir. Yine de ADC dahil olmak üzere Google Cloud kimlik bilgileriyle kimlik doğrulaması yapılır, ancak istek doğrudan API'ye benzer: model gövdede kalır ve sürüm bilgisi anthropic-version başlığında iletilir. Erişim, kendi IAM rolleri (roles/claude.user ve ilgili olanlar) aracılığıyla sağlanır, kurulum proje için yeni bir Anthropic organizasyonu oluşturur ve kullanım Google Cloud Marketplace üzerinden faturalandırılır. İstek URL'leriniz aiplatform içeriyor ve :rawPredict ile bitiyorsa, bu bölümde açıklanan Google yönetimli rotayı kullanıyorsunuz demektir.
Rota 4: Microsoft Foundry, Azure rotasıdır
Azure üzerinde Claude araması yaptıysanız, istediğiniz bölüm burasıdır ve desteklenen bir rota mevcuttur. Claude, Microsoft Foundry (eski adıyla Azure AI Foundry) içinde çalışır ve Azure Marketplace üzerinden Claude Consumption Units olarak faturalandırılır. Bir Foundry kaynağı oluşturur, içinde bir Claude modeli dağıtır ve https://{resource}.services.ai.azure.com/anthropic/v1/* adresindeki Azure barındırmalı uç noktayı çağırırsınız.
İki kimlik bilgisi çalışır. Birincisi, Foundry portalındaki dağıtımın Ayrıntılar sekmesinden alınan ve api-key veya x-api-key başlığında gönderilen Azure tarafından verilmiş bir anahtardır. İkincisi, sunucuda daha iyi bir seçenek olan Microsoft Entra belirtecidir; çünkü bu durumda Azure rol tabanlı erişim denetimi, uç noktayı kimin çağırabileceğini yönetir.
ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)
curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
-H "content-type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'model alanı, bir model tanımlayıcısını değil, dağıtım adınızı taşır. İkisi varsayılan olarak eşleşir ve bir dağıtımı kendiniz adlandırdığınız anda eşleşmeyi bırakırlar; bu, aksi takdirde doğru olan bir istekte Deployment not found hatasının yaygın nedenidir. Python ve TypeScript SDK'ları, ANTHROPIC_FOUNDRY_API_KEY ve ANTHROPIC_FOUNDRY_RESOURCE değişkenlerini ortamdan okur. 10 Kasım 2026 itibarıyla belgelendiği üzere, Foundry desteği yedi resmi SDK'nın tamamını kapsar: C#, Go, Java, PHP, Python, Ruby ve TypeScript. Go, özel bir foundry paketi (go get github.com/anthropics/anthropic-sdk-go/v2/foundry) kullanır ve Ruby, 4 Kasım 2026'da yayınlanan gem sürüm 2.5.0 ile özel bir Anthropic::FoundryClient kazanmıştır. Bu sürümden önce, Ruby kodunun genel istemciyi Foundry temel URL'sine yönlendirmesi gerekiyordu.
Genel bir istemciyi Foundry temel URL'sine yönlendirmenin, 2.5.0 sürümünden önce yazılmış Ruby kodu veya Anthropic'in kendi Foundry örneklerinin bu şekilde çağırdığı ant CLI olsun, hala riskli bir tarafı vardır. Kimlik bilgilerini genel istemciye açıkça iletmezseniz ve ortamda hala ANTHROPIC_API_KEY veya ANTHROPIC_AUTH_TOKEN ayarlıysa, istemci bunu alır ve Anthropic kimlik bilgilerinizi bir Microsoft uç noktasına gönderir. Değişkeni kaldırın veya Foundry anahtarını ya da belirtecini istemciye açıkça iletin. Ruby'de, Foundry anahtarını veya bir Entra belirteç sağlayıcısını alan Anthropic::FoundryClient yapısına geçmek daha temiz bir çözümdür. Bir Entra erişim belirteci, 60 ila 90 dakika arasında rastgele bir varsayılan ömür alır, bu nedenle uzun süre çalışan bir sürecin bunu başlangıçta yakalamak yerine yenilemesi gerekir.
Sunucunuzdaki kimlik bilgisi ne kadar süre geçerli kalır?
Bu grafiğin arkasındaki veriler
[
{
"label": "Anthropic key, 30-day preset",
"max_lifetime_hours": 720
},
{
"label": "Anthropic key, 7-day preset",
"max_lifetime_hours": 168
},
{
"label": "AWS STS assumed role",
"max_lifetime_hours": 12
},
{
"label": "Bedrock short-term API key",
"max_lifetime_hours": 12
},
{
"label": "Entra ID access token, default upper bound",
"max_lifetime_hours": 1.5
},
{
"label": "Federated Anthropic token, default",
"max_lifetime_hours": 1
}
]Bunlar, her sağlayıcı tarafından yayınlanan ve Ekim 2026 itibarıyla okunan üst sınırlar ve varsayılan değerlerdir; ölçülmüş veriler değildir. Bunlar tek bir nedenden dolayı önemlidir: Sızdırılan bir kimlik bilgisinin, siz sızıntıyı fark edene kadar ne kadar süreyle çalışmaya devam edeceğini gösterirler. Tablonun alt kısmındaki federasyon Anthropic belirteci varsayılan olarak 1 saate kadar geçerlidir; bu süre aynı zamanda kimlik sağlayıcısının belirtecinin kalan ömrünün iki katı ile sınırlandırılmıştır. Bir Microsoft Entra erişim belirtecinin tek bir varsayılan değeri yoktur: Microsoft her birine 60 ile 90 dakika arasında (ortalama 75 dakika) rastgele bir ömür atar. Tabloda 1.5 saatlik üst sınır olarak gösterilen bu varsayılan değer; istemciye, kaynağa ve kiracıda Koşullu Erişim (Conditional Access) özelliğinin etkin olup olmadığına göre değişiklik gösterir. Hem istemci hem de kaynak Sürekli Erişim Değerlendirmesini (Continuous Access Evaluation) desteklediğinde, Entra bu süreyi 24 ila 28 saate kadar uzatabilir ve hesap devre dışı bırakılması gibi olaylarda belirteci gerçek zamanlıya yakın bir hızda iptal edebilir. Bir kiracı belirteç ömrü ilkesi, bu süreyi 10 dakika ile 23:59:59 arasında herhangi bir değere ayarlayabilir. SDK'lar federasyon Anthropic belirteçlerini otomatik olarak yeniler; Foundry üzerinde, sabit bir belirteç dizisi geçirmek yerine belirteçleri yenilemesi için bir Entra belirteç sağlayıcısı yapılandırın. Bir federasyon kuralı, kendi belirteç ömrünü bir dakika ile 24 saat arasında herhangi bir değere ayarlayabilir ve Konsol'un Connect iş yükü sihirbazı varsayılan olarak 10 dakika atar; bu nedenle varsayılan değeri varsaymak yerine kuralı okuyun. Üstlenilen bir rol (assumed role) ve Bedrock kısa süreli API anahtarının her ikisi de 12 saatlik sürede kalır. Bedrock uzun süreli API anahtarının tabloda yeri yoktur çünkü sabit bir üst sınırı yoktur: oluşturulurken seçilen son kullanma tarihine kadar geçerlidir veya API çağrısında CredentialAgeDays atlanmışsa süresi dolmaz; AWS'nin bunu yalnızca keşif amaçlı önermesinin nedeni budur. 30 günlük ön ayarla oluşturulan bir anahtar 720 saat boyunca geçerli kalır ve sunucunuzdaki bir dosyada bir ay boyunca duran kimlik bilgisi budur.
VPS üzerinde kimlik bilgilerinin saklanması
Gizli veriyi yalnızca root kullanıcısının okuyabileceği bir dosyaya yerleştirin ve systemd'nin bunu sürece iletmesini sağlayın. Bu yöntem her SDK sürümünden bağımsız olduğu için bir kez ve doğru şekilde yapılması değerlidir.
sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/envDosya düz KEY=value satırları içerir. export, tırnak işaretleri veya shell sözdizimi kullanılmaz; çünkü systemd bunu bir shell üzerinden çalıştırmak yerine doğrudan kendisi ayrıştırır.
ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME[Unit]
Description=Claude API service
After=network-online.target
[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure
[Install]
WantedBy=multi-user.targetsystemd, EnvironmentFile= dosyasını User=claudeapp kullanıcısına geçiş yapmadan önce root yetkileriyle okur; bu nedenle servis hesabının dosyaya okuma erişimine sahip olması gerekmez. root sahipliğinde 600 modu yeterlidir; yukarıdaki install komutunun bu şekilde ayarlanmasının nedeni budur. Servisi sudo systemctl enable --now claude-app ile başlatın, ardından birimin sürekli yeniden başlatılmak yerine active (running) durumuna ulaştığını systemctl status claude-app ile doğrulayın.
Kaçınmanız gereken dört durum ve her birinin kontrol edilebilir bir nedeni vardır:
- Anahtarı birim dosyası içinde
Environment=ile yazmayın./etc/systemd/systemaltındaki bir birim herkes tarafından okunabilir; bu nedenlesystemctl cat claude-appgizli veriyi herhangi bir yerel kullanıcıya açık eder. - Dosyayı commit etmeyin.
.gitignoreyeni bir dosyanın commit edilmesini engeller ancak halihazırda commit edilmiş bir dosya için bir şey yapmaz; çünkü git geçmişi kendisine verilen her şeyi saklar. - Gizli veriyi container imajının içine gömmeyin.
ENVdeğerleri imaj yapılandırmasında kalıcıdır ve build argümanları imaj geçmişinde veya köken meta verilerinde görünür. Dosyayı sonraki bir katmanda silmek, önceki katmanlardan kaldırmaz. Gizli verileri çalışma zamanında--env-fileveya mount edilmiş bir dosya ile iletin. - Süreç ortamını root kullanıcısından gizli tutulabilir sanmayın.
sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n'anahtarı geri yazdırır. Dosya okuma komutunun kendisisudogerektirir; shell girdi yönlendirmesisudoöncesinde çalışır ve mevcut hesabınızın izinlerini kullanır. Amaç, gizli veriyi root dışındaki tüm hesaplardan korumaktır; root zaten ne yaparsanız yapın dosyayı okuyabilir.
Bu son nokta, tasarımın size sağladığı korumanın sınırını belirler. root erişimli dosya, saklanan anahtarı korur ancak servis hesabı olarak çalışan herhangi bir kod süreç ortamını okuyabilir ve alt süreçler bunu devralır. Süreç sizin yazmadığınız bir kod çalıştırıyorsa bu yanlış bir kapsayıcıdır; çünkü sürecin yürütebildiği her şey kendi ortamını okuyabilir. Gizli verileri bir yapay zeka aracının erişiminden uzak tutmak konusu, farklı bir yanıt gerektiren bu durumu ele alır.
Kesinti yaşamadan anahtar rotasyonu nasıl yapılır?
Önce yeni anahtarı oluşturun, ardından eskisini iptal edin. Aşağıdaki tek servisli yeniden başlatma işlemi servisi kısa süreliğine kesintiye uğratır; kesintisiz erişilebilirlik için yeniden başlatma sırasında istekleri karşılayacak ikinci bir örneğe ihtiyaç duyulur.
- Yeni anahtarı, eskisiyle aynı çalışma alanında (workspace) Konsol üzerinden oluşturun.
/etc/claude-app/envdosyasınasudoeditkullanarak yazın.sudo systemctl restart claude-appkomutunu çalıştırın.- Servisin isteklere yanıt verdiğini doğrulayın, ardından Konsol üzerinden eski anahtarı iptal edin.
EnvironmentFile, birim (unit) başladığında okunur; bu nedenle çalışan bir süreç, başlatma sırasında kendisine verilen değeri korur. systemctl daemon-reload, birim dosyalarını yeniden okur ancak çalışan bir sürecin ortam değişkenlerine dokunmaz; bu yüzden yeni anahtar yalnızca yeniden başlatma ile devreye girer. 4. adım yerine 1. adımda iptal işlemi yapmak, 3. adıma kadar sürecek bir kesintiye neden olur.
Bulut rotaları sağlayıcı tarafında döner. Bir IAM kullanıcısı aynı anda iki aktif erişim anahtarını destekler; bu nedenle ikinciyi oluşturun, dağıtın ve ardından ilkini silin. Bir Google servis hesabı anahtarı da aynı şekilde döner. Bir Foundry kaynağı iki anahtar taşır ve birini yeniden oluşturmak, eski değerinin çalışmasını anında durdurur; bu yüzden servisi kullandığı anahtarı yeniden oluşturmadan önce diğer anahtara taşıyın. Entra token'ları ve federasyon Anthropic token'ları manuel token rotasyonu gerektirmez; mümkün olan yerlerde bunları kullanmak için en güçlü argüman budur.
Konsoldayken çalışma alanı için bir harcama limiti belirleyin. Sızdırılmış bir anahtar, başka herhangi bir sorun yaratmadan önce maliyetli olur; bir VPS üzerindeki ajanın harcama limitini belirleme rehberi bu kontrollerin nasıl yapılacağını açıklar.
İstemcim neden 401 veya 403 hatası döndürüyor?
Doğrudan API üzerinde authentication_error ile 401 hatası. Anahtar hatalı, iptal edilmiş veya süresi dolmuş olabilir. Kod değişmediği ve istek dün çalıştığı için genellikle gözden kaçan durum sürenin dolmasıdır. Konsol üzerindeki anahtarın son kullanma tarihi sütununu kontrol edin veya Admin API üzerinden expires_at değerini okuyun; süresi olmayan anahtarlar için bu değer null olarak görünür. Kişisel bir anahtar, sahibi organizasyondan ayrıldığında da çalışmayı durdurur.
SDK, federasyon ayarınızı yok sayıyor ve bunun yerine bir anahtar kullanıyor. ANTHROPIC_API_KEY ve ANTHROPIC_AUTH_TOKEN, kimlik bilgisi öncelik sırasında federasyonun üzerinde yer alır, bu nedenle her ikisi de federasyonu gölgeler. Bunun keskin sonucu şudur: boş bir dize olarak dışa aktarılan bir değişken yine de kendi yerini işgal eder, bu nedenle ANTHROPIC_API_KEY="", SDK'nın bir sonraki aşamaya geçmek yerine boş bir anahtarla kimlik doğrulaması yapmasına neden olur. unset ANTHROPIC_API_KEY kullanın.
Federasyon üzerinde Authentication failed mesajı ile 401 hatası. Bu mesaj, her olası neden için kasıtlı olarak aynı tutulmuştur; böylece bir çağırıcı, hata metnini okuyarak kural yapılandırmanızı analiz edemez. Asıl neden, Konsol'daki kimlik doğrulama geçmişi sayfasında kayıtlıdır. JWT üzerinde tahminde bulunmak yerine oradan başlayın.
Foundry üzerinde 403 hatası. Belirteç kimlik doğrulaması başarılı oldu ancak Azure hesabınız çağrıya izin veren bir role sahip değil. İsteği yapan kimliğe Foundry User (eski adıyla Azure AI User) veya Cognitive Services User gibi bir Azure RBAC rolü atayın.
Bedrock üzerindeki herhangi bir hata. SigV4 kimlik doğrulaması için önce servis kullanıcısı olarak aws sts get-caller-identity komutunu çalıştırın. Bu komut, sunucunun kullanılabilir AWS kimlik bilgilerine sahip olup olmadığını yanıtlar; böylece kimlik bilgisi sorunu ile model erişim sorunu veya bölge uyuşmazlığı birbirinden ayrılmış olur. 29 Ekim 2026 itibarıyla AWS, gerekli AWS Marketplace izinlerine sahip ticari bölgelerde birçok modele ilk kullanımda erişim sağlar, ancak bazı modeller ayrı bir hesap düzeyi erişimi gerektirir. InvokeModel rotası üzerinden çağrılan Anthropic modelleri, hesap başına (veya tüm AWS Organizasyonu için bir kez, ancak opt-in bölgelerde tekrar gerekir) tek seferlik bir kullanım durumu formu gerektirir ve bu onaylanana kadar çağrı AccessDeniedException döndürür. AWS, bu formun bedrock-mantle uç noktası için geçerli olmadığını belirtmektedir. Bir hesapta bir modele yapılan ilk çağrı, Bedrock'ın arka planda AWS Marketplace aboneliğini başlatmasını sağlar ve bu abonelik, aws-marketplace:Subscribe, aws-marketplace:Unsubscribe ve aws-marketplace:ViewSubscriptions izinlerine sahip bir kimlik gerektirir. Eksik izinler, ilk çağrının başarısız olmasına her zaman neden olmaz: AWS, abonelik kurulurken çağrıların 15 dakikaya kadar başarılı olabileceğini, abonelik başarısız olduğunda ise sonraki çağrıların aynı AccessDeniedException hatasını döndürdüğünü belirtir. İlk birkaç dakikası çalışan ve ardından hata vermeye başlayan bir servis, kimlik bilgilerinden ziyade bu duruma işaret eder. İzinleri verdikten sonra AWS, aboneliğin tamamlanması için 2 dakikaya kadar süre tanır. Çağırdığınız bölgede sunulmayan bir model, kimlik bilgileriniz ne kadar iyi olursa olsun başarısız olur.
FAQ
Claude'u Bedrock veya Vertex üzerinde kullanmak için Anthropic API anahtarına ihtiyacım var mı?
Hayır. Amazon Bedrock üzerinde SDK, istekleri SigV4 kullanarak AWS kimlik bilgileriyle imzalar veya bir Bedrock API anahtarı gönderir; Google Cloud üzerinde ise Application Default Credentials aracılığıyla bulunan bir Google erişim belirteci gönderir. Her iki kurulumda da Anthropic tarafından verilmiş bir gizli anahtar bulunmaz ve kullanım ücretleri Anthropic yerine bulut hesabına yansıtılır. ANTHROPIC_API_KEY içinde bırakılan bir Anthropic anahtarının bu sunucularda bir güvenlik riski oluşturmasının nedeni de budur: bir bulut uç noktasına yönlendirilmiş genel bir istemci, bu anahtarı oraya gönderecektir.
Claude Azure üzerinde mevcut mu?
Evet, eski adıyla Azure AI Foundry olan Microsoft Foundry aracılığıyla kullanılabilir. Bir Foundry kaynağı oluşturup içine bir Claude modeli dağıtmalı ve https://{resource}.services.ai.azure.com/anthropic/v1/messages üzerinden, bir api-key başlığında Azure tarafından verilmiş bir anahtar veya bir Microsoft Entra taşıyıcı belirteci ile çağrı yapmalısınız. Kullanım ücretleri Azure Marketplace üzerinden Claude Consumption Units cinsinden faturalandırılır. İstek gövdesindeki model alanı, dağıtım adınızı içermelidir; bu ad, yalnızca dağıtımı oluştururken varsayılan adı koruduysanız model tanımlayıcısıyla eşleşir; ad daha sonra değiştirilemez.
Claude API anahtarını bir Linux sunucusunda nerede saklamalıyım?
root kullanıcısına ait, 600 izinlerine sahip bir dosyada ve bir systemd ünitesinde EnvironmentFile= aracılığıyla yüklenmiş şekilde saklanmalıdır. systemd, üniteyi User= kullanıcısına geçirmeden önce dosyayı root olarak okur, bu nedenle servis hesabının dosyaya erişim iznine ihtiyacı yoktur. Anahtarı depodan, (herkes tarafından okunabilen ve systemctl cat ile yazdırılabilen) ünite dosyasının kendisinden ve container imajı yapılandırması, katmanları veya derleme meta verilerinden uzak tutun.
Claude API isteğim hiçbir şey değişmediği halde neden 401 hatası vermeye başladı?
Oluşturulurken seçilen son kullanma tarihine ulaşan bir anahtar 401 hatası döndürür. Son kullanma tarihi oluşturma aşamasında belirlenir, sonradan düzenlenemez ve kısa ömürlü anahtarlar herhangi bir uyarı e-postası gönderilmeden sona erer. Süresi dolmuş bir anahtar yeniden etkinleştirilemez; bu nedenle yeni bir anahtar oluşturun, bunu environment dosyasına yazın, servisi yeniden başlatın ve eski anahtarı daha sonra iptal edin. Anahtarın güncel olduğundan eminseniz, eski bir kimlik bilgisinin onu gölgeleyip gölgelemediğini kontrol edin: boş bir dizgiye ayarlanmış ANTHROPIC_API_KEY, altındaki federasyon ve profil kaynaklarına göre öncelik kazanır.