---
title: "Claude Code na Windows: instalacja, WSL i konfiguracja"
url: "https://szymonlakomy.pl/claude-code-na-windows"
description: "Claude Code na Windows: instalacja natywna, przez WinGet albo w WSL, powłoka Git Bash lub PowerShell, folder %USERPROFILE%\\.claude i typowe błędy."
updated: "2026-11-14"
author: "Szymon Łakomy"
language: "pl"
---

[Strona główna](https://szymonlakomy.pl/) [Claude Code w firmie](https://szymonlakomy.pl/claude-code-w-firmie) Claude Code na Windows

# 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](https://szymonlakomy.pl/o-mnie). Aktualizacja: 14 listopada 2026

**Claude Code na Windows** działa natywnie w Windows 10 w wersji 1809 lub nowszej i w Windows Server 2019 lub nowszym, a także w WSL. Instalujesz go jednym poleceniem w PowerShell lub CMD, bez uprawnień administratora, albo przez WinGet. Git for Windows jest opcjonalny: daje Claude Code powłokę Bash, a bez niego polecenia wykonuje PowerShell. Ustawienia użytkownika leżą w %USERPROFILE%\.claude.

## 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](https://szymonlakomy.pl/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](https://szymonlakomy.pl/jak-napisac-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](https://szymonlakomy.pl/pomoc-z-claude-i-chatgpt), według stawki 150 do 200 zł netto za godzinę. Wspólną konfigurację repozytorium opisuje strona [Claude Code w firmie](https://szymonlakomy.pl/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](https://code.claude.com/docs/en/setup) (Anthropic)
- [Troubleshoot installation and login](https://code.claude.com/docs/en/troubleshoot-install) (Anthropic)
- [Settings files and precedence](https://code.claude.com/docs/en/settings) (Anthropic)
- [Deploy managed settings](https://code.claude.com/docs/en/managed-settings) (Anthropic)
- [Use Claude Code in VS Code](https://code.claude.com/docs/en/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

- [Claude Code w firmie](https://szymonlakomy.pl/claude-code-w-firmie)
- [Hooki w Claude Code](https://szymonlakomy.pl/hooki-w-claude-code)
- [Jak napisać CLAUDE.md](https://szymonlakomy.pl/jak-napisac-claude-md)
- [Claude Code czy Codex](https://szymonlakomy.pl/claude-code-czy-codex)
- [Pomoc z Claude i ChatGPT](https://szymonlakomy.pl/pomoc-z-claude-i-chatgpt)
- [Szkolenie z Claude dla zespołu](https://szymonlakomy.pl/szkolenie-z-claude-dla-zespolu)
- [Programista AI na zlecenie](https://szymonlakomy.pl/programista-ai-na-zlecenie)

## 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.

[Bezpłatna wycena](https://szymonlakomy.pl/kontakt?temat=ai) [697 322 226](tel:697322226) [LinkedIn](https://www.linkedin.com/in/szymon-%C5%82akomy-7a1192361/)
