Installation de Claude Code

Claude Code est l'outil officiel d'Anthropic qui vous permet d'utiliser Claude directement dans votre environnement de développement. Il existe deux façons principales de l'utiliser : Claude Code CLI (interface en ligne de commande) et l'extension VS Code.

📋 Prérequis généraux

Avant de commencer, assurez-vous d'avoir :

Un compte Anthropic avec accès à l'API Claude
Une clé API valide (obtenue sur console.anthropic.com)
Node.js 18+ installé (requis pour CLI, recommandé pour VS Code)

🖥️ Option 1 : Claude Code CLI (Recommandé)

Le CLI est l'interface officielle en ligne de commande pour interagir avec Claude depuis votre terminal.

Installation du CLI

Méthode 1 : Via npm (Recommandé)

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

Méthode 2 : Via Homebrew (macOS/Linux)

brew tap anthropics/claude
brew install claude-code

Méthode 3 : Installation manuelle

Téléchargez le binaire depuis github.com/anthropics/claude-code/releases
Ajoutez-le à votre PATH :

# macOS/Linux
sudo mv claude-code /usr/local/bin/
chmod +x /usr/local/bin/claude-code

# Windows (PowerShell en admin)
Move-Item claude-code.exe C:\Windows\System32\

Vérification de l'installation

claude --version

Vous devriez voir la version installée (ex: claude-code v1.2.0)

Configuration du CLI

1. Authentification

Configurez votre clé API :

claude auth login

Vous serez invité à entrer votre clé API. Celle-ci sera stockée de manière sécurisée dans :

macOS/Linux : ~/.config/claude/credentials
Windows : %APPDATA%\claude\credentials

Alternative : Utiliser une variable d'environnement

export ANTHROPIC_API_KEY="sk-ant-api03-..."

2. Configuration initiale

Créez un fichier de configuration personnalisée :

claude config init

Cela crée ~/.config/claude/config.json :

{
  "model": "claude-sonnet-4-5-20250929",
  "maxTokens": 4096,
  "temperature": 1.0,
  "editor": "code"
}

Utilisation du CLI

Commandes de base

Chat interactif :

claude chat

Question rapide :

claude ask "Comment créer un composant React ?"

Analyser un fichier :

claude analyze src/app.ts

Générer du code :

claude generate "Create a Express API with TypeScript" --output src/api.ts

Travailler avec des projets

Initialiser un projet Claude :

cd my-project
claude init

Cela crée un .claudeconfig avec :

Liste des fichiers à inclure
Fichiers à ignorer (comme .claudeignore)
Configuration spécifique au projet

Analyser tout le projet :

claude project analyze

Générer de la documentation :

claude project docs --format markdown

Nouvelles fonctionnalités (Version 2.0+, Sept-Oct 2025)

🔄 Checkpointing automatique : Claude Code sauvegarde automatiquement l'état de votre code avant chaque changement.

⏪ Commande /rewind : Revenir à un checkpoint précédent :

/rewind  # Dans une session Claude Code

Ou appuyez sur Esc Esc pour revenir en arrière rapidement.

🔍 Historique de prompts (Ctrl+r) : Recherchez et réutilisez vos anciens prompts :

# Dans claude chat, appuyez sur Ctrl+r
# Tapez pour rechercher dans l'historique

🧠 Extended Thinking : Activez le mode de réflexion approfondie :

claude chat --extended-thinking

🔌 Support MCP (Model Context Protocol) : Connectez des serveurs MCP pour étendre les capacités :

claude mcp add <server-name>

🧩 Système de plugins : Installez des plugins avec la commande /plugin :

/plugin install <plugin-name>

Commandes avancées

Refactoring :

claude refactor src/legacy.js --style modern --output src/modern.js

Tests automatiques :

claude test generate src/service.ts --framework jest

Code review :

claude review src/ --issues security,performance

Workflow complet :

# Analyser, refactor, tester, documenter
claude workflow full src/

Options globales

Option	Description	Exemple
`--model`	Modèle à utiliser	`claude ask "..." --model claude-opus`
`--temperature`	Créativité (0-1)	`claude generate "..." --temperature 0.8`
`--max-tokens`	Limite de tokens	`claude chat --max-tokens 8000`
`--json`	Sortie en JSON	`claude analyze file.ts --json`
`--verbose`	Mode verbeux	`claude project analyze --verbose`

