SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Claude Code Amazon Bedrock veya Vertex AI ile Kullanımı

Claude Code aracını Amazon Bedrock veya Google Vertex AI üzerinden çalıştırmak için gerekli ortam değişkenlerini, faturalandırma detaylarını ve kısıtlamaları öğrenin.

Claude Code kendi bulut hesabınızda çalıştığında neler değişir

Claude Code'u Amazon Bedrock veya Google Vertex AI üzerinde çalıştırabilirsiniz; bu geçiş, iki veya üç ortam değişkeni ile ekibinizin halihazırda sahip olduğu bulut kimlik bilgilerini gerektirir. Yerel taraftaki her şey aynı şekilde çalışmaya devam eder: CLI, alt aracılar (subagents), kancalar (hooks), yetenekler (skills), MCP sunucuları ve CLAUDE.md dosyalarınız. Yalnızca model çağrısı taşınır ve bununla birlikte dört unsur da yer değiştirir: isteğin üzerinden geçtiği ağ, ödemeyi yapan hesap, çağırma yetkiniz olan Claude modelleri ve sunucu tarafında mevcut olan özellikler.

Soru nadiren çalışıp çalışmadığıdır. Çalışır. Soru, bu dört unsurdan hangisinin sizin için daha önemli olduğudur.

Üç yönlendirme ve her birinin maliyeti

Abonelikle doğrudan Anthropic. Pro, Max, Ultra, Team veya Enterprise planında bir claude.ai hesabıyla oturum açılır. İstekler Anthropic API'ye gönderilir. Pro, Max, Ultra ve Team planlarında koltuk başına ödeme yapılır ve kullanım token başına ölçülmek yerine planın limitleriyle sınırlandırılır. Güncel Enterprise planları istisnadır: koltuk ücreti herhangi bir kullanım hakkı içermez ve her token bu ücretin üzerine standart API tarifeleriyle ayrıca faturalandırılır. Koltuk tabanlı eski Enterprise sözleşmeleri yenileme sırasında bu modele geçirilir. Bu yönlendirme, hesap üzerine kurulu Claude Code on the web, mobil uygulama ve Remote Control gibi arayüzlere erişim sağlayan tek seçenektir. Bir ekip için Team planı, kuruluş genelinde Claude Code yapılandırmasına yönelik single sign-on ve sunucu tarafından yönetilen ayarları zaten içerir. Claude Enterprise planı ise bunlara ek olarak denetim günlükleri, SCIM, özel veri saklama denetimleri ve Compliance API sağlar.

API anahtarıyla doğrudan Anthropic. Anthropic Console üzerinden bir anahtar oluşturulur ve token başına ödeme yapılır. Altyapı ve bölgeler abonelik seçeneğiyle aynıdır. Koltuk ücreti yoktur ve kullanım Anthropic'in kendi dashboard'unda görüntülenir. İki seçenekten hangisinin daha ucuz olduğu, aracının gün içinde gerçekte kaç saat çalıştığına bağlıdır. API ile abonelik maliyetlerinin karşılaştırılması ve Claude Code'un pratikteki maliyeti konularının tamamı buna odaklanır.

Bedrock veya Vertex üzerindeki üçüncü taraf endpoint. Model, kullanıcının kendi AWS veya Google Cloud hesabı üzerinden sunulur. Çıkarım sırasında istek akışında Anthropic yer almaz. Token kullanımı, zaten alınan bulut faturasına eklenir ve mevcut IAM (identity and access management) politikaları ile denetim günlükleri kapsamında yönetilir. Üç ek üçüncü taraf seçeneği vardır: Microsoft Foundry, AWS üzerindeki Claude Platform ve Google Cloud üzerindeki Claude Models (Anthropic managed). Bunlar da aynı şekilde çalışır: sağlayıcıyı tek bir environment variable seçer ve ödemeyi bulut hesabı yapar. Anthropic tarafından yönetilen Google Cloud yönlendirmesinde CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD=1 kullanılır. Bu yönlendirme Vertex'ten ayrıdır.

