Jak zaktualizować Claude Code do najnowszej wersji w 2026 roku

Claude Code zmienia się niemal codziennie. Otwierasz najnowszy dziennik zmian i znajdujesz nowe polecenia, naprawione błędy oraz poprawę szybkości. Tymczasem w terminalu działa kompilacja sprzed dwóch tygodni, a połowa tych usprawnień po prostu nie działa. Claude też ci o tym nie mówi: uruchamia się jak zwykle, a ty zastanawiasz się, dlaczego inni mają funkcję, której tobie brakuje.

Pokażę, jak sprawdzić wersję, zaktualizować ją do najnowszej i co zrobić, jeśli aktualizacja nie chce się zainstalować. Polecenia są cytowane dosłownie z oficjalnej dokumentacji Claude Code i zostały sprawdzone na początku września 2026 roku. W tamtym czasie najnowszą opublikowaną wersją była 2.1.261, ale u ciebie numer będzie inny. Nie ma sensu gonić za konkretnym numerem — ważne, żeby korzystać z niedawno wydanej kompilacji.

Informacje o korzystaniu z Ailoot znajdziesz w dokumentacji.

Jak szybko zaktualizować Claude Code do najnowszej wersji?#

Poniżej szczegółowo omówię każdy przypadek, ale jeśli się spieszysz, te trzy polecenia wystarczą w niemal każdej sytuacji.

claude --version   # aktualnie zainstalowana wersja
claude update      # natychmiastowa aktualizacja (instalacja natywna)
claude doctor      # sprawdzenie instalacji i aktualizacji

Pierwsze polecenie pokazuje wersję, drugie ją aktualizuje, a trzecie diagnozuje problemy, jeśli coś pójdzie nie tak. Poniżej wyjaśnię, kiedy używać każdego z nich i dlaczego claude update nie działa u niektórych osób.

Jak sprawdzić, która wersja Claude Code jest obecnie zainstalowana?#

Przed aktualizacją warto wiedzieć, z której wersji zaczynasz. Polecenie jest proste:

claude --version

Zobaczysz wiersz podobny do 2.1.211 (Claude Code). To twoja obecna wersja. Porównaj pierwsze dwie liczby z najnowszym numerem w dzienniku zmian — jeśli twoja jest znacznie niższa, czas na aktualizację.

Jeśli chcesz uzyskać szerszy obraz, uruchom claude doctor. To polecenie tylko sprawdza i niczego nie zmienia: nie uruchamia sesji, ale pokazuje stan instalacji, błędy w pliku ustawień oraz ostrzeżenia z gotowymi sugestiami poprawek. Wyświetla też wynik ostatniej próby automatycznej aktualizacji — przydatny, gdy podejrzewasz, że aktualizacja w tle niepostrzeżenie nie zdołała się zainstalować.

Czy Claude Code aktualizuje się automatycznie?#

Wszystko zależy od tego, jak zainstalowano Claude Code. Instalacja natywna — zalecana przez Anthropic i wykonywana przez skrypt ze strony internetowej — może aktualizować się automatycznie, co dokumentacja wyraźnie potwierdza.

Działa to tak: Claude Code sprawdza aktualizacje podczas uruchamiania i okresowo w trakcie działania. Jeśli znajdzie nową wersję, pobiera ją i instaluje w tle, a następnie stosuje przy kolejnym uruchomieniu. Wystarczy co kilka dni zamknąć i ponownie otworzyć sesję, by znów mieć aktualną wersję.

Wynik ostatniej próby aktualizacji w tle możesz sprawdzić tym samym poleceniem claude doctor. Pokaże, czy aktualizacja z jakiegoś powodu nie zdołała się zainstalować.

Jeśli jednak Claude Code został zainstalowany przez menedżer pakietów — Homebrew na MacBooku, WinGet w Windows albo apt lub dnf w Linuksie — aktualizacje w tle nie są dostępne. Takie instalacje aktualizuje się zwykłym poleceniem aktualizacji; osobna sekcja poniżej opisuje tę procedurę.

Niedawna wersja Claude Code to podstawa, ale sama nie wystarczy. Spójne wyniki zależą nie od wersji narzędzia, lecz od sposobu, w jaki z nim pracujesz.

Jak ręcznie zaktualizować Claude Code jednym poleceniem?#

Nie musisz czekać, aż sprawdzenie w tle wykryje nową wersję. Możesz zaktualizować ją od razu tym poleceniem:

claude update

Możliwe są dwa wyniki. Jeśli aktualizacja zostanie znaleziona i zainstalowana, Claude Code wyświetli wiersz podobny do Successfully updated from <old version> to version <new version>. Jeśli masz już najnowszą kompilację, zobaczysz Claude Code is up to date (<version>) — czyli nie ma nic do aktualizacji.

W przypadku menedżerów pakietów to polecenie ma pewien haczyk. Jeśli Claude Code został zainstalowany przez Homebrew, WinGet lub apk, claude update zwraca krótszą odpowiedź — Claude is up to date! — i nie zawsze sam pobiera nową kompilację. W takich instalacjach pewniej jest użyć własnego polecenia aktualizacji menedżera pakietów, opisanego poniżej.

