SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Claude na Linux: aplikacja desktopowa i CLI

Sprawdź, jak uruchomić Claude na systemach Linux. Opisujemy instalację wersji beta przez apt, konfigurację Claude Code CLI oraz ograniczenia w dostępie do funkcji Computer Use.

Które elementy Claude działają obecnie natywnie w systemie Linux

Claude w systemie Linux działa w czterech odrębnych obszarach i według stanu na październik 2026 r. wszystkie cztery działają na standardowej maszynie z systemem Ubuntu lub Debian. Aplikacja desktopowa instalowana jest z repozytorium apt firmy Anthropic i znajduje się w fazie beta. Claude Code CLI (interfejs wiersza poleceń) to skompilowany plik binarny, który działa na większej liczbie dystrybucji niż aplikacja desktopowa. Aplikacja internetowa pod adresem claude.ai wymaga jedynie przeglądarki, a API to punkt końcowy HTTPS, z którego korzysta się z poziomu własnego kodu.

Trzy funkcje dostępne w systemach macOS i Windows są nieobecne lub ograniczone w wersji beta na system Linux: Computer Use, gdzie Claude steruje aplikacjami na ekranie, dyktowanie głosowe oraz globalny skrót klawiszowy Quick Entry. Firma Anthropic dokumentuje, że funkcje Computer Use oraz dyktowanie nie są dostępne w systemie Linux. Skrót klawiszowy Quick Entry działa w sesji X11, natomiast w natywnej sesji Wayland wymaga portalu GlobalShortcuts środowiska graficznego, więc bez tego portalu skrót nie jest dostępny. echo $XDG_SESSION_TYPE wypisuje x11 lub wayland i informuje, w którym przypadku się znajdujesz. Interfejs CLI posiada własną funkcję dyktowania głosowego, więc brak dyktowania dotyczy aplikacji desktopowej, a nie samego Claude.

Dostępność funkcji ulega zmianom, dlatego należy traktować tę stronę jako opis obszarów działania i sprawdzić aktualny stan przed planowaniem wdrożenia. Ostatnia sekcja zawiera listę stron do weryfikacji.

Instalacja aplikacji Claude Desktop w Ubuntu lub Debianie

Zgodnie z dokumentacją wymagany jest Ubuntu 22.04 lub nowszy albo Debian 12 lub nowszy, na architekturze x86_64 (którą dpkg nazywa amd64) lub arm64. Inne dystrybucje oparte na Debianie mogą działać, ale nie są testowane. Dla Fedory i RHEL nie ma jeszcze pakietu, dlatego w tych systemach należy użyć CLI albo przeglądarki.

Należy instalować z repozytorium apt, a nie z pobranego pliku .deb. Aplikacja Linux nie ma własnego mechanizmu aktualizacji, dlatego nowe wersje są dostarczane wyłącznie przez menedżer pakietów. Zarejestrowanie repozytorium pozwala programowi apt upgrade je wykrywać.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

Polecenie gpg --show-keys powinno wyświetlić odcisk klucza 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Należy go porównać przed zarejestrowaniem repozytorium, ponieważ niezidentyfikowany klucz podpisujący jest kluczem zaufanym bez weryfikacji. Jeśli gpg zgłosi, że plik nie zawiera prawidłowych danych OpenPGP, pobieranie się nie powiodło, a apt update zakończy się później błędem NO_PUBKEY BAA929FF1A7ECACE.

Rejestracja repozytorium polega na zapisaniu jednego wiersza deb w pliku /etc/apt/sources.list.d/claude-desktop.list. Ten wiersz należy skopiować ze strony instalacji Anthropic dla systemu Linux: code.claude.com/docs/en/desktop-linux, dokładnie w podanej postaci. Adres repozytorium jest elementem tej procedury najbardziej podatnym na zmianę. Wiersz przepisany z pamięci może później spowodować wyświetlenie E: Unable to locate package claude-desktop. Przed wklejeniem należy go przeczytać: arch=amd64,arm64 określa, dlaczego apt na innej architekturze niczego nie znajdzie, a signed-by= wskazuje sprawdzony plik keyring. Ogranicza to użycie tego klucza do jednego repozytorium, zamiast ufać mu dla wszystkich danych odczytywanych przez apt.

