Seria tutoriali Claude Code 6: Jak uwierzytelnić – logowanie przez przeglądarkę i ręczna konfiguracja klucza API

Proces uwierzytelniania: logowanie przez przeglądarkę i ręczna konfiguracja klucza API

Po zainstalowaniu Claude Code, musisz jeszcze przejść uwierzytelnianie, aby móc z niego korzystać. Musisz powiązać narzędzie ze swoim kontem Anthropic. Są dwa sposoby: logowanie przez przeglądarkę i ręczna konfiguracja klucza API. Oba sposoby dają ten sam efekt – wybierz ten, który jest dla Ciebie wygodniejszy.

Sposób 1: Logowanie przez przeglądarkę (zalecany)

Claude Code udostępnia automatyczne polecenie uwierzytelniania claude login, które otwiera przeglądarkę, pozwala na autoryzację w sieci, a następnie automatycznie zapisuje poświadczenia w terminalu.

Kroki:

W terminalu wpisz:

bash claude login

System wyświetli komunikat i automatycznie otworzy w domyślnej przeglądarce stronę autoryzacji Anthropic.
Jeśli nie otworzy się automatycznie, w terminalu pojawi się link – możesz go skopiować i otworzyć ręcznie w przeglądarce.
Zaloguj się na swoje konto Anthropic w przeglądarce (jeśli jesteś już zalogowany, strona poprosi bezpośrednio o autoryzację).
Kliknij „Zezwól” lub „Autoryzuj”, strona przeglądarki wyświetli komunikat „Autoryzacja powiodła się, możesz zamknąć tę stronę”.
Wróć do terminala – zobaczysz komunikat o zakończeniu uwierzytelniania. Teraz po wpisaniu polecenia claude będzie ono powiązane z Twoim kontem.

Sposób 2: Ręczna konfiguracja klucza API

Jeśli używasz serwera bez interfejsu graficznego, kontenera lub nie chcesz korzystać z autoryzacji przez przeglądarkę, możesz pobrać klucz API z konsoli Anthropic i skonfigurować go w Claude Code.

Kroki:

Otwórz przeglądarkę i wejdź na https://console.anthropic.com, zaloguj się na swoje konto Anthropic.
Przejdź do strony API Keys (zwykle w ustawieniach lub w opcjach dla deweloperów) i kliknij „Utwórz klucz API”.
Nadaj kluczowi nazwę (np. claude-code-local), a po wygenerowaniu natychmiast go skopiuj.
Uwaga: klucz jest wyświetlany tylko raz – po zamknięciu strony nie będzie go widać. Jeśli zapomnisz go zapisać, usuń stary i wygeneruj nowy.
Wróć do terminala – są dwa sposoby na przekazanie klucza do Claude Code:

A. Zmienna środowiskowa:

bash export ANTHROPIC_API_KEY=twój-klucz-api

Dodaj tę linię do pliku ~/.bashrc lub ~/.zshrc, aby działała automatycznie przy każdym uruchomieniu.

B. Konfiguracja w pliku:

Claude Code odczytuje również swój własny plik konfiguracyjny. Ręcznie edytuj plik ~/.claude/config.json (jeśli nie istnieje, utwórz go) i wpisz:

json { "apiKey": "twój-klucz-api" }

Uwaga: zaleca się ustawienie uprawnień tego pliku na 600 (chmod 600 ~/.claude/config.json), aby uniemożliwić odczyt innym użytkownikom.

Przetestuj połączenie:

bash claude "Cześć, odpowiedz 'OK'"

Jeśli otrzymasz poprawną odpowiedź, klucz jest skonfigurowany poprawnie.

Częste błędy przy ręcznej konfiguracji:

Klucz nie zaczyna się od sk-ant- czy sk-? Nie, klucz API Anthropic rzeczywiście zaczyna się od sk-ant-api03- i jest długim ciągiem znaków. Podczas kopiowania nie pomiń żadnego znaku.
Jeśli ustawisz zarówno zmienną środowiskową, jak i plik konfiguracyjny, zmienna środowiskowa ma wyższy priorytet. Zachowaj tylko jeden sposób, aby uniknąć nieporozumień.
Klucz jest poświadczeniem płatnym – nie wysyłaj go do repozytorium Git. Zaleca się dodanie całego katalogu ~/.claude lub pliku konfiguracyjnego do .gitignore.

Zmiana konta lub wylogowanie

Jeśli chcesz zmienić konto lub usunąć lokalne poświadczenia:

Jeśli używasz claude login: wykonaj claude logout, a następnie ponownie claude login.
Jeśli ręcznie skonfigurowałeś klucz: usuń stary klucz ze zmiennej środowiskowej lub pliku konfiguracyjnego i zastąp go nowym.

Testowanie poprawności uwierzytelnienia

claude "wyjaśnij, co robi bieżący katalog"

Jeśli narzędzie odczyta ogólne informacje o projekcie, środowisko jest gotowe.