Adlandırma notu, Ekim 2026 itibarıyla: Google, Vertex AI'ın adını Google Cloud's Agent Platform olarak değiştirdi. Anthropic belgelerinde yeni ad kullanılır. Claude Code oturum açma isteminde hâlâ Google Vertex AI yazarken environment variable değerlerinde hâlâ VERTEX ifadesi bulunur.

Veri yerleşimi ekiplerin bunu yapmasının asıl nedenidir

Bedrock üzerinde istek, kendi hesabınız içinde, seçtiğiniz AWS bölgesindeki bir Bedrock endpoint'ine gönderilir. Bekleyen veriler, AWS tarafından yönetilen anahtarlarla AES-256 kullanılarak şifrelenir. AWS KMS (key management service) üzerinden kendi anahtarınızı da sağlayabilirsiniz. Vertex üzerinde bunun karşılığı, Google tarafından yönetilen şifreleme anahtarlarıdır. CMEK (customer-managed encryption keys) kullanımı da mümkündür. Erişim, hâlihazırda kullandığınız IAM rolleriyle denetlenir. Çağrılar CloudTrail üzerinde veya Data Access audit logging etkinleştirildiğinde Cloud Audit Logs üzerinde görünür. Regülasyona tabi bir ekip için temel gerekçe budur ve bu güçlü bir gerekçedir.

Ancak iki ayrıntı, durumun pazarlama mesajlarının ima ettiğinden daha az kesin olduğunu gösterir.

Cross-region inference profile tek bir bölge değildir. Bedrock üzerinde Claude Code, yerleşik varsayılan modellerini cross-region inference profile kimliklerine çözümler. Tercih ettiği prefix, çözümlenen bölgeden gelir: us. bir us-* bölgesinde, eu. bir eu-* bölgesinde, apac. bir ap-* bölgesinde ve us-gov. GovCloud üzerinde kullanılır. Cross-region profile, bir isteği aynı coğrafi bölge içindeki başka bir bölgeden sunabilir. Bu nedenle elde edilen garanti bir şehir değil, bir coğrafi bölgedir. Gereksiniminiz tek bir bölge belirtiyorsa cross-region profile yerine, o bölgedeki bir foundation model tarafından desteklenen bir application inference profile üzerinden yönlendirme yapılmalı ve ANTHROPIC_MODEL bu profile'ın ARN değeri olarak ayarlanmalıdır.

Bazı trafik yine Anthropic'e ulaşır. Telemetry, error reporting ve /feedback komutu hem Bedrock hem de Vertex üzerinde varsayılan olarak devre dışıdır. /feedback, herhangi bir veriyi yüklemek yerine kendi makinenizde ~/.claude/feedback-bundles/ altında bir arşiv oluşturur. Ancak iki istisna her sağlayıcıda çalışır. Bir URL alınmadan önce WebFetch aracı, bir güvenlik blocklist kontrolü yapmak için yalnızca hostname bilgisini api.anthropic.com adresine gönderir. Session quality surveys de görünmeye devam eder. İlkini settings file içinde skipWebFetchPreflight kullanarak, ikincisini ise CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1 kullanarak devre dışı bırakabilirsiniz. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ayarının yapılması, diğer gerekli olmayan trafikle birlikte survey'leri de durdurur. Ancak kendi opt-out ayarını kullanan WebFetch kontrolünü etkilemez. Bir host platform CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST ayarını yaptığında telemetry bunun yerine varsayılan olarak etkin olur.

Training konusunda, Anthropic ticari şartlar kapsamında Claude Code üzerinden gönderilen kod veya prompt'larla model eğitimi yapmaz. Üçüncü taraf platform kullanımı da ticari kapsamdadır. Training'e izin veren opt-in seçeneği olan Development Partner Program, Bedrock veya Vertex kullanıcılarına hiç sunulmaz. Vertex üzerinde Fable modelleri, abuse monitoring amacıyla prompt-response paylaşımının Anthropic ile yapılmasını gerektirir. Aynı durum Cyber Verification Program'a dahil edilen modeller için de geçerlidir. Bu endpoint'lerde zero data retention, AWS veya Google ile yaptığınız sözleşmeye ve modelin retention gereksinimlerine tabidir.

Amazon Bedrock için Claude Code yapılandırma

