Jak zainstalować Claude Code na Windows, macOS i Linuksie — klucz API bez subskrypcji i płatność BLIK-iem

Claude Code instaluje się jednym oficjalnym poleceniem (poniżej wersje dla macOS i Linuksa, PowerShella oraz CMD). Anthropic zaleca natywny instalator, a npm jest alternatywą, która wymaga Node.js 22 lub nowszego. Bez subskrypcji Pro/Max i bez logowania wystarczy ustawić ANTHROPIC_BASE_URL=https://api.kunavo.com (bez /v1), ANTHROPIC_AUTH_TOKEN z kluczem API i trzy zmienne przypinające modele. Wtedy płacisz tylko za zużyte tokeny z salda, które doładujesz BLIK-iem w złotych, od 10 USD. Na koniec wpisz w Claude Code /status, żeby sprawdzić, czy klucz działa.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

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

:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Polecenia i zmienne sprawdziliśmy 3 października 2026 w oficjalnej dokumentacji instalacji Claude Code i w dokumentacji zmiennych środowiskowych. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 3 października 2026. Polska jest na liście krajów obsługiwanych przez Anthropic (sprawdzone 3 października 2026), zarówno dla Claude.ai, jak i dla API.

Logowanie czy klucz API?

Po instalacji Claude Code musi się uwierzytelnić. Są dwie drogi, a ten poradnik szczegółowo opisuje drugą:

Zanim zaczniesz

Metoda 1: natywny instalator (zalecana)

W oficjalnej dokumentacji ta metoda ma zakładkę „Native Install (Recommended)”. Polecenia znajdziesz na początku strony. Na macOS, Linuksie i w WSL służy do tego linia z install.sh. W Windows PowerShell użyj irm … | iex, a w wierszu polecenia CMD linii z install.cmd. Natywna instalacja aktualizuje się automatycznie w tle. Claude Code da się też zainstalować przez Homebrew lub WinGet, ale według dokumentacji te instalacje domyślnie nie aktualizują się same, więc aktualizujesz je ręcznie w menedżerze pakietów:

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

Po instalacji otwórz nowe okno terminala, bo okno otwarte wcześniej nie widzi zaktualizowanej zmiennej PATH. Potem sprawdź:

claude --version   # wypisuje numer wersji, np. 2.1.211 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor nie otwiera sesji. Wypisuje tylko stan instalacji i diagnostykę plików ustawień. Dzięki temu najszybciej odróżnisz problem z instalacją od problemu z konfiguracją.

Gdy pobieranie się nie udaje

Jeśli terminal pokazuje syntax error near unexpected token '<' albo curl: (22) The requested URL returned error: 403, to według oficjalnej strony o problemach z instalacją (sprawdzone 3 października 2026) adres instalatora zwrócił stronę HTML lub kod błędu zamiast skryptu. Strona z napisem App unavailable in region oznacza według dokumentacji, że Claude Code nie jest dostępny w Twoim kraju. Polska jest jednak na liście obsługiwanych krajów, więc jeśli widzisz ten napis w Polsce, sprawdź, czy połączenie nie wychodzi przez VPN albo proxy. Samo 403 bez treści może też pochodzić z firmowego proxy lub zapory, która blokuje pobieranie. Dokumentacja radzi wtedy najpierw sprawdzić połączenie sieciowe, bo inne metody instalacji łączą się z tymi samymi serwerami. Spróbuj z innej sieci albo poproś administratora o odblokowanie tych adresów.

Metoda 2: npm (Node.js 22 lub nowszy)

npm nadal jest jedną z metod opisanych w oficjalnej dokumentacji. Pakiet wymaga Node.js 22 lub nowszego. Część polskich poradników wciąż podaje Node.js 18, co jest już nieaktualne. Na starszym Node.js npm wypisze ostrzeżenie EBADENGINE, ale nie przerwie instalacji, a claude będzie działać, bo pakiet pobiera natywny program, który nie korzysta z Node.js w czasie działania. Jeśli nie masz Node.js, zainstaluj wersję 22 lub nowszą ze strony nodejs.org.

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• Nigdy nie używaj sudo npm install -g. Dokumentacja ostrzega, że prowadzi to do problemów z uprawnieniami i stanowi zagrożenie dla bezpieczeństwa.
• Aktualizuj przez @latest. Do aktualizacji użyj npm install -g @anthropic-ai/claude-code@latest, a nie npm update -g.
• Nie pomijaj zależności opcjonalnych. Właściwy program instaluje się jako opcjonalna zależność, czyli pakiet @anthropic-ai/claude-code-* dla Twojej platformy. Z flagą --omit=optional albo z optional=false w .npmrc instalacja na macOS lub Linuksie skończy się komunikatem claude native binary not installed.

