Przewodnik instalacji Claude Code: Skrypt irm, konfiguracja npm i https://claude.ai/install.ps1

Fred· AI Engineer & Developer Educator3 min read

Wprowadzenie

Claude Code to moje glowne narzedzie linii polecen do kodowania wspomaganego AI. Niezaleznie czy jestes na Windows, macOS czy Linux, instalacja jest prosta z wieloma opcjami:

  • Natywny plik binarny (Zalecany): curl -fsSL https://claude.ai/install.sh | bash dla Linux/macOS
  • Windows PowerShell: irm https://claude.ai/install.ps1 | iex dla uzytkownikow Windows
  • Globalna instalacja npm: npm install -g @anthropic-ai/claude-code dla srodowisk Node.js

Ten przewodnik opisuje szczegolowo kazda metode instalacji, plus rozwiazywanie problemow za pomoca polecenia claude doctor do diagnozowania i naprawiania typowych problemow.

Zalecane: Natywny plik binarny

Od 2025 roku jest kilka srodowisk uruchomieniowych dla Claude, w tym Node.js i Bun.js. Anthropic zaleca uzywanie instalacji natywnego pliku binarnego. Ta metoda unika konfliktow miedzy menedzerami pakietow i jest najbardziej stabilna.

Instalacja natywnego pliku binarnego

  1. Uruchom skrypt instalacyjny:

    curl -fsSL https://claude.ai/install.sh | bash
  2. Przeladuj konfiguracje powloki:

    source ~/.bashrc
    # lub dla uzytkownikow zsh:
    source ~/.zshrc
  3. Zweryfikuj instalacje:

    claude --version
    claude doctor

To wszystko! Claude Code powinien byc teraz zainstalowany w ~/.claude/bin/claude lub ~/.local/bin/claude.

Rozwiazywanie problemow z claude doctor

Polecenie claude doctor to pierwsze miejsce do rozwiazywania problemow. Analizuje twoja instalacje i raportuje potencjalne problemy.

claude doctor

Co sprawdza claude doctor

Polecenie claude doctor sprawdza:

  • Metode instalacji: Natywny plik binarny, npm, Bun lub Homebrew
  • Informacje o wersji: Aktualna wersja i status aktualizacji
  • Mozliwosc automatycznej aktualizacji: Czy aktualizacje moga byc stosowane
  • Funkcjonalnosc wyszukiwania: Czy ripgrep jest prawidlowo dolaczony/zainstalowany
  • Konfiguracja PATH: Czy Claude jest prawidlowo w twoim PATH
  • Sciezka wykonania: Faktyczny uruchamiany plik binarny

Alternatywne metody instalacji

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

Jesli wolisz uzywac npm (Node Package Manager), mozesz zainstalowac Claude Code globalnie. Ta metoda wymaga Node.js 18 lub wyzszego.

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

Wazne: Nigdy nie uzywaj sudo npm install -g poniewaz powoduje to problemy z uprawnieniami.

Windows: Uzywanie irm https://claude.ai/install.ps1 | iex

Dla uzytkownikow Windows masz trzy opcje:

  1. WSL (Zalecane): Zainstaluj WSL i postepuj wedlug instrukcji dla Linux
  2. Git Bash: Uzyj natywnego instalatora z Git Bash
  3. PowerShell (Natywny Windows):
    irm https://claude.ai/install.ps1 | iex

Polecenie irm to Invoke-RestMethod PowerShella, ktore pobiera zawartosc z URL. Skrypt https://claude.ai/install.ps1 obsluguje:

  • Wykrywanie architektury Windows (x64, ARM64)
  • Pobieranie odpowiedniego pliku binarnego Claude Code
  • Instalacje do katalogu uzytkownika
  • Dodawanie Claude do zmiennej srodowiskowej PATH

Po instalacji

Uwierzytelnianie

Po instalacji uwierzytelnij Claude Code:

claude

Zostaniesz poproszony o wybor metody uwierzytelniania:

  • Claude Console (domyslnie): Dla dostepu API z rozliczeniami na console.anthropic.com
  • Claude Pro/Max: Jesli masz subskrypcje Claude
  • Enterprise: Dla wdrozen AWS Bedrock lub Google Vertex AI

Podstawowe uzycie

Zacznij uzywac Claude Code:

# Przejdz do swojego projektu
cd /sciezka/do/twojego/projektu

# Uruchom Claude Code
claude

# Uzyskaj pomoc
claude help

# W sesji uzyj polecen slash
/help    # Pokaz dostepne polecenia
/clear   # Wyczysc rozmowe
/exit    # Wyjdz z Claude Code

Zarzadzanie aktualizacjami

Claude Code automatycznie aktualizuje sie domyslnie. Aktualizacje sa sprawdzane przy uruchomieniu i stosowane w tle.

Jak zaktualizowac Claude Code

claude update

Typowe problemy i rozwiazania

Problem: "command not found: claude"

PATH nie zostal zaktualizowany. Dodaj do konfiguracji powloki:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Problem: Funkcja wyszukiwania nie dziala

Zwykle naprawiana przez natywna instalacje, ale jesli problem trwa:

# Zainstaluj ripgrep recznie
sudo apt-get install ripgrep  # Ubuntu/Debian
brew install ripgrep          # macOS

Najlepsze praktyki

  1. Zawsze uzywaj natywnego pliku binarnego chyba ze masz specyficzne wymagania
  2. Unikaj sudo przy kazdej metodzie instalacji
  3. Trzymaj automatyczne aktualizacje wlaczone dla bezpieczenstwa i funkcji
  4. Uruchom claude doctor po kazdej instalacji lub aktualizacji
  5. Posprzataj stare instalacje przed instalacja nowych wersji

Podsumowanie

Pamietaj: w razie watpliwosci usun wszystko i zacznij od nowa z natywnym plikiem binarnym. To najprostszy, najszybszy i najbardziej niezawodny sposob uruchamiania Claude Code.

Szybka referencja

  • Instalacja: curl -fsSL https://claude.ai/install.sh | bash
  • Sprawdz wersje: claude --version
  • Diagnoza: claude doctor
  • Aktualizacja: claude update
  • Uruchom: claude
  • Pomoc: claude help
Fred

Fred

AUTHOR

Full-stack developer with 10+ years building production applications. I use Claude Code daily for development and know its strengths and limitations.

P.S. — If you tried this and your app is now on fire, I offer emergency rescue services. No judgment. Get rescue help →

Need a developer who gets it?

POC builds, vibe-coded fixes, and real engineering. Let's talk.

Hire Me →