sudo apt update && sudo apt install claude-desktop

Aplikację należy uruchomić z launchera aplikacji albo wykonać w terminalu polecenie claude-desktop. Można zalogować się za pomocą konta claude.ai albo przez SSO (single sign-on) organizacji, jeśli firma je skonfigurowała. Są to dwie metody logowania wymienione na stronie instalacji Anthropic dla systemu Linux. Użytkownicy kluczy API są kierowani do CLI. Anthropic osobno opisuje drugi tryb wdrażania tej samej aplikacji. Po skonfigurowaniu dostawcy inferencji (Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, brama LLM albo bezpośrednio Anthropic API) ekran logowania umożliwia pominięcie uwierzytelniania Anthropic. Dostawca obsługuje wtedy inferencję i rozliczenia dla Chat, Cowork i Code. Dokumentacja wskazuje lokalizację zarządzanej konfiguracji w systemie Linux: /etc/claude-desktop/managed-settings.json. Strona instalacji systemu Linux prowadzi obecnie także do dokumentacji wdrażania dostarczanej przez podmiot zewnętrzny. Na urządzeniach bez konfiguracji Claude Desktop wersja Claude Desktop 3.1623.1 lub nowsza oferuje również opcję Use your Claude API account na standardowym ekranie logowania. Można wtedy zalogować się za pomocą Claude Console albo wprowadzić klucz API bez wcześniejszej konfiguracji. W Claude Desktop 4.23118.0 lub nowszym odnośnik ten jest ukryty podczas logowania do komputera, jeśli organizacja blokuje inne konta, nawet bez zarządzania urządzeniem.

Zadania Cowork wykonywane na własnym komputerze używają maszyny wirtualnej. Wymaga to włączenia wirtualizacji sprzętowej oraz dodania użytkownika do grupy kvm (sudo usermod -aG kvm $USER, a następnie wylogowania się i ponownego zalogowania). Nie każde zadanie Cowork jest wykonywane lokalnie. Od 6 października 2026 nowe zadania Cowork w planach Pro, Max i Ultra są wykonywane w chmurze Anthropic. Nie ma ustawienia pozwalającego pozostawić je na komputerze. Organizacje Team i Enterprise, które włączyły ujednolicone środowisko Chat i Cowork, również wykonują zadania w chmurze. W tych planach maszyna wirtualna ma znaczenie tylko dla zadań już uruchomionych na komputerze. Anthropic wskazuje Claude Code w aplikacji desktopowej jako rozwiązanie dla nowych zadań, które muszą pozostać lokalne.

E: Unable to locate package claude-desktop oznacza, że apt nigdy nie odczytał repozytorium. Polecenie cat /etc/apt/sources.list.d/claude-desktop.list powinno wyświetlić wpis deb, a dpkg --print-architecture powinno wypisać amd64 lub arm64, ponieważ dla innych architektur nie są publikowane żadne pakiety. Aktualizacje będą następnie dostarczane razem z resztą systemu przez sudo apt update && sudo apt upgrade.

Co istnieje wyłącznie w przeglądarce

Serwis claude.ai działa w każdej współczesnej przeglądarce na dowolnej dystrybucji, co czyni go rozwiązaniem dla Fedora, RHEL, Arch, openSUSE oraz każdego innego systemu, dla którego nie ma dostępnego pakietu. Przeglądarka zapewnia również dostęp do Claude Code w wersji webowej, gdzie sesja uruchamiana jest w infrastrukturze chmurowej, a nie na lokalnej maszynie: domyślnie w infrastrukturze Anthropic lub we własnym, samodzielnie hostowanym środowisku organizacji, jeśli sesje są do niego kierowane. Zawsze wykorzystywane są przy tym dane uwierzytelniające subskrypcji użytkownika.

