​
Configuration système requise

  • Systèmes d’exploitation : macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows via WSL
  • Matériel : 4 Go de RAM minimum
  • Logiciels :
    • Node.js 18+
    • git 2.23+ (optionnel)
    • CLI GitHub ou GitLab pour les flux de travail PR (optionnel)
  • Réseau : Connexion Internet requise pour l’authentification et le traitement IA
  • Localisation : Disponible uniquement dans les pays pris en charge

​
Installer et authentifier

1

Installer Claude Code

Install NodeJS 18+, then run:

npm install -g @anthropic-ai/claude-code

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Naviguer vers votre projet

cd votre-répertoire-projet
3

Démarrer Claude Code

claude
4

Terminer l'authentification

Claude Code offre plusieurs options d’authentification :

  1. Console Anthropic : L’option par défaut. Connectez-vous via la Console Anthropic et terminez le processus OAuth. Nécessite une facturation active sur console.anthropic.com.
  2. Application Claude (avec plan Pro ou Max) : Abonnez-vous au plan Pro ou Max de Claude pour un abonnement unifié qui inclut à la fois Claude Code et l’interface web. Obtenez plus de valeur au même prix tout en gérant votre compte en un seul endroit. Connectez-vous avec votre compte Claude.ai. Lors du lancement, choisissez l’option qui correspond à votre type d’abonnement.
  3. Plateformes d’entreprise : Configurez Claude Code pour utiliser Amazon Bedrock ou Google Vertex AI pour les déploiements d’entreprise avec votre infrastructure cloud existante.

​
Initialiser votre projet

Pour les nouveaux utilisateurs, nous recommandons :

1

Démarrer Claude Code

claude
2

Exécuter une commande simple

> résumer ce projet
3

Générer un guide de projet CLAUDE.md

/init
4

Valider le fichier CLAUDE.md généré

Demandez à Claude de valider le fichier CLAUDE.md généré dans votre dépôt.

​
Dépannage

​
Dépannage de l’installation WSL

Actuellement, Claude Code ne fonctionne pas directement sous Windows et nécessite WSL.

Vous pourriez rencontrer les problèmes suivants dans WSL :

Problèmes de détection OS/plateforme : Si vous recevez une erreur lors de l’installation, WSL pourrait utiliser le npm de Windows. Essayez :

  • Exécutez npm config set os linux avant l’installation
  • Installez avec npm install -g @anthropic-ai/claude-code --force --no-os-check (N’utilisez PAS sudo)

Erreurs Node introuvable : Si vous voyez exec: node: not found lors de l’exécution de claude, votre environnement WSL pourrait utiliser une installation Windows de Node.js. Vous pouvez le confirmer avec which npm et which node, qui devraient pointer vers des chemins Linux commençant par /usr/ plutôt que /mnt/c/. Pour corriger cela, essayez d’installer Node via le gestionnaire de paquets de votre distribution Linux ou via nvm.

​
Optimiser la configuration de votre terminal

Claude Code fonctionne mieux lorsque votre terminal est correctement configuré. Suivez ces directives pour optimiser votre expérience.

Shells pris en charge :

  • Bash
  • Zsh
  • Fish

​
Thèmes et apparence

Claude ne peut pas contrôler le thème de votre terminal. Cela est géré par votre application de terminal. Vous pouvez faire correspondre le thème de Claude Code à votre terminal lors de l’intégration ou à tout moment via la commande /config

​
Sauts de ligne

Vous avez plusieurs options pour saisir des sauts de ligne dans Claude Code :

  • Échappement rapide : Tapez \ suivi d’Entrée pour créer une nouvelle ligne
  • Raccourci clavier : Appuyez sur Option+Entrée (Meta+Entrée) avec une configuration appropriée

Pour configurer Option+Entrée dans votre terminal :

Pour Mac Terminal.app :

  1. Ouvrez Réglages → Profils → Clavier
  2. Cochez “Utiliser Option comme touche Meta”

Pour iTerm2 et le terminal VSCode :

  1. Ouvrez Réglages → Profils → Touches
  2. Sous Général, définissez la touche Option Gauche/Droite sur “Esc+”

Astuce pour les utilisateurs iTerm2 et VSCode : Exécutez /terminal-setup dans Claude Code pour configurer automatiquement Shift+Entrée comme alternative plus intuitive.

​
Configuration des notifications

Ne manquez jamais quand Claude termine une tâche avec une configuration de notification appropriée :

​
Notifications de sonnerie du terminal

Activez les alertes sonores lorsque les tâches se terminent :

claude config set --global preferredNotifChannel terminal_bell

Pour les utilisateurs macOS : N’oubliez pas d’activer les permissions de notification dans Réglages Système → Notifications → [Votre Application Terminal].

​
Notifications système iTerm 2

Pour les alertes iTerm 2 lorsque les tâches se terminent :

  1. Ouvrez les Préférences iTerm 2
  2. Naviguez vers Profils → Terminal
  3. Activez “Silence bell” et Filtrer les Alertes → “Envoyer les alertes générées par séquence d’échappement”
  4. Définissez votre délai de notification préféré

Notez que ces notifications sont spécifiques à iTerm 2 et ne sont pas disponibles dans le Terminal macOS par défaut.

​
Gestion des entrées volumineuses

Lors du travail avec du code étendu ou de longues instructions :

  • Évitez le collage direct : Claude Code peut avoir des difficultés avec du contenu collé très long
  • Utilisez des flux de travail basés sur des fichiers : Écrivez le contenu dans un fichier et demandez à Claude de le lire
  • Soyez conscient des limitations de VS Code : Le terminal VS Code est particulièrement sujet à tronquer les longs collages

​
Mode Vim

Claude Code prend en charge un sous-ensemble de raccourcis clavier Vim qui peuvent être activés avec /vim ou configurés via /config.

Le sous-ensemble pris en charge inclut :

  • Changement de mode : Esc (vers NORMAL), i/I, a/A, o/O (vers INSERT)
  • Navigation : h/j/k/l, w/e/b, 0/$/^, gg/G
  • Édition : x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (répéter)