Claude Code CLI : La Référence Technique Définitive
Mis à jour le 12 décembre 2025
Mise à jour de décembre 2025 : Claude Code alimente désormais les workflows d'ingénierie d'entreprise avec l'édition agentique multi-fichiers, l'intégration du protocole MCP avec plus de 300 services externes, des sous-agents spécialisés pour les tâches complexes, et un système de hooks pour l'automatisation CI/CD. Le système de permissions permet des contrôles de sécurité granulaires. La commutation de modèle entre Haiku (rapide/économique) et Opus (puissant) optimise les compromis coût-performance.
J'ai passé des mois à pousser Claude Code à ses limites à travers des bases de code en production, des pipelines CI/CD et des déploiements entreprise. Ce guide distille cette expérience en la référence complète que j'aurais aimé avoir quand j'ai commencé. Il couvre tout, de la première installation aux patterns avancés que la plupart des utilisateurs ne découvrent jamais.
Claude Code n'est pas une interface de chat qui connaît la programmation par hasard. C'est un système agentique qui lit votre base de code, exécute des commandes, modifie des fichiers, gère les workflows git, se connecte à des services externes, et délègue des tâches complexes à des sous-agents spécialisés—le tout via une interface en ligne de commande qui s'intègre à la façon dont les développeurs travaillent réellement.
La différence entre utiliser Claude Code de manière occasionnelle et l'utiliser efficacement réside dans la compréhension de son architecture : la hiérarchie de configuration qui contrôle le comportement, le système de permissions qui régit les opérations, le système de hooks qui permet l'automatisation déterministe, le protocole MCP qui étend les capacités, et le système de sous-agents qui gère les tâches complexes multi-étapes. Maîtrisez ces systèmes et Claude Code devient un multiplicateur de force. Manquez-les et vous laissez la majorité de la valeur sur la table.
Ce guide suppose que vous êtes à l'aise avec les outils en ligne de commande et que vous voulez le tableau complet. Chaque fonctionnalité est documentée avec la syntaxe réelle, des exemples de configuration concrets, et les cas limites qui piègent les utilisateurs expérimentés. Que vous configuriez votre premier projet ou déployiez à travers une organisation d'ingénierie d'entreprise, l'information est ici.
Comment Fonctionne Claude Code : Le Modèle Mental
Avant de plonger dans les fonctionnalités, comprenez comment l'architecture de Claude Code façonne tout ce que vous faites avec. Le système opère en trois couches :
┌─────────────────────────────────────────────────────────┐
│ COUCHES CLAUDE CODE │
├─────────────────────────────────────────────────────────┤
│ COUCHE D'EXTENSION │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MCP │ │ Hooks │ │ Skills │ │ Plugins │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ Outils externes, automatisation déterministe, expertise│
│ domaine, extensions packagées │
├─────────────────────────────────────────────────────────┤
│ COUCHE DE DÉLÉGATION │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Sous-agents (jusqu'à 10 en parallèle) │ │
│ │ Explore | Plan | General-purpose | Custom │ │
│ └─────────────────────────────────────────────────┘ │
│ Contextes isolés pour travail ciblé, renvoie résumés │
├─────────────────────────────────────────────────────────┤
│ COUCHE PRINCIPALE │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Contexte de Conversation Principal │ │
│ │ Outils: Read, Edit, Bash, Glob, Grep, etc. │ │
│ └─────────────────────────────────────────────────┘ │
│ Votre interaction principale; contexte limité; coûte │
└─────────────────────────────────────────────────────────┘
Couche Principale : Votre conversation principale. Chaque message, lecture de fichier et sortie d'outil consomme du contexte d'une fenêtre partagée de 200K tokens (1M avec premium). Quand le contexte se remplit, Claude perd la trace des décisions antérieures et la qualité se dégrade. Cette couche coûte de l'argent par token.
Couche de Délégation : Les sous-agents démarrent avec des contextes propres, font un travail ciblé, et renvoient des résumés. Les résultats d'exploration ne gonflent pas votre conversation principale—seules les conclusions reviennent. Utilisez les sous-agents Haiku pour l'exploration (économique, rapide) et Sonnet pour l'implémentation.
Couche d'Extension : MCP connecte des services externes (bases de données, GitHub, Sentry). Les hooks garantissent l'exécution de commandes shell indépendamment du comportement du modèle. Les skills encodent l'expertise domaine que Claude applique automatiquement. Les plugins packagent tout cela pour la distribution.
L'insight clé : La plupart des utilisateurs travaillent entièrement dans la Couche Principale, regardant le contexte gonfler et les coûts grimper. Les utilisateurs avancés poussent l'exploration et le travail spécialisé vers la Couche de Délégation, gardent la Couche d'Extension configurée pour leur workflow, et utilisent la Couche Principale uniquement pour l'orchestration et les décisions finales.
Table des Matières
- Installation et Authentification
- Modes d'Interaction Principaux
- Plongée Profonde dans le Système de Configuration
- Sélection et Changement de Modèle
- Système de Permissions et Sécurité
- Système de Hooks
- MCP (Model Context Protocol)
- Sous-agents et Délégation de Tâches
- Mode Extended Thinking
- Styles de Sortie
- Commandes Slash
- Skills
- Système de Plugins
- Gestion de la Mémoire et du Contexte
- Images et Entrées Multimodales
- Intégration Git et Workflows
- Intégration IDE
- Patterns d'Utilisation Avancés
- Claude Code Remote
- Background Agents
- Gestion des Coûts et Facturation
- Optimisation des Performances
- Dépannage et Débogage
- Déploiement Entreprise
- Référence des Raccourcis Clavier
- Bonnes Pratiques
Installation et Authentification
Configuration Système Requise
Claude Code fonctionne sur macOS 10.15+, Ubuntu 20.04+/Debian 10+, et Windows 10+ via WSL ou Git Bash. Le système nécessite un minimum de 4 Go de RAM et une connexion internet active. La compatibilité shell fonctionne mieux avec Bash, Zsh ou Fish.
Pour Windows, WSL 1 et WSL 2 fonctionnent tous deux. Git Bash fonctionne également si vous préférez Windows natif. Alpine Linux et autres systèmes basés sur musl nécessitent des packages supplémentaires :
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
Méthodes d'Installation
Installation native (recommandée)
Le binaire natif offre l'expérience la plus propre sans dépendance Node.js :
# macOS et Linux
curl -fsSL https://claude.ai/install.sh | bash
# Alternative Homebrew
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Pour une installation de version spécifique :
# Installer une version spécifique
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
# Installer la dernière explicitement
curl -fsSL https://claude.ai/install.sh | bash -s latest
# Windows PowerShell - version spécifique
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Installation NPM
Pour les environnements où npm est préféré :
npm install -g @anthropic-ai/claude-code
N'utilisez jamais sudo avec l'installation npm—cela crée des problèmes de permissions qui compliquent tout en aval.
Migration depuis une installation existante
Si vous avez une ancienne installation basée sur npm, migrez vers le binaire natif :
claude install
Options d'Authentification
Claude Code supporte trois chemins d'authentification, chacun avec des compromis différents :
Claude Console (facturation API)
Connectez-vous directement à l'API d'Anthropic via console.anthropic.com. Créez un compte, configurez la facturation, et authentifiez-vous via le CLI. Cela fournit une facturation à l'usage avec un accès API complet. Un workspace "Claude Code" dédié est créé automatiquement—vous ne pouvez pas créer de clés API pour ce workspace, mais vous pouvez surveiller l'utilisation.
Abonnement Claude Pro ou Max
Utilisez vos identifiants de compte claude.ai. L'abonnement couvre à la fois l'interface web et l'utilisation CLI sous un seul plan mensuel. Cela simplifie la facturation pour les utilisateurs individuels qui veulent des coûts prévisibles.
Plateformes entreprise
AWS Bedrock, Google Vertex AI et Microsoft Foundry fournissent chacun un accès de qualité entreprise avec des relations de facturation cloud existantes :
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project
# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optionnel: auth par clé API (sinon utilise Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key
Pour les déploiements entreprise derrière des proxies ou via des passerelles LLM :
# Proxy d'entreprise
export HTTPS_PROXY='https://proxy.example.com:8080'
# Passerelle LLM (ignorer l'auth native)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
Vérification
claude doctor
Cela rapporte le type d'installation, la version, la configuration système, et tout problème détecté.
Mises à Jour
Claude Code se met à jour automatiquement par défaut, vérifiant au démarrage et périodiquement pendant les sessions. Les mises à jour se téléchargent en arrière-plan et s'appliquent au prochain lancement.
Désactiver les mises à jour automatiques :
export DISABLE_AUTOUPDATER=1
Ou dans settings.json :
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Mise à jour manuelle :
claude update
Désinstallation
Installation native (macOS/Linux/WSL) :
rm -f ~/.local/bin/claude
rm -rf ~/.claude-code
Installation native (Windows PowerShell) :
Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force
Nettoyer la configuration (supprime tous les paramètres) :
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json
Modes d'Interaction Principaux
REPL Interactif
Lancez Claude Code sans arguments pour entrer dans la boucle interactive lecture-évaluation-impression :
cd your-project
claude
Le REPL maintient le contexte de conversation entre les tours. Tapez directement vos requêtes, recevez les réponses, et continuez jusqu'à ce que vous quittiez avec /exit ou Ctrl+D.
Commencez avec un prompt initial pour orienter la session :
claude "explique le flux d'authentification dans ce projet"
Astuce d'expert : Le REPL persiste l'état à travers les événements de compaction. Quand le contexte devient trop grand, Claude résume automatiquement la conversation ancienne tout en préservant les décisions clés et les extraits de code. Vous pouvez déclencher cela manuellement avec /compact ou ajouter des instructions personnalisées pour ce qu'il faut préserver.
Mode Non-Interactif
Le mode print (-p) exécute une seule requête et quitte :
# Requête directe
claude -p "liste tous les commentaires TODO dans ce projet"
# Traiter l'entrée pipée
cat error.log | claude -p "identifie la cause racine de ces échecs"
# Chaîner avec d'autres outils
claude -p "génère un README" > README.md
Pour une sortie structurée adaptée au parsing dans les scripts :
claude -p "compte les lignes par type de fichier" --output-format json
La sortie JSON inclut tout ce dont vous avez besoin pour l'automatisation :
{
"type": "result",
"subtype": "success",
"total_cost_usd": 0.0034,
"is_error": false,
"duration_ms": 2847,
"duration_api_ms": 1923,
"num_turns": 4,
"result": "Texte de réponse ici...",
"session_id": "abc-123-d
[Contenu tronqué pour la traduction]
