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
  1. Wymagania przed instalacją Claude Code na Linux
  2. Instalacja skryptem albo z repozytorium
  3. Alpine i inne dystrybucje z musl
  4. Logowanie na serwerze bez przeglądarki
  5. Typowe błędy instalacji na Linux
  6. Piaskownica, aktualizacje i odinstalowanie

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.

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

Program 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.

bash
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-code

Polecenie 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.

bash
apk add bash curl libgcc libstdc++ ripgrep

Pakiet 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.

  • Killed albo 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śniej WORKDIR /tmp.
  • Error loading shared library libstdc++.so.6 oznacza, że pobrała się wersja dla musl na systemie z glibc albo odwrotnie. Sprawdzicie to poleceniem ldd --version.
  • Illegal instruction to 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 found oznacza brak ~/.local/bin na PATH. Dopiszcie export PATH="$HOME/.local/bin:$PATH" do ~/.bashrc i 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.

bash
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Instalację 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.

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.