Claude Code: konfiguracja Amazon Bedrock i Vertex AI
Dowiedz się, jak uruchomić Claude Code przez Amazon Bedrock lub Google Vertex AI. Sprawdź wymagane zmienne środowiskowe, sposób rozliczania kosztów oraz różnice w dostępnych modelach.
Co zmienia się, gdy Claude Code działa na własnym koncie w chmurze
Claude Code można uruchomić w środowisku Amazon Bedrock lub Google Vertex AI. Zmiana konfiguracji wymaga jedynie ustawienia dwóch lub trzech zmiennych środowiskowych oraz wykorzystania poświadczeń chmurowych, którymi zespół już dysponuje. Wszystkie lokalne elementy działają w ten sam sposób: CLI, subagenty, hooki, umiejętności, serwery MCP oraz pliki CLAUDE.md. Zmienia się jedynie miejsce wywołania modelu, co wiąże się z czterema aspektami: siecią, przez którą przechodzi żądanie, kontem obciążanym kosztami, dostępnymi modelami Claude oraz funkcjami dostępnymi po stronie serwera.
Pytanie rzadko dotyczy tego, czy to rozwiązanie działa. Ono działa. Pytanie brzmi, który z tych czterech aspektów jest dla użytkownika najważniejszy.
Trzy ścieżki routingu i związane z nimi koszty
Bezpośrednie połączenie z Anthropic w ramach subskrypcji. Logujesz się przy użyciu konta claude.ai w planie Pro, Max, Ultra, Team lub Enterprise. Żądania trafiają do API Anthropic. W planach Pro, Max, Ultra oraz Team opłata jest naliczana za stanowisko, a wykorzystanie jest ograniczone limitami planu, a nie rozliczane za token. Wyjątkiem są obecne plany Enterprise: opłata za stanowisko nie obejmuje limitu wykorzystania, a każdy token jest rozliczany dodatkowo według standardowych stawek API (starsze umowy Enterprise oparte na stanowiskach przechodzą na ten model przy odnowieniu). Jest to jedyna ścieżka routingu, która zapewnia dostęp do interfejsów opartych na koncie, takich jak Claude Code w przeglądarce, aplikacja mobilna oraz Remote Control. W przypadku zespołów plan Team zawiera już funkcję logowania jednokrotnego (SSO) oraz zarządzane centralnie ustawienia konfiguracji Claude Code dla całej organizacji, a plan Claude Enterprise dodaje do tego dzienniki audytu, SCIM, niestandardowe mechanizmy retencji danych oraz Compliance API.
Bezpośrednie połączenie z Anthropic przy użyciu klucza API. Tworzysz klucz w Anthropic Console i płacisz za każdy token. Wykorzystywana jest ta sama infrastruktura i te same regiony co w przypadku subskrypcji, nie ma opłaty za stanowisko, a zużycie jest widoczne w panelu Anthropic. To, która z tych dwóch opcji jest tańsza, zależy od liczby godzin dziennie, w których agent faktycznie pracuje, co jest głównym tematem porównania kosztów API względem subskrypcji oraz rzeczywistych kosztów Claude Code.
Punkt końcowy strony trzeciej w Bedrock lub Vertex. Model jest obsługiwany przez Twoje własne konto AWS lub Google Cloud. Anthropic nie znajduje się na ścieżce żądania w momencie wnioskowania (inference). Tokeny są doliczane do rachunku, który już otrzymujesz, zgodnie z zasadami IAM (zarządzanie tożsamością i dostępem) oraz dziennikami audytu, które już prowadzisz. Istnieją trzy dodatkowe opcje stron trzecich: Microsoft Foundry, Claude Platform on AWS oraz Claude Models on Google Cloud (zarządzane przez Anthropic). Działają one w ten sam sposób: jedna zmienna środowiskowa wybiera dostawcę, a płatność następuje z poziomu konta chmurowego. Ścieżka Google Cloud zarządzana przez Anthropic wykorzystuje CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD=1 i jest oddzielona od Vertex.
Uwaga dotycząca nazewnictwa, stan na październik 2026: Google zmieniło nazwę Vertex AI na Google Cloud's Agent Platform. Dokumentacja Anthropic używa nowej nazwy, monit logowania Claude Code nadal wyświetla Google Vertex AI, a zmienne środowiskowe nadal wskazują na VERTEX.
Rezydencja danych to główny powód stosowania tego rozwiązania
W usłudze Bedrock żądanie trafia do punktu końcowego Bedrock w wybranym regionie AWS, wewnątrz własnego konta. Dane w spoczynku są szyfrowane algorytmem AES-256 przy użyciu kluczy zarządzanych przez AWS, a użytkownik może dostarczyć własny klucz za pośrednictwem AWS KMS (key management service). W usłudze Vertex odpowiednikiem jest szyfrowanie zarządzane przez Google, z dostępną opcją CMEK (customer-managed encryption keys). Dostęp jest regulowany przez role IAM, które już są w użyciu, a wywołania są widoczne w CloudTrail lub, po włączeniu logowania audytowego Data Access, w Cloud Audit Logs. Dla zespołu podlegającego regulacjom jest to kluczowy argument i jest on w pełni uzasadniony.
Dwa szczegóły sprawiają, że sytuacja nie jest tak jednoznaczna, jak sugerują materiały marketingowe.
Profil wnioskowania międzyregionalnego (cross-region inference profile) nie ogranicza się do jednego regionu. W Bedrock narzędzie Claude Code przypisuje wbudowane modele domyślne do identyfikatorów profili międzyregionalnych, a preferowany prefiks pochodzi z regionu, w którym nastąpiło rozpoznanie: us. w regionie us-*, eu. w regionie eu-*, apac. w regionie ap-* oraz us-gov. w GovCloud. Profil międzyregionalny może obsłużyć żądanie z innego regionu w obrębie tej samej geografii, więc gwarancja dotyczy obszaru geograficznego, a nie konkretnego miasta. Jeśli wymogi narzucają jeden region, należy kierować ruch przez application inference profile wspierany przez model bazowy w tym regionie, zamiast przez profil międzyregionalny, i ustawić ANTHROPIC_MODEL na jego ARN.
Część ruchu nadal dociera do Anthropic. Telemetria, raportowanie błędów oraz polecenie /feedback są domyślnie wyłączone zarówno w Bedrock, jak i Vertex, a /feedback zapisuje archiwum w ~/.claude/feedback-bundles/ na lokalnej maszynie zamiast przesyłać dane na zewnątrz. Istnieją dwa wyjątki wspólne dla każdego dostawcy. Przed pobraniem adresu URL narzędzie WebFetch wysyła nazwę hosta (i tylko nazwę hosta) do api.anthropic.com w celu sprawdzenia czarnej listy bezpieczeństwa. Nadal wyświetlane są również ankiety dotyczące jakości sesji. Pierwszą funkcję można wyłączyć za pomocą skipWebFetchPreflight w pliku ustawień, a drugą za pomocą CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1. Ustawienie CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC również wyłącza ankiety oraz pozostały nieistotny ruch, ale nie wpływa na sprawdzanie WebFetch, które posiada własny mechanizm rezygnacji. Gdy platforma hostująca ustawia CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, telemetria jest domyślnie włączona.
W kwestii trenowania: zgodnie z warunkami komercyjnymi Anthropic nie trenuje modeli na kodzie ani promptach przesyłanych przez Claude Code, a korzystanie z platform zewnętrznych odbywa się na zasadach komercyjnych. Program Development Partner Program, czyli opcja dobrowolnego wyrażenia zgody na trenowanie, nie jest w ogóle oferowany użytkownikom Bedrock ani Vertex. W usłudze Vertex modele Fable wymagają udostępniania promptów i odpowiedzi firmie Anthropic w celu monitorowania nadużyć; to samo dotyczy modeli objętych programem Cyber Verification Program. Brak retencji danych w tych punktach końcowych zależy od umowy z AWS lub Google oraz od wymogów retencyjnych danego modelu.
Konfiguracja Claude Code dla Amazon Bedrock
Dwie czynności muszą zostać wykonane raz dla każdego konta AWS, zanim konfiguracja klienta zacznie mieć znaczenie. Należy otworzyć konsolę Amazon Bedrock, wybrać model Anthropic z katalogu modeli i przesłać formularz dotyczący przypadku użycia: dostęp jest przyznawany natychmiast po przesłaniu. Następnie należy dołączyć politykę IAM, która zezwala na wywołania wykonywane przez Claude Code.
bedrock:InvokeModelbedrock:InvokeModelWithResponseStreambedrock:ListInferenceProfilesbedrock:GetInferenceProfile
ListInferenceProfiles pozwala Claude Code sprawdzić przy starcie, które modele mogą być faktycznie wywoływane w ramach danego konta. GetInferenceProfile umożliwia rozwiązanie ARN profilu wnioskowania aplikacji na bazowy model podstawowy, co pozwala na wybór poprawnego formatu żądania. Bez tego uprawnienia żądania nadal kończą się powodzeniem, ponieważ Claude Code ponawia próbę z użyciem drugiego formatu. Objawem jest dodatkowy cykl komunikacji dla każdego nowego modelu, a nie błąd. Polityka opublikowana przez Anthropic zezwala również na aws-marketplace:ViewSubscriptions oraz aws-marketplace:Subscribe przy wywołaniach przez Bedrock, co obejmuje krok subskrypcji modelu.
Najszybszą ścieżką konfiguracji klienta jest kreator. Należy uruchomić claude, wybrać 3rd-party platform, a następnie Amazon Bedrock, lub wpisać /setup-bedrock w sesji, w której użytkownik jest już zalogowany. Narzędzie odczytuje profile z katalogu ~/.aws, weryfikuje dostępne modele i zapisuje wynik w bloku env pliku ~/.claude/settings.json, dzięki czemu konfiguracja nie zależy od profilu powłoki.
W przypadku automatyzacji wdrożenia należy samodzielnie ustawić zmienne.
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1Poświadczenia pochodzą ze standardowego łańcucha poświadczeń AWS SDK, więc wszystko, co działa w przypadku CLI aws, zadziała również tutaj: aws configure, profil SSO, przyjęta rola (assumed role) lub klucz API Bedrock.
aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-nameexport AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-keyToken bearer jest najprostszą opcją, z którą należy postępować ostrożnie, ponieważ jest to sekret przechowywany w zmiennej środowiskowej. AWS wydaje krótkoterminowe klucze ważne do 12 godzin oraz długoterminowe klucze ważne do określonej daty; te drugie są zalecane wyłącznie do celów testowych. Na współdzielonym serwerze budowania należy preferować rolę, która wygasa. To samo rozumowanie dotyczy wszystkich innych poświadczeń, które agent może odczytać, co jest przedmiotem ochrony sekretów przed dostępem agenta AI.
Pułapka regionu. Claude Code ustala region w następującej kolejności: AWS_REGION, następnie AWS_DEFAULT_REGION, potem region w aktywnym profilu AWS, a na końcu us-east-1. Ostatni krok jest wartością domyślną, a nie błędem, więc zespół, który nie ustawił regionu i założył routing europejski, wyśle żądania do regionu w USA bez żadnego ostrzeżenia. Należy uruchomić /status wewnątrz Claude Code, aby sprawdzić ustalony region oraz źródło, z którego pochodzi. Aby potwierdzić, jakie modele można wywoływać w danym regionie dla danego konta, należy uruchomić aws bedrock list-inference-profiles --region your-region.
Bedrock oferuje również punkt końcowy Mantle, który wykorzystuje natywny format API Anthropic. Należy go wybrać za pomocą CLAUDE_CODE_USE_MANTLE=1; korzysta on z tych samych poświadczeń AWS, ale wymaga osobnych uprawnień IAM bedrock-mantle:.
Uruchamianie Claude Code w Google Vertex AI
Włącz API i pobierz dane uwierzytelniające.
gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default loginZłóż wniosek o dostęp do wybranych modeli Claude w Model Garden. Czas oczekiwania na zatwierdzenie wynosi od 24 do 48 godzin. Przyznaj rolę roles/aiplatform.user, która zawiera uprawnienie aiplatform.endpoints.predict, wykorzystywane zarówno do wywoływania modeli, jak i zliczania tokenów.
Następnie wybierz dostawcę.
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-IDCLOUD_ML_REGION przyjmuje global, czyli lokalizację wieloregionalną, taką jak eu lub us, albo pojedynczy region. Globalny punkt końcowy zapewnia najwyższą dostępność, ale daje najmniejszą kontrolę nad tym, gdzie obsługiwane jest żądanie. Wymogi dotyczące rezydencji danych zazwyczaj wymuszają wskazanie konkretnej lokalizacji. Dostępność modeli różni się w zależności od wybranego typu punktu końcowego. Jeśli wymagany model nie jest dostępny w globalnym punkcie końcowym, przypisz go do konkretnej lokalizacji za pomocą zmiennej VERTEX_REGION_CLAUDE_*, pozostawiając resztę konfiguracji w trybie globalnym. Sprawdź aktualną stronę lokalizacji Vertex AI, zamiast polegać na nieaktualnych listach.
Pułapka projektu. ANTHROPIC_VERTEX_PROJECT_ID decyduje o tym, dokąd trafiają żądania. Claude Code kieruje je do tego projektu, nawet jeśli GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT lub plik z danymi uwierzytelniającymi wskazany przez GOOGLE_APPLICATION_CREDENTIALS zawierają inną wartość. Na maszynie, gdzie gcloud wskazuje jeden projekt, a pozostałość ANTHROPIC_VERTEX_PROJECT_ID wskazuje inny, koszty zostaną przypisane do tego drugiego, a sesja nie wyświetli żadnego ostrzeżenia.
Zweryfikuj ustawienia po każdej zmianie dostawcy. Uruchom /status, aby sprawdzić aktywnego dostawcę i konfigurację. Jeśli zmienne nie docierają do procesu, sprawdź, czy zostały wyeksportowane w powłoce, która uruchomiła claude. Przenieś je do bloku env w pliku ustawień; jest to również sposób na uniknięcie przekazywania wartości takich jak AWS_PROFILE do każdego innego uruchamianego procesu.
Dostępne modele i czas ich udostępnienia
Aliasy takie jak sonnet oraz opus nie oznaczają najnowszych wersji. W przypadku punktów końcowych innych firm rozwiązują się one do domyślnego modelu wbudowanego w Claude Code dla danego dostawcy, co może wiązać się z opóźnieniem względem bieżącego wydania lub brakiem aktywacji w danym koncie. Gdy model domyślny jest niedostępny, Claude Code przełącza się na wcześniejszy lub niższy model w ramach sesji i wyświetla powiadomienie. Ten mechanizm awaryjny nie jest zapisywany na stałe, jednak Claude Code może przechowywać informacje o odmowie dostępu do modelu na maszynie przez okres do jednego dnia. Po upływie dziesięciu minut od ostatniego sprawdzenia, przy uruchomieniu aplikacji, ponownie weryfikowana jest zapamiętana odmowa dla bieżącego modelu domyślnego.
W przypadku wdrożenia w zespole należy przypiąć konkretne wersje.
# 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>'Identyfikatory należy pobrać z przeglądu modeli oraz z katalogu dostawcy, ponieważ format różni się w zależności od platformy: Bedrock wymaga identyfikatora profilu wnioskowania (inference profile ID) lub ARN, natomiast Vertex oczekuje zwykłej nazwy modelu. Nie należy kopiować ich z artykułów, w tym z niniejszego tekstu. Przypinanie modeli pozwala również kontrolować koszty, ponieważ domyślnym modelem głównym jest model klasy Opus, który jest droższy za token niż Sonnet. W rezultacie wdrożenie bez przypisanych modeli jest rozliczane według wyższej stawki. Aby ustawić jeden konkretny model jako domyślny dla sesji, należy przypisać jego pełny identyfikator do ANTHROPIC_MODEL.
Czas udostępnienia modelu jest najbardziej istotnym czynnikiem w tym porównaniu. W przypadku bezpośredniego API Anthropic model działa w dniu premiery. W usługach Bedrock i Vertex model staje się dostępny, gdy dostawca chmury udostępni go w danym regionie, a konto otrzyma odpowiednie uprawnienia. Jeśli określone zadania wymagają najnowszego modelu, należy zachować ścieżkę routingu, która zapewnia do niego dostęp. Jest to praktyczne uzasadnienie dla kierowania różnych modeli do różnych zadań.
Ograniczenia przy korzystaniu z Bedrock i Vertex
Wszystkie funkcje lokalne działają u każdego dostawcy: subagenty, hooki, slash commands, umiejętności, wtyczki, punkty kontrolne (checkpoints), piaskownica (sandboxing), zarządzany plik ustawień oraz metryki OpenTelemetry. Braki dotyczą wyłącznie strony serwerowej.
Niedostępne w obu punktach końcowych: Advisor, Channels, Code Mode, pulpit nawigacyjny analityki, ustawienia zarządzane przez serwer oraz polecenia /design-sync i /import. Niedostępne jest również wszystko, co wymaga konta claude.ai, w tym Claude Code w przeglądarce, aplikacja mobilna, Remote Control, procedury (routines) oraz artefakty.
Tylko w Bedrock: tryb fast mode jest niedostępny, a narzędzie WebSearch nie istnieje, więc Claude nie może przeprowadzić wyszukiwania w sesji skierowanej do Bedrock. Nadal może jednak odczytać stronę za pomocą WebFetch, jeśli użytkownik poda adres URL. W Vertex wyszukiwanie w sieci działa dla modeli generatywnych Claude 4 i nowszych. Vertex obsługuje również fast mode w Fable 5.2 z Claude Code w wersji 2.1.322 lub nowszej w global, us lub eu, przy czym standardowa prędkość jest używana jako rozwiązanie zapasowe, jeśli dostawca odrzuci fast mode.
Ograniczone w obu przypadkach: auto mode działa tylko na ograniczonej liczbie nowszych modeli, komunikacja między sesjami obejmuje tylko inne sesje na tej samej maszynie, a /loop, który samodzielnie dobiera interwał, wymaga Claude Code w wersji 2.1.248 lub nowszej. Dostęp do pulpitu jest możliwy przez Claude Desktop w 3P lub poprzez routing bramy skonfigurowany w aplikacji bądź przez administratora. Przed zadeklarowaniem dostępności funkcji zespołowi należy sprawdzić stronę dostępności funkcji firmy Anthropic, ponieważ lista ta ulega zmianom.
Kto ponosi koszty
Subskrypcja oraz punkt końcowy zewnętrznego dostawcy to odrębne zakupy. Jeden nie zastępuje drugiego.
Należy to wyraźnie zaznaczyć, ponieważ błąd ten nie generuje powiadomień. Ustawienie CLAUDE_CODE_USE_BEDROCK=1 na maszynie, na której użytkownik jest jednocześnie zalogowany w ramach licencji Max, powoduje, że ruch jest rozliczany przez AWS: według stawek za token w modelu on-demand usługi Bedrock lub w ramach zakupionej przepustowości (provisioned throughput). Opłata za licencję jest naliczana co miesiąc i nie pokrywa żadnej części tego ruchu. Nie istnieje również wspólny widok kosztów: wydatki są widoczne w AWS Cost Explorer lub Google Cloud Billing, a panel analityczny Anthropic nie jest dostępny u żadnego z tych dostawców. Polecenie /logout również znika, ponieważ nie ma sesji Anthropic do zakończenia. Poświadczeniem jest w tym przypadku poświadczenie chmurowe.
Stawki znajdują się na stronach dostawców i ulegają zmianom, dlatego należy zapoznać się z cennikiem Amazon Bedrock lub cennikiem Vertex AI, zamiast polegać na wartościach podanych w artykułach. Jeden aspekt strukturalny pozostaje niezmienny: wnioskowanie on-demand w tych punktach końcowych jest rozliczane za token, więc agent pozostawiony w trybie ciągłego działania generuje koszty bez limitu planu, który mógłby je zatrzymać. Alternatywą oferowaną przez obie chmury jest provisioned throughput, czyli zarezerwowana przepustowość o stałej opłacie za czas jej utrzymywania. AWS rozlicza ją godzinowo, a Claude Code korzysta z niej, gdy identyfikator modelu zostanie ustawiony jako ARN przepustowości. Kwestię tego, czy którekolwiek z tych rozwiązań jest bardziej opłacalne niż zakup licencji dla każdego użytkownika, warto rozważyć przed wdrożeniem, a nie po otrzymaniu pierwszej faktury. Artykuł porównanie kosztów licencji i rozliczeń za token dla planów Team oraz Enterprise przedstawia zestawienie w skali zespołu.
Limity szybkości i kwoty działają inaczej w zależności od ścieżki routingu
W subskrypcjach Pro, Max, Ultra, Team oraz starszych planach Enterprise opartych na liczbie stanowisk, limity są przypisane do konta i resetują się zgodnie z harmonogramem. Osiągnięcie limitu oznacza konieczność oczekiwania, chyba że włączono kredyty na zużycie: subskrybenci Pro, Max i Ultra oraz organizacje w planach Team i starszych Enterprise mogą kontynuować pracę po przekroczeniu limitu według standardowych stawek API, aż do osiągnięcia limitu wydatków. Bieżące plany Enterprise oparte na zużyciu nie posiadają limitów na poziomie planu ani stanowiska: opłaty naliczane są według faktycznego wykorzystania, a administratorzy mogą ustawiać limity wydatków dla organizacji oraz poszczególnych użytkowników. To zachowanie opisano w sposobie działania limitów zużycia.
W przypadku klucza API Anthropic limity są przypisane do organizacji, wyrażone jako liczba żądań i tokenów na minutę oraz rosną wraz z poziomem wykorzystania.
W usługach Bedrock i Vertex limity to kwoty chmurowe, niezależne od jakiegokolwiek planu Anthropic. W Bedrock są one ustalane dla konta i regionu, zazwyczaj w podziale na model, wraz z dzienną kwotą tokenów dla wspieranych modeli w danym koncie i regionie. W Vertex limity są ustalane dla projektu i lokalizacji, a w przypadku globalnych i wieloregionalnych punktów końcowych, modele Claude wprowadzone po 26 maja 2026 r. współdzielą jedną kwotę na linię modeli: każda wersja rodziny modeli pobiera zasoby z tej samej puli w danej lokalizacji, przy czym globalny punkt końcowy oraz każdy punkt wieloregionalny posiadają oddzielne pule. Błąd 429 zazwyczaj oznacza wyczerpanie jednej z tych kwot, jednak w przypadku współdzielonej przepustowości typu pay-as-you-go może również oznaczać brak dostępnych zasobów u dostawcy, dlatego przed wprowadzeniem zmian należy ponowić próbę z użyciem mechanizmu backoff. Jeśli problemem jest kwota, rozwiązanie znajduje się w konsoli dostawcy: należy wnioskować o zwiększenie limitu lub przenieść się do lokalizacji z dostępną rezerwą. Bedrock rozlicza kwotę według reguły token burndown, a nie stałej liczby żądań, natomiast zarezerwowana przepustowość w obu chmurach jest nabywana jako provisioned throughput. W przypadku Vertex, podczas diagnozowania błędu 429, należy sprawdzić, czy punkt końcowy w pojedynczym regionie obsługuje zarówno główny model, jak i mniejszy, szybki model; CLOUD_ML_REGION=global stanowi udokumentowany punkt wyjścia dla poprawy dostępności. Strona quotas firmy Google zawiera informacje na temat wnioskowania o zwiększenie limitów.
Tryby awarii i odpowiadające im komunikaty
Could not load the default credentials w Vertex. Brak domyślnych poświadczeń aplikacji (Application Default Credentials) lub ich wygaśnięcie. Uruchom gcloud auth application-default login lub wskaż GOOGLE_APPLICATION_CREDENTIALS plik klucza konta serwisowego.
Błąd 404 dotyczący nazwy modelu w Vertex. Model nie został włączony w Model Garden dla danego projektu lub nie jest dostępny w wybranej lokalizacji. Niektóre modele są udostępniane wyłącznie przez globalny punkt końcowy lub w lokalizacjach wieloregionowych, takich jak eu, a nie w konkretnym regionie.
on-demand throughput isn't supported w Bedrock. Przekazano identyfikator podstawowego modelu (foundation model ID) dla modelu, który jest dostępny wyłącznie przez profil wnioskowania (inference profile). Należy użyć identyfikatora profilu wnioskowania.
AWS default-chain credential resolve timed out. Proces w łańcuchu poświadczeń AWS został wstrzymany, na przykład pomocnik credential_process oczekuje na dane wejściowe, których nie może otrzymać. Rozwiązanie wypełniające pamięć podręczną poświadczeń domyślnie przekracza limit czasu po 60 sekundach. Jeśli łańcuch faktycznie wymaga więcej czasu, na przykład w przypadku przepływu SSO w przeglądarce z uwierzytelnianiem MFA (multi-factor authentication) za wrapperem, należy zwiększyć limit w milisekundach za pomocą CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Przy ustawionym CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1 każde żądanie API rozwiązuje łańcuch bez tego limitu.
Błąd podczas uruchamiania Bedrock streaming response has content-type. Element pośredniczący między Claude Code a Bedrock modyfikuje strumień danych. Bedrock przesyła dane w binarnym formacie event-stream z typem zawartości application/vnd.amazon.eventstream, więc bramka, która przesyła je ponownie jako server-sent events, zwraca treść, której Claude Code nie może zdekodować. Należy skonfigurować bramkę tak, aby przekazywała treść odpowiedzi oraz nagłówek Content-Type bez zmian.
Otwieranie kart przeglądarki w pętli podczas AWS SSO. Korporacyjna sieć VPN lub proxy z inspekcją TLS przerywa proces logowania, Claude Code interpretuje zerwane połączenie jako błąd uwierzytelniania, ponownie uruchamia polecenie awsAuthRefresh i powtarza ten proces w nieskończoność. Należy usunąć awsAuthRefresh z pliku ustawień i uruchomić aws sso login ręcznie przed rozpoczęciem pracy z Claude Code.
Wybór metody routingu
Wybierz bezpośrednie połączenie z Anthropic, jeśli wymagasz dostępu do nowych modeli w dniu premiery oraz pełnego zestawu funkcji. Wybierz klucz API, jeśli preferujesz rozliczenia za tokeny bez konieczności wykupowania licencji stanowiskowych. Wybierz Bedrock lub Vertex, jeśli wymagane jest, aby wnioskowanie odbywało się wewnątrz konta chmurowego, którym już zarządzasz, i akceptujesz ograniczenia w dostępności modeli oraz uboższy zestaw funkcji w zamian za to rozwiązanie. Strony konfiguracyjne, które warto dodać do zakładek, to oficjalne dokumentacje Anthropic dla Amazon Bedrock oraz Google Vertex AI, a także lista AWS zawierająca modele według regionów.
Żadna z tych trzech opcji nie zmienia miejsca wykonywania agenta. Claude Code jest procesem lokalnym, który odczytuje pliki i wykonuje polecenia niezależnie od tego, który punkt końcowy odpowiada na zapytania. Dlatego zespoły, które chcą uruchamiać go poza laptopem, umieszczają agenta programistycznego na VPS i eksportują tam te same zmienne środowiskowe.
FAQ
Czy moja subskrypcja Claude opłaca Claude Code w ramach Bedrock lub Vertex?
Nie. Subskrypcja Pro, Max, Ultra, Team lub Enterprise oraz zewnętrzny punkt końcowy to oddzielne zakupy i żaden z nich nie obejmuje drugiego. Przy ustawionych CLAUDE_CODE_USE_BEDROCK=1 lub CLAUDE_CODE_USE_VERTEX=1 ruch jest rozliczany przez AWS lub Google Cloud za każdy token według stawek on-demand lub w ramach zakupionej przepustowości (provisioned throughput) i trafia na rachunek u dostawcy chmury, podczas gdy subskrypcja nadal obejmuje opłaty za standardowe interfejsy. Śledzenie wydatków przenosi się odpowiednio do AWS Cost Explorer lub Google Cloud Billing, ponieważ panel analityczny Anthropic nie jest dostępny u żadnego z tych dostawców.
Do którego regionu Claude Code wysyła moje żądania w Amazon Bedrock?
Do regionu, który został rozpoznany, co pokaże /status. Claude Code sprawdza AWS_REGION, następnie AWS_DEFAULT_REGION, potem region w aktywnym profilu AWS, a w przypadku braku tych ustawień przyjmuje us-east-1. Wbudowane modele domyślne są następnie kierowane do profili wnioskowania międzyregionalnego (cross-region inference), których prefiks odpowiada danemu regionowi, na przykład us. lub eu.; profil międzyregionalny może obsłużyć żądanie z innego regionu w obrębie tej samej strefy geograficznej. Jeśli wymagany jest konkretny region, należy użyć profilu wnioskowania aplikacji opartego na modelu podstawowym w tym regionie zamiast profilu międzyregionalnego i ustawić ANTHROPIC_MODEL na jego ARN.
Dlaczego najnowszy model Claude jest niedostępny na moim koncie Bedrock lub Vertex?
Ponieważ każdy dostawca chmury udostępnia modele według własnego harmonogramu, a dodatkowo konto musi posiadać przyznany dostęp. W Vertex dostęp należy zamówić w Model Garden, a zatwierdzenie może potrwać od 24 do 48 godzin. Do tego czasu aliasy takie jak sonnet i opus wskazują na wbudowane ustawienie domyślne Claude Code dla danego dostawcy, a gdy to ustawienie nie jest dostępne na koncie, Claude Code przełącza się na wcześniejszy lub niższy model dla danej sesji i wyświetla powiadomienie. Przypisz ANTHROPIC_DEFAULT_SONNET_MODEL oraz powiązane z nim wartości do identyfikatorów, których dostępność została potwierdzona.
Czy wyszukiwanie w sieci jest dostępne w Claude Code w Amazon Bedrock?
Nie. Narzędzie WebSearch nie jest dostępne w Bedrock, więc Claude nie może przeprowadzić wyszukiwania z sesji skierowanej do tej usługi. Nadal może jednak odczytać określoną stronę za pomocą WebFetch, jeśli podasz adres URL. W Google Vertex AI wyszukiwanie w sieci działa dla modeli generacji Claude 4 i nowszych, co stanowi jedną z niewielu różnic w możliwościach na korzyść Vertex.
Czy potrzebuję konta Anthropic, aby uruchomić Claude Code w Bedrock lub Vertex?
Nie. Uwierzytelnianie odbywa się za pomocą poświadczeń AWS lub Google Cloud, dlatego /logout jest niedostępne u obu dostawców. Jedno połączenie z Anthropic pozostaje aktywne niezależnie od używanego dostawcy: przed pobraniem adresu URL narzędzie WebFetch wysyła nazwę hosta (i tylko nazwę hosta) do api.anthropic.com w celu sprawdzenia jej na liście blokowanych domen (safety blocklist). Ustaw skipWebFetchPreflight w pliku konfiguracyjnym, aby wyłączyć to sprawdzanie, i połącz to z regułami uprawnień WebFetch, jeśli nadal chcesz ograniczyć domeny, do których Claude może uzyskiwać dostęp.