Claude Code na Windows: instalacja natywna, WSL i codzienna praca
Claude Code nie wymaga Linuksa ani WSL: działa natywnie w Windows, w terminalu, aplikacji desktop i VS Code. Opisuję instalację według dokumentacji Anthropic, ścieżki ustawień i praktykę z codziennej pracy na Windows.
Autor: Szymon Łakomy. Aktualizacja:
Jakie są wymagania Claude Code na Windows?
Claude Code potrzebuje 64-bitowego Windows 10 w wersji 1809 lub nowszej albo Windows Server 2019 lub nowszego, co najmniej 4 GB RAM i procesora x64 lub ARM64. Do tego według dokumentacji Anthropic, stan na 14 listopada 2026:
- Konto. Płatny plan Claude z dostępem do Claude Code, na przykład Pro, Max, Team albo Enterprise, lub konto Claude Console. Darmowy plan claude.ai go nie obejmuje.
- Git for Windows. Zalecany, ale opcjonalny. Bez niego Claude Code nie ma narzędzia Bash i korzysta z PowerShell.
Jak zainstalować Claude Code na Windows?
Najprostszy sposób instalacji Claude Code to instalator natywny: w PowerShell irm https://claude.ai/install.ps1 | iex, a w CMD odpowiednik z dokumentacji. Nie wymaga uprawnień administratora, a claude --version w nowym oknie terminala potwierdza instalację.
| Sposób | Co trzeba mieć | Na co uważać |
|---|---|---|
| Instalator natywny (PowerShell lub CMD) | sam Windows | aktualizuje się w tle, bez piaskownicy poleceń |
| WinGet | menedżer pakietów WinGet | domyślnie bez automatycznych aktualizacji: winget upgrade Anthropic.ClaudeCode |
| WSL 2 | włączone WSL 2 i instalator linuksowy w WSL | z piaskownicą poleceń, dla narzędzi linuksowych |
| WSL 1 | włączone WSL 1 | bez piaskownicy, gdy WSL 2 jest niedostępne |
| Aplikacja desktop | instalator ze strony Claude | Claude Code bez terminala |
| Rozszerzenie VS Code | VS Code od wersji 1.94.0 | własna kopia CLI, bez polecenia claude w PATH |
Według dokumentacji Claude Code, stan na 14 listopada 2026. Terminal, aplikacja desktop i rozszerzenia IDE czytają te same pliki ustawień.
Git Bash czy PowerShell: w jakiej powłoce Claude Code wykonuje polecenia?
Z Git for Windows Claude Code wykonuje polecenia w Git Bash i ma obok narzędzie PowerShell, domyślnie włączone dla kont claude.ai i Console. Bez Git for Windows polecenia idą przez PowerShell.
Z praktyki: Claude Code używam codziennie na Windows, również przy budowie tego serwisu, i agent korzysta z obu powłok. W CLAUDE.md zapisuję, dla której powłoki są polecenia projektu. Typowe pułapki to /dev/null kontra $null oraz rm -rf kontra Remove-Item. Pole shell mają też hooki w Claude Code.
Gdzie Claude Code trzyma ustawienia na Windows?
Na Windows ~/.claude oznacza %USERPROFILE%\.claude, a pliki zarządzane przez firmę leżą w C:\Program Files\ClaudeCode.
| Plik | Ścieżka na Windows | Kogo dotyczy |
|---|---|---|
| Ustawienia użytkownika | %USERPROFILE%\.claude\settings.json | jedną osobę we wszystkich projektach |
| Ustawienia projektu | .claude\settings.json w repozytorium | cały zespół |
| Ustawienia lokalne | .claude\settings.local.json, poza gitem | jedną osobę w jednym projekcie |
| Ustawienia zarządzane | C:\Program Files\ClaudeCode\managed-settings.json albo rejestr HKLM\SOFTWARE\Policies\ClaudeCode | całą firmę, wdrażane przez IT, na przykład przez Intune lub zasady grupy |
| CLAUDE.md organizacji | C:\Program Files\ClaudeCode\CLAUDE.md | całą organizację, wdrażany przez IT |
| Program claude.exe | %USERPROFILE%\.local\bin | instalację natywną |
Zmienna CLAUDE_CONFIG_DIR przenosi pliki z katalogu domowego. Treść pliku instrukcji opisuję w poradniku jak napisać CLAUDE.md.
Praktyka: końce linii, cudzysłowy i ścieżki ze spacjami
W pracy na Windows pilnuję końców linii, ścieżek ze spacjami i cudzysłowów. To moja praktyka, a nie zalecenie Anthropic.
- Końce linii. Plik zapisany na Windows z CRLF w repozytorium z LF może pokazać w diffie zmianę w każdym wierszu. Dlatego w zespole lepiej zapisać reguły końców linii w .gitattributes (eol), zamiast polegać tylko na ustawieniu core.autocrlf na każdym komputerze.
- Ścieżki ze spacjami. C:\Program Files i podobne ścieżki zawsze biorę w cudzysłów, także w skryptach hooków. W plikach JSON ukośnik wsteczny piszę podwójnie.
- Cudzysłowy w powłokach. PowerShell traktuje tekst w apostrofach dosłownie, a w cudzysłowach podstawia zmienne. Przy błędzie polecenia najpierw sprawdzam, która powłoka je wykonała.
Typowe problemy z Claude Code na Windows i rozwiązania
Typowe problemy po instalacji Claude Code to ścieżka PATH, pomylona powłoka albo nieznaleziony Git Bash. Przypadki z dokumentacji Anthropic:
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| „claude is not recognized” po instalacji | katalog %USERPROFILE%\.local\bin nie jest w PATH | dopisać go do PATH i otworzyć nowe okno terminala |
| „irm is not recognized” albo błąd przy && | polecenie dla innej powłoki | użyć instalatora dla otwartej powłoki: PowerShell albo CMD |
| „running scripts is disabled on this system” | zasady wykonywania PowerShell blokują skrypty npm | Set-ExecutionPolicy RemoteSigned dla bieżącego użytkownika albo instalator natywny |
| Claude Code nie znajduje Git Bash | Git poza domyślnym miejscem i poza PATH | ścieżka do bin\bash.exe w CLAUDE_CODE_GIT_BASH_PATH |
| „does not support 32-bit Windows” | uruchomiony Windows PowerShell (x86) | otworzyć Windows PowerShell bez dopisku x86 |
| „The process cannot access the file” przy instalacji | drugi instalator albo antywirus blokuje pobrany plik | usunąć %USERPROFILE%\.claude\downloads i powtórzyć |
Gdy problem dotyczy całego zespołu, pomagam w ramach pomocy z Claude i ChatGPT, według stawki 150 do 200 zł netto za godzinę. Wspólną konfigurację repozytorium opisuje strona Claude Code w firmie.
Źródła
Opis opieram na poniższych źródłach. Przepisy, dokumentacja producentów i warunki usług się zmieniają, więc szczegóły warto sprawdzić u źródła:
- Advanced setup (Anthropic)
- Troubleshoot installation and login (Anthropic)
- Settings files and precedence (Anthropic)
- Deploy managed settings (Anthropic)
- Use Claude Code in VS Code (Anthropic)
Najczęstsze pytania
Czy Claude Code działa na Windows bez WSL?
Tak, Claude Code działa natywnie w Windows 10 w wersji 1809 lub nowszej i w Windows Server 2019 lub nowszym. WSL 2 przydaje się przy narzędziach linuksowych albo gdy potrzebna jest piaskownica poleceń, której natywny Windows nie obsługuje.
Czy do Claude Code na Windows potrzebny jest Git?
Nie, Git for Windows jest opcjonalny, choć dokumentacja Anthropic go zaleca. Daje Git Bash, którego Claude Code używa w narzędziu Bash. Bez niego polecenia wykonuje PowerShell.
Gdzie jest folder .claude na Windows?
Folder użytkownika to %USERPROFILE%\.claude, zwykle C:\Users\nazwa\.claude. Ustawienia projektu leżą w katalogu .claude w repozytorium, a inne miejsce dla plików użytkownika wskażesz zmienną CLAUDE_CONFIG_DIR.
Jak zaktualizować Claude Code na Windows?
Instalacja natywna aktualizuje się sama w tle, a od razu zrobisz to poleceniem claude update. Wersję z WinGet domyślnie aktualizujesz ręcznie poleceniem winget upgrade Anthropic.ClaudeCode. Według dokumentacji może się to nie udać przy działającym Claude Code, bo Windows blokuje plik programu.
Powiązane strony
Zespół pracuje na Windows i zaczyna z Claude Code?
Napisz, na jakim stosie pracujecie i czy korzystacie z WSL. Pomogę ustawić instalację, powłokę i wspólną konfigurację repozytorium.