Warto zrozumieć ograniczenia przeglądarki. Sama przeglądarka nie może odczytywać plików na własnym serwerze ani wykonywać na nim poleceń. Wszystko, co wymaga interakcji z maszyną, wymaga zainstalowanego na niej oprogramowania, czyli CLI, aplikacji desktopowej lub skonfigurowanego, samodzielnie hostowanego środowiska uruchomieniowego (runner). Sesje w chmurze mogą uzyskiwać dostęp do podłączonych folderów lokalnych za pośrednictwem otwartej aplikacji desktopowej.

Co oferuje CLI, czego nie zapewnia aplikacja webowa

Uruchomienie claude w danym katalogu powoduje, że narzędzie pracuje w jego obrębie. Na tym polega różnica, a cała reszta jest jej konsekwencją.

  • Narzędzie odczytuje i edytuje pliki w bieżącym katalogu roboczym, a w trybie Manual prosi o potwierdzenie przed wprowadzeniem zmian. Tryb Auto stosuje edycje z automatycznymi kontrolami bezpieczeństwa w tle i jest domyślnym ustawieniem dla bieżących sesji interaktywnych, o ile ustawienia lub polityka nie stanowią inaczej. Uruchom z claude --permission-mode default, aby samodzielnie weryfikować działania.
  • Narzędzie wykonuje polecenia powłoki z uprawnieniami sesji, dzięki czemu może budować projekt, uruchamiać testy, czytać logi lub sprawdzać stan usługi bezpośrednio na serwerze.
  • Narzędzie działa bez sesji interaktywnej: claude -p "read the nginx error log and summarise it" generuje jedną odpowiedź i kończy pracę, co jest przydatne w zadaniach cron lub potokach CI/CD. W wersji Claude Code 2.1.302 lub nowszej, takie uruchomienia startują w trybie Manual, jeśli nie ustawiono trybu uprawnień, a akcje wymagające zatwierdzenia są odrzucane, chyba że dostarczysz mechanizm autoryzacji; użyj --permission-mode auto, aby klasyfikator je zweryfikował. Sposób sformułowania odpowiedzi zależy od użytkownika, ponieważ styl wyjściowy edytuje prompt systemowy dla każdej odpowiedzi i pozwala zachować zwięzłość w skryptach, podczas gdy sesja interaktywna dostarcza szczegółowych wyjaśnień.
  • Narzędzie łączy serwery MCP (model context protocol) za pomocą claude mcp add, co daje modelowi dostęp do narzędzi wykraczających poza system plików.
  • Narzędzie działa w środowiskach bez interfejsu graficznego, co dotyczy każdego serwera VPS (virtual private server), który wynajmiesz.

Ostatni punkt wyjaśnia, dlaczego przewodnik po serwerach skupia się na CLI. Wynajęty serwer posiada jedynie SSH (secure shell), więc terminal jest jedynym dostępnym interfejsem. Praca w ten sposób podlega własnym zasadom, które szczegółowo opisuje uruchamianie Claude Code na VPS wewnątrz tmux, a wykorzystanie Claude w codziennej pracy administratora przedstawia zadania, które warto mu powierzyć.

Integracje z edytorami stanowią rozwiązanie pośrednie. Rozszerzenie dla VS Code wymaga wersji VS Code 1.94.0 lub nowszej i udostępnia panel graficzny wewnątrz edytora, umożliwiający podgląd różnic i planów. Rozszerzenie zawiera prywatną kopię CLI dla tego panelu i nie dodaje claude do zmiennej PATH, więc wpisanie claude w zintegrowanym terminalu nadal wymaga samodzielnej instalacji. Edytory oparte na VS Code instalują to samo rozszerzenie z rejestru Open VSX; dostępna jest również wtyczka dla JetBrains.

Czy do uruchomienia Claude Code na Linux potrzebny jest Node.js?

Nie w przypadku zalecanej metody instalacji. Instalator natywny pobiera skompilowany plik binarny, który nie wymaga środowiska Node.js.

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

claude --version powinno wyświetlić numer wersji, na przykład 2.1.211 (Claude Code). Jeśli coś wydaje się nie w porządku, uruchom claude doctor, co wyświetli diagnostykę instalacji oraz plików ustawień w trybie tylko do odczytu, bez rozpoczynania sesji.