Jak zaktualizować Claude Code zainstalowany przez Homebrew lub WinGet?#

Jeśli Claude Code został zainstalowany przez menedżer pakietów, a nie skrypt ze strony internetowej, odpowiadasz za jego aktualizację. Oto polecenia dla poszczególnych systemów.

macOS z Homebrew:

brew upgrade claude-code

Homebrew oferuje dwie opcje. Claude Code jest dostępny w dwóch wariantach. Wariant claude-code korzysta z kanału stable — wersji starszej mniej więcej o tydzień, pomijającej wydania z poważnymi problemami. Wariant claude-code@latest pobiera najnowszą wersję zaraz po jej wydaniu. Zaktualizuj wariant, który został zainstalowany: jeśli masz claude-code@latest, polecenie będzie brzmiało brew upgrade claude-code@latest.

Windows z WinGet:

winget upgrade Anthropic.ClaudeCode

Podczas działania Claude Code aktualizacja przez WinGet czasami kończy się niepowodzeniem, ponieważ Windows używa pliku wykonywalnego. Claude Code wyświetli wtedy polecenie do ręcznego użycia; zamknij program i ponownie uruchom aktualizację.

W Linuksie z apt, dnf lub apk nie musisz znać osobnego polecenia — najnowsza wersja pojawia się przy zwykłej aktualizacji systemu, ponieważ Claude Code udostępnia podpisane repozytoria.

Jeśli nie chcesz o tym pamiętać, możesz użyć zmiennej środowiskowej CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Ustaw ją na 1, a Claude Code będzie uruchamiać aktualizację w tle przez Homebrew i WinGet, a po pomyślnej aktualizacji zasugeruje ponowne uruchomienie. Dokumentacja zawiera zastrzeżenie: Claude Code czasami informuje o nowej wersji, zanim faktycznie pojawi się ona w menedżerze pakietów. Jeśli aktualizacja nie znajdzie nowej wersji, poczekaj chwilę i spróbuj ponownie.

Przy okazji, jeśli dopiero wybierasz sposób instalacji Claude Code, osobny artykuł o instalowaniu Claude Code zawiera szczegółowy poradnik, w tym wyjaśnienie, dlaczego instalator natywny jest wygodniejszy niż menedżery pakietów.

Dlaczego Claude Code nie chce się zaktualizować i co zrobić?#

Czasami aktualizujesz program raz za razem, ale claude --version uparcie pokazuje stary numer. Omówię główne przyczyny, zaczynając od najczęstszej.

Najpierw sprawdź, czy masz jednocześnie kilka instalacji Claude Code. Może się tak zdarzyć, jeśli najpierw zainstalowano program przez npm, a później ponownie w wersji natywnej. Polecenie aktualizuje jedną kopię, ale terminal uruchamia drugą, więc wersja pozornie się nie zmienia. Sprawdź, ile masz kopii:

which -a claude

Claude Code może znajdować się w trzech miejscach: ~/.local/bin/claude to instalator natywny, ~/.claude/local/ to stara lokalna instalacja npm z wczesnych wersji, a globalny pakiet npm pokazuje polecenie npm -g ls @anthropic-ai/claude-code. Jeśli znajdziesz więcej niż jedną instalację, pozostaw tylko jedną — najlepiej natywną. Usuń pozostałe w ten sposób:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

Drugą częstą przyczyną jest brak prawa zapisu do globalnego folderu npm. Jeśli Claude Code został zainstalowany globalnie przez npm i nie ma uprawnień do zapisu w swoim folderze, aktualizacja w tle nie zostanie zainstalowana. Claude Code wyświetli jednorazowe powiadomienie podczas uruchamiania, a claude doctor wskaże dokładnie, co należy naprawić. To kolejny powód, by wybrać instalację natywną: zapisuje ona pliki w folderze domowym i nie wymaga tych uprawnień.

Trzecia sytuacja występuje, gdy zastąpisz program uruchamiający ~/.local/bin/claude własnym skryptem lub dowiązaniem symbolicznym. Od wersji 2.1.207 automatyczne aktualizacje pozostawiają taki program uruchamiający bez zmian: nowe wersje nadal są instalowane w folderze ~/.local/share/claude/versions/, ale to twój skrypt decyduje, którą z nich uruchomić. Nie usuwaj jedynego programu uruchamiającego, by potem wywołać claude update po nazwie. Najpierw zachowaj własny launcher i, dla dowiązania, jego cel w osobnej nieużywanej lokalizacji kopii. Przenieś launcher z oryginalnej ścieżki dopiero po sprawdzeniu kopii. Odtwórz natywny launcher przez oficjalny instalator, który nie wymaga istniejącego polecenia claude:

# macOS, Linux lub WSL: oficjalny instalator natywny
curl -fsSL https://claude.ai/install.sh | bash

Po zakończeniu otwórz nowy terminal i sprawdź wynik:

claude --version
claude doctor