Fichier .claudeignore

Créez un .claudeignore à la racine de votre projet :

# Dépendances
node_modules/
vendor/
.venv/

# Build
dist/
build/
.next/
out/

# Environnement
.env
.env.local
*.log

# IDE
.vscode/
.idea/
*.swp

💻 Option 2 : Extension VS Code

L'extension VS Code intègre Claude directement dans votre éditeur.

Installation de l'extension VS Code

Méthode 1 : Via le Marketplace VS Code

Ouvrez VS Code
Cliquez sur l'icône Extensions (ou Ctrl+Shift+X / Cmd+Shift+X)
Recherchez "Claude Code" dans la barre de recherche
Cliquez sur Install sur l'extension officielle Anthropic
Attendez la fin de l'installation (quelques secondes)

Méthode 2 : Via la ligne de commande

code --install-extension anthropic.claude-code

Méthode 3 : Installation manuelle

Si vous avez téléchargé le fichier .vsix :

Ouvrez VS Code
Extensions > ... > Install from VSIX
Sélectionnez le fichier téléchargé

Configuration initiale

1. Ajouter votre clé API

Après l'installation, Claude Code vous demandera votre clé API :

Cliquez sur l'icône Claude dans la barre latérale
Cliquez sur "Set API Key"
Collez votre clé API Anthropic
Cliquez sur "Save"

Alternative : Configuration manuelle via settings.json :

{
  "claude-code.apiKey": "sk-ant-api03-...",
  "claude-code.model": "claude-sonnet-4-5-20250929"
}

2. Choisir le modèle

Claude Code supporte plusieurs modèles (famille Claude 4) :

claude-sonnet-4-5-20250929 : Recommandé (modèle phare, excellent pour le code et agents)
claude-haiku-4-5-20251001 : Le plus rapide et économique (performances proches de Sonnet 4 à 1/3 du prix)
claude-opus-4-1-20250805 : Raisonnement profond (tâches complexes spécialisées)

Par défaut, Claude Code utilise Sonnet 4.5 depuis septembre 2025.

Configuration :

{
  "claude-code.model": "claude-sonnet-4-5-20250929"
}

3. Personnaliser les paramètres

Accédez aux paramètres : Ctrl+, (ou Cmd+,) puis recherchez "Claude Code"

Paramètres recommandés :

{
  "claude-code.model": "claude-sonnet-4-5-20250929",
  "claude-code.maxTokens": 4096,
  "claude-code.temperature": 1.0,
  "claude-code.autoSave": true,
  "claude-code.showInlineCompletion": true,
  "claude-code.contextWindow": 200000
}

Fonctionnalités principales

Chat intégré

Ouvrez la vue Claude (icône dans la barre latérale)
Posez des questions en langage naturel
Claude a accès au contexte de votre projet

Raccourci : Ctrl+Shift+P > "Claude: Open Chat"

Complétion de code

Claude Code propose des complétions intelligentes :

Tapez du code naturellement
Attendez la suggestion (apparaît en gris)
Appuyez sur Tab pour accepter
Esc pour rejeter

Désactiver les complétions :

{
  "claude-code.showInlineCompletion": false
}

Génération de code

Sélectionnez du code puis :

Clic droit > "Claude: Generate"
Décrivez ce que vous voulez
Claude génère le code

Raccourci : Ctrl+Shift+G (ou Cmd+Shift+G)

Refactoring

Sélectionnez du code puis :

Clic droit > "Claude: Refactor"
Choisissez le type de refactoring
Claude applique les modifications

Explication de code

Sélectionnez du code puis :

Clic droit > "Claude: Explain"
Claude explique en détail

Nouvelles fonctionnalités VS Code (Beta, Sept-Oct 2025)

🎯 Plan Mode : Claude génère un plan d'action avant d'exécuter des changements. Vous pouvez approuver ou modifier le plan avant l'exécution.

👁️ Inline Diffs : Visualisez les changements proposés directement dans l'éditeur avec des diffs interactifs en temps réel.

✅ Auto-Accept : Acceptez automatiquement les suggestions de Claude qui passent les tests et validations.

🔄 Checkpoints & Rewind :

Sauvegarde automatique avant chaque changement
Esc Esc pour revenir rapidement au checkpoint précédent
Restaurez code, conversation, ou les deux