Claude Code na Windows: PowerShell, CMD, WSL i PATH

Windows ma dwa różne polecenia instalacyjne, a wybór zależy tylko od terminala. Jeśli wiersz zaczyna się od PS C:\Users\TwojaNazwa>, pracujesz w PowerShellu. Jeśli widzisz samo C:\Users\TwojaNazwa>, bez PS, to wiersz polecenia (CMD). Według dokumentacji nie trzeba uruchamiać terminala jako administrator, choć niektóre poradniki tak radzą.

Najczęstszy błąd to wklejenie polecenia do niewłaściwego terminala. Linia dla CMD wklejona do PowerShella daje The token '&&' is not a valid statement separator. Linia dla PowerShella wklejona do CMD daje 'irm' is not recognized as an internal or external command. W polskim Windows ten sam komunikat brzmi: „irm” nie jest rozpoznawany jako polecenie wewnętrzne lub zewnętrzne, program wykonywalny lub plik wsadowy. Z kolei linia curl … | bash z macOS wklejona do PowerShella kończy się błędem A parameter cannot be found that matches parameter name 'fsSL' albo 'bash' is not recognized as the name of a cmdlet. W każdym z tych przypadków wystarczy użyć linii przeznaczonej dla Twojego terminala.

W menu Start są dwa wpisy: „Windows PowerShell” i „Windows PowerShell (x86)”. Ten drugi działa jako proces 32-bitowy, więc nawet na 64-bitowym komputerze kończy się błędem Claude Code does not support 32-bit Windows. Otwieraj wpis bez dopisku (x86).

Git for Windows jest opcjonalny, ale zalecany. Gdy jest zainstalowany, Claude Code wykonuje polecenia przez dołączony do niego Git Bash, a bez niego przez PowerShell. Jeśli Git jest zainstalowany, ale Claude Code nie znajduje Git Bash, ustaw w bloku env pliku ~/.claude/settings.json zmienną CLAUDE_CODE_GIT_BASH_PATH ze ścieżką do bash.exe. Przykładowa ścieżka z dokumentacji to C:\Program Files\Git\bin\bash.exe.

Jeśli wybierasz WSL, uruchom linię dla macOS i Linuksa w terminalu WSL i tam też startuj claude, a nie w PowerShellu ani w CMD.

Błąd zasad wykonywania skryptów (npm w PowerShellu)

Komunikat npm.ps1 cannot be loaded because running scripts is disabled on this system przy instalacji lub uruchamianiu przez npm oznacza, że zasady wykonywania (execution policy) PowerShella blokują skrypt startowy .ps1, który wygenerował npm. Według dokumentacji możesz pozwolić bieżącemu użytkownikowi na uruchamianie lokalnych skryptów (polecenie poniżej), użyć npm.cmd i claude.cmd albo przejść na natywny instalator dla PowerShella.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Polecenie „claude” nie jest rozpoznawane po instalacji

command not found: claude albo 'claude' is not recognized oznacza, że katalogu instalacji nie ma w PATH. Natywny instalator umieszcza program w ~/.local/bin/claude na macOS i Linuksie oraz w %USERPROFILE%\.local\bin\claude.exe na Windows. Najpierw otwórz nowy terminal. Jeśli na Windows nadal nie działa, sprawdź i dopisz ścieżkę w PowerShellu tak, jak podaje dokumentacja:

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

Klucz API zamiast logowania (bez subskrypcji)

