Démarrer avec Claude Code : guide d'installation et de configuration

Table des matières

1. →Prérequis
2. →Méthodes d'installation
3. →Authentification
4. →Premières commandes
5. →Intégration IDE
6. →Dépannage

Prêt à découvrir le codage agentique propulsé par l'IA ? Ce guide étape par étape vous permettra d'exécuter Claude Code en moins de 5 minutes, quel que soit votre système d'exploitation.

Prérequis

Avant d'installer Claude Code, assurez-vous d'avoir :

Requis

• →Abonnement Claude : Pro (17-20 $/mois), Max (100-200 $/mois), Teams ou Enterprise
  • →Ou un compte Claude Console avec des crédits API
• →Système d'exploitation : macOS, Linux, Windows ou WSL (Windows Subsystem for Linux)

Optionnel mais recommandé

• →Node.js 18+ : Requis uniquement pour l'installation via NPM
• →Git : Pour les fonctionnalités de contrôle de version
• →Un éditeur de code : VS Code, JetBrains, Vim, etc. (Claude Code fonctionne avec n'importe quel éditeur)

Méthodes d'installation

Claude Code propose quatre méthodes d'installation. Choisissez celle qui correspond à votre environnement :

Méthode 1 : Installation native (recommandée)

L'installateur natif est la méthode la plus simple et la plus fiable.

macOS et Linux

Ouvrez votre terminal et exécutez :

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

Ce script :

1. →Télécharge le dernier binaire Claude Code
2. →L'installe dans votre PATH système
3. →Configure les mises à jour automatiques

Windows PowerShell

Ouvrez PowerShell en tant qu'administrateur et exécutez :

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

Invite de commandes Windows (CMD)

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

Vérifier l'installation

Après l'installation, vérifiez que Claude Code fonctionne :

claude --version

Vous devriez voir une sortie comme :

Claude Code v1.0.45

Méthode 2 : Homebrew (macOS)

Si vous utilisez Homebrew sur macOS :

brew install --cask claude-code

Mettez à jour plus tard avec :

brew upgrade claude-code

Méthode 3 : Installation NPM

Pour les développeurs Node.js qui préfèrent NPM :

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

Important : L'installation NPM nécessite Node.js 18 ou supérieur.

Mettez à jour plus tard avec :

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

Méthode 4 : Installation manuelle

Pour les entreprises ou configurations personnalisées, téléchargez les binaires directement depuis :

• →Claude Code Releases

Première authentification

Après l'installation, vous devez vous authentifier avec votre compte Anthropic.

Étape 1 : Naviguez vers un projet

cd votre-repertoire-projet

Étape 2 : Lancez Claude Code

claude

Étape 3 : Authentifiez-vous

Au premier lancement, Claude Code va :

1. →Ouvrir votre navigateur par défaut
2. →Rediriger vers la page de connexion Anthropic
3. →Vous demander d'autoriser Claude Code

Complétez l'authentification dans votre navigateur, puis retournez dans votre terminal.

Étape 4 : Confirmez l'authentification

Une fois authentifié, vous verrez :

✓ Authenticated as your-email@example.com
✓ Using Claude Pro subscription

Welcome to Claude Code! How can I help you today?
>

Options d'authentification

Abonnement Claude (par défaut)

Si vous avez un abonnement Claude Pro, Max, Teams ou Enterprise, l'authentification se fait automatiquement via OAuth.

Clé API (utilisateurs Console)

Si vous utilisez Claude Console avec des crédits API :

# Définissez votre clé API comme variable d'environnement
export ANTHROPIC_API_KEY="sk-ant-..."

# Lancez Claude Code
claude

Pour une configuration persistante, ajoutez à votre profil shell (~/.bashrc, ~/.zshrc, etc.) :

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

AWS Bedrock

Pour les utilisateurs entreprise avec AWS Bedrock :

export ANTHROPIC_MODEL="us.anthropic.claude-sonnet-4-20250514-v1:0"
export AWS_REGION="us-east-1"
# Assurez-vous que les identifiants AWS sont configurés

claude

Google Vertex AI

Pour les utilisateurs Google Cloud :

export ANTHROPIC_MODEL="claude-sonnet-4@20250514"
export CLOUD_ML_REGION="us-east5"
export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"

claude

Votre première session Claude Code

Parcourons votre première interaction avec Claude Code.

Étape 1 : Démarrez dans votre projet

cd mon-projet
claude

Étape 2 : Initialisez la mémoire du projet

Créez un fichier CLAUDE.md pour aider Claude à comprendre votre projet :

> /init

Claude Code va :

1. →Scanner la structure de votre projet
2. →Identifier les langages, frameworks et patterns
3. →Générer un fichier CLAUDE.md avec le contexte du projet

Étape 3 : Posez une question

> What does this project do? Explain the main architecture.

Claude analysera votre codebase et fournira une vue d'ensemble.

Étape 4 : Faites votre première modification

> Add a health check endpoint to the API at /health that returns { status: "ok" }

Claude va :

1. →Trouver vos routes API
2. →Créer le endpoint en suivant vos patterns existants
3. →Vous montrer ce qui a changé

Étape 5 : Revoyez les modifications

> /review

Claude examine les modifications récentes et fournit un retour.

Étape 6 : Vérifiez l'utilisation

> /cost

Consultez votre consommation de tokens pour la session.

Étape 7 : Quittez

> /exit

Ou appuyez deux fois sur Ctrl+C.

Configuration essentielle

Options CLI

Claude Code prend en charge divers flags de personnalisation :

# Utiliser un modèle spécifique
claude --model claude-opus-4-5-20251101

# Définir le nombre maximum de tours de conversation
claude --max-turns 20

# Démarrer avec un prompt spécifique
claude -p "Review the changes in the last commit"

# Exécuter en mode impression (non interactif)
claude --print "Explain the main.py file"

Référence des flags courants

Fichier de paramètres

Créez ~/.claude/settings.json pour une configuration persistante :

{
  "model": "claude-sonnet-4-20250514",
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": ["Bash(rm:*)"]
  },
  "theme": "dark"
}