🧠 Extended Thinking Toggle : Bouton en bas à droite de l'input pour activer/désactiver la réflexion approfondie de Claude.

📂 Drag & Drop de fichiers : Glissez-déposez des fichiers et dossiers directement dans le chat pour les inclure au contexte.

@-mentions de fichiers :

@src/app.ts Explique cette fonction

🔌 Support MCP & Plugins : Les serveurs MCP configurés via CLI fonctionnent aussi dans VS Code. Installez des plugins avec /plugin <nom>.

🔀 Sessions multiples : Lancez plusieurs sessions Claude Code simultanément dans différents onglets.

Raccourcis clavier

Commande	Windows/Linux	macOS
Ouvrir chat	`Ctrl+Shift+C`	`Cmd+Shift+C`
Générer code	`Ctrl+Shift+G`	`Cmd+Shift+G`
Expliquer	`Ctrl+Shift+E`	`Cmd+Shift+E`
Refactorer	`Ctrl+Shift+R`	`Cmd+Shift+R`
Nouvelle conversation	`Ctrl+Shift+N`	`Cmd+Shift+N`

Personnaliser : File > Preferences > Keyboard Shortcuts > Rechercher "Claude"

Gestion du contexte

Claude Code analyse automatiquement :

Fichiers ouverts
Structure du projet
Dépendances (package.json, requirements.txt, etc.)
Git status

Ajouter des fichiers au contexte

@fichier.ts Explique cette fonction

Exclure des fichiers

Créez un .claudeignore à la racine :

node_modules/
.next/
dist/
*.log
.env

Résolution de problèmes

L'extension ne démarre pas

Vérifiez la version de VS Code (Help > About)
Redémarrez VS Code
Réinstallez l'extension
Vérifiez les logs : View > Output > Claude Code

Erreur "Invalid API Key"

Vérifiez que la clé commence par sk-ant-api03-
Vérifiez qu'elle n'a pas de caractères parasites
Régénérez la clé sur console.anthropic.com
Vérifiez les limites de votre compte

Complétions lentes

Réduisez claude-code.contextWindow
Ajoutez plus de fichiers à .claudeignore
Utilisez Haiku 4.5 pour plus de vitesse (2x plus rapide que Sonnet 4)

Erreur "Rate Limit"

Vous avez atteint la limite de requêtes :

Attendez quelques minutes
Augmentez votre tier sur console.anthropic.com
Réduisez la fréquence des requêtes

Utilisation avancée

Snippets personnalisés

Créez vos propres snippets avec contexte Claude :

{
  "Claude React Component": {
    "prefix": "crc",
    "body": [
      "// @claude: Generate a React component with:",
      "// - TypeScript",
      "// - Props validation",
      "// - Proper types",
      "$0"
    ]
  }
}

Multi-fichiers

Claude peut travailler sur plusieurs fichiers :

