Installer et configurer Claude Code - guide par terminal et plateforme

Ce que couvre cet article

Claude Code est l’interface en ligne de commande (CLI) d’Anthropic pour le développement assisté par IA. Lancé en 2025 et devenu un outil de référence en 2026, il s’installe en une commande sur macOS, Linux et Windows. Cet article détaille les étapes d’installation par plateforme, les options de configuration selon votre terminal, et les réglages essentiels pour adapter Claude Code à votre workflow quotidien.

Toutes les informations proviennent de la documentation officielle Anthropic, vérifiées en avril 2026.

Prérequis système

Avant d’installer Claude Code, vérifiez que votre machine répond à ces exigences minimales :

• Systèmes d’exploitation : macOS 13.0+, Windows 10 1809+ (ou Server 2019+), Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
• RAM : 4 Go minimum
• Réseau : connexion internet permanente requise
• Shells supportés : Bash, Zsh, PowerShell ou CMD
• Windows uniquement : Git for Windows est obligatoire

Un compte Anthropic est nécessaire : Claude Pro, Max, Team, Enterprise ou Console (accès API avec crédits prépayés). Le plan gratuit Claude.ai n’inclut pas l’accès à Claude Code. Les fournisseurs cloud Amazon Bedrock, Google Vertex AI et Microsoft Foundry sont aussi supportés.

Installation par plateforme

macOS et Linux (méthode recommandée)

L’installateur natif est la méthode recommandée. Il télécharge le binaire, l’installe dans ~/.local/bin/claude et configure votre PATH automatiquement :

curl -fsSL https://claude.ai/install.sh | bash

Pour installer une version spécifique ou le canal stable (version décalée d’environ une semaine, qui évite les régressions majeures) :

# Canal stable
curl -fsSL https://claude.ai/install.sh | bash -s stable

# Version spécifique
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Les installations natives se mettent à jour automatiquement en arrière-plan. La nouvelle version prend effet au prochain lancement de session.

Windows - PowerShell

Depuis PowerShell (pas besoin de droits administrateur) :

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

Si vous voyez l’erreur “The token ‘&&’ is not a valid statement separator”, vous êtes dans PowerShell alors que vous avez tapé une commande CMD. Votre invite affiche PS C:\ quand vous êtes dans PowerShell.

Windows - CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows - WSL

WSL 1 et WSL 2 sont supportés. WSL 2 supporte en plus le sandboxing pour une sécurité renforcée. Dans WSL, utilisez la commande macOS/Linux (curl).

Alternatives : Homebrew et WinGet

Deux gestionnaires de paquets sont supportés, mais sans mise à jour automatique :

# Homebrew (macOS/Linux)
brew install --cask claude-code
brew upgrade claude-code  # mise à jour manuelle

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode  # mise à jour manuelle

L’installation npm (npm install -g @anthropic-ai/claude-code) est dépréciée depuis 2026. Elle nécessite Node.js 18+ et ne bénéficie pas des mises à jour automatiques. Anthropic recommande de migrer vers l’installateur natif.

Authentification et premier lancement

Après installation, ouvrez un nouveau terminal (pour que le PATH soit mis à jour) et lancez :

claude

Au premier lancement, Claude Code ouvre votre navigateur par défaut pour l’authentification. Connectez-vous avec votre compte Anthropic et autorisez le CLI. Les identifiants sont stockés localement et persistent entre les sessions.

Pour vérifier votre installation et diagnostiquer d’éventuels problèmes :

# Version installée
claude --version

# Diagnostic complet
claude doctor

# Statut d'authentification
claude auth status

La commande claude doctor détecte automatiquement la plupart des problèmes de configuration (PATH, permissions, connectivité) et propose des corrections.

Flags CLI essentiels

Claude Code accepte de nombreux flags en ligne de commande. Voici les plus utilisés au quotidien :

Commandes de base

