Instalacja i uwierzytelnianie

Ten przewodnik obejmuje wszystko, czego potrzebujesz, aby zainstalować Claude Code i przeprowadzić uwierzytelnianie do natychmiastowego użytku. Niezależnie od tego, czy używasz macOS, Windows czy Linux, pomożemy ci zacząć kodować z asystencją AI w mniej niż 15 minut.

Wymagania systemowe

Wymagania wstępne

Przed instalacją Claude Code upewnij się, że Twój system spełnia następujące wymagania:

System operacyjny:
- macOS 10.15+
- Ubuntu 20.04+/Debian 10+
- Windows 10+ (z WSL 1/2 lub Git for Windows)
Sprzęt: minimum 4GB RAM
Oprogramowanie: zainstalowany Node.js 18+
Sieć: wymagane połączenie internetowe
Terminal: najlepiej współpracuje z Bash, Zsh lub Fish
Lokalizacja: musisz być w kraju obsługiwanym przez Anthropic

Metody instalacji

Standardowa instalacja (zalecana)

Instalacja przez npm

Otwórz terminal i uruchom:
Okno terminala
```
npm install -g @anthropic-ai/claude-code
```
NIE używaj sudo npm install -g, ponieważ może to prowadzić do problemów z uprawnieniami i zagrożeń bezpieczeństwa.
Weryfikacja instalacji

Sprawdź, czy Claude Code został prawidłowo zainstalowany:
Okno terminala
```
claude --version
```
Sprawdzenie kondycji systemu

Upewnij się, że wszystko jest skonfigurowane poprawnie:
Okno terminala
```
claude doctor
```

Jeśli napotkasz błędy uprawnień, przejdź na instalację lokalną:

# Po początkowej próbie instalacji globalnej
claude migrate-installer

To przenosi Claude Code do ~/.claude/local/ i ustawia alias powłoki. Nie jest wymagany sudo do przyszłych aktualizacji.

Dla natywnej instalacji platformy:

# Z istniejącej instalacji
claude install

# Lub świeża instalacja przez curl
curl -fsSL claude.ai/install.sh | bash

Obsługa platform: macOS, Linux, Windows (przez WSL)

Konfiguracja Windows

WSL (zalecane)
Natywny Windows

Używając Windows Subsystem for Linux

Obsługiwane są zarówno WSL 1, jak i WSL 2. Zainstaluj Node.js w swoim środowisku WSL:

# Wewnątrz WSL
sudo apt update
sudo apt install nodejs npm
npm install -g @anthropic-ai/claude-code

Używając Git Bash

Zainstaluj Git for Windows
Dla przenośnych instalacji Git ustaw ścieżkę bash:
Okno terminala
```
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
```
Zainstaluj Claude Code przez npm w Git Bash

Opcje uwierzytelniania

Claude Code oferuje trzy metody uwierzytelniania dostosowane do różnych potrzeb:

Konsola Anthropic (domyślna) Połącz się przez konsolę Anthropic z OAuth. Wymaga aktywnej subskrypcji w console.anthropic.com

Plan Claude Pro/Max Ujednolicona subskrypcja dla Claude Code i interfejsu webowego. Ta sama cena, więcej wartości

Platformy korporacyjne Użyj Amazon Bedrock lub Google Vertex AI dla wdrożeń korporacyjnych

Szybkie uwierzytelnianie

Uruchom Claude Code
Okno terminala
```
cd twoj-projekt
claude
```

Wybierz metodę uwierzytelniania

Przy pierwszym uruchomieniu zobaczysz opcje takie jak:

Witaj w Claude Code!

Wybierz metodę uwierzytelniania:
1. Konsola Anthropic (domyślna)
2. Subskrypcja Claude Pro/Max
3. Korporacyjna (Bedrock/Vertex)

Zakończ uwierzytelnianie
- Konsola/Claude.ai: przeglądarka otwiera się dla przepływu OAuth
- Korporacyjna: najpierw skonfiguruj zmienne środowiskowe (patrz poniżej)

Uwierzytelnianie korporacyjne

Amazon Bedrock

Włącz dostęp do modelu w AWS
- Przejdź do konsoli Amazon Bedrock
- Poproś o dostęp do modeli Claude
- Poczekaj na zatwierdzenie (zwykle natychmiastowe)

Skonfiguruj dane uwierzytelniające

aws configure
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