Node.js ma znaczenie tylko w przypadku instalacji przez npm. Od października 2026 pakiet npm wymaga Node.js 22 lub nowszego. W przypadku starszych wersji Node.js, npm wyświetla ostrzeżenie EBADENGINE zamiast przerywać działanie, ponieważ pakiet pobiera ten sam natywny plik binarny jako zależność dla danej platformy i tworzy odpowiednie dowiązania.

npm install -g @anthropic-ai/claude-code

W npm 12 krok postinstall jest domyślnie pomijany, co uniemożliwia uruchomienie claude. Jeśli npm --version zaczyna się od 12, należy użyć powyższego instalatora natywnego lub dodać Claude Code do allow-scripts w konfiguracji użytkownika npm przed ponowną instalacją.

Nie należy uruchamiać tego z sudo. Dokumentacja odradza używanie sudo npm install -g, ponieważ pozostawia to pliki należące do root w globalnym prefiksie npm, co powoduje błędy uprawnień przy kolejnej instalacji lub aktualizacji przez użytkownika bez uprawnień. Gdy katalog globalny npm nie jest zapisywalny, automatyczna aktualizacja w tle przestaje działać, a claude doctor zawiera listę rozwiązań tego problemu.

Anthropic publikuje również podpisane repozytoria pakietów dla Debian, Fedora, RHEL i Alpine, dzięki czemu sudo apt install claude-code działa podobnie do pakietu desktopowego, korzystając z własnego klucza podpisywania pod adresem https://downloads.claude.ai/keys/claude-code.asc.

Instalacja dla użytkownika czy w całym systemie?

Natywny instalator przeprowadza instalację dla pojedynczego użytkownika. Umieszcza on program uruchamiający w ~/.local/bin/claude jako dowiązanie symboliczne w ~/.local/share/claude/versions/, nie wymaga uprawnień root i aktualizuje się automatycznie w tle. Każdy użytkownik na maszynie otrzymuje oddzielną kopię w osobnej wersji.

Instalacja za pomocą menedżera pakietów obejmuje cały system. Jeden plik binarny obsługuje wszystkich użytkowników, wymaga uprawnień root i nie aktualizuje się automatycznie przez Claude Code. Aktualizację przeprowadza się za pomocą sudo apt update && sudo apt upgrade claude-code, czyli tego samego polecenia, którego używa się do zarządzania pozostałym oprogramowaniem na serwerze.

Wybierz instalację dla użytkownika na maszynie, do której logujesz się jako Ty, co dotyczy większości prac na VPS. Wybierz instalację z pakietu na serwerze współdzielonym lub obrazie maszyny, gdzie wymagana jest jedna wersja dla wszystkich użytkowników, a aktualizacje mają odbywać się zgodnie z Twoim harmonogramem. W przypadku instalacji natywnej dwa ustawienia w ~/.claude/settings.json określają sposób działania aktualizacji:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Kanał stable śledzi wydania starsze o około tydzień i pomija wersje z poważnymi regresjami. DISABLE_AUTOUPDATER zatrzymuje jedynie sprawdzanie w tle, dzięki czemu claude update nadal działa, a Ty zachowujesz kontrolę nad momentem wdrożenia nowej wersji. Ma to znaczenie na serwerze, na którym długotrwałe zadanie działa bez nadzoru i gdzie zmiana pliku binarnego w trakcie jego pracy jest niepożądana.

Logowanie przez SSH i utrzymanie sesji

Przy pierwszym uruchomieniu CLI na wynajętym serwerze pojawiają się dwa problemy typowe dla systemu Linux. Proces logowania wymaga przeglądarki, a na serwerze jej nie ma. Zerwane połączenie SSH przerywa wykonywane zadania.

Drugi problem rozwiązuje tmux. Sesja tmux należy do serwera tmux działającego na zdalnej maszynie, a nie do połączenia, dlatego zerwanie połączenia nie zatrzymuje procesu.

tmux new -s claude
claude

