Instalacja Claude Code na Linux. Na małym serwerze instalator potrafi zabraknąć pamięci
Jak zainstalować Claude Code na Ubuntu, Debianie, Fedorze i Alpine. Instalator, repozytoria apt, dnf i apk, logowanie przez SSH, typowe błędy i odinstalowanie.
Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy
W tym tekście
W skrócie
Na Linuksie Claude Code instaluje się skryptem albo z podpisanych repozytoriów apt, dnf i apk. Opisujemy wymagania dla dystrybucji, Alpine, logowanie na serwerze bez przeglądarki, błędy z pamięcią i bibliotekami oraz odinstalowanie.
Na najtańszym serwerze w chmurze instalacja Claude Code kończy się jednym słowem Killed. To nie błąd programu, tylko systemowy mechanizm, który zabija proces, gdy kończy się pamięć. Linux daje więcej dróg instalacji niż Mac czy Windows i więcej miejsc, w których coś może pójść inaczej. Wszystko poniżej sprawdziliśmy w dokumentacji Anthropic, stan na 10 listopada 2026.
Czym jest samo narzędzie, opisaliśmy w tekście Claude Code. Co robi poza czatem. Pozostałe części cyklu zbiera przewodnik po Claude Code.
Wymagania przed instalacją Claude Code na Linux
Dokumentacja wymienia Ubuntu 20.04 i nowsze, Debiana 10 i nowszego oraz Alpine Linux 3.19 i nowszy. Repozytoria pakietów są też dla Fedory i RHEL. Procesor musi być x64 albo ARM64, a pamięci RAM co najmniej 4 GB. Sama instalacja potrzebuje około 512 MB wolnej pamięci. Do logowania potrzebne jest konto Pro, Max, Ultra, Team, Enterprise, konto w Claude Console albo dostęp przez chmurę firmową.
Na Windows z WSL obowiązuje ta sama instrukcja, bo w WSL instaluje się wersję linuksową. Różnice opisaliśmy w tekście o instalacji na Windows.
Instalacja skryptem albo z repozytorium
Najprostsza droga to skrypt instalacyjny. Wersja z niego sama się aktualizuje.
curl -fsSL https://claude.ai/install.sh | bashProgram trafia do ~/.local/bin/claude, a kolejne wersje do ~/.local/share/claude/versions/. Gdy instalator skończy, otwórzcie nową sesję terminala i wpiszcie claude --version. Polecenie claude doctor sprawdzi instalację i pliki ustawień bez uruchamiania sesji.
Na serwerach często wygodniejsze są repozytoria, bo aktualizacje przychodzą razem z resztą systemu. Anthropic prowadzi podpisane repozytoria apt, dnf i apk, każde z kanałem stable i latest. Stable to wersja sprzed mniej więcej tygodnia bez wydań z poważnymi błędami. Tak wygląda instalacja kanału stable na Debianie i Ubuntu.
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-codePolecenie gpg --show-keys powinno wypisać jeden odcisk klucza, 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Jeśli na świeżym systemie brakuje curl albo gpg, doinstalujcie je przez sudo apt install curl gnupg. Na Fedorze i RHEL repozytorium dodaje się plikiem w /etc/yum.repos.d/ i instaluje przez sudo dnf install claude-code. Dokładną treść pliku podaje dokumentacja.
Instalacja z repozytorium nie aktualizuje się przez Claude Code. Robicie to zwykłą aktualizacją systemu, na przykład sudo apt update && sudo apt upgrade claude-code albo sudo dnf upgrade claude-code.
Alpine i inne dystrybucje z musl
Alpine domyślnie nie ma basha ani curla, więc skrypt instalacyjny kończy się błędem not found. Przed instalacją doinstalujcie potrzebne pakiety.
apk add bash curl libgcc libstdc++ ripgrepPakiet ripgrep jest w repozytorium community. Jeśli apk go nie znajduje, dopiszcie to repozytorium do /etc/apk/repositories i wykonajcie apk update. Potem w pliku ~/.claude/settings.json ustawcie zmienną USE_BUILTIN_RIPGREP na 0, żeby Claude Code używał systemowego ripgrepa. Anthropic prowadzi też repozytorium apk, wtedy instalacja to apk add claude-code po dodaniu klucza i adresu repozytorium.
Logowanie na serwerze bez przeglądarki
Przy pierwszym uruchomieniu claude chce otworzyć przeglądarkę. Przez SSH albo w kontenerze jej nie ma, więc naciśnijcie c, żeby skopiować adres logowania. Otwórzcie go w przeglądarce na swoim komputerze i zalogujcie się. Strona pokaże kod, który wklejacie do terminala w miejscu Paste code here. Jeśli wklejanie nie działa, użyjcie claude auth login, które czyta kod ze standardowego wejścia.
Na Linuksie login trafia do pliku ~/.claude/.credentials.json z uprawnieniami 0600, czyli dostępnego tylko dla Waszego użytkownika. Na Macu jest Pęk kluczy, tu jest zwykły plik, więc nie kopiujcie folderu ~/.claude na cudze maszyny.
Typowe błędy instalacji na Linux
Dokumentacja opisuje kilka objawów, które zdarzają się głównie na Linuksie.
Killedalbo komunikat o przerwanej instalacji z kodem 137 oznacza brak pamięci. Pomaga zamknięcie innych procesów albo dodanie pliku wymiany, na przykład 2 GB, i ponowne uruchomienie skryptu.- Instalacja zawiesza się w kontenerze Docker, gdy skrypt startuje z katalogu
/. Ustawcie wcześniejWORKDIR /tmp. Error loading shared library libstdc++.so.6oznacza, że pobrała się wersja dla musl na systemie z glibc albo odwrotnie. Sprawdzicie to poleceniemldd --version.Illegal instructionto zła architektura albo procesor bez instrukcji AVX, częsty w starszych maszynach wirtualnych. Inna metoda instalacji nie pomoże, bo pobiera ten sam program.bash: claude: command not foundoznacza brak~/.local/binna PATH. Dopiszcieexport PATH="$HOME/.local/bin:$PATH"do~/.bashrci otwórzcie nową sesję.
Jeśli katalogi domowe leżą na dysku sieciowym, sesja może paść z komunikatem Bus error, gdy aktualizacja na innej maszynie usunie używany plik. Dokumentacja radzi wtedy instalować program na dysku lokalnym, na przykład z repozytorium.
Piaskownica, aktualizacje i odinstalowanie
Na Linuksie i w WSL 2 Claude Code może uruchamiać polecenia w piaskownicy, która ogranicza dostęp do plików i sieci. Potrzebuje do tego pakietów bubblewrap i socat, na Debianie i Ubuntu instalowanych przez sudo apt-get install bubblewrap socat. Polecenie /sandbox w sesji pokaże, czego brakuje.
Wersja ze skryptu aktualizuje się sama, a claude update robi to od razu. Odinstalowanie wygląda tak.
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeInstalację z apt usuwa sudo apt remove claude-code, z dnf sudo dnf remove claude-code, a z apk apk del claude-code. Warto przy tym usunąć też plik repozytorium i klucz. Ustawienia, zgody i historia zostają w ~/.claude i w pliku ~/.claude.json.
Po instalacji przejdźcie do pierwszego uruchomienia i logowania, a przed pracą na serwerze przeczytajcie o uprawnieniach Claude Code.
Na serwerze z małą ilością pamięci najpierw dodajcie plik wymiany, a dopiero potem uruchamiajcie instalator. Jeśli chcecie sprawdzić, gdzie AI odciąży Waszą firmę poza kodem, zapraszamy na darmowy audyt AI.
Co chcecie zmienić w swojej firmie?
Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.
Usługa, o której jest ten tekst
Automatyzacja i AI / OCRAutomatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.