export AWS_ACCESS_KEY_ID=twoj-klucz-id
export AWS_SECRET_ACCESS_KEY=twoj-tajny-klucz
export AWS_SESSION_TOKEN=twoj-token-sesji  # Jeśli używasz tymczasowych danych
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

export AWS_BEARER_TOKEN_BEDROCK=twoj-klucz-api-bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

Uruchom Claude Code
Okno terminala
```
claude
```

Google Vertex AI

Włącz API w Google Cloud
- IAM Credentials API
- Security Token Service API
- Vertex AI API
Poproś o dostęp do modelu
- Przejdź do Vertex AI Model Garden
- Wyszukaj modele “Claude”
- Poproś o dostęp (zatwierdzenie 24-48 godzin)

Skonfiguruj uwierzytelnianie

# Uwierzytelnij się z Google Cloud
gcloud auth application-default login

# Ustaw zmienne środowiskowe
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=twoj-id-projektu

Uruchom Claude Code
Okno terminala
```
claude
```

Za korporacyjnym proxy

Jeśli jesteś za korporacyjnym proxy:

# Proxy HTTP/HTTPS
export HTTPS_PROXY='https://proxy.company.com:8080'
export HTTP_PROXY='http://proxy.company.com:8080'

# Jeśli używasz certyfikatów self-signed
export NODE_TLS_REJECT_UNAUTHORIZED=0  # Używaj ostrożnie

Dla stałej konfiguracji proxy dodaj do swojego profilu powłoki (~/.bashrc, ~/.zshrc, itp.).

Rozwiązywanie częstych problemów

Błędy uprawnień na Linux/macOS

Szybka naprawa
Naprawa prefiksu NPM

# Przejdź na instalację lokalną
claude migrate-installer

# Uruchom ponownie powłokę
source ~/.bashrc  # lub ~/.zshrc

# Utwórz katalog npm dostępny do zapisu dla użytkownika
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Zainstaluj ponownie Claude Code
npm install -g @anthropic-ai/claude-code

Problemy z Windows WSL

Błąd “Node not found”: Upewnij się, że używasz Linux Node.js, nie Windows:

which node  # Powinno pokazać /usr/bin/node, nie /mnt/c/...

Problemy z wykrywaniem OS: Wymuś tryb Linux:

npm config set os linux
npm install -g @anthropic-ai/claude-code --force --no-os-check

Problemy z uwierzytelnianiem

Jeśli uwierzytelnianie nie powiedzie się:

# Wyczyść przechowywane dane uwierzytelniające
rm -rf ~/.config/claude-code/auth.json

# Spróbuj ponownie
claude

Niepowodzenia automatycznych aktualizacji

Wyłącz automatyczne aktualizacje jeśli potrzeba:

# Przez konfigurację
claude config set autoUpdates false --global

# Lub zmienną środowiskową
export DISABLE_AUTOUPDATER=1

Zweryfikuj swoją instalację

Po instalacji i uwierzytelnieniu sprawdź, czy wszystko działa:

Sprawdź wersję i diagnostykę
Okno terminala
```
claude doctor
```
Przetestuj podstawową funkcjonalność
Okno terminala
```
claude "Stwórz skrypt hello world w Pythonie"
```
Sprawdź status uwierzytelniania
Okno terminala
```
claude /whoami
```

Dla najlepszego doświadczenia wielu programistów uruchamia Claude Code z:

claude --dangerously-skip-permissions

To pomija ciągłe prośby o uprawnienia (podobnie do starego “yolo mode” w Cursor). Używaj według własnego uznania w oparciu o wymagania bezpieczeństwa.

Następne kroki

Skonfiguruj swoje środowisko Ustaw integrację z IDE, skróty klawiszowe i ustawienia specyficzne dla projektu

Zainicjuj swój pierwszy projekt Utwórz plik CLAUDE.md i skonfiguruj kontekst projektu

Szybki przewodnik

Polecenie	Cel
`claude --version`	Sprawdź zainstalowaną wersję
`claude doctor`	Uruchom diagnostykę
`claude update`	Ręcznie zaktualizuj Claude Code
`claude migrate-installer`	Napraw problemy z uprawnieniami
`claude config set <klucz> <wartość>`	Skonfiguruj ustawienia
`claude /logout`	Wyloguj się i wyczyść dane uwierzytelniające

Pamiętaj: Claude Code domyślnie aktualizuje się automatycznie, utrzymując cię na najnowszej wersji z najnowszymi funkcjami i poprawkami bezpieczeństwa.