)` — 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?
Najważniejsze w tej sekcji
Menedżery pakietów nie aktualizują Claude Code automatycznie, więc musisz samodzielnie uruchomić polecenie aktualizacji. Na MacBooku z Homebrew jest to brew upgrade claude-code. W systemie Windows z WinGet — winget upgrade Anthropic.ClaudeCode. W Linuksie aktualizacja przez apt, dnf lub apk jest częścią zwykłej aktualizacji systemu. Jeśli chcesz, aby Claude Code sam wykonywał aktualizację przez Homebrew i WinGet, ustaw zmienną środowiskową CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE na one.
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:
```bash
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:
```powershell
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.
| Sposób instalacji | Polecenie aktualizacji |
|----------------------|----------------|
| Instalator natywny | aktualizuje się automatycznie albo użyj `claude update` |
| Homebrew (macOS) | `brew upgrade claude-code` |
| WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` |
| apt / dnf / apk (Linux) | zwykła aktualizacja systemu |
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](https://ailoot.ai/blog/pl/install-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ć?
Najważniejsze w tej sekcji
Zwykle możliwe są trzy przyczyny. Po pierwsze, masz kilka instalacji Claude Code, które ze sobą kolidują: polecenie aktualizuje jedną, ale uruchamia się inna. Po drugie, globalny folder npm nie jest zapisywalny, więc aktualizacja w tle po cichu nie może się zainstalować. Po trzecie, mogłeś zastąpić program uruchamiający własnym skryptem. Zacznij rozwiązywanie problemu od poleceń claude doctor i which -a claude; pokażą dokładnie, gdzie leży problem.
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:
```bash
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:
```bash
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](https://code.claude.com/docs/en/setup#install-claude-code), który nie wymaga istniejącego polecenia `claude`:
```bash
# 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:
```bash
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?
Najważniejsze w tej sekcji
Claude Code ma dwa kanały aktualizacji. Latest to kanał domyślny; nowe funkcje pojawiają się zaraz po wydaniu. Stable to wersja starsza mniej więcej o tydzień, pomijająca wydania z poważnymi problemami. Jeśli ważniejsze są dla ciebie świeże funkcje, pozostań przy latest. Jeśli bardziej cenisz przewidywalność i nie chcesz trafiać na niedopracowane kompilacje, przełącz się na stable. Możesz zmienić kanał za pomocą ustawienia autoUpdatesChannel w pliku settings.json lub polecenia /config.
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`:
```json
{
"autoUpdatesChannel": "stable"
}
```
Jeśli chcesz dostosować Claude Code do swoich nawyków, zajrzyj do osobnego poradnika o [dostosowywaniu Claude Code](https://ailoot.ai/blog/pl/claude-personalization-profile-memory/) — omawia cały plik ustawień, nie tylko kanał aktualizacji.
## Jak zainstalować określoną wersję lub ustawić wersję minimalną?
Najważniejsze w tej sekcji
Instalator natywny przyjmuje zarówno nazwę kanału, jak i dokładny numer wersji. Aby zainstalować określoną kompilację, dodaj jej numer na końcu polecenia instalacyjnego, na przykład bash -s 2.1.89. W ten sam sposób możesz zainstalować kanał stable zamiast latest. Aby aktualizacje nigdy nie cofnęły cię poniżej określonej wersji, ustaw w settings.json opcję minimumVersion. To dolna granica, poniżej której nie zejdzie ani aktualizacja w tle, ani claude update.
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:
```bash
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
W systemie Windows odpowiednik w PowerShell wygląda nieco inaczej:
```powershell
& ([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`:
```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ą?
Najważniejsze w tej sekcji
Jeśli nie potrzebujesz aktualizacji Claude Code w tle, wyłącz je za pomocą zmiennej DISABLE_AUTOUPDATER w bloku env pliku settings.json. Zatrzymuje ona tylko sprawdzanie w tle — polecenie claude update nadal będzie działać, jeśli zechcesz zaktualizować program ręcznie. Jeśli potrzebujesz zablokować każdą ścieżkę aktualizacji, także ręczne aktualizacje, użyj drugiej zmiennej, DISABLE_UPDATES. Przydaje się to, gdy udostępniasz Claude Code zespołowi i chcesz, by wszyscy korzystali z tej samej wersji.
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ń:
```json
{
"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](https://ailoot.ai/blog/pl/claude-account-suspension-appeal/).
## Od czego zacząć?
Najważniejsze w tej sekcji
Zacznij od sprawdzenia wersji poleceniem claude --version i porównania jej z najnowszym numerem w dzienniku zmian. Jeśli instalacja jest natywna, zaktualizuj ją poleceniem claude update i uruchom ponownie sesję. Jeśli Claude Code został zainstalowany przez Homebrew lub WinGet, użyj polecenia aktualizacji menedżera pakietów. Jeśli wersja się nie zmieni, uruchom claude doctor i which -a claude, aby sprawdzić, czy wiele instalacji nie powoduje konfliktu. Wybierz też kanał: latest zapewnia świeże funkcje, a stable — większy spokój.
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](https://ailoot.ai/blog/pl/claude-code-alternatives/) wyjaśnia, czym Claude Code różni się od innych agentów terminalowych i kiedy warto rozważyć alternatywy.
### Źródła
- [Claude Code - konfiguracja zaawansowana, oficjalna dokumentacja](https://docs.claude.com/en/docs/claude-code/setup) - automatyczne aktualizacje instalacji natywnych, polecenie claude update, kanały latest i stable, ustawienia autoUpdatesChannel i minimumVersion, DISABLE_AUTOUPDATER, instalowanie określonej wersji
- [Claude Code - rozwiązywanie problemów z instalacją, oficjalna dokumentacja](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - konflikty wielu instalacji, which -a claude, uprawnienia folderu npm, własne programy uruchamiające, zawieszanie się claude update
- [Claude Code - CHANGELOG w serwisie GitHub](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - lista wersji i zmian w każdej kompilacji; miejsce, w którym można sprawdzić najnowszy numer
Poznaj [Ailoot](https://ailoot.ai/).
## Pytania i odpowiedzi
### Dlaczego claude update nadal uruchamia stary własny skrypt?
Natywny aktualizator pozostawia własny launcher, więc nadal wybiera on program. Przed naprawą zachowaj skrypt i jego cel; użyj udokumentowanego instalatora zamiast usuwać jedyne polecenie i natychmiast je wywoływać.
### Jak sprawdzić naprawę launchera?
Otwórz nowy terminal i uruchom claude --version; powinien wypisać numer wersji. Potem sprawdź instalację i ostrzeżenia launchera przez claude doctor. Jeśli brak polecenia, najpierw napraw PATH.
## Ailoot · Firma i jej portfel projektów
Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.
Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.
Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.