Commande	Description
claude	Démarrer une session interactive
claude "requête"	Session interactive avec prompt initial
claude -p "requête"	Mode non-interactif : réponse puis exit
claude -c	Reprendre la dernière conversation du répertoire courant
claude -r "nom"	Reprendre une session par ID ou nom
claude update	Forcer la mise à jour immédiate

Configuration de session

Flag	Valeurs	Exemple
--model	sonnet, opus, haiku ou nom complet	claude --model opus
--permission-mode	default, acceptEdits, plan, auto, dontAsk, bypassPermissions	claude --permission-mode plan
--effort	low, medium, high, max	claude --effort high
--output-format	text, json, stream-json	claude -p --output-format json "requête"
--tools	Liste d’outils autorisés	claude --tools "Bash,Edit,Read"
--worktree	Nom du worktree Git	claude -w feature-auth

Personnalisation du prompt système

Flag	Effet
--system-prompt "texte"	Remplace entièrement le prompt système par défaut
--append-system-prompt "texte"	Ajoute du texte à la fin du prompt par défaut (recommandé)
--system-prompt-file chemin	Charge le prompt depuis un fichier
--bare	Mode minimal : ignore hooks, skills, plugins, MCP, CLAUDE.md

Pour la plupart des usages, préférez --append-system-prompt qui conserve les capacités natives de Claude Code tout en ajoutant vos instructions.

Configuration selon le terminal

Claude Code s’adapte à votre terminal, mais certains réglages améliorent l’expérience selon l’émulateur utilisé.

Thème et apparence

Claude Code ne contrôle pas le thème de votre terminal - c’est votre émulateur qui le gère. En revanche, vous pouvez synchroniser le thème de Claude Code (clair ou sombre) avec celui de votre terminal via la commande /config dans une session interactive.

Saut de ligne (Shift+Enter)

Pour saisir des prompts multiligne, plusieurs options existent :

Méthode	Terminaux compatibles
Shift+Enter natif	iTerm2, WezTerm, Ghostty, Kitty
/terminal-setup	VS Code, Alacritty, Zed, Warp (configuration automatique)
Ctrl+J	Tous les terminaux sans configuration
\ + Entrée	Tous les terminaux

La commande /terminal-setup n’apparaît que dans les terminaux qui nécessitent une configuration manuelle. Si vous utilisez iTerm2, WezTerm, Ghostty ou Kitty, elle n’est pas visible car Shift+Enter fonctionne déjà nativement.

Notifications de fin de tâche

Quand Claude termine son travail et attend votre input, il envoie une notification :

• Kitty et Ghostty : notifications bureau sans configuration supplémentaire
• iTerm2 : activer dans Settings > Profiles > Terminal > “Notification Center Alerts”, puis cocher “Send escape sequence-generated alerts”
• macOS Terminal.app : pas de support natif - utiliser un hook de notification
• tmux : ajouter set -g allow-passthrough on dans votre config pour que les notifications atteignent le terminal externe

Option+Enter (macOS)

Pour utiliser Option+Enter comme raccourci de saut de ligne :

• Terminal.app : Settings > Profiles > Keyboard > cocher “Use Option as Meta Key”
• iTerm2 : Settings > Profiles > Keys > General > Left/Right Option key > “Esc+”
• VS Code : ajouter "terminal.integrated.macOptionIsMeta": true dans les settings

Mode Vim

