Przejdź do głównej zawartości

Uwierzytelnianie w Claude Code: subskrypcje, klucze API i dostawcy chmury

Claude Code uwierzytelnia się logowaniem do subskrypcji Claude (Pro, Max, Team lub Enterprise), kontem Claude Console rozliczanym według stawek API albo poświadczeniami dostawcy chmury: Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry lub Claude Platform on AWS. Gdy dostępnych jest kilka poświadczeń, o wyborze decyduje stała kolejność pierwszeństwa, dlatego aktywną metodę potwierdza się poleceniem /status.

Ta strona jest dla programistów, którzy logują się po raz pierwszy: na laptopie, przez SSH albo w CI. Tech leadzi, którzy ujednolicają logowanie w zespole, znajdą ustawienia organizacyjne pod koniec. Typowa awaria wygląda tak: płacisz za Max, ale profil powłoki nadal eksportuje ANTHROPIC_API_KEY z pobocznego projektu, więc każda sesja obciąża ten klucz. Albo pipeline nie ma przeglądarki i pierwsze zadanie, które uruchamia claude, zawiesza się na ekranie logowania.

Co zyskujesz, konfigurując uwierzytelnianie Claude Code

Dział zatytułowany „Co zyskujesz, konfigurując uwierzytelnianie Claude Code”
  • Działające logowanie w modelu rozliczeń, którego naprawdę chcesz, sprawdzone poleceniem, a nie pytaniem zadanym modelowi.
  • Kolejność pierwszeństwa, która rozstrzyga, które poświadczenie wygrywa, oraz prompt wykrywający konflikty na twojej maszynie.
  • Token dla CI, który nie wymaga przeglądarki, i skrypt pobierający rotowane klucze z magazynu sekretów.
  • Ustawienia zarządzane, które trzymają logowania zespołu w jednej organizacji, razem z lukami, jakie zostawiają.

Wszystkie polecenia na tej stronie sprawdzono 2026-09-26 w zainstalowanym CLI, Claude Code 2.1.283 (claude --help, claude auth --help), oraz w oficjalnej dokumentacji uwierzytelniania.

Wybieraj według tego, kto płaci i kto zarządza dostępem. Sam proces logowania jest najprostszą częścią.

MetodaWybierz, gdyRozliczenieJak się logujesz
Claude Pro lub MaxPracujesz jako indywidualny programistaStały abonament miesięczny z limitami w kroczących oknach 5-godzinnych i tygodniowychclaude, a potem Claude account with subscription
Claude for Teams lub EnterpriseFirma chce jednej faktury, stanowisk i SSOZa stanowisko; Enterprise dolicza użycie według stawek APIclaude z kontem claude.ai, na które zaprosił cię administrator
Claude ConsoleChcesz płacić za tokeny i śledzić koszty per workspaceTokeny według stawek APIclaude auth login --console albo ANTHROPIC_API_KEY
Amazon BedrockRuch AI musi zostać na koncie AWSFaktura AWSKreator konfiguracji albo CLAUDE_CODE_USE_BEDROCK=1
Google Cloud’s Agent Platform (dawniej Vertex AI)Ruch AI musi zostać w projekcie Google CloudFaktura Google CloudKreator konfiguracji albo CLAUDE_CODE_USE_VERTEX=1
Microsoft FoundryRuch AI musi zostać w AzureFaktura AzureCLAUDE_CODE_USE_FOUNDRY=1 (bez kreatora)
Claude Platform on AWSKupujesz platformę Anthropic przez AWSFaktura AWSCLAUDE_CODE_USE_ANTHROPIC_AWS=1

Darmowy plan Claude nie obejmuje Claude Code. Według stanu na 2026-09-26 opublikowane ceny to Pro 20 USD miesięcznie, Max 5x 100 USD i Max 20x 200 USD; Team i Enterprise są wyceniane za stanowisko (claude.com/pricing). Ile każda opcja kosztuje przy obciążeniu agentowym, opisuje strona kontrola kosztów Claude Code. Jeśli firma kieruje cały ruch do modeli przez własne proxy, zamiast tej strony przeczytaj konfigurację bramy LLM.

To domyślna ścieżka dla użytkowników Pro, Max, Team i Enterprise.

  1. W terminalu uruchom Claude Code:

    Okno terminala
    claude

    Aby zalogować się bez otwierania sesji, uruchom zamiast tego claude auth login. Domyślnie korzysta z subskrypcji Claude; dodaj --sso, aby wymusić firmowe SSO, albo --email you@example.com, aby wstępnie wypełnić stronę logowania.

  2. Na ekranie logowania wybierz Claude account with subscription. Otworzy się przeglądarka. Jeśli się nie otworzy, naciśnij c, aby skopiować adres logowania, i wklej go w dowolnej przeglądarce.

  3. Zaloguj się. Jeśli przeglądarka zamiast powrotu do terminala pokaże kod, wklej go przy komunikacie Paste code here if prompted. Dzieje się tak przez SSH, w WSL2 i w kontenerach, gdzie przeglądarka nie może połączyć się z lokalnym serwerem zwrotnym Claude Code.

  4. Poczekaj na Login successful i naciśnij Enter.

  5. Sprawdź w terminalu, jako kto jesteś zalogowany:

    Okno terminala
    claude auth status --text

    W sesji te same informacje pokazuje /status, łącznie z metodą logowania, organizacją i adresem e-mail.

Członkowie planów Team i Enterprise przechodzą ten sam proces z kontem claude.ai, na które zaprosił ich administrator. Enterprise dokłada do Teams przejmowanie kont w firmowej domenie (domain capture), uprawnienia oparte na rolach i Compliance API.

Rozliczenie przez Console nalicza opłaty za tokeny, co pasuje do nieregularnego użycia i zespołów, które już śledzą wydatki w Console. Najpierw administrator musi zaprosić cię do organizacji w Console z rolą Claude Code (może tworzyć tylko klucze Claude Code) albo Developer.

Okno terminala
claude auth login --console

Od wersji v2.1.242 logowanie do Console (Anthropic Console account na ekranie logowania albo claude auth login --console) pyta o sposób:

  • Sign in with your Console account (oznaczone jako zalecane) zapisuje odświeżane logowanie OAuth i nie tworzy klucza API. Wybierz tę opcję: na dysku nie ma statycznego sekretu, który mógłby wyciec.
  • Create an API key (oznaczone jako legacy, czyli starszy sposób) tworzy klucz i zapisuje go razem z innymi poświadczeniami.

Logowanie bez klucza wylogowuje też z każdego logowania claude.ai zapisanego na maszynie, więc nie używaj go na laptopie, na którym chcesz zachować logowanie do subskrypcji; /logout usuwa i unieważnia zapisane przez nie poświadczenie.

Claude Code pomija ten wybór i zawsze tworzy klucz, gdy działasz przez dostawcę chmury albo gdy plik ustawień ustawia forceLoginOrgUUID lub forceLoginMethod na "claudeai" albo "console", a także gdy na maszynie istnieje zarządzane źródło ustawień, którego nie da się odczytać. Przed logowaniem bez klucza wyczyść ANTHROPIC_API_KEY.

Klucz możesz też podać bezpośrednio przez ANTHROPIC_API_KEY. W sesji interaktywnej Claude Code raz prosi o akceptację klucza i zapamiętuje odpowiedź; później zmienisz ją przełącznikiem „Use custom API key” w /config. Z claude -p klucz jest używany zawsze, gdy jest obecny. Wczytuj go z menedżera sekretów zamiast wpisywać do ~/.zshrc albo użyj apiKeyHelper.

U dostawcy chmury logowanie w przeglądarce nie jest potrzebne. Uwierzytelniają własne poświadczenia dostawcy, a żądania trafiają na fakturę twojego konta chmurowego. Dla Bedrock i Google Cloud’s Agent Platform najprostszą drogą jest kreator: uruchom claude, na ekranie logowania wybierz 3rd-party platform i wskaż dostawcę. Kreator wykrywa poświadczenia, pyta o region, sprawdza, które modele Claude możesz wywołać, i zapisuje wynik w bloku env pliku ~/.claude/settings.json.

Najpierw włącz model Anthropic w katalogu modeli konsoli Bedrock i wyślij formularz z opisem zastosowania. Potem uruchom kreator (później otworzysz go ponownie przez /setup-bedrock; dopóki nie ustawisz CLAUDE_CODE_USE_BEDROCK=1, polecenie jest ukryte w menu, więc wpisz je w całości) albo ustaw zmienne samodzielnie:

Okno terminala
# Terminal: logowanie profilem IAM Identity Center, potem wskazanie Bedrock w Claude Code
aws sso login --profile YOUR_PROFILE
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_PROFILE=YOUR_PROFILE
export AWS_REGION=us-east-1 # opcjonalne, gdy profil już ustawia region
claude

YOUR_PROFILE to nazwa profilu w ~/.aws/config. Wybieraj profil zamiast statycznych eksportów AWS_ACCESS_KEY_ID. Aby wygasła sesja SSO odnawiała się automatycznie, dodaj do ustawień "awsAuthRefresh": "aws sso login --profile YOUR_PROFILE"; Claude Code uruchamia to polecenie tylko wtedy, gdy poświadczenia wyglądają na wygasłe, a kontrola STS GetCallerIdentity to potwierdzi.

Po pierwszym prompcie uruchom /status: pokazuje dostawcę, a dla Bedrock także ustalony region oraz jego źródło, jeśli pochodzi z plików konfiguracyjnych AWS albo z domyślnej wartości zapasowej.

Uwierzytelnij Claude Code w CI i na maszynach bez przeglądarki

Dział zatytułowany „Uwierzytelnij Claude Code w CI i na maszynach bez przeglądarki”

W pipeline’ie nikt nie kliknie w przeglądarce. Masz dwie możliwości:

  • Token subskrypcji. Uruchom claude setup-token na własnej maszynie. Polecenie otwiera ten sam proces w przeglądarce co /login i wypisuje roczny token OAuth, niczego nie zapisując. Zapisz token w magazynie sekretów CI jako CLAUDE_CODE_OAUTH_TOKEN. Wymaga planu Pro, Max, Team lub Enterprise i pozwala tylko na żądania do modelu: nie uruchomi sesji Remote Control ani nie pobierze konektorów claude.ai. Nie wpisuj go do profilu powłoki na laptopie: /login przy ustawionej zmiennej przełącza tylko bieżącą sesję, a każda nowa sesja znowu czyta zmienną.
  • Klucz API z Console. Zapisz go jako ANTHROPIC_API_KEY. Użyj go (albo apiKeyHelper przekazanego przez --settings) w każdym zadaniu z claude --bare, bo tryb bare nigdy nie czyta CLAUDE_CODE_OAUTH_TOKEN, pęku kluczy ani sesji z /login. Klucz w osobnym workspace Console dodatkowo oddziela koszty pipeline’u od kosztów ludzi.

Wstrzykuj sekret tylko do kroku, który uruchamia Claude Code. Nigdy nie pozwól, by zadanie pobierające niezaufany pull request miało go w środowisku. Workflow opisuje strona CI/CD, a zakres i rotację poświadczeń — tożsamość agentów i sekrety.

Którego poświadczenia używa Claude Code, gdy ustawiono kilka?

Dział zatytułowany „Którego poświadczenia używa Claude Code, gdy ustawiono kilka?”

Claude Code wybiera dokładnie jedno poświadczenie, w tej kolejności:

  1. Poświadczenia dostawcy chmury, gdy ustawiono CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX lub CLAUDE_CODE_USE_FOUNDRY.
  2. ANTHROPIC_AUTH_TOKEN, wysyłany jako token bearer (dla bram LLM i proxy).
  3. ANTHROPIC_API_KEY, po akceptacji w sesji interaktywnej.
  4. Wynik skryptu apiKeyHelper.
  5. CLAUDE_CODE_OAUTH_TOKEN z claude setup-token.
  6. Profile Anthropic i poświadczenia federacyjne (CLI ant i Workload Identity Federation). Profil z ant auth login lub z logowania do Console bez klucza trafia tu tylko wtedy, gdy wskazuje go ANTHROPIC_PROFILE; w przeciwnym razie jest poniżej /login. Gdy profil jest w użyciu, /status pokazuje wiersz Profile.
  7. Logowanie do subskrypcji z /login.

Zalogowana sesja Claude apps gateway stoi ponad tą listą. Wniosek praktyczny: wszystko, co eksportuje twoja powłoka, wygrywa z subskrypcją. Zaakceptowany ANTHROPIC_API_KEY obciąża Console, choć płacisz za Max, a klucz z wyłączonej organizacji sprawia, że każde żądanie kończy się błędem. Gdy skonfigurowane są i logowanie, i klucz, /status oznacza to, które nie jest używane.

Gdy klucze pochodzą z magazynu sekretów albo wygasają według harmonogramu, wskaż w apiKeyHelper skrypt, który wypisuje poświadczenie na stdout. Claude Code uruchamia go przez /bin/sh (w Windows przez cmd) i wysyła wynik jako klucz API.

{
"apiKeyHelper": "~/.claude/bin/anthropic-key.sh"
}

Claude Code buforuje wynik i uruchamia skrypt ponownie po pięciu minutach (zmienisz to przez CLAUDE_CODE_API_KEY_HELPER_TTL_MS), po odpowiedzi 401 lub 403 oraz przed żądaniem, gdy zbuforowana wartość to wygasły JWT. Skrypt zdefiniowany w ustawieniach projektu uruchamia się dopiero po zaakceptowaniu zaufania do workspace. Jeśli skrypt zwróci kod błędu, przekroczy czas albo nic nie wypisze, żądania w ciągu trzech prób kończą się komunikatem Your apiKeyHelper script is failing.

Gdzie Claude Code przechowuje poświadczenia i jak przełączać konta?

Dział zatytułowany „Gdzie Claude Code przechowuje poświadczenia i jak przełączać konta?”
SystemGdzie jest zapisane logowanie
macOSSzyfrowany pęk kluczy (Keychain). Gdy jest zablokowany (częste przez SSH), Claude Code zapisuje logowanie w ~/.claude/.credentials.json z uprawnieniami 0600.
Linux~/.claude/.credentials.json, uprawnienia 0600
Windows%USERPROFILE%\.claude\.credentials.json, dostępny tylko dla twojego użytkownika dzięki uprawnieniom katalogu profilu

Zmienna CLAUDE_CONFIG_DIR przenosi .credentials.json i pliki ustawień do wskazanego katalogu, a w macOS używa osobnego wpisu w pęku kluczy. To czysty sposób na równoległe konto prywatne i firmowe:

Okno terminala
# ~/.zshrc: drugie polecenie z własnym logowaniem i ustawieniami
alias claude-work='CLAUDE_CONFIG_DIR="$HOME/.claude-work" claude'

Uruchom claude-work raz i zaloguj się kontem firmowym. Aby zmienić konto w obrębie jednej konfiguracji, wpisz w sesji /login; /logout wylogowuje i dodatkowo resetuje konfigurację pierwszego uruchomienia.

Tech leadzi wdrażający Claude Code w zespole powinni zablokować logowanie kontami prywatnymi. Ustaw oba klucze w zarządzanym pliku ustawień maszyny (managed-settings.json, dystrybuowanym przez MDM):

{
"forceLoginMethod": "claudeai",
"forceLoginOrgUUID": "YOUR_ORG_UUID"
}

YOUR_ORG_UUID znajdziesz w ustawieniach administratora claude.ai dla organizacji Teams lub Enterprise. Zanim na tym polegasz, poznaj luki:

  • Ustawienia zarządzane z serwera nie przekierują pierwszego logowania, bo docierają tylko do kont, które już należą do organizacji. Dystrybuuj te klucze przez zarządzanie urządzeniami, a jeśli używasz też ustawień z serwera, ustaw je w obu miejscach.
  • Interaktywny ekran logowania wstępnie zaznacza metodę, ale jej nie wymusza, a claude setup-token i /install-github-app egzekwują tylko forceLoginMethod, więc nadal mogą wygenerować token w innej organizacji.
  • Poświadczenia ze środowiska są blokowane przy starcie, gdy ustawiono forceLoginOrgUUID: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN i apiKeyHelper nie potwierdzają członkostwa w organizacji. Sesje dostawców chmury i profile Anthropic nie są blokowane, więc dostęp do chmury ogranicz przez IAM, a profile sprawdzaj w /status.
  • Logowania do Console nie są sprawdzane pod kątem organizacji: przy logowaniu do Console forceLoginOrgUUID jedynie wstępnie wybiera organizację na stronie logowania, a programista zalogowany do Console przed wdrożeniem kluczy pozostaje zalogowany. Ponieważ ekran logowania nie wymusza też forceLoginMethod, o tym, kto może rozliczać się przez Console, decyduj przez członkostwo w organizacji Console.

Pełne wdrożenie, z uprawnieniami i telemetrią, opisują strony zarządzana polityka dla agentów i integracja z przedsiębiorstwem.

Nie pytaj modelu, jakiego konta używa: model widzi rozmowę, a nie magazyn poświadczeń. Sprawdzaj narzędzie i przypisz każdą kontrolę do konkretnej osoby.

  • Programista, raz na maszynę: claude auth status --text wypisuje wiersz Login method oraz bazowy URL i ewentualne proxy; /status w sesji pokazuje metodę logowania, organizację i e-mail oraz oznacza poświadczenie skonfigurowane, lecz nieużywane.
  • CI, przy każdym uruchomieniu: opisany wyżej smoke test przerywa zadanie przed właściwą pracą, jeśli sekretu brakuje, wygasł albo został unieważniony.
  • Tech lead, raz na wdrożenie: na jednym zarządzanym laptopie zaloguj się kontem prywatnym i sprawdź, że Claude Code je odrzuca; potem wyeksportuj testowy ANTHROPIC_API_KEY i sprawdź, że start jest zablokowany.
  • Właściciel budżetu, co tydzień: porównaj /usage (subskrypcje) albo stronę użycia w Console (rozliczenie API) z oczekiwaniami; niespodziewany rachunek z Console od użytkownika subskrypcji to opisana wyżej pułapka pierwszeństwa.

Przeglądarka się nie otwiera albo nie wraca do terminala. Naciśnij c, aby skopiować adres, zaloguj się w dowolnym miejscu i wklej kod przy Paste code here if prompted. Przez SSH, w WSL2 i w kontenerach to normalne.

Login expired · Please run /login. Uruchom /login. Od wersji v2.1.217 Claude Code ostrzega trzy dni przed wygaśnięciem komunikatem Your login expires in 3 days · run /login to renew (wersje v2.1.203–v2.1.216 ostrzegały pięć dni wcześniej). Ostrzeżenie pojawia się tylko wtedy, gdy aktywnym poświadczeniem jest logowanie claude.ai albo Console. Odnów logowanie przed uruchomieniem sesji w tle albo Remote Control: sesja działająca bez nadzoru staje w miejscu, gdy wygaśnie jej logowanie.

Płacisz za subskrypcję, a widzisz opłaty za API, albo żądania padają po unieważnieniu klucza. Klucz ze środowiska wygrywa z logowaniem. Uruchom unset ANTHROPIC_API_KEY, usuń go z profilu powłoki i potwierdź w /status.

Your apiKeyHelper script is failing. Uruchom skrypt ręcznie, przekierowując stdout do wc -c. Musi wypisać wyłącznie klucz, zakończyć się kodem 0 i działać wyraźnie krócej niż 10 sekund; po 10 sekundach Claude Code pokazuje ostrzeżenie o wolnym skrypcie.

Start kończy się błędem polityki organizacji. Administrator ustawił forceLoginOrgUUID, co blokuje klucze ze środowiska. Wyczyść je i użyj /login z kontem firmowym.

Poświadczenia chmurowe wygasły w ciągu dnia. Uruchom ponownie aws sso login albo gcloud auth application-default login. Aby działo się to automatycznie, ustaw w ustawieniach awsAuthRefresh dla Bedrock albo gcpAuthRefresh dla Google Cloud’s Agent Platform.

Model jest niedostępny u dostawcy. Włącz go w katalogu modeli Bedrock albo w Model Garden lub przypnij model, który twoje konto może wywołać; identyfikatory są w przeglądzie modeli. W Foundry najpierw sprawdź, czy ANTHROPIC_FOUNDRY_RESOURCE zawiera prawdziwą nazwę zasobu, a nie placeholder.

Logowanie do Console w macOS przez SSH się nie udaje. Logowanie do Console, które tworzy klucz API, wymaga zapisywalnego pęku kluczy. Odblokuj go albo wybierz logowanie do Console bez klucza.

Trafiasz na limit użycia w Pro lub Max. Uruchom /usage, aby zobaczyć, które okno się wyczerpało i kiedy się odnowi, a potem ogranicz liczbę równoległych sesji albo przejdź na większy plan. Kompromisy opisuje kontrola kosztów Claude Code.

Uwierzytelnianie następuje po instalacji Claude Code. Kolejny krok to tryb uprawnień, model i hierarchia ustawień w twoich projektach. Używasz też Codex? Zobacz Uwierzytelnianie w Codex.