Herhangi bir istemci yapılandırmasının etkili olabilmesi için AWS hesabı başına bir kez iki işlem yapılır. Amazon Bedrock konsolunu açın, model kataloğundan bir Anthropic modeli seçin ve kullanım senaryosu formunu gönderin: erişim, gönderimden hemen sonra verilir. Ardından Claude Code tarafından yapılan çağrılara izin veren bir IAM ilkesi ekleyin.

  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListInferenceProfiles
  • bedrock:GetInferenceProfile

ListInferenceProfiles, Claude Code'un başlangıçta hesabınızın gerçekte hangi modelleri çağırabildiğini denetlemesini sağlar. GetInferenceProfile, bir uygulama inference profile ARN'sini arkasındaki foundation model'e geri çözümlemesini sağlar; böylece doğru istek biçimini seçebilir. Bu olmadan da istekler başarılı olur; çünkü Claude Code diğer biçimle bir kez daha dener. Belirti bir hata değil, her yeni model için ek bir gidiş-dönüş işlemidir. Anthropic tarafından yayımlanan ilke, Bedrock üzerinden çağrıldığında aws-marketplace:ViewSubscriptions ve aws-marketplace:Subscribe işlemlerine de izin verir; bu da model aboneliği adımını kapsar.

En hızlı istemci yolu sihirbazı kullanmaktır. claude komutunu çalıştırın, 3rd-party platform ve ardından Amazon Bedrock seçeneklerini belirleyin veya zaten oturum açılmış bir oturumda /setup-bedrock yazın. Sihirbaz, ~/.aws dizininizdeki profilleri okur, hangi modelleri çağırabildiğinizi doğrular ve sonucu ~/.claude/settings.json dosyasındaki env bloğuna yazar. Böylece hiçbir işlem shell profilinize bağlı olmaz.

Betiklenmiş bir dağıtım için değişkenleri kendiniz ayarlayın.

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

Kimlik bilgileri standart AWS SDK kimlik bilgisi zincirinden alınır. Bu nedenle aws CLI için zaten çalışan her yöntem burada da çalışır: aws configure, bir SSO profili, üstlenilmiş bir rol veya bir Bedrock API anahtarı.

aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-name
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bearer token en basit seçenektir. Ancak bir environment variable içinde gizli bilgi olarak bulunduğu için dikkatle ele alınmalıdır. AWS, 12 saate kadar geçerli olan kısa süreli anahtarlar ve belirlediğiniz bir tarihe kadar geçerli olan uzun süreli anahtarlar verir. Uzun süreli anahtarların yalnızca keşif amacıyla kullanılmasını önerir. Paylaşımlı bir build sunucusunda süresi dolan bir rol tercih edin. Aynı yaklaşım, agent'ın okuyabildiği diğer tüm kimlik bilgileri için de geçerlidir. Bu konu gizli bilgileri bir AI agent'ın erişiminden uzak tutma bölümünde ele alınır.

Bölge tuzağı. Claude Code bölgeyi şu sırayla çözümler: AWS_REGION, ardından AWS_DEFAULT_REGION, sonra etkin AWS profilinizdeki region ve son olarak us-east-1. Son adım bir varsayılandır; hata değildir. Bu nedenle hiçbir yerde bölge ayarlamayan ve Avrupa üzerinden yönlendirme yapıldığını varsayan bir ekip, ekrana herhangi bir uyarı yazdırılmadan isteklerini bir ABD bölgesine gönderir. Çözümlenen bölgeyi ve bu bölgenin hangi kaynaktan geldiğini görmek için Claude Code içinde /status komutunu çalıştırın. Hesabınızın bir bölgede neleri çağırabildiğini doğrulamak için aws bedrock list-inference-profiles --region your-region komutunu çalıştırın.

Bedrock ayrıca native Anthropic API biçimini kullanan Mantle endpoint'ini sunar. Bu endpoint'i CLAUDE_CODE_USE_MANTLE=1 ile seçin. Aynı AWS kimlik bilgilerini kullanır, ancak ayrı bedrock-mantle: IAM izinleri gerektirir.

Google Vertex AI üzerinde Claude Code çalıştırma

API'yi etkinleştirin ve kimlik bilgilerini alın.

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