Pierwsze polecenie musi wypisać numer wersji. Przed dalszą pracą przejrzyj ostrzeżenia doctor o launcherze lub PATH; zachowanej kopii nie usuwaj przed potwierdzeniem działania zamiennika.

Innym objawem jest zawieszenie się claude update lub claude doctor zaraz po wierszu Checking for updates. W starszych wersjach (sprzed 2.1.214) czasami zdarzało się to, gdy jeden z plików konfiguracji powłoki, na przykład ~/.zshrc, był katalogiem zamiast plikiem. Nowsze kompilacje pomijają ten przypadek, więc aktualizacja do najnowszej wersji również naprawia ten błąd.

Jak wybrać kanał aktualizacji: latest czy stable?#

Aktualizacja do najnowszej wersji nie zawsze oznacza pobranie najnowszej kompilacji w dniu jej wydania. Claude Code pozwala wybrać jeden z dwóch kanałów, co wpływa na to, co otrzymasz podczas aktualizacji.

Kanał latest jest domyślny. Nowe funkcje pojawiają się zaraz po wydaniu, co jest przydatne, jeśli chcesz wypróbować je jako pierwszy. Kanał stable udostępnia wersję starszą mniej więcej o tydzień: miała czas się ustabilizować i pomija wydania z poważnymi problemami. To wybór dla osób, które bardziej cenią spokój niż szybkość.

Najłatwiej przełączyć kanał poleceniem /config w Claude Code, w sekcji Auto-update channel. Możesz też wpisać ustawienie ręcznie w pliku settings.json:

{
  "autoUpdatesChannel": "stable"
}

Jeśli chcesz dostosować Claude Code do swoich nawyków, zajrzyj do osobnego poradnika o dostosowywaniu Claude Code — omawia cały plik ustawień, nie tylko kanał aktualizacji.

Jak zainstalować określoną wersję lub ustawić wersję minimalną?#

Czasami potrzebujesz konkretnej wersji zamiast najnowszej — na przykład, by wrócić do kompilacji, na której twój przepływ pracy na pewno działał. Instalator natywny to umożliwia: przyjmuje nazwę kanału i dokładny numer wersji. Określoną kompilację zainstalujesz tak:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

W systemie Windows odpowiednik w PowerShell wygląda nieco inaczej:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

W ten sam sposób możesz zainstalować kanał stable — zamiast numeru wpisz stable. Kanał wybrany podczas instalacji stanie się domyślnym kanałem przyszłych aktualizacji automatycznych.

Jeśli chcesz zabezpieczyć się przed powrotem do starszej wersji, ustaw wersję minimalną w pliku settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

To dolna granica. Ani aktualizacja w tle, ani claude update nie zainstalują wersji niższej od wskazanej. Przydaje się to podczas przechodzenia na stable, jeśli nie chcesz cofnąć się z nowszej kompilacji, której już używasz.

Jak wyłączyć automatyczne aktualizacje, jeśli przeszkadzają?#

Czasami aktualizacje w tle przeszkadzają, na przykład gdy chcesz utrzymać w zespole dokładnie jedną wersję. Możesz wyłączyć je w pliku ustawień:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Ważny szczegół: DISABLE_AUTOUPDATER wycisza wyłącznie sprawdzanie w tle. Polecenie claude update nadal będzie działać, więc aktualizację wciąż możesz przeprowadzić ręcznie. Jeśli chcesz zablokować wszystkie ścieżki aktualizacji naraz, w tym ręczne, użyj bardziej restrykcyjnej zmiennej DISABLE_UPDATES. Stosuje się ją, gdy Claude Code jest rozpowszechniany własnym kanałem i użytkownicy mają pozostać dokładnie przy dostarczonej kompilacji.

Do zwykłego, samodzielnego użytku lepiej nie zmieniać tych zmiennych: nowsza wersja Claude Code jest niemal zawsze lepsza od starej, a aktualizacja może zawierać poprawkę bezpieczeństwa. Utrzymywanie narzędzia w aktualnej wersji pomaga zachować dostęp i unikać dziwnych błędów; osobny artykuł wyjaśnia, jak nie stracić dostępu do konta Claude.

Od czego zacząć?#

Oto krótki plan.

1. Sprawdź obecną wersję: claude --version. Porównaj ją z najnowszym numerem w dzienniku zmian.
2. Zaktualizuj program. Instalacja natywna — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. Uruchom ponownie sesję Claude Code, aby zastosować nową wersję.
4. Jeśli wersja się nie zmieniła, uruchom claude doctor i which -a claude. Prawdopodobnie masz kilka instalacji lub folder npm bez prawa zapisu.
5. Wybierz odpowiedni kanał: latest, jeśli chcesz otrzymywać nowe funkcje zaraz po ich wydaniu, albo stable, jeśli ważniejsza jest przewidywalność. Zmień go za pomocą /config.

Nowsza wersja naprawia błędy i dodaje nowe polecenia, ale samo zaktualizowanie narzędzia nie zbuduje za ciebie projektu. Poradnik o alternatywach dla Claude Code wyjaśnia, czym Claude Code różni się od innych agentów terminalowych i kiedy warto rozważyć alternatywy.

Poznaj Ailoot.