Sesję można odłączyć za pomocą Ctrl-b, a następnie d. Później można do niej wrócić za pomocą tmux attach -t claude.

Logowanie jest pierwszym problemem. Uruchom claude i skopiuj oddzielny URL autoryzacji wyświetlony nad monitem terminala dotyczącym wklejenia. Otwórz ten URL w przeglądarce na własnym komputerze. Po zalogowaniu przez ten URL przeglądarka wyświetli kod logowania zamiast powrócić do localhost. Wklej ten kod do terminala przy monicie Paste code here if prompted. Terminal wyświetli wtedy Login successful.

Jeśli sesja ma rozpocząć działanie bez nadzoru, claude setup-token otwiera tę samą autoryzację w przeglądarce i wyświetla w terminalu token OAuth ważny przez jeden rok. Token nie jest nigdzie zapisywany, dlatego należy go skopiować i ustawić w wymaganym miejscu.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Ten token wymaga płatnego planu i może służyć wyłącznie do wykonywania żądań do modeli. Należy traktować go jak hasło ważne przez jeden rok. Miejsce przechowywania tokenu oraz sposób uniemożliwienia agentowi jego odczytania opisano w sekcji przechowywanie sekretów poza zasięgiem agentów AI.

Małe serwery napotykają jeszcze jedno ograniczenie. Instalacja wymaga około 512 MB wolnej pamięci, a udokumentowane wymaganie sprzętowe do uruchomienia programu wynosi co najmniej 4 GB RAM. Na instancji z 1 GB RAM i niewielką ilością wolnej pamięci kernel może zakończyć instalację za pomocą mechanizmu OOM killer. Instalator wyświetli wtedy:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Dodaj swap, a następnie ponownie uruchom instalator. Swap to miejsce na dysku używane przez kernel jako pamięć awaryjna. Jest znacznie wolniejszy niż RAM, ale wystarcza do zakończenia instalacji.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon włącza plik tylko na czas bieżącego uruchomienia systemu. Jeśli ma być ponownie dostępny po restarcie, dodaj wiersz dla /swapfile do /etc/fstab. Zagadnienie tego, co jeszcze należy zabezpieczyć przed zezwoleniem agentowi na wykonywanie poleceń na działającym serwerze, opisano w sekcji bezpieczne uruchamianie Claude Code na VPS.

Gdzie w systemie Linux znajdują się dane uwierzytelniające Claude

W systemie Linux /login zapisuje dane uwierzytelniające w pliku ~/.claude/.credentials.json z trybem pliku 0600. W systemie macOS te same dane są zwykle przechowywane w zaszyfrowanym Keychain, ale gdy Keychain odrzuci zapis, używany jest ten sam zwykły plik. W systemie Linux token znajduje się w zwykłym pliku w katalogu domowym, a każdy proces uruchomiony z uprawnieniami danego użytkownika może go odczytać. Ustawienie CLAUDE_CONFIG_DIR powoduje przeniesienie pliku do tego katalogu.

Ma to dwa skutki. Kopia zapasowa /home zawiera aktywne dane logowania, więc skopiowanie jej na współdzielony komputer przekazuje dostęp do konta każdej osobie, która może ją odczytać. Obraz maszyny utworzony z systemu, na którym wykonano logowanie, zawiera te dane logowania w każdej instancji sklonowanej z tego obrazu. Przed utworzeniem migawki uruchom /logout.

Priorytet danych uwierzytelniających może powodować problemy, gdy jednocześnie używana jest subskrypcja i klucz API. Gdy w powłoce ustawiono ANTHROPIC_API_KEY, Claude Code używa tego klucza po zaakceptowaniu go, więc subskrypcja pozostaje niewykorzystana, a opłaty są naliczane za każdy token. /status pokazuje, które dane uwierzytelniające są aktywne, a unset ANTHROPIC_API_KEY przywraca logowanie za pomocą subskrypcji.

