Claude Code na Windows: konfiguracja dla deweloperów

# Profesjonalna konfiguracja Claude Code na Windows: specyfika dla specjalistów IT

Instalacja Claude Code w systemie Windows wymaga uwzględnienia specyfiki tego systemu operacyjnego oraz integracji z narzędziami deweloperskimi. W tym artykule znajdziesz sprawdzone ustawienia do pracy z AWS, PowerShell i Git Bash bez błędów.

Przygotowanie środowiska

Aby Claude Code działał poprawnie, należy właściwie skonfigurować podstawowe komponenty. Zacznij od instalacji Git Bash — kluczowego elementu, ponieważ instalator Claude Code korzysta z niego do wykonywania poleceń:

winget install Git.Git

Podczas instalacji Git zachowaj wszystkie ustawienia domyślne, w tym integrację z Eksploratorami Windows i dodanie do PATH. Zwróć szczególną uwagę na PowerShell: w Windows domyślnie dostępna jest przestarzała wersja 5.1 na .NET Framework. Do nowoczesnych projektów wymagana jest PowerShell 7+:

winget install Microsoft.PowerShell

Po instalacji uruchamiaj dokładnie pwsh, a nie powershell.exe. Sprawdź wersję:

pwsh --version

Ważne: wszystkie kolejne polecenia muszą być wykonywane w PowerShell 7+. Dla wygody zaleca się korzystanie z Windows Terminal, który obsługuje równoległą pracę z różnymi powłokami.

Instalacja i uwierzytelnianie

Kluczowe cechy instalacji:

• Użyj oficjalnego skryptu:

irm https://claude.ai/install.ps1 | iex

• Alternatywna metoda przez WinGet wymaga ręcznej aktualizacji:

winget install Anthropic.ClaudeCode

• Aby wskazać konkretną wersję:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.105

Po instalacji sprawdź działanie:

claude --version
claude doctor

Jeśli pojawi się błąd command not found, dodaj ścieżkę ręcznie:

$userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
[Environment]::SetEnvironmentVariable("PATH", 
  "$userPath;$env:USERPROFILE\.local\bin", 
  "User")

Do uwierzytelniania:

• Większość użytkowników może uruchomić claude i zalogować się przez przeglądarkę
• Przy użyciu rozliczeń API ustaw klucz:

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-...", "User")

Konfiguracja pod specyfikę Windows

Rozwiązywanie problemów z PowerShell

Domyślnie Claude Code używa Git Bash, co powoduje konflikty z syntaksą PowerShell. Aby działał poprawnie, dodaj do %USERPROFILE%\.claude\settings.json:

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1",
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  },
  "defaultShell": "powershell"
}

To aktywuje:

• Automatyczne wykrywanie pwsh.exe
• Przekierowanie interaktywnych poleceń przez PowerShell
• Zachowanie Git Bash do operacji wewnętrznych

Praca ze ścieżkami i systemem plików

NTFS różni się zasadniczo od systemów plików Linux:

• Niewrażliwość na wielkość liter w nazwach plików
• Wymagania dotyczące uprawnień do linków symbolicznych
• Specyfika obsługi znaków nowej linii (CRLF vs LF)

Krytyczne ustawienia:

• Zawsze używaj ścieżek Windows z backslashami
• Do skryptów dodaj konwersję znaków nowej linii:

(Get-Content script.sh) -replace "`r`n", "`n" | Set-Content -NoNewline script.sh

• W globalnych instrukcjach (%USERPROFILE%\.claude\CLAUDE.md) podaj:

# File paths
- Use Windows paths: C:\\Users\\<user>\\projects\\...
- Do NOT use Unix paths

Integracja z usługami chmurowymi

AWS i PowerShell

Do pracy z AWS przez PowerShell:

• Zainstaluj AWS Tools for PowerShell
• Skonfiguruj profile w %USERPROFILE%\.aws\credentials
• W CLAUDE.md dodaj:

# Available tools
- Use aws-powershell for AWS operations
- Use SSM documents with PowerShell

Rozwiązywanie problemów z serwerami MCP

MCP używa Unix domain sockets, które nie są dostępne w Windows. Rozwiązanie obejściowe:

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:/Projects"]
    }
  }
}

Ważne:

• Używaj bezpośrednich ukośników w ścieżkach JSON
• Unikaj sztywno zdefiniowanych ścieżek Unix w kodzie serwerów
• Do plików tymczasowych jawnie podawaj ścieżki specyficzne dla Windows

Co ważne

• PowerShell 7+ jest obowiązkowy — wersja 5.1 nie obsługuje nowoczesnych scenariuszy
• Git Bash jest kluczowy — nawet przy pracy z PowerShell jest wymagany do operacji wewnętrznych
• Ścieżki w stylu Windows — Claude Code nie rozpoznaje ścieżek Unix i skrótów ~
• Problemy z MCP — wymagają ręcznej konfiguracji przez cmd /c dla Windows
• Znaki nowej linii — automatyczna konwersja CRLF→LF jest niezbędna dla skryptów

Wskazówki dla rosyjskich deweloperów

Od 2026 roku oficjalny dostęp do Claude Code w Rosji jest ograniczony. Zalecane rozwiązania:

• Korzystanie z kont firmowych przez dostawców chmurowych (AWS Bedrock)
• Konfiguracja serwerów proxy z uwierzytelnianiem
• Praca przez rozliczenia API z płatnością z góry
• Alternatywne serwery MCP z zlokalizowanymi ścieżkami

Ważne: przy użyciu klucza API upewnij się, że jest aktywny i powiązany z działającym kontem. Sprawdzaj status przez claude /status.

Podsumowanie

Instalacja Claude Code na Windows wymaga uwzględnienia trzech kluczowych aspektów: poprawnej konfiguracji PowerShell, adaptacji do specyfiki NTFS oraz rozwiązania problemów z serwerami MCP. Dla deweloperów AWS szczególnie ważne jest podanie poprawnych ścieżek w plikach konfiguracyjnych i zapewnienie konwersji znaków nowej linii. Przy spełnieniu tych warunków można osiągnąć wydajność porównywalną z środowiskiem Linux.

— Editorial Team