Claude Code na Windows: nastavení pro vývojáře

Profesionální nastavení Claude Code na Windows: specifika pro IT specialisty

Instalace Claude Code ve Windows vyžaduje zohlednění specifik operního systému a integrace s nástroji pro vývoj. V tomto článku najdete ověřená nastavení pro práci s AWS, PowerShell a Git Bash bez chyb.

Příprava prostředí

Pro správný chod Claude Code je nutné správně nastavit základní komponenty. Začněte instalací Git Bash – klíčové komponenty, protože instalátor Claude Code ho používá k vykonávání příkazů:

winget install Git.Git

Při instalaci Git ponechte všechna nastavení podle výchozích hodnot, včetně integrace s Explorerem a přidání do PATH. Zvláštní pozornost věnujte PowerShellu: ve Windows je podle výchozích nastavení dostupná zastaralá verze 5.1 na .NET Framework. Pro moderní projekty je potřebný PowerShell 7+:

winget install Microsoft.PowerShell

Po instalaci spouštějte přesně pwsh, ne powershell.exe. Zkontrolujte verzi:

pwsh --version

Důležité: všechny následující příkazy proveďte v PowerShell 7+. Pro pohodlí doporučujeme Windows Terminal, který podporuje paralelní práci s různými shellovými prostředími.

Instalace a autentizace

Klíčové specifika instalace:

• Použijte oficiální skript:

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

• Alternativní metoda přes WinGet vyžaduje ruční aktualizaci:

winget install Anthropic.ClaudeCode

• Pro určení konkrétní verze:

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

Po instalaci zkontrolujte funkčnost:

claude --version
claude doctor

Pokud se objeví chyba command not found, přidejte cestu ručně:

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

Pro autentizaci:

• Většině uživatelů stačí spustit claude a přihlásit se přes prohlížeč
• Při použití API-bilingu nastavte klíč:

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

Nastavení podle specifik Windows

Řešení problémů s PowerShell

Claude Code podle výchozích nastavení používá Git Bash, což způsobuje konflikty s syntaxí PowerShell. Pro správný chod přidejte 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"
}

Toto aktivuje:

• Automatické rozpoznání pwsh.exe
• Přesměrování interaktivních příkazů přes PowerShell
• Zachování Git Bash pro interní operace

Práce s cestami a souborovým systémem

NTFS se zásadně liší od linuxových souborových systémů:

• Nereaguje na velikost písmen v názvech souborů
• Požadavky na práva pro symbolické odkazy
• Specifika zpracování přenosů řádků (CRLF vs LF)

Kritická nastavení:

• Vždy používejte Windows cesty s zpětnými lomítky
• Pro skripty přidejte převod přenosů řádků:

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

• V globálních instrukcích (%USERPROFILE%\.claude\CLAUDE.md) uveďte:

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

Integrace s cloudovými službami

AWS a PowerShell

Pro práci s AWS přes PowerShell:

• Nainstalujte AWS Tools for PowerShell
• Nastavte profily v %USERPROFILE%\.aws\credentials
• Do CLAUDE.md přidejte:

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

Řešení problémů s MCP servery

MCP používá Unix domain sockets, které nejsou ve Windows dostupné. Obchodní řešení:

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

Důležité:

• V JSON cestách používejte přímé lomítka
• Vyhněte se pevně daným Unix cestám v kódu serverů
• Pro dočasné soubory explicitně uveďte Windows-specifické cesty

Co je důležité

• PowerShell 7+ je povinný – verze 5.1 nepodporuje moderní scénáře
• Git Bash je kritický – i při práci s PowerShell je potřebný pro interní operace
• Cesty ve stylu Windows – Claude Code nerozpoznává Unix cesty a ~-zkratky
• Problémy s MCP – vyžadují ruční nastavení přes cmd /c pro Windows
• Přenosy řádků – automatická konverze CRLF→LF je nutná pro skripty

Specifika pro ruské vývojáře

Od roku 2026 je oficiální přístup k Claude Code v Rusku omezen. Doporučená řešení:

• Použití firemních účtů přes cloudové providery (AWS Bedrock)
• Nastavení proxy serverů s autentizací
• Práce přes API-billing s předem zaplacenou platbou
• Alternativní MCP servery s lokalizovanými cestami

Důležité: při použití API klíče se ujistěte, že je aktivní a vázaný na funkční účet. Zkontrolujte stav přes claude /status.

Závěr

Instalace Claude Code ve Windows vyžaduje zohlednění tří klíčových aspektů: správného nastavení PowerShell, adaptace na specifika NTFS a řešení problémů s MCP servery. Pro vývojáře AWS je zvláště kritické zadat správné cesty v konfiguračních souborech a zajistit konverzi přenosů řádků. Při dodržení těchto podmínek lze dosáhnout výkonu srovnatelného s linuxovým prostředím.

— Editorial Team