Logowanie wygasa. W ciągu trzech dni przed wygaśnięciem komunikat uruchamiania ma treść Your login expires in 3 days. Ostrzeżenie to nigdy nie blokuje żądania. Po wygaśnięciu, jeśli nie można odświeżyć logowania, każde żądanie modelu kończy się błędem Login expired · Please run /login. Należy uwzględnić to przed pozostawieniem sesji bez nadzoru na cały weekend, ponieważ taka sesja przestaje wykonywać postęp i nie może samodzielnie wznowić pracy.

Czy jedna subskrypcja Claude obejmuje wszystkie sposoby korzystania?

Jeden płatny plan obejmuje wszystkie sposoby korzystania z tej samej usługi przy użyciu tego samego loginu, z wyjątkami dotyczącymi niektórych planów Enterprise. Konto Pro, Max, Ultra lub Team umożliwia logowanie do claude.ai w przeglądarce, aplikacji desktopowej, CLI oraz rozszerzenia VS Code. Za każdym razem jest to ta sama subskrypcja. Dotyczy to również konta Enterprise w nowym planie lub planie samoobsługowym, które nie jest używane przez organizację przygotowaną do wymagań HIPAA, ponieważ pojedyncze miejsce Enterprise obejmuje Claude Code. Starsze plany Enterprise nadal używają osobnych typów miejsc. W takim przypadku korzystanie z Claude Code wymaga miejsca Chat + Claude Code albo miejsca Premium w starszym planie opartym na miejscach. Miejsce Chat-only lub Standard nie obejmuje tych funkcji. Organizacje Enterprise przygotowane do wymagań HIPAA również używają osobnych typów miejsc Chat oraz Chat + Claude Code. W planie Enterprise przygotowanym do wymagań HIPAA Claude Code wymaga miejsca Chat + Claude Code, a objęcie terminala i karty Code w Claude Desktop umową BAA wymaga konfiguracji HIPAA albo odpowiedniego zakresu zero data retention. Konfiguracja HIPAA nie obejmuje rozszerzeń VS Code i JetBrains ani sesji w chmurze. W planach Pro, Max, Ultra, Team oraz Enterprise opartych na miejscach obowiązuje również jeden wspólny limit użycia. Długie uruchomienie CLI na serwerze zmniejsza więc limit dostępny w aplikacji desktopowej. Gdy dowolny interfejs odmawia wykonania pracy, należy ustalić które okno limitu zostało osiągnięte i co w tej sytuacji zrobić. Plan Enterprise oparty na użyciu nie ma wliczonego limitu, który można wyczerpać. Każdy interfejs jest rozliczany według stawek API od pierwszego tokena. Bezpłatny plan claude.ai nie obejmuje dostępu do Claude Code. Bez płatnego planu można zalogować CLI za pomocą konta Claude Console. Jeśli organizacja korzysta z Amazon Bedrock, Google Cloud's Agent Platform lub Microsoft Foundry, można również uwierzytelnić się za pośrednictwem tego dostawcy bez logowania w przeglądarce. Przy subskrypcji claude.ai lub logowaniu SSO funkcje Claude Code w aplikacji desktopowej wymagają płatnego planu. Opisany wcześniej osobno konfigurowany tryb third-party oraz, jeśli jest dostępna, opcja konta Claude API na urządzeniach niezarządzanych pozwalają aplikacji desktopowej korzystać zamiast tego z rozliczeń Console lub dostawcy.

API jest innym produktem i podlega innym zasadom rozliczania. Konto Console jest rozliczane za tokeny na podstawie rzeczywiście wysłanych danych. Jest to rozwiązanie odpowiednie dla budowanej usługi, a nie dla pracy wykonywanej przez użytkownika w terminalu. Ustawienie ANTHROPIC_API_KEY przełącza CLI na ten sposób rozliczania. Jest to świadomy wybór, a nie tryb awaryjny. W standardowym trybie aplikacja desktopowa loguje się przez OAuth. W trybie third-party korzysta z danych uwierzytelniających zapisanych we własnej konfiguracji.