Model Garden'da kullanmak istediğiniz Claude modelleri için erişim isteğinde bulunun. Onay için 24 ila 48 saat bekleyin. Hem model çağırma hem de token sayımı için kullanılan aiplatform.endpoints.predict iznini içeren roles/aiplatform.user rolünü verin.

Ardından sağlayıcıyı seçin.

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

CLOUD_ML_REGION; global değerini, eu veya us gibi çok bölgeli bir konumu ya da tek bir bölgeyi kabul eder. Global endpoint en yüksek kullanılabilirliği sağlar, ancak bir isteğin nerede sunulacağı üzerindeki denetim en düşüktür. Bu nedenle veri yerleşimi gereksinimi genellikle bunun yerine belirli bir konumun belirtilmesini gerektirir. Model kapsamı bu üç biçim arasında farklılık gösterir. İhtiyaç duyduğunuz modellerden biri global endpoint üzerinde yoksa yalnızca o modeli VERTEX_REGION_CLAUDE_* değişkeniyle belirli bir konuma sabitleyin ve diğer tüm modelleri global olarak bırakın. Güncelliğini yitirebilecek bir listeye güvenmek yerine geçerli Vertex AI konumları sayfasını kontrol edin.

Proje tuzağı. İsteklerin nereye gönderileceğine ANTHROPIC_VERTEX_PROJECT_ID karar verir. GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT veya GOOGLE_APPLICATION_CREDENTIALS tarafından belirtilen kimlik bilgileri dosyası farklı bir proje içerse bile Claude Code istekleri bu projeye yönlendirir. gcloud değişkeninin bir projeyi gösterdiği, eski kalmış ANTHROPIC_VERTEX_PROJECT_ID değişkeninin ise başka bir projeyi belirttiği bir makinede ücretler ikinci projeye yansır ve oturum içinde bu durumu belirten herhangi bir uyarı gösterilmez.

Sağlayıcıyı her değiştirdiğinizde doğrulama yapın. Etkin sağlayıcıyı ve yapılandırmayı kontrol etmek için /status komutunu çalıştırın. Değişkenler sürece ulaşmıyorsa bunların claude komutunu başlatan shell içinde dışa aktarıldığını doğrulayın. Bunları ayarlar dosyasının env bloğuna taşıyın. Bu yöntem, AWS_PROFILE gibi bir değerin başlattığınız diğer tüm süreçlere aktarılmasını da önler.

Hangi modellerin kullanılacağı ve ne kadar geç sunulacakları

sonnet ve opus gibi takma adlar en yeni modelleri ifade etmez. Üçüncü taraf bir endpoint üzerinde bunlar, Claude Code'un ilgili sağlayıcı için yerleşik varsayılanına çözülür. Bu varsayılan, güncel sürümün gerisinde kalabilir ve hesabınızda hiç etkinleştirilmemiş olabilir. Varsayılan kullanılamadığında Claude Code, ilgili oturum için daha eski veya daha düşük seviyeli bir modele geçer ve bir bildirim yazdırır. Bu geçiş kaydedilmez. Ancak Claude Code, model erişim retlerini makinede bir güne kadar hatırlayabilir. Ayrıca mevcut varsayılan model için hatırlanan bir erişim reddini, son kontrolden bu yana on dakika geçtiğinde başlangıç sırasında yeniden kontrol eder.

Bir ekip genelinde dağıtım yapılacaksa sürümler sabitlenmelidir.

# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'

Kimlikleri modeller genel bakışı sayfasından ve sağlayıcınızın kataloğundan alın. Çünkü biçim sağlayıcıya göre değişir: Bedrock bir inference profile ID veya ARN bekler, Vertex ise düz bir model adı bekler. Bunları bir makaleden, bu makale dahil, kopyalamayın. Sürüm sabitleme aynı zamanda maliyet kontrolü sağlar. Bunun nedeni, varsayılan primary modelin Opus sınıfında olması ve Opus'un token başına Sonnet'ten daha pahalı olmasıdır. Bu nedenle hiçbir şeyi sabitlemeyen bir dağıtım daha yüksek ücret üzerinden faturalandırılır. Bunun yerine tek bir modeli oturum varsayılanı olarak sabitlemek için ANTHROPIC_MODEL değişkenini tam kimliğiyle ayarlayın.