Voir Claude Code Permissions : modes Deny, Allow et Ask pour la configuration détaillée des permissions.

Intégration IDE

Claude Code fonctionne avec n'importe quel éditeur, mais offre une intégration plus poussée avec certains :

VS Code

Installez l'extension Claude Code :

1. →Ouvrez VS Code
2. →Allez dans Extensions (Ctrl+Shift+X)
3. →Recherchez « Claude Code »
4. →Installez l'extension officielle Anthropic

Ou via CLI :

code --install-extension anthropic.claude-code

Fonctionnalités :

• →Panneau Claude Code intégré
• →Intégration dans la barre d'état
• →Raccourcis clavier

IDE JetBrains

Installez depuis le JetBrains Marketplace :

1. →Ouvrez Paramètres → Plugins
2. →Recherchez « Claude Code »
3. →Installez et redémarrez

Fonctionnalités :

• →Intégration dans la fenêtre d'outils
• →Suggestions contextuelles

Éditeurs en terminal (Vim, Neovim, Emacs)

Claude Code s'exécute dans un volet terminal séparé. Utilisez tmux ou des terminaux divisés :

# Terminal 1 : Votre éditeur
nvim src/main.py

# Terminal 2 : Claude Code
claude

Configuration de la ligne d'état

Pour les terminaux qui le supportent :

> /statusline

Cela ajoute l'état de Claude Code à votre invite de terminal.

Initialisation du projet

Pour la meilleure expérience, initialisez chaque projet avec Claude Code :

Initialisation automatique

> /init

Cela crée un fichier CLAUDE.md adapté à votre projet.

CLAUDE.md manuel

Créez .claude/CLAUDE.md ou CLAUDE.md à la racine de votre projet :

# Project: My Awesome App

## Overview
A Next.js e-commerce platform with TypeScript and Prisma.

## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Prisma with PostgreSQL
- Tailwind CSS

## Conventions
- Use functional components with hooks
- API routes in /app/api/
- All database changes require migrations
- Tests in __tests__ folders alongside code

## Important Notes
- Never modify /lib/payment/ directly (handled by external team)
- Environment variables in .env.local (not committed)

En savoir plus dans CLAUDE.md : le fichier mémoire IA de votre projet expliqué.

Dépannage

« Command not found: claude »

