Claude Code na Windows i WSL, instalacja krok po kroku 2026

Spis treści

• WSL2 vs natywny Windows
• Instalacja WSL2 Ubuntu
• Instalacja Claude Code w WSL
• Typowe problemy WSL
• VS Code i Claude Code w WSL
• FAQ

Claude Code na Windows działa, ale z ograniczeniami. PATH issues, CRLF line endings, bash komendy zachowują się dziwnie. Rekomendowane podejście to WSL2 z Ubuntu, daje pełnoprawne środowisko Linux w Windowsie. Poniżej krok po kroku setup + typowe problemy.

WSL2 vs natywny Windows

Porównanie środowisk dla Claude Code na Windows

Aspekt	WSL2 Ubuntu (rekomendowane)	Natywny Windows
Bash komendy	Pełne wsparcie	PowerShell, niektóre nie działają
Linux tooling (npm, git)	Natywne	Wymaga oddzielnej instalacji
Performance filesystem	Bardzo dobre w ~/	OK ale CRLF issues
RAM usage	3-8GB VM overhead	Minimum
Setup time	15-20 minut	5 minut
Docker	Działa świetnie	Wymaga Docker Desktop (płatne dla firm)

Instalacja WSL2 Ubuntu krok po kroku

1. Otwórz PowerShell jako Administrator (Win+X, Windows Terminal (Admin))
2. Wpisz wsl --install. Zainstaluje WSL2 + Ubuntu default
3. Restart Windowsa
4. Po restarcie, Ubuntu uruchomi się automatycznie. Ustaw username (małe litery, bez spacji) i password
5. Update Ubuntu: sudo apt update && sudo apt upgrade -y
6. Zainstaluj Node.js 22 LTS:

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt-get install -y nodejs
   node --version  # v22.x.x

7. Zainstaluj git (jeśli brak): sudo apt install git

Instalacja Claude Code w WSL

# W terminalu Ubuntu (nie w PowerShell!)
npm install -g @anthropic-ai/claude-code
claude --version

# Konfiguracja API key
echo 'export ANTHROPIC_API_KEY=sk-ant-xxx' >> ~/.bashrc
source ~/.bashrc

# Test
mkdir test-claude && cd test-claude
claude

Jeśli pojawi się prompt Claude, działa. Wpisz prosty task: "Stwórz hello.py który wypisze Cześć Świecie" żeby zweryfikować end-to-end.

Typowe problemy WSL

npm install permission denied

Nie używaj sudo. Skonfiguruj npm na własny katalog:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

WSL nie widzi internetu / proxy

Jeśli firma używa proxy, ustaw w WSL:

export HTTPS_PROXY=http://proxy.firma.pl:8080
export HTTP_PROXY=http://proxy.firma.pl:8080
npm config set proxy http://proxy.firma.pl:8080

Slow filesystem performance

Nie pracuj w /mnt/c/ (Windows mounted filesystem). Trzymaj projekty w Linux filesystem (~/projects/). Różnica performance: 10× szybsze na małych plikach (Node modules!).

WSL zużywa za dużo RAM

Stwórz %UserProfile%\.wslconfig w Windows:

[wsl2]
memory=8GB
processors=4
swap=4GB

Restart: wsl --shutdown.

VS Code i Claude Code w WSL

Idealny setup: VS Code w Windows + WSL extension + Claude Code w embedded terminalu.

1. Zainstaluj VS Code na Windows (windowsowa instalacja, NIE w WSL)
2. Zainstaluj WSL extension (Microsoft) w VS Code marketplace
3. W terminalu Ubuntu, w folderze projektu: code . otwiera VS Code z folderem WSL
4. Otwórz integrated terminal w VS Code (Ctrl+`) - uruchamia bash w WSL
5. Wpisz claude - sesja Claude Code w VS Code, plnie zintegrowana z plikami

Ten setup daje: Windows desktop UX + Linux dev tools + VS Code IDE features + Claude Code agent w terminalu. Standardowy stack polskiego mid-deva 2026.

Najczęściej zadawane pytania

Powiązane artykuły

Claude Code•9 min

Claude Code cena 2026, ile kosztuje i czy jest darmowy

Claude Code cena w PLN i USD, plany Pro i Max, API pay-as-you-go, darmowe kredyty i alternatywy. Najtańsza legalna ścieżka. Stan maj 2026.

Czytaj

Claude Code•9 min

Claude Max plan po polsku, ceny i limity 2026

Plan Claude Max po polsku: ceny Max 5x i 20x, ile zapytań daje, Claude Pro vs Max, Max vs API. Limity sesji i tygodniowe. Stan maj 2026, dla kogo warto.

Czytaj

Claude Code•15 min

Claude Code Skills po polsku, tutorial Agent Skills 2026

Pierwszy polski tutorial Agent Skills w Claude Code. SKILL.md, frontmatter, progressive disclosure, jak tworzyć skille krok po kroku, vs subagents i MCP.

Czytaj