Ceny i limity planów zmieniają się zbyt często, aby je tutaj powtarzać. Aktualne wartości są śledzone na dwóch stronach: ile faktycznie kosztuje Claude Code oraz którego planu Claude potrzebujesz. Przy porównywaniu rozliczania za token z planem miesięcznym pomocna będzie strona API a subskrypcja, która pokazuje punkt opłacalności obu rozwiązań.

Błędy instalacji, które faktycznie wystąpią

bash: claude: command not found zaraz po poprawnej instalacji. Plik binarny znajduje się w ~/.local/bin/claude, a ten katalog nie znajduje się w ścieżce wyszukiwania powłoki. Potwierdź to za pomocą echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", które nie wyświetli niczego, jeśli wpis jest nieobecny. Napraw to dla bash za pomocą echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, a następnie uruchom source ~/.bashrc. Sama instalacja rozszerzenia VS Code nigdy nie tworzy tego pliku, ponieważ rozszerzenie przechowuje własną kopię CLI wewnątrz katalogu rozszerzenia.

Error loading shared library libstdc++.so.6. Instalator pobrał niewłaściwy wariant pliku binarnego, zazwyczaj kompilację musl w systemie glibc, lub użytkownik pracuje w systemie musl, któremu brakuje bibliotek uruchomieniowych. Niewłaściwy wariant występuje, gdy obecne są pakiety kompilacji skrośnej musl, a mechanizm wykrywania błędnie je interpretuje. Uruchom ldd --version 2>&1 | head -1: wynik zawierający GNU libc lub GLIBC oznacza, że system korzysta z glibc i otrzymał niewłaściwy plik binarny, więc należy usunąć instalację i uruchomić instalator ponownie. W systemie Alpine i innych systemach musl rozwiązanie jest odwrotne, apk add libgcc libstdc++ ripgrep.

Dwie kopie claude na jednej maszynie. which -a claude wyświetla każde dopasowanie w zmiennej PATH. Instalacja natywna to dowiązanie symboliczne z ~/.local/bin/claude do ~/.local/share/claude/versions/, starsza lokalna instalacja npm znajduje się w ~/.claude/local/, a npm -g ls @anthropic-ai/claude-code ujawnia globalną instalację npm. Usuń niepotrzebne kopie, ponieważ nieaktualna wersja znajdująca się wcześniej w zmiennej PATH sprawia, że naprawiony błąd nadal wydaje się występować.

Gdzie sprawdzić aktualny stan

Zasady logowania do konta Claude API, domyślne uprawnienia w trybie bez nadzoru, przebieg logowania SSH oraz sposób przechowywania danych uwierzytelniających sprawdzono 7 listopada 2026. Pozostałe numery wersji i daty w tym przewodniku są nadal migawkami stanu z października 2026. Trwała jest ogólna struktura: cztery interfejsy, jedno logowanie w przypadku płatnych interfejsów oraz jedna decyzja dotycząca tego, czy CLI ma być dostępne dla danego użytkownika, czy dla całego systemu.

FAQ

Czy istnieje aplikacja Claude na komputery z systemem Linux?

Tak. W październiku 2026 jest dostępna w wersji beta. Obsługuje Ubuntu 22.04 lub nowszy oraz Debian 12 lub nowszy na platformach amd64 lub arm64. Należy zainstalować ją za pomocą sudo apt install claude-desktop po dodaniu repozytorium apt firmy Anthropic i jej klucza podpisu. Dzięki temu nowe wersje będą dostarczane wraz ze standardowymi aktualizacjami systemu. Wersja dla systemu Linux ma te same karty co aplikacja macOS, w tym kartę Claude Code. Funkcje Computer Use i dyktowanie głosowe nie są jeszcze dostępne w wersji dla systemu Linux. Globalny skrót Quick Entry działa w X11, ale w natywnej sesji Wayland wymaga portalu GlobalShortcuts środowiska graficznego. Fedora i RHEL nie mają pakietu. W tych dystrybucjach należy używać CLI lub serwisu claude.ai w przeglądarce.

Czy do uruchomienia Claude Code w systemie Linux potrzebny jest Node.js?