macOS/Linux : Ajoutez au PATH

export PATH="$HOME/.claude/bin:$PATH"

Ajoutez cette ligne à votre ~/.bashrc ou ~/.zshrc.

Windows : Redémarrez PowerShell ou ajoutez au PATH système.

« Authentication failed »

1. →

   Effacez les identifiants existants :

   claude /logout
   

2. →

   Ré-authentifiez-vous :

   claude /login
   

« Connection refused » ou erreurs réseau

Vérifiez votre connexion internet et les paramètres de pare-feu. Claude Code a besoin d'accéder à :

• →api.anthropic.com
• →claude.ai

Performances lentes sur les gros projets

Pour les très grandes bases de code :

1. →

   Utilisez .claudeignore pour exclure les fichiers inutiles :

   node_modules/
   .git/
   dist/
   build/
   *.log
   

2. →

   Commencez avec un contexte spécifique :

   claude --context "src/api/"
   

Problèmes spécifiques à Windows

Échec des serveurs NPX : Utilisez le wrapper cmd /c :

claude mcp add --transport stdio my-server -- cmd /c npx -y some-package

Vérifier l'état de l'installation

> /doctor

Cela exécute des diagnostics et signale les éventuels problèmes.

Mettre à jour Claude Code

Claude Code se met à jour automatiquement, mais vous pouvez forcer une mise à jour :

Installation native

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

Homebrew

brew upgrade claude-code

NPM

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

Vérifier les mises à jour

> /release-notes

Désinstaller Claude Code

Si vous avez besoin de désinstaller :

Installation native (macOS/Linux)

rm -rf ~/.claude
rm $(which claude)

Homebrew

brew uninstall claude-code

NPM

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

Windows

Utilisez « Ajouter ou supprimer des programmes » ou :

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"

Prochaines étapes

Maintenant que Claude Code est installé, voici ce qu'il faut explorer ensuite :

1. →

   Maîtrisez les commandes Slash : Apprenez toutes les commandes intégrées → Claude Code Slash Commands : guide de référence complet

2. →

   Configurez la mémoire du projet : Mettez en place CLAUDE.md pour vos projets → CLAUDE.md : le fichier mémoire IA de votre projet expliqué

3. →

   Comprenez les permissions : Configurez les paramètres de sécurité → Claude Code Permissions : modes Deny, Allow et Ask

4. →

   Connectez des outils externes : Configurez les intégrations MCP → Model Context Protocol (MCP) pour Claude Code : guide complet

Articles connexes

• →Claude Code vs Copilot vs Cursor — Comparaison d'outils
• →Claude Code Slash Commands Reference — Toutes les commandes
• →Claude Code Sub-Agents — Orchestrer des tâches complexes
• →Claude Code GitHub Actions — Automatisation CI/CD
• →Claude Cowork Guide — Agent d'automatisation de bureau

Points clés à retenir

1. →

   Plusieurs méthodes d'installation : L'installation native est recommandée pour la plupart des utilisateurs, avec des options Homebrew, NPM et manuelle disponibles.

2. →

   L'authentification est automatique pour les abonnés Claude, ou utilisez des clés API pour les utilisateurs Console.

3. →

   Exécutez /init sur les nouveaux projets pour créer un fichier CLAUDE.md de mémoire projet.

4. →

   Les flags CLI personnalisent le comportement : Utilisez --model, --max-turns et --print pour différents workflows.

5. →

   L'intégration IDE améliore l'expérience mais n'est pas requise — Claude Code fonctionne avec n'importe quel éditeur depuis le terminal.

Prêt à construire des prompts efficaces ?

Vous avez installé Claude Code — il est maintenant temps de maîtriser l'art de communiquer efficacement avec lui.

Dans notre Module 1 — Anatomie des LLM et structure des prompts, vous apprendrez :

• →Comment les grands modèles de langage traitent vos prompts
• →L'anatomie de prompts efficaces pour les tâches de codage
• →La gestion des tokens et l'optimisation de la fenêtre de contexte
• →Les techniques pour des résultats cohérents et de haute qualité

→ Explorer le Module 1 : Anatomie des LLM et structure des prompts

Dernière mise à jour : 28 janvier 2026