Przejdź do treści

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óbCo trzeba miećNa co uważać
Instalator natywny (PowerShell lub CMD)sam Windowsaktualizuje się w tle, bez piaskownicy poleceń
WinGetmenedżer pakietów WinGetdomyślnie bez automatycznych aktualizacji: winget upgrade Anthropic.ClaudeCode
WSL 2włączone WSL 2 i instalator linuksowy w WSLz piaskownicą poleceń, dla narzędzi linuksowych
WSL 1włączone WSL 1bez piaskownicy, gdy WSL 2 jest niedostępne
Aplikacja desktopinstalator ze strony ClaudeClaude Code bez terminala
Rozszerzenie VS CodeVS Code od wersji 1.94.0wł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 WindowsKogo dotyczy
Ustawienia użytkownika%USERPROFILE%\.claude\settings.jsonjedną osobę we wszystkich projektach
Ustawienia projektu.claude\settings.json w repozytoriumcały zespół
Ustawienia lokalne.claude\settings.local.json, poza gitemjedną osobę w jednym projekcie
Ustawienia zarządzaneC:\Program Files\ClaudeCode\managed-settings.json albo rejestr HKLM\SOFTWARE\Policies\ClaudeCodecałą firmę, wdrażane przez IT, na przykład przez Intune lub zasady grupy
CLAUDE.md organizacjiC:\Program Files\ClaudeCode\CLAUDE.mdcałą organizację, wdrażany przez IT
Program claude.exe%USERPROFILE%\.local\bininstalację 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:

ObjawPrzyczynaRozwiązanie
„claude is not recognized” po instalacjikatalog %USERPROFILE%\.local\bin nie jest w PATHdopisać go do PATH i otworzyć nowe okno terminala
„irm is not recognized” albo błąd przy &&polecenie dla innej powłokiużyć instalatora dla otwartej powłoki: PowerShell albo CMD
„running scripts is disabled on this system”zasady wykonywania PowerShell blokują skrypty npmSet-ExecutionPolicy RemoteSigned dla bieżącego użytkownika albo instalator natywny
Claude Code nie znajduje Git BashGit 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 instalacjidrugi instalator albo antywirus blokuje pobrany plikusunąć %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:

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.