Krótkie podsumowanie: Instalacja Claude Code na Windows wymaga konfiguracji WSL2 (Windows Subsystem for Linux), instalacji Ubuntu i uruchomienia prostego skryptu instalacyjnego. Proces umożliwia użytkownikom Windows dostęp do asystenta kodowania AI firmy Anthropic poprzez ich terminal. Dostępne są natywne pliki binarne dla systemu Windows, jednak WSL2 jest nadal najlepszą praktyką w przypadku instalacji na Windows.
Claude Code to asystent kodowania oparty na sztucznej inteligencji, który działa bezpośrednio w terminalu, pomagając programistom tworzyć funkcje, naprawiać błędy i automatyzować zadania związane z tworzeniem oprogramowania. Jednak dla użytkowników systemu Windows istnieje pewien haczyk.
Claude Code jest dostępny jako natywny plik wykonywalny dla systemu Windows i można go zainstalować za pomocą npm lub bezpośredniego pobrania pliku binarnego bez WSL2. Jednak wymaga on Windows Subsystem for Linux (WSL2), a oficjalna metoda instalacji nadal opiera się na WSL2.
Oto jak można go uruchomić na Windows 11 lub Windows 10.
Wymagania systemowe
Przed rozpoczęciem instalacji sprawdź, czy komputer z systemem Windows spełnia następujące wymagania:
- Windows 10 1809+ lub Windows Server 2019+
- Windows 11 (dowolna wersja)
- Co najmniej 4 GB wolnej pamięci RAM
- Uprawnienia administratora w systemie
- Połączenie internetowe do pobierania WSL2 i Ubuntu
Instalacja wymaga miejsca na dysku dla WSL2, Ubuntu i Claude Code.
Krok 1: Włącz Subsytem Windows dla systemu Linux
WSL2 zapewnia środowisko Linuksa bezpośrednio w systemie Windows. Jest to podstawa, która umożliwia działanie Claude Code.
Otwórz PowerShell jako administrator. Kliknij prawym przyciskiem myszy przycisk Start i wybierz „Windows PowerShell (Admin)” lub „Terminal (Admin)” w systemie Windows 11.
Uruchom to polecenie:
wsl --install
To polecenie włącza niezbędne funkcje systemu Windows i instaluje Ubuntu jako domyślną dystrybucję Linuksa. System prawdopodobnie poprosi o ponowne uruchomienie.
Po ponownym uruchomieniu WSL2 automatycznie zakończy konfigurację. Ubuntu uruchomi się i poprosi o nazwę użytkownika i hasło. Te dane uwierzytelniające dotyczą tylko środowiska Linuksa — nie muszą być zgodne z danymi uwierzytelniającymi systemu Windows.
Krok 2: Zweryfikuj instalację WSL2
Po ponownym uruchomieniu systemu i zakończeniu wstępnej konfiguracji Ubuntu, zweryfikuj, czy WSL2 działa poprawnie.
Otwórz terminal Ubuntu (wyszukaj „Ubuntu” w menu Start) i uruchom:
wsl --version
Wyświetli to informacje o wersji WSL. Szukaj „WSL version: 2.x.x” w wynikach.
Jeśli polecenie pokaże zamiast tego WSL1, zaktualizuj do WSL2 za pomocą:
wsl --set-default-version 2
Krok 3: Zainstaluj Claude Code
Teraz czas na właściwą instalację Claude Code. Oficjalna dokumentacja zawiera jedno-liniowy skrypt instalacyjny.
W terminalu Ubuntu uruchom:
curl -fsSL claude.ai/install.sh | bash
Skrypt pobiera plik binarny Claude Code, ustawia niezbędne uprawnienia i dodaje go do ścieżki systemowej (PATH). Czas instalacji jest zmienny i zależy od szybkości internetu oraz specyfikacji systemu.
Według oficjalnej dokumentacji Claude Code, instalator automatycznie wykrywa architekturę systemu i pobiera odpowiednią wersję pliku binarnego.
Częste problemy z instalacją
Niektórzy użytkownicy systemu Windows zgłaszają komunikat „command not found: claude” po instalacji. Zazwyczaj dzieje się tak, ponieważ zmienna PATH nie została odświeżona.
Zamknij i ponownie otwórz terminal Ubuntu, a następnie spróbuj ponownie. Jeśli problem nadal występuje, poniższa konfiguracja ścieżki może pomóc jako nieoficjalne obejście:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Krok 4: Uwierzytelnij Claude Code
Claude Code wymaga uwierzytelnienia za pomocą konta Anthropic przed użyciem.
Uruchom to polecenie:
claude
Terminal wyświetli adres URL i poprosi o uwierzytelnienie. Proces nieznacznie różni się w zależności od indywidualnych użytkowników i kont zespołowych:
| Typ konta | Metoda uwierzytelniania | Co jest wymagane |
|---|---|---|
| Indywidualne | Osobisty klucz API | Konto Anthropic z dostępem do API |
| Zespół/Organizacja | Token organizacji | Token uwierzytelniający dostarczony przez administratora |
Otwórz podany adres URL w przeglądarce, zaloguj się na konto Anthropic i autoryzuj Claude Code. Terminal potwierdzi pomyślne uwierzytelnienie.
Praca z projektami Windows w WSL2
Tutaj sprawy się komplikują. Systemy plików Windows i systemy plików WSL2 są oddzielne.
Pliki systemu Windows są dostępne z WSL2 pod adresem /mnt/c/ (dla dysku C:), /mnt/d/ (dla dysku D:) i tak dalej. Jednak wiąże się to z kosztami wydajności. Dyskusje społeczności wskazują na różnice w wydajności między folderami zamontowanymi w systemie Windows a natywnymi folderami WSL2.
Aby uzyskać najlepszą wydajność, skopiuj pliki projektu do katalogu domowego WSL2:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Kompromis? Integracja z IDE staje się bardziej skomplikowana. Visual Studio Code radzi sobie z tym dobrze dzięki rozszerzeniu Remote-WSL, ale inne IDE mogą mieć problemy.
Testowanie instalacji
Sprawdź, czy Claude Code działa poprawnie za pomocą prostego testu.
Przejdź do katalogu projektu (lub utwórz folder testowy):
mkdir ~/claude-test
cd ~/claude-test
claude "stwórz prosty skrypt hello world w Pythonie"
Claude Code powinien odpowiedzieć, utworzyć plik i wyświetlić kod. Potwierdza to pomyślną instalację.
Przestań przepłacać, najpierw odbierz dostępne kredyty AI
Instalacja Claude Code na Windows jest zazwyczaj szybka. Prawdziwy koszt pojawia się później, gdy programiści zaczną testować prompty, uruchamiać skrypty i integrować model z aplikacjami. Ta faza eksperymentów może generować wiele wywołań API, a wiele zespołów odkrywa koszt dopiero po rozpoczęciu budowania.
Zanim zaczniesz wydawać pieniądze na użytkowanie, warto sprawdzić, czy kwalifikujesz się do otrzymania kredytów AI lub programów partnerskich. Get AI Perks gromadzi te możliwości w jednym miejscu, wymieniając kredyty i zniżki od dostawców AI, platform chmurowych i narzędzi dla deweloperów, wraz z prostymi instrukcjami, jak je odebrać.
Zanim uruchomisz swój pierwszy projekt Claude Code, sprawdź Get AI Perks i odbierz kredyty AI, które mogą pokryć Twoje koszty rozwoju.
Najczęściej zadawane pytania
Czy Claude Code może działać natywnie na Windows bez WSL2?
Tak, ale WSL2 nadal pozostaje najlepszą metodą instalacji dla systemu Windows.
Czy Claude Code działa z Windows Terminal?
Tak. Windows Terminal może otwierać karty Ubuntu, umożliwiając dostęp do Claude Code bez przełączania się na oddzielne okno Ubuntu. W Windows Terminal kliknij strzałkę w dół i wybierz Ubuntu z listy profili.
Czy moje istniejące narzędzia deweloperskie dla systemu Windows będą działać z Claude Code?
To zależy od narzędzia. Visual Studio Code integruje się dobrze dzięki rozszerzeniu Remote-WSL. IDE JetBrains i inne narzędzia mogą wymagać dodatkowej konfiguracji. Oficjalna dokumentacja wspomina o VS Code i JetBrains jako obsługiwanych platformach.
Jak zaktualizować Claude Code w systemie Windows?
Claude Code aktualizuje się automatycznie domyślnie. Aby ręcznie zaktualizować, uruchom `claude update` w terminalu Ubuntu. Funkcja automatycznej aktualizacji może zostać wyłączona za pomocą plików konfiguracyjnych, jeśli jest to potrzebne w środowiskach korporacyjnych.
Jaka jest różnica między Claude Code a API Claude?
Claude Code to asystent kodowania oparty na terminalu, który wykonuje polecenia i edytuje pliki. API Claude zapewnia programowy dostęp do modelu językowego Claude w celu tworzenia niestandardowych aplikacji. Służą one różnym celom i wymagają różnych procesów konfiguracji.
Czy mogę używać Claude Code z projektami .NET na Windows?
Tak, ale z zastrzeżeniami. Dyskusje społeczności wskazują, że obsługa .NET SDK w WSL2 działa, ale wymaga zainstalowania wersji .NET SDK dla systemu Linux w Ubuntu. .NET zainstalowany w systemie Windows nie będzie dostępny z WSL2.
Ile kosztuje Claude Code?
Cena zależy od użytkowania i typu konta. Sprawdź oficjalną stronę internetową Anthropic, aby poznać aktualne poziomy cenowe i plany zespołowe, ponieważ koszty różnią się w zależności od zużycia API i wymagań organizacji.
Następne kroki po instalacji
Po zainstalowaniu Claude Code zacznij odkrywać jego możliwości. Dokumentacja szybkiego startu zaleca rozpoczęcie od prostych zadań, takich jak wyjaśnianie kodu, przed przejściem do bardziej złożonych operacji.
Wypróbuj te polecenia, aby się zapoznać:
- claude "wyjaśnij tę funkcję" -- Uzyskaj wyjaśnienia kodu
- claude commit -- Generuj komunikaty commitów Git
- claude -c -- Kontynuuj ostatnią rozmowę
Oficjalna dokumentacja zawiera szczegółowe przewodniki dotyczące integracji z IDE, instalacji wtyczek i zaawansowanych opcji konfiguracji. Dla zespołów ustawienia zarządzane przez serwer i śledzenie analiz oferują dodatkową kontrolę nad wdrożeniami Claude Code.
Konfiguracja WSL2 może wydawać się dodatkowymi krokami w porównaniu do natywnych aplikacji Windows, ale jest to obecnie jedyna droga do uruchomienia Claude Code na Windows. Dobra wiadomość? Po skonfigurowaniu działa płynnie i integruje się z większością przepływów pracy deweloperskiej.