ANTHROPIC_BASE_URL to wbudowana zmienna Claude Code. Według oficjalnej dokumentacji nadpisuje ona punkt końcowy API, żeby kierować zapytania przez proxy lub bramę (gateway). Podłączenie Claude Code do usługi zgodnej z Anthropic Messages API jest więc konfiguracją przewidzianą przez Anthropic. Nie potrzebujesz wtyczek ani zmodyfikowanego programu. Na macOS i Linuksie dopisz zmienne do pliku konfiguracyjnego powłoki (~/.zshrc albo ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Na Windows możesz najpierw sprawdzić konfigurację w jednym oknie PowerShella:

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Na stałe najlepiej wpisać zmienne do bloku env w pliku ustawień użytkownika ~/.claude/settings.json (na Windows %USERPROFILE%\.claude\settings.json). Według dokumentacji ten plik obowiązuje we wszystkich Twoich projektach. Jeśli w pliku są już inne ustawienia, dopisz do niego tylko blok env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

W każdej z tych pięciu linii łatwo o pomyłkę:

• ANTHROPIC_BASE_URL to sama domena. Claude Code sam dokleja /v1/messages. Z /v1 na końcu zapytanie trafi pod /v1/v1/messages i zwróci 404.
• ANTHROPIC_AUTH_TOKEN, nie ANTHROPIC_API_KEY. Wartość ANTHROPIC_AUTH_TOKEN trafia do nagłówka Authorization z przedrostkiem Bearer i działa od razu. ANTHROPIC_API_KEY trafia do nagłówka x-api-key i w trybie interaktywnym trzeba go raz zatwierdzić. Jeśli wtedy odmówisz, klucz będzie po cichu ignorowany. Ponownie włączysz go w /config → Use custom API key.
• ANTHROPIC_MODEL wybiera model główny. Tutaj jest to Claude Sonnet 5 (claude-sonnet-5). Nazwa musi być dokładnie taka jak na liście modeli Kunavo. Starszych nazw z datą na końcu Kunavo nie rozpoznaje.
• ANTHROPIC_DEFAULT_OPUS_MODEL przypina alias opus. Według oficjalnej dokumentacji konfiguracji modeli (sprawdzone 3 października 2026) dla użytkowników API model domyślny i alias opus wskazują Opus 5.5, a alias sonnet wskazuje Sonnet 5.5. Aliasy z czasem się zmieniają, a wersję przypina się pełną nazwą modelu albo zmienną taką jak ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo obecnie (stan na 3 października 2026) nie udostępnia Sonnet 5.5, a nowy Opus wydany przez Anthropic nie musi być od razu dostępny w Kunavo. Zapytanie o model, którego nie ma, zwraca 404, dlatego przypinamy i model główny, i alias opus. Jeśli przełączasz modele poleceniem /model sonnet, dodaj jeszcze ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.
• ANTHROPIC_DEFAULT_HAIKU_MODEL obsługuje też zadania w tle. Według dokumentacji ta zmienna wybiera model dla aliasu haiku i dla funkcji działających w tle. W Kunavo Claude Haiku 4.5 kosztuje 0,70 USD za milion tokenów wejściowych i 3,50 USD za milion wyjściowych. Model główny Claude Sonnet 5 kosztuje 1,40 USD / 7,00 USD (cennik Anthropic: 2,00 USD / 10,00 USD), a Claude Opus 5 kosztuje 3,50 USD / 17,50 USD (wejście / wyjście, za milion tokenów).

Klucza nie wpisuj do projektowego .claude/settings.json. Według dokumentacji podłączania bramy ten plik trafia do repozytorium, a więc do każdego, kto je sklonuje. Pamiętaj też o kolejności pierwszeństwa. Gdy ta sama zmienna jest ustawiona i w powłoce, i w bloku env pliku ustawień, w większości sesji obowiązuje wartość z pliku ustawień. Osobna zasada dotyczy klucza model w pliku ustawień: zmienna ANTHROPIC_MODEL ma przed nim pierwszeństwo, a model działa tylko wtedy, gdy zmiennej nie ma. Jeśli zmiana w powłoce nie działa, najpierw sprawdź plik ustawień. W rozszerzeniu Claude Code dla VS Code zmienne ustawia się w claudeCode.environmentVariables, w ustawieniach użytkownika samego VS Code.

Pierwsze uruchomienie i /status

Według dokumentacji podłączania bramy (sprawdzone 3 października 2026) z ustawionym ANTHROPIC_AUTH_TOKEN polecenie claude od razu otwiera sesję bez ekranu logowania. Zmienna działa natychmiast i nie trzeba jej zatwierdzać, jak w przypadku ANTHROPIC_API_KEY. Jeśli zamiast tego widzisz ekran logowania, Claude Code nie odczytał klucza.

Klucz musi być tam, gdzie Claude Code czyta go przed pierwszą konfiguracją, czyli ustawiony poleceniem export w powłoce albo w bloku env pliku ~/.claude/settings.json użytkownika. W trybie interaktywnym blok env z projektowego .claude/settings.json lub .claude/settings.local.json zaczyna działać dopiero po kreatorze pierwszego uruchomienia i pytaniu o zaufanie do folderu. Z kluczem tylko w ustawieniach projektu przy pierwszym starcie i tak zobaczysz ekran logowania.

W sesji wpisz /status i sprawdź dwa wiersze:

• Anthropic base URL pojawia się tylko wtedy, gdy ustawiony jest adres bramy. Powinien pokazywać https://api.kunavo.com. Jeśli tego wiersza nie ma, ANTHROPIC_BASE_URL nie dotarł do sesji.
• Auth token z nazwą ANTHROPIC_AUTH_TOKEN oznacza, że działa klucz API, a nie zapisane logowanie claude.ai. Jeśli widzisz Login method z kontem claude.ai, zmienna nie zadziałała.

Adres i klucz możesz też sprawdzić przed uruchomieniem Claude Code, metodą z oficjalnej dokumentacji. Polega ona na wysłaniu zapytania o 1 token wyjściowy, które pobierze z salda symboliczną kwotę. Polecenie czyta zmienne z bieżącej powłoki, więc nawet jeśli klucz jest w pliku ustawień, najpierw ustaw zmienne poleceniem export w tym terminalu. Odpowiedź JSON zaczynająca się od {"id":"msg_ oznacza, że adres i klucz działają. Kod 401 oznacza, że klucz został odrzucony.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

W PowerShellu to samo sprawdzenie wygląda tak. Jeśli wszystko działa, w odpowiedzi zobaczysz pole id zaczynające się od msg_:

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Co działa inaczej z kluczem API

• Remote Control i dyktowanie głosowe są niedostępne. Według dokumentacji wymagają tożsamości claude.ai i nie działają, gdy aktywny jest ANTHROPIC_AUTH_TOKEN. Od wersji 2.1.196 Remote Control jest też wyłączany, gdy ANTHROPIC_BASE_URL wskazuje inny host niż api.anthropic.com.
• /fast pokazuje tryb szybki jako wyłączony. Według dokumentacji, gdy jest tylko token bearer, Claude Code traktuje fast mode jako wyłączony i nie wysyła zapytania o dostępność.
• Wyszukiwanie narzędzi MCP jest domyślnie wyłączone. Dzieje się tak, gdy ANTHROPIC_BASE_URL wskazuje host inny niż Anthropic.
• Liczby w /context są szacunkowe. Kunavo nie udostępnia endpointu /v1/messages/count_tokens. Według dokumentacji zgodności bram (sprawdzone 3 października 2026) Claude Code liczy wtedy tokeny lokalnie na podstawie liczby znaków.

Pełny opis integracji znajdziesz w dokumentacji integracji Claude Code (po angielsku), a wersję tego poradnika po angielsku w artykule Install Claude Code.

Płatność BLIK: doładowanie salda i klucz API

Subskrypcje Claude kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (FAQ rozliczeń Claude, sprawdzone 3 października 2026). BLIK-iem nie zapłacisz za Pro ani za Max. W Kunavo BLIK doładowuje przedpłacone saldo API, z którego Claude Code płaci za tokeny po ustawieniu klucza tak jak wyżej. Wszystkie kroki płatności opisuje poradnik jak zapłacić za Claude BLIK-iem, a w skrócie wygląda to tak:

1. Załóż konto Kunavo przez e-mail albo konto Google. Przy rejestracji nie musisz podawać karty.
2. W zakładce Rozliczenia (Billing) wybierz kwotę doładowania. Minimum to 10 USD i nie ma opłaty miesięcznej. Przy większych kwotach dostajesz bonus: 100 USD → 110 USD na saldzie, 1000 USD → 1200 USD na saldzie, 5000 USD → 6250 USD na saldzie.
3. Na stronie płatności Stripe kwota jest pokazana w złotych. Wybierz BLIK, wygeneruj w aplikacji bankowej sześciocyfrowy kod, wpisz go i potwierdź płatność w aplikacji. Według dokumentacji Stripe (sprawdzone 3 października 2026) kod BLIK jest ważny 2 minuty, a po rozpoczęciu płatności masz 60 sekund na jej zatwierdzenie.
4. W zakładce Klucze API utwórz klucz zaczynający się od sk-kn-. Klucz wyświetla się tylko raz, więc od razu go zapisz i wpisz do ANTHROPIC_AUTH_TOKEN.

Na stronie płatności w złotych oprócz BLIK-a są też karty (Visa, Mastercard), Apple Pay i Google Pay na obsługiwanych urządzeniach oraz Link. Nie ma natomiast Przelewy24, PayU, PayPal ani zwykłego przelewu bankowego. Ceny są ustalone w dolarach, a Stripe przelicza je na złote. Według dokumentacji Stripe o Adaptive Pricing (sprawdzone 3 października 2026) kurs zawiera opłatę za przewalutowanie w wysokości 2–4%, którą ponosi kupujący. Płacąc kartą w dolarach, unikniesz tej opłaty, choć wtedy obowiązują kurs i opłaty Twojego banku, a BLIK działa tylko w złotych. Dokładną kwotę w złotych zobaczysz na stronie płatności przed potwierdzeniem.

BLIK działa tylko przy ręcznym doładowaniu. Automatyczne doładowanie wymaga zapisanej karty lub Link. Saldo nie wygasa, a za nieudane zapytania nie płacisz. Kunavo nie wystawia faktur VAT, a historię doładowań znajdziesz w zakładce Rozliczenia (Billing). Pamiętaj, że to doładowanie salda API Kunavo, a nie opłata za Claude Pro czy Max.

Ile to kosztuje (przykładowe wyliczenie)

W Claude Code płacisz za tokeny. Przy każdym zapytaniu Claude Code wysyła cały kontekst rozmowy od nowa, ale powtarzający się początek kontekstu może być rozliczany po stawce odczytu z cache. Poniżej jest przykładowy rachunek na tokenach. To nie jest pomiar ani górny limit kosztów. Wszystkie założenia są podane:

• każde zapytanie ma 40 000 tokenów wejściowych, z czego 36 000 (90%) jest rozliczanych jako odczyt z cache, a pozostałe 4000 jako zapis do cache;
• każde zapytanie zwraca 1000 tokenów wyjściowych;
• w jednej sesji pracy jest 50 takich zapytań, bez wywołań Claude Haiku 4.5 w tle;
• w Kunavo odczyt z cache kosztuje 10% stawki wejściowej, a zapis do cache 1,25× stawki wejściowej. To proporcje dla Claude Sonnet 5, a każdy model w zestawieniu liczony jest według własnych proporcji.

Rzeczywisty koszt zależy od długości kontekstu, liczby trafień w cache, długości odpowiedzi i tego, czy między zadaniami czyścisz rozmowę poleceniem /clear. Stawki wszystkich modeli znajdziesz w cenniku. Własne zużycie oszacujesz kalkulatorem kosztów tokenów Claude (po angielsku). Kiedy bardziej opłaca się subskrypcja, a kiedy API, opisuje poradnik ile kosztuje Claude Code.

Najczęstsze błędy

Ograniczenia

• Kunavo nie wystawia faktur VAT.
• BLIK działa tylko przy ręcznym doładowaniu. Automatyczne doładowanie wymaga zapisanej karty lub Link.
• To API rozliczane za tokeny, a nie subskrypcja Claude Pro lub Max. Z kluczem API nie działają Remote Control ani dyktowanie głosowe, tryb /fast jest wyłączony, a wyszukiwanie narzędzi MCP jest domyślnie wyłączone.
• Kunavo obecnie (stan na 3 października 2026) nie udostępnia Sonnet 5.5, więc bez przypiętych modeli domyślne aliasy mogą zwracać 404.
• Oficjalna dokumentacja Claude Code i dokumentacja integracji Kunavo są tylko po angielsku.

Najczęstsze pytania