Modelin kullanıma sunulma zamanı, bu karşılaştırmadaki en belirgin farktır. Anthropic'in kendi API'sinde bir model, yayınlandığı gün çalışır. Bedrock ve Vertex üzerinde ise model, bulut sağlayıcınız ilgili bölgede modeli etkinleştirdiğinde ve hesabınıza erişim verildiğinde çalışır. Bazı işlerin en yeni model üzerinde çalışması gerekiyorsa bu modele erişebilen en az bir routing tanımını koruyun. Farklı işler için farklı modellere yönlendirme kullanmanın pratik gerekçesi budur.

Bedrock ve Vertex üzerinde vazgeçilenler

Yerel olarak çalışan her şey tüm sağlayıcılarda çalışır: alt aracılar, kancalar, slash komutları, beceriler, eklentiler, checkpoint'ler, sandbox kullanımı, yönetilen ayarlar dosyası ve OpenTelemetry metrikleri. Eksik olanların tamamı sunucu tarafındadır.

Her iki uç noktada da kullanılamayanlar: Advisor, Channels, Code Mode, analytics dashboard, sunucu tarafından yönetilen ayarlar ve /design-sync ile /import komutlarıdır. Ayrıca claude.ai hesabı gerektiren hiçbir özellik kullanılamaz. Buna web üzerinde Claude Code, mobil uygulama, Remote Control, rutinler ve artifact'ler dahildir.

Yalnızca Bedrock'ta: fast mode kullanılamaz ve WebSearch aracı burada mevcut değildir. Bu nedenle Claude, Bedrock'a yönlendirilen bir oturumdan arama çalıştıramaz. Ancak bir URL verildiğinde WebFetch ile sayfanın içeriğini okuyabilir. Vertex'ta web araması, Claude 4 generation modelleri ve sonraki modeller için çalışır. Vertex ayrıca Claude Code v2.1.322 veya sonraki sürümleriyle Fable 5.2 üzerinde global, us veya eu içinde fast mode'u destekler. Sağlayıcı fast mode'u reddederse standart hız kullanılır.

Her ikisinde de kısmen kullanılabilir: auto mode yalnızca daha yeni modellerden oluşan sınırlı bir kümede çalışır, oturumlar arası mesajlaşma yalnızca aynı makinedeki diğer oturumlarınıza ulaşır ve aralığını kendisi belirleyen bir /loop için Claude Code v2.1.248 veya sonraki bir sürüm gerekir. Desktop'a 3P üzerindeki Claude Desktop aracılığıyla veya uygulamada ya da bir yönetici tarafından yapılandırılan gateway yönlendirmesiyle erişilebilir. Bir özelliği ekibinize sunmadan önce Anthropic'in özellik kullanılabilirliği sayfasını kontrol edin; bu liste değişebilir.

Fatura kime kesilir

Abonelik ve üçüncü taraf uç noktası ayrı satın alımlardır. Biri diğerinin yerine geçmez.

Bu durumun açıkça belirtilmesi gerekir çünkü yapılan hata sessizce gerçekleşir. CLAUDE_CODE_USE_BEDROCK=1 ayarını, aynı zamanda Max koltuğu ile oturum açtığınız bir makinede yapılandırırsanız, trafik AWS tarafından faturalandırılır: Bedrock'ın isteğe bağlı (on-demand) oranları üzerinden token başına veya hesabınızın satın aldığı sağlanan iş hacmi (provisioned throughput) üzerinden ücretlendirilir. Koltuk ücreti aylık olarak alınmaya devam eder ve bu trafiğin hiçbirini karşılamaz. Ayrıca birleşik bir görünüm de yoktur: harcama verileri AWS Cost Explorer veya Google Cloud Billing paneline aktarılır ve Anthropic analiz paneli her iki sağlayıcıda da kullanılamaz. /logout komutu da ortadan kalkar çünkü sonlandırılacak bir Anthropic oturumu yoktur. Kimlik bilgisi, bulut sağlayıcısının kimlik bilgisidir.