@src/components/*.tsx Refactor all components to use composition pattern

Tests automatiques

@user.service.ts Generate comprehensive unit tests

Meilleures pratiques

Contexte clair

✅ "Refactor this function to use async/await" ❌ "Fix this"

Code incrémental

Commencez par de petites modifications
Validez chaque étape
Construisez progressivement

Revue du code

Ne faites pas confiance aveuglément
Testez les suggestions
Comprenez les changements

Sécurité

Ne partagez jamais votre clé API
Ajoutez les secrets à .claudeignore
Utilisez des variables d'environnement

Mise à jour

VS Code met à jour automatiquement les extensions.

Vérifier manuellement :

Extensions > Claude Code
Cliquez sur la roue dentée
"Check for updates"

Version actuelle : Visible dans le panneau Extensions

Ressources

Documentation officielle : docs.anthropic.com/claude-code
Discord CC France : discord.gg/cc-france
GitHub : github.com/anthropics/claude-code
Support : [email protected]

🔄 CLI vs Extension VS Code : Quelle option choisir ?

Comparaison rapide

Critère	CLI	Extension VS Code
Interface	Terminal	Interface graphique
Installation	npm/brew	Marketplace VS Code
Intégration	Scripts, CI/CD	Éditeur uniquement
Vitesse	Très rapide	Rapide
Automatisation	✅ Excellent	❌ Limité
Complétion code	❌ Non	✅ Oui
Workflow CI/CD	✅ Oui	❌ Non
Courbe apprentissage	Moyenne	Facile

Cas d'usage recommandés

Utilisez le CLI si :

✅ Vous travaillez beaucoup dans le terminal
✅ Vous voulez automatiser des tâches
✅ Vous intégrez Claude dans des pipelines CI/CD
✅ Vous travaillez sur plusieurs éditeurs (Vim, Neovim, Emacs, etc.)
✅ Vous préférez les scripts et l'automatisation

Utilisez l'extension VS Code si :

✅ VS Code est votre éditeur principal
✅ Vous voulez des complétions de code en temps réel
✅ Vous préférez une interface graphique
✅ Vous êtes débutant avec Claude
✅ Vous voulez un chat intégré dans l'éditeur

Utilisez les deux si :

🎯 CLI pour scripts et automatisation
🎯 Extension pour le développement quotidien
🎯 Meilleure flexibilité selon le contexte

Exemples de workflows combinés

Développement quotidien

# Matin : Analyser les changements avec le CLI
claude review --since yesterday

# Journée : Développer avec VS Code + extension
# (complétion automatique, chat intégré)

# Soir : Générer la doc avec le CLI
claude project docs --format markdown > CHANGELOG.md

Pipeline CI/CD

# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Install Claude CLI
        run: npm install -g @anthropic-ai/claude-code
      - name: Review code
        run: claude review src/ --issues security,performance
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Prochaines étapes

Maintenant que vous avez installé Claude Code :

Pour le CLI :

🖥️ Essayez claude chat pour une session interactive
📁 Initialisez un projet avec claude init
🔄 Automatisez vos workflows avec des scripts

Pour VS Code :

💬 Ouvrez le chat Claude dans la barre latérale
⌨️ Testez les complétions automatiques
🎨 Personnalisez les raccourcis clavier

Pour aller plus loin :

🚀 Consultez le guide "Premiers pas avec l'API Claude"
💬 Rejoignez #claude-code sur Discord CC France
📚 Explorez les guides avancés
🎯 Participez aux challenges de code de la communauté

Bon développement avec Claude Code ! 🎉

Installation de Claude Code

Prérequis recommandés

Installation de Claude Code

📋 Prérequis généraux

🖥️ Option 1 : Claude Code CLI (Recommandé)

Installation du CLI

Méthode 1 : Via npm (Recommandé)

Méthode 2 : Via Homebrew (macOS/Linux)

Méthode 3 : Installation manuelle

Vérification de l'installation

Configuration du CLI

1. Authentification

2. Configuration initiale

Utilisation du CLI

Commandes de base

Travailler avec des projets

Nouvelles fonctionnalités (Version 2.0+, Sept-Oct 2025)

Commandes avancées

Options globales

Fichier .claudeignore

💻 Option 2 : Extension VS Code

Installation de l'extension VS Code

Méthode 1 : Via le Marketplace VS Code

Méthode 2 : Via la ligne de commande

Méthode 3 : Installation manuelle

Configuration initiale

1. Ajouter votre clé API

2. Choisir le modèle

3. Personnaliser les paramètres

Fonctionnalités principales

Chat intégré

Complétion de code

Génération de code

Refactoring

Explication de code

Nouvelles fonctionnalités VS Code (Beta, Sept-Oct 2025)

Raccourcis clavier

Gestion du contexte

Ajouter des fichiers au contexte

Exclure des fichiers

Résolution de problèmes

L'extension ne démarre pas

Erreur "Invalid API Key"

Complétions lentes

Erreur "Rate Limit"

Utilisation avancée

Snippets personnalisés

Multi-fichiers

Tests automatiques

Meilleures pratiques

Contexte clair

Code incrémental

Revue du code

Sécurité

Mise à jour

Ressources

🔄 CLI vs Extension VS Code : Quelle option choisir ?

Comparaison rapide

Cas d'usage recommandés

Utilisez le CLI si :

Utilisez l'extension VS Code si :

Utilisez les deux si :

Exemples de workflows combinés

Développement quotidien

Pipeline CI/CD

Prochaines étapes

Pour le CLI :

Pour VS Code :

Pour aller plus loin :

Ce guide vous a-t-il été utile ?

Prochaines étapes

Premiers pas avec l'API Claude