Nie w przypadku zalecanej instalacji. curl -fsSL https://claude.ai/install.sh | bash pobiera skompilowany plik binarny, który w czasie działania nie korzysta z Node.js. Node.js jest potrzebny tylko po zainstalowaniu pakietu npm. W październiku 2026 pakiet ten wymaga Node.js 22 lub nowszego. W starszej wersji Node.js npm wyświetla ostrzeżenie EBADENGINE, ale instalacja nadal się kończy, ponieważ ten sam natywny plik binarny jest pobierany jako zależność specyficzna dla platformy. Nie należy instalować go za pomocą sudo npm install -g. Polecenie pozostawia pliki należące do root w prefiksie npm i powoduje problemy z późniejszymi aktualizacjami.

Jak zalogować się do Claude Code przez SSH?

Uruchom claude i skopiuj osobny adres URL autoryzacji wyświetlony nad monitem terminala służącym do wklejania. Otwórz ten adres w przeglądarce na własnym komputerze, a nie na serwerze. Po zalogowaniu się za pomocą tego adresu przeglądarka wyświetli kod logowania zamiast powrócić do localhost. Wklej ten kod w monicie Paste code here if prompted. W przypadku sesji uruchamianych bez obecności użytkownika wykonaj claude setup-token i ustaw wyświetlony token jako CLAUDE_CODE_OAUTH_TOKEN w każdym wymaganym miejscu.

Gdzie Claude Code przechowuje dane logowania w systemie Linux?

W ~/.claude/.credentials.json z trybem pliku 0600 albo w CLAUDE_CONFIG_DIR po ustawieniu tej zmiennej. W systemie Linux nie jest używany keychain. macOS zwykle korzysta z zaszyfrowanego Keychain, ale po odrzuceniu zapisu przez Keychain przechodzi na ten sam zwykły plik. Każdy proces uruchomiony jako dany użytkownik może odczytać plik poświadczeń systemu Linux. Kopia zapasowa /home lub obraz maszyny zawiera zatem aktywne dane logowania. Przed wykonaniem migawki albo skopiowaniem systemu uruchom /logout. Jeżeli w środowisku ustawiono również ANTHROPIC_API_KEY, ma ono pierwszeństwo przed zapisanym logowaniem subskrypcyjnym po jego zatwierdzeniu. Polecenie /status pokazuje, które dane logowania są aktywne.

Czy subskrypcja Claude Pro obejmuje również CLI i aplikację internetową?

Tak. Plan Pro, Max, Ultra lub Team umożliwia logowanie jednym kontem do claude.ai, aplikacji desktopowej, CLI i rozszerzenia VS Code. Dotyczy to również planu Enterprise, z wyjątkiem starszych planów Enterprise oraz planów Enterprise przygotowanych do wymagań HIPAA, które obejmują Claude Code tylko na stanowiskach zawierających tę funkcję, na przykład na stanowiskach Chat + Claude Code. Organizacje przygotowane do wymagań HIPAA używają osobnych typów stanowisk Chat i Chat + Claude Code. Tylko stanowiska Chat + Claude Code obejmują Claude Code. Bezpłatny plan claude.ai nie obejmuje Claude Code. Terminalowe CLI wymaga więc płatnego planu, konta Claude Console albo dostawcy chmurowego używanego przez organizację, takiego jak Amazon Bedrock, Google Cloud's Agent Platform lub Microsoft Foundry. Aplikacja desktopowa obsługuje logowanie za pomocą subskrypcji lub SSO oraz skonfigurowane wnioskowanie z użyciem zewnętrznych dostawców. Na urządzeniach bez konfiguracji Claude Desktop wersja 3.1623.1 lub nowsza oferuje również opcję konta Claude API. Umożliwia ona logowanie do Console albo użycie klucza API bez wcześniejszej konfiguracji. W wersji 4.23118.0 lub nowszej odnośnik ten jest ukryty podczas logowania do komputera, na którym organizacja blokuje inne konta, nawet bez zarządzania urządzeniem. API jest rozliczane osobno za każdy token z konta Console. Jest to inny produkt niż subskrypcja.

Czy ten artykuł był przydatny?