Fiyatlar sağlayıcının kendi sayfasında yer alır ve değişiklik gösterebilir; bu nedenle herhangi bir makaledeki rakam yerine Amazon Bedrock fiyatlandırması veya Vertex AI fiyatlandırması sayfalarını inceleyin. Değişmeyen yapısal bir nokta vardır: bu uç noktalardaki isteğe bağlı çıkarım (inference) işlemleri token başına faturalandırılır; bu nedenle tüm gün çalışan bir temsilci, onu durduracak bir plan sınırı olmaksızın, ne kadar tüketirse o kadar maliyet oluşturur. Her iki bulut sağlayıcısının da sunduğu alternatif, sağlanan iş hacmidir; yani elinizde tuttuğunuz sürece sabit bir ücret karşılığında rezerve edilmiş kapasitedir. AWS bunu saatlik olarak faturalandırır ve Claude Code, sağlanan iş hacmi ARN değerini model kimliği olarak ayarladığınızda bunu kullanır. Hangisinin herkes için koltuk satın almaktan daha avantajlı olduğu, ilk faturadan sonra değil, kullanıma sunmadan önce hesaplanmalıdır ve Team ve Enterprise için koltuk ile token başına maliyet karşılaştırması bu kıyaslamayı ekip ölçeğinde yapmaktadır.

Her yönlendirme katmanında hız sınırları ve kotalar farklı çalışır

Pro, Max, Ultra, Team ve eski seat tabanlı Enterprise aboneliklerinde sınırlar hesaba aittir ve belirli bir takvime göre sıfırlanır. Bir sınıra ulaşıldığında, kullanım kredileri etkin değilse beklemek gerekir. Pro, Max ve Ultra aboneleri ile Team ve eski seat tabanlı Enterprise kuruluşları, bir harcama sınırına kadar standart API ücretleri üzerinden çalışmaya devam edebilir. Bunun için kullanım kredilerinin etkin olması gerekir. Güncel kullanıma dayalı Enterprise planlarında plan veya seat düzeyinde kullanım sınırı yoktur. Kullanım tüketime göre ücretlendirilir. Yöneticiler kuruluş ve bireysel harcama sınırları belirleyebilir. Bu davranış kullanım sınırlarının çalışma şekli bölümünde açıklanır.

Bir Anthropic API anahtarında sınırlar kuruluşa aittir. Sınırlar dakika başına istek ve token cinsinden ifade edilir. Kullanım katmanı yükseldikçe bu sınırlar da artar.

Bedrock ve Vertex üzerinde sınırlar, herhangi bir Anthropic planıyla ilişkili olmayan cloud kotalarıdır. Bedrock'ta kotalar hesap ve region başına, çoğunlukla model başına belirlenir. Ayrıca bu hesap ve region içinde desteklenen modeller arasında geçerli günlük bir token kotası bulunur. Vertex'te kotalar project ve location başına belirlenir. Global ve multi-region endpoint'lerde 26 Mayıs 2026 tarihinden sonra kullanıma sunulan Claude modelleri, model lineage başına tek bir kotayı paylaşır: bir model ailesinin tüm sürümleri, belirli bir location için aynı havuzdan kullanım yapar. Global endpoint ile her multi-region endpoint ayrı havuzlar kullanır. 429 hatası genellikle bu kotalardan birinin tükendiğini gösterir. Ancak paylaşımlı pay-as-you-go kapasitesinde, sağlayıcının yeterli kapasiteye sahip olmaması da aynı hataya neden olabilir. Bu nedenle herhangi bir değişiklik yapmadan önce backoff ile yeniden denenmelidir. Sorun kotanızdan kaynaklanıyorsa çözüm sağlayıcının console arayüzündedir: artış talep edilmeli veya yeterli kapasite bulunan bir location seçilmelidir. Bedrock, kotayı sabit istek sayısı yerine bir token burndown kuralına göre tahsis eder. Her iki cloud üzerinde reserved capacity, provisioned throughput olarak satın alınır. Vertex'te 429 hatasını incelerken single-region endpoint'in hem primary model'i hem de küçük fast model'i sunduğu doğrulanmalıdır. Daha iyi erişilebilirlik için belgelenen başlangıç noktası CLOUD_ML_REGION=global değeridir. Artış talebi için Google'ın quotas sayfasına bakılmalıdır.

