Claude Code unter Windows: Einrichtung für Entwickler

Professionelle Claude-Code-Einrichtung unter Windows: Wichtige Tipps für IT-Profis

Die Einrichtung von Claude Code unter Windows erfordert die Berücksichtigung von Betriebssystemspezifika und die Integration in Entwicklungstools. Dieser Artikel teilt bewährte Konfigurationen zum fehlerfreien Arbeiten mit AWS, PowerShell und Git Bash.

Umgebungsvorbereitung

Damit Claude Code korrekt funktioniert, richten Sie die grundlegenden Komponenten richtig ein. Beginnen Sie mit der Installation von Git Bash – einer kritischen Komponente, da der Claude-Code-Installer diese zur Ausführung von Befehlen nutzt:

winget install Git.Git

Während der Git-Installation behalten Sie alle Standardeinstellungen bei, einschließlich der Explorer-Integration und dem Hinzufügen zum PATH. Achten Sie besonders auf PowerShell: Windows verwendet standardmäßig eine veraltete Version 5.1 auf .NET Framework. Moderne Projekte erfordern PowerShell 7+:

winget install Microsoft.PowerShell

Nach der Installation starten Sie pwsh, nicht powershell.exe. Überprüfen Sie die Version:

pwsh --version

Wichtig: Alle nachfolgenden Befehle müssen in PowerShell 7+ ausgeführt werden. Zur Bequemlichkeit verwenden Sie Windows Terminal, das parallele Arbeit mit verschiedenen Shells unterstützt.

Installation und Authentifizierung

Wichtige Installationsmerkmale:

• Verwenden Sie das offizielle Skript:

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

• Die WinGet-Alternative erfordert manuelle Updates:

winget install Anthropic.ClaudeCode

• Für eine bestimmte Version:

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

Nach der Installation prüfen Sie die Funktionalität:

claude --version
claude doctor

Bei einem command not found-Fehler fügen Sie den Pfad manuell hinzu:

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

Zur Authentifizierung:

• Für die meisten Nutzer reicht claude aus und die Anmeldung im Browser
• Für API-Abrechnung setzen Sie den Schlüssel:

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

Windows-spezifische Konfiguration

Behebung von PowerShell-Problemen

Standardmäßig verwendet Claude Code Git Bash, was zu Konflikten mit PowerShell-Syntax führt. Für den reibungslosen Betrieb fügen Sie in %USERPROFILE%\.claude\settings.json hinzu:

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

Dies aktiviert:

• Automatische Erkennung von pwsh.exe
• Weiterleitung interaktiver Befehle über PowerShell
• Beibehaltung von Git Bash für interne Operationen

Arbeiten mit Pfaden und Dateisystem

NTFS unterscheidet sich grundlegend von Linux-Dateisystemen:

• Groß-/Kleinschreibung für Dateinamen
• Berechtigungsanforderungen für symbolische Links
• Eigenheiten bei Zeilenenden (CRLF vs. LF)

Kritische Einstellungen:

• Verwenden Sie immer Windows-Pfade mit Backslashes
• Für Skripte Zeilenendkonvertierung hinzufügen:

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

• In globalen Anweisungen (%USERPROFILE%\.claude\CLAUDE.md) angeben:

# Dateipfade
- Verwenden Sie Windows-Pfade: C:\\Users\\<user>\\projects\\...
- Verwenden Sie KEINE Unix-Pfade

Integration mit Cloud-Diensten

AWS und PowerShell

Für AWS-Arbeiten über PowerShell:

• Installieren Sie AWS Tools for PowerShell
• Konfigurieren Sie Profile in %USERPROFILE%\.aws\credentials
• In CLAUDE.md hinzufügen:

# Verfügbare Tools
- Verwenden Sie aws-powershell für AWS-Operationen
- Verwenden Sie SSM-Dokumente mit PowerShell

Behebung von MCP-Server-Problemen

MCP verwendet Unix-Domain-Sockets, die unter Windows nicht verfügbar sind. Workaround:

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

Wichtig:

• Verwenden Sie Schrägstriche in JSON-Pfaden
• Vermeiden Sie hartcodierte Unix-Pfade im Servercode
• Für Temporärdateien explizit Windows-spezifische Pfade angeben

Wichtige Punkte

• PowerShell 7+ ist zwingend erforderlich – Version 5.1 unterstützt keine modernen Szenarien
• Git Bash ist entscheidend – auch mit PowerShell für interne Operationen notwendig
• Windows-Pfade – Claude Code erkennt keine Unix-Pfade oder ~-Abkürzungen
• MCP-Probleme – erfordern manuelle Einrichtung über cmd /c unter Windows
• Zeilenenden – automatische CRLF→LF-Konvertierung ist für Skripte essenziell

Tipps für russische Entwickler

Ab 2026 wird der offizielle Zugriff auf Claude Code in Russland eingeschränkt sein. Empfohlene Lösungen:

• Firmenkonten über Cloud-Provider (AWS Bedrock)
• Proxy-Server mit Authentifizierung
• API-Abrechnung mit Vorauszahlung
• Alternative MCP-Server mit lokalisierten Pfaden

Wichtig: Bei einem API-Schlüssel stellen Sie sicher, dass er aktiv ist und an ein funktionierendes Konto gebunden. Status prüfen über claude /status.

Fazit

Die Einrichtung von Claude Code unter Windows hängt von drei Schlüsselfaktoren ab: korrekter PowerShell-Konfiguration, NTFS-Anpassungen und MCP-Server-Behebungen. Für AWS-Entwickler ist die richtige Angabe von Pfaden in Konfigurationsdateien und die Handhabung von Zeilenenden entscheidend. Folgen Sie diesen Tipps, und Sie erreichen Linux-Niveau.

— Editorial Team