Claude Code: model not found / model unavailable - jak naprawić

Claude Code

Claude Code: model not found / model unavailable - jak naprawić

W skrócie

Kiedy Claude Code prosi o model, którego nie ma, dostajesz błąd model not found lub model unavailable. Pokazujemy, skąd bierze się zła nazwa modelu i jak szybko wskazać poprawny.

Jak to wygląda w praktyce

Przy starcie zadania Claude Code zwraca model not found lub model unavailable z błędem not_found_error. Narzędzie nie wykonuje zapytania, bo nie potrafi znaleźć modelu, o który zostało poproszone.

Często dzieje się to po aktualizacji albo po ręcznym ustawieniu konkretnej nazwy modelu, która przestała być aktualna. Ponowienie nie pomaga - dopóki wskazujesz nieistniejący model, błąd wraca za każdym razem.

Dlaczego tak się dzieje

Powodem jest zwykle przestarzała lub błędna nazwa albo ID modelu - w konfiguracji, w ustawieniach lub w zmiennej środowiskowej. Może to być literówka w identyfikatorze, model wycofany po aktualizacji albo wpisany na sztywno stary model, który już nie istnieje.

Druga grupa przyczyn to niedostępność: model bywa niedostępny na Twoim planie albo w Twoim regionie. Wtedy identyfikator jest formalnie poprawny, ale konkretny model nie jest dla Ciebie udostępniony i Claude Code zgłasza, że go nie znajduje.

Jak to rozwiązać krok po kroku

1. Wybierz model przez /model z listy dostępnych zamiast wpisywać jego nazwę ręcznie - to eliminuje literówki i wycofane identyfikatory.
2. Zaktualizuj Claude Code do najnowszej wersji, żeby narzędzie znało aktualne nazwy modeli.
3. Popraw lub usuń wymuszoną nazwę modelu w ustawieniach albo w zmiennej środowiskowej, jeśli była wpisana na sztywno.
4. Sprawdź, czy dany model jest dostępny na Twoim planie i w Twoim regionie - jeśli nie, wybierz inny z dostępnych.
5. Gdy nie masz pewności co do nazwy, kieruj się rodziną Claude 4.x (Opus, Sonnet, Haiku), bo identyfikatory modeli bywają aktualizowane.

Jak sprawdzić, że zadziałało

Po wybraniu modelu przez /model uruchom krótkie zapytanie. Jeśli przejdzie bez komunikatu model not found ani model unavailable, wskazany model jest dostępny i aktywny na Twoim koncie.

Sprawdź też, czy w ustawieniach lub zmiennej środowiskowej nie pozostała stara, wymuszona nazwa modelu, która mogłaby ponownie nadpisać wybór. Gdy lista w /model pokazuje aktualne modele i 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