Hata türleri ve görülecek dizeler

Vertex üzerinde Could not load the default credentials. Application Default Credentials eksik veya süresi dolmuş. gcloud auth application-default login komutunu çalıştırın veya GOOGLE_APPLICATION_CREDENTIALS değerini bir service account key dosyasını gösterecek şekilde ayarlayın.

Vertex üzerinde modeli belirten bir 404 hatası. Model, ilgili proje için Model Garden'da etkinleştirilmemiştir veya belirlediğiniz konumda sunulmuyordur. Bazı modeller yalnızca global endpoint üzerinde ya da eu gibi çok bölgeli bir konumda sunulur; belirli bir bölgede sunulmaz.

Bedrock üzerinde on-demand throughput isn't supported. Yalnızca inference profile üzerinden sunulan bir model için doğrudan foundation model ID kullandınız. Bunun yerine inference profile ID kullanın.

AWS default-chain credential resolve timed out. AWS credential chain içindeki bir adım yanıt vermeyi durdurmuştur. Örneğin credential_process helper, hiçbir zaman alamayacağı bir girdiyi bekliyor olabilir. Credential cache'i dolduran çözümleme işlemi varsayılan olarak 60 saniye sonra zaman aşımına uğrar. Zincirinizin gerçekten daha uzun süreye ihtiyacı varsa, örneğin wrapper arkasında MFA (multi-factor authentication) kullanan bir browser SSO akışında, sınırı milisaniye cinsinden CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS ile artırın. CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1 ayarlandığında her API isteği zinciri bu sınır olmadan çözümler.

Bedrock streaming response has content-type başlatılırken hata oluşması. Claude Code ile Bedrock arasındaki bir bileşen stream'i yeniden yazıyordur. Bedrock, içeriği application/vnd.amazon.eventstream content type değerine sahip ikili bir event-stream biçiminde iletir. Bu nedenle yanıtı server-sent events olarak yeniden oluşturan bir gateway, Claude Code'un çözemeyeceği bir gövde döndürür. Gateway'i, yanıt gövdesini ve Content-Type header'ını değiştirmeden iletecek şekilde düzeltin.

AWS SSO sırasında browser sekmelerinin döngü halinde açılması. Kurumsal bir VPN veya TLS incelemesi yapan bir proxy oturum açma işlemini kesintiye uğratır. Claude Code, bozulan bağlantıyı authentication failure olarak okur, awsAuthRefresh komutunu yeniden çalıştırır ve bu işlem sürekli tekrarlanır. Ayar dosyanızdaki awsAuthRefresh değerini kaldırın ve Claude Code'u başlatmadan önce aws sso login komutunu elle çalıştırın.

Yönlendirme seçimi

Yeni modelleri yayınlandığı gün kullanmak ve tüm özellik setine erişmek isteniyorsa Anthropic direct seçilmelidir. Koltuk satın almadan token başına ücretlendirme isteniyorsa bir API key kullanılmalıdır. Çıkarım işleminin yönetilen mevcut bir cloud account içinde gerçekleşmesi gerekiyorsa Bedrock veya Vertex seçilmelidir. Bu durumda sağlayıcının model kullanılabilirliğinin ve daha sınırlı özellik listesinin kabul edilmesi gerekir. Yer işaretlerine eklenmeye değer kurulum sayfaları Anthropic'in Amazon Bedrock ve Google Vertex AI için hazırladığı sayfalar ile AWS'nin region bazında model listesi sayfasıdır.

Bu üç seçeneğin hiçbiri agent'ın nerede çalıştığını değiştirmez. Claude Code, hangi endpoint yanıt verirse versin, dosyalarınızı okuyan ve komutlarınızı çalıştıran yerel bir süreçtir. Bu nedenle agent'ın bir laptop yerine başka bir yerde çalışmasını isteyen ekipler coding agent'ı bir VPS üzerinde çalıştırır ve aynı değişkenleri buraya aktarır.

FAQ

Claude aboneliğim Bedrock veya Vertex üzerindeki Claude Code kullanımını karşılıyor mu?

Hayır. Pro, Max, Ultra, Team veya Enterprise koltuğu ile üçüncü taraf uç noktası ayrı satın alımlardır; biri diğerinin ücretini karşılamaz. CLAUDE_CODE_USE_BEDROCK=1 veya CLAUDE_CODE_USE_VERTEX=1 ayarlandığında trafik, AWS ya da Google Cloud tarafından kendi isteğe bağlı kullanım ücretleri üzerinden token başına veya satın alınmış sağlanan aktarım kapasitesine göre ücretlendirilir ve ilgili bulut faturasına yansır. Koltuk ücreti ise kapsadığı yüzeyler için alınmaya devam eder. Harcama takibi de AWS Cost Explorer'a veya Google Cloud Billing'e taşınır; çünkü Anthropic analiz paneli bu sağlayıcıların hiçbirinde kullanılamaz.

Claude Code, Amazon Bedrock üzerinde isteklerimi hangi bölgeye gönderir?

Çözümlenen bölgeye gönderir; bu bölgeyi /status ile görebilirsiniz. Claude Code önce AWS_REGION, ardından AWS_DEFAULT_REGION ve sonra etkin AWS profilinizdeki region değerini kontrol eder. Bunların hiçbiri ayarlanmamışsa us-east-1 değerine geri döner. Yerleşik varsayılan modeller daha sonra, bölgeyi izleyen ön eke sahip bölgeler arası çıkarım profillerine çözümlenir. Örneğin us. veya eu. kullanılabilir. Bölgeler arası bir profil, aynı coğrafya içindeki başka bir bölgeden gelen isteği karşılayabilir. Belirli bir bölgenin zorunlu olduğu durumlarda bölgeler arası profil yerine, o bölgedeki bir temel model tarafından desteklenen uygulama çıkarım profili kullanılmalıdır. Ardından ANTHROPIC_MODEL bu profilin ARN değerine ayarlanmalıdır.

En yeni Claude modeli Bedrock veya Vertex hesabımda neden görünmüyor?

Çünkü her bulut sağlayıcısı modelleri kendi takvimine göre etkinleştirir ve hesabınıza ayrıca erişim izni verilmesi gerekir. Vertex üzerinde erişim, Model Garden üzerinden istenir ve onay 24 ila 48 saat sürebilir. Bu süre boyunca sonnet ve opus gibi diğer adlar, Claude Code'un ilgili sağlayıcı için yerleşik varsayılan modeline çözümlenir. Bu varsayılan model hesabınızda kullanılamıyorsa Claude Code oturum için daha eski veya daha düşük seviyeli bir modele geri döner ve bir bildirim gösterir. ANTHROPIC_DEFAULT_SONNET_MODEL ve benzerlerini, etkin olduklarını doğruladığınız kimliklere sabitleyin.

Amazon Bedrock üzerinde Claude Code'da web araması kullanılabilir mi?

Hayır. WebSearch aracı Bedrock üzerinde kullanılamaz. Bu nedenle Claude, buraya yönlendirilen bir oturumdan arama çalıştıramaz. URL sağlandığında WebFetch ile belirli bir sayfayı yine de okuyabilir. Google Vertex AI üzerinde web araması, Claude 4 üretim modelleri ve sonraki sürümler için kullanılabilir. Bu, Vertex lehine olan az sayıdaki yetenek farkından biridir.

Bedrock veya Vertex üzerinde Claude Code çalıştırmak için Anthropic hesabı gerekir mi?

Hayır. Kimlik doğrulama AWS veya Google Cloud kimlik bilgilerinizle yapılır. Bu nedenle /logout her iki sağlayıcıda da kullanılamaz. Kullandığınız sağlayıcıdan bağımsız olarak Anthropic'e bir bağlantı devam eder: WebFetch aracı bir URL'yi almadan önce ana bilgisayar adını ve yalnızca ana bilgisayar adını api.anthropic.com adresine göndererek bu adı güvenlik engelleme listesine karşı kontrol eder. Bu davranışı devre dışı bırakmak için ayar dosyanızda skipWebFetchPreflight değerini ayarlayın. Claude'un erişebileceği alan adlarını sınırlamak istiyorsanız bunu WebFetch izin kurallarıyla birlikte kullanın.

Bu yazı işinize yaradı mı?