Claude Code sur Windows : configuration pour les développeurs

Configuration professionnelle de Claude Code sur Windows : Conseils clés pour les pros de l'IT

La configuration de Claude Code sur Windows nécessite de prendre en compte les spécificités du système d'exploitation et l'intégration avec les outils de développement. Cet article partage des configurations éprouvées pour travailler avec AWS, PowerShell et Git Bash sans erreurs.

Préparation de l'environnement

Pour que Claude Code fonctionne correctement, configurez convenablement les composants de base. Commencez par installer Git Bash — un composant critique, car l'installateur de Claude Code l'utilise pour exécuter les commandes :

winget install Git.Git

Lors de l'installation de Git, conservez tous les paramètres par défaut, y compris l'intégration avec l'Explorateur et l'ajout au PATH. Portez une attention particulière à PowerShell : Windows dispose par défaut d'une version obsolète 5.1 sur .NET Framework. Les projets modernes requièrent PowerShell 7+ :

winget install Microsoft.PowerShell

Après l'installation, lancez pwsh, et non powershell.exe. Vérifiez la version :

pwsh --version

Important : Toutes les commandes suivantes doivent être exécutées dans PowerShell 7+. Pour plus de commodité, utilisez Windows Terminal, qui permet de travailler en parallèle avec différents shells.

Installation et authentification

Principales fonctionnalités d'installation :

• Utilisez le script officiel :

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

• L'alternative WinGet nécessite des mises à jour manuelles :

winget install Anthropic.ClaudeCode

• Pour une version spécifique :

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

Après l'installation, vérifiez qu'elle fonctionne :

claude --version
claude doctor

Si vous obtenez une erreur command not found, ajoutez le chemin manuellement :

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

Pour l'authentification :

• Pour la plupart des utilisateurs, exécutez simplement claude et connectez-vous via le navigateur
• Pour la facturation API, définissez la clé :

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

Configuration spécifique à Windows

Résolution des problèmes PowerShell

Par défaut, Claude Code utilise Git Bash, ce qui provoque des conflits avec la syntaxe PowerShell. Pour un fonctionnement correct, ajoutez à %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"
}

Cela active :

• La détection automatique de pwsh.exe
• Le routage des commandes interactives via PowerShell
• La conservation de Git Bash pour les opérations internes

Travail avec les chemins et le système de fichiers

NTFS présente des différences fondamentales par rapport aux systèmes de fichiers Linux :

• Insensibilité à la casse pour les noms de fichiers
• Exigences de permissions pour les liens symboliques
• Particularités de gestion des fins de ligne (CRLF vs LF)

Paramètres critiques :

• Utilisez toujours les chemins Windows avec des barres obliques inversées
• Pour les scripts, ajoutez une conversion des fins de ligne :

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

• Dans les instructions globales (%USERPROFILE%\.claude\CLAUDE.md), spécifiez :

# Chemins de fichiers
- Utilisez les chemins Windows : C:\\Users\\<user>\\projects\\...
- N'utilisez PAS les chemins Unix

Intégration avec les services cloud

AWS et PowerShell

Pour travailler avec AWS via PowerShell :

• Installez AWS Tools for PowerShell
• Configurez les profils dans %USERPROFILE%\.aws\credentials
• Dans CLAUDE.md, ajoutez :

# Outils disponibles
- Utilisez aws-powershell pour les opérations AWS
- Utilisez les documents SSM avec PowerShell

Résolution des problèmes de serveur MCP

MCP utilise des sockets de domaine Unix, indisponibles sur Windows. Solution de contournement :

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

Important :

• Utilisez des barres obliques en avant dans les chemins JSON
• Évitez les chemins Unix codés en dur dans le code du serveur
• Pour les fichiers temporaires, spécifiez explicitement des chemins spécifiques à Windows

Points clés

• PowerShell 7+ est obligatoire — la version 5.1 ne prend pas en charge les scénarios modernes
• Git Bash est critique — même avec PowerShell, il est nécessaire pour les opérations internes
• Chemins au format Windows — Claude Code ne reconnaît pas les chemins Unix ni les raccourcis ~
• Problèmes MCP — nécessitent une configuration manuelle via cmd /c sur Windows
• Fins de ligne — la conversion automatique CRLF→LF est essentielle pour les scripts

Conseils pour les développeurs russes

À partir de 2026, l'accès officiel à Claude Code en Russie sera restreint. Solutions recommandées :

• Comptes d'entreprise via des fournisseurs cloud (AWS Bedrock)
• Serveurs proxy avec authentification
• Facturation API avec prépaiement
• Serveurs MCP alternatifs avec chemins localisés

Important : Avec une clé API, assurez-vous qu'elle est active et liée à un compte fonctionnel. Vérifiez le statut via claude /status.

Conclusion

La configuration de Claude Code sur Windows repose sur trois aspects clés : une configuration correcte de PowerShell, des adaptations NTFS et des correctifs pour les serveurs MCP. Pour les développeurs AWS, spécifier correctement les chemins dans les fichiers de configuration et gérer les fins de ligne est crucial. Suivez ces conseils, et vous obtiendrez des performances équivalentes à Linux.

— Editorial Team