Claude Code supporte un sous-ensemble de raccourcis Vim activable via /config > Editor mode, ou en ajoutant "editorMode": "vim" dans ~/.claude.json. Les commandes supportées incluent : modes (Esc, i/I, a/A, o/O), navigation (h/j/k/l, w/e/b, 0/$), édition (x, dw/dd/D, cw/cc/C), yank/paste (yy, p/P) et text objects (iw/aw, i”/a”, i(/a().

Système de settings

Claude Code utilise un système de configuration hiérarchique à 4 niveaux (scopes). Chaque niveau surcharge le précédent :

Scope	Fichier	Portée	Partagé en équipe ?
Managed	Serveur / MDM / managed-settings.json	Tous les utilisateurs machine	Oui (déployé par IT)
User	~/.claude/settings.json	Vous, tous projets	Non
Project	.claude/settings.json	Tous les collaborateurs du repo	Oui (commité dans Git)
Local	.claude/settings.local.json	Vous, ce repo uniquement	Non (gitignored)

Réglages les plus utiles

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "effortLevel": "high",
  "autoUpdatesChannel": "stable",
  "language": "french",
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  },
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

Parmi les clés disponibles :

• model : modèle par défaut (claude-sonnet-4-6, claude-opus-4-6)
• effortLevel : niveau d’effort persistant (low, medium, high)
• autoUpdatesChannel : canal de mise à jour (latest ou stable)
• language : langue de réponse (french, japanese, etc.)
• permissions : règles allow/deny pour contrôler les outils accessibles
• defaultMode : mode de permission par défaut au lancement
• alwaysThinkingEnabled : activer le mode réflexion étendue par défaut
• sandbox : configuration du sandboxing (isolation filesystem et réseau)

Fichiers CLAUDE.md

En complément des settings, Claude Code lit des fichiers CLAUDE.md qui lui donnent des instructions contextuelles :

Fichier	Portée	Usage
~/.claude/CLAUDE.md	Global	Conventions personnelles permanentes
CLAUDE.md (racine projet)	Projet	Standards projet, commandes build
CLAUDE.local.md	Machine	Préférences locales, chemins spécifiques

Ces fichiers sont injectés automatiquement dans le contexte de chaque conversation. Pour des instructions ponctuelles (workflow de déploiement, template de PR), utilisez plutôt les skills dans le dossier .claude/skills/.

Mises à jour et maintenance

Les installations natives se mettent à jour automatiquement en arrière-plan. Claude Code vérifie les mises à jour au démarrage et périodiquement pendant l’exécution.

Canaux de mise à jour

Canal	Comportement
latest (défaut)	Nouvelles fonctionnalités dès leur sortie
stable	Version décalée d’environ une semaine, évite les régressions majeures

Configurer le canal via /config > Auto-update channel, ou dans settings.json : "autoUpdatesChannel": "stable".

Pour désactiver les mises à jour automatiques, ajouter dans settings.json :

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Commandes de maintenance

# Mise à jour immédiate
claude update

# Diagnostic complet
claude doctor

# Vérifier la version
claude --version

Désinstallation

Si besoin, la désinstallation est propre :

# Installation native (macOS/Linux)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# Homebrew
brew uninstall --cask claude-code

# WinGet
winget uninstall Anthropic.ClaudeCode

# Supprimer la configuration (optionnel)
rm -rf ~/.claude
rm ~/.claude.json

Résolution de problèmes courants

Les problèmes les plus fréquents après installation :

• Commande introuvable : ouvrez un nouveau terminal pour charger le PATH mis à jour, ou ajoutez manuellement ~/.local/bin à votre fichier shell (~/.bashrc, ~/.zshrc)
• Git Bash introuvable (Windows) : dans settings.json, définir le chemin : "env": {"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"}
• Scintillement du terminal : activer le rendu plein écran avec CLAUDE_CODE_NO_FLICKER=1 dans la clé env de settings.json
• Alpine Linux : installer libgcc, libstdc++ et ripgrep, puis définir USE_BUILTIN_RIPGREP=0 dans settings.json

La commande claude doctor reste le premier réflexe : elle détecte et propose des corrections pour la majorité des problèmes de configuration.

Pour aller plus loin

Cet article couvre l’installation et la configuration de base. Claude Code offre de nombreuses fonctionnalités avancées : serveurs MCP pour étendre les capacités, hooks pour automatiser des actions, sous-agents pour paralléliser le travail, et un système de sandboxing pour isoler les commandes.

Pour une prise en main encadrée, Ocade Fusion propose des formations pratiques sur Claude Code et l’IA, de l’initiation à l’utilisation avancée en contexte professionnel.

Dernière mise à jour : avril 2026. Sources : documentation officielle Claude Code.