Claude Code: Invalid API key - jak naprawić klucz API

Claude Code

Claude Code: Invalid API key - jak naprawić klucz API

W skrócie

Komunikat Invalid API key pojawia się, gdy rozliczasz się kluczem API, a Claude Code nie może się nim uwierzytelnić. Pokazujemy, gdzie najczęściej tkwi problem i jak go naprawić krok po kroku.

Jak to wygląda w praktyce

Przy próbie wykonania zapytania Claude Code zwraca Invalid API key z błędem authentication_error i kodem 401. Narzędzie w ogóle nie zaczyna pracy - odbija się już na etapie uwierzytelnienia, więc żadne zadanie nie rusza.

Dotyczy to sytuacji, gdy rozliczasz się kluczem API, a nie subskrypcją. Charakterystyczne jest to, że ponowienie nie pomaga: dopóki klucz jest zły lub źle podany, każda próba kończy się tym samym błędem 401.

Dlaczego tak się dzieje

Najczęstsze przyczyny to błędny, wygasły lub odwołany klucz, zmienna ANTHROPIC_API_KEY nieustawiona albo nadpisana pustą czy starą wartością, oraz klucz skopiowany ze spacją lub w niepełnej postaci. Wystarczy jeden urwany znak, żeby uwierzytelnienie padło.

Bywa też, że klucz pochodzi z innej organizacji niż ta, na której chcesz pracować, albo mieszasz logowanie subskrypcją z rozliczeniem kluczem API. Claude Code korzysta wtedy z niewłaściwego źródła uwierzytelnienia i zgłasza 401.

Jak to rozwiązać krok po kroku

1. Sprawdź, czy zmienna ANTHROPIC_API_KEY jest ustawiona i zawiera pełny, poprawny klucz bez spacji na początku i końcu.
2. Upewnij się, że żaden profil powłoki ani skrypt nie nadpisuje ANTHROPIC_API_KEY pustą lub starą wartością.
3. Wygeneruj nowy klucz w konsoli Anthropic, jeśli obecny mógł wygasnąć albo zostać odwołany, i ustaw go ponownie.
4. Zweryfikuj, że klucz należy do właściwej organizacji, na której chcesz pracować.
5. Ustal, skąd Claude Code bierze uwierzytelnienie - z subskrypcji czy z klucza API - i nie mieszaj obu metod w jednej sesji.
6. Sprawdź /status, aby potwierdzić, że narzędzie widzi poprawne źródło uwierzytelnienia.

Jak sprawdzić, że zadziałało

Po ustawieniu klucza uruchom dowolne krótkie zapytanie. Jeśli przejdzie bez komunikatu Invalid API key i bez kodu 401, klucz jest poprawny i aktywny, a Claude Code korzysta z właściwego źródła uwierzytelnienia.

Dla pewności wywołaj /status - potwierdzi, czy narzędzie uwierzytelnia się kluczem API czy subskrypcją. Jeśli źródło się zgadza, a zapytania działają, problem jest rozwiązany.

Wróć do listy problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5