Claude Code : le tutoriel complet en français

Ce tutoriel vous accompagne de l’installation à votre premier changement vérifié, puis vous montre les réglages qui comptent au quotidien : le fichier CLAUDE.md, les permissions, le contexte, les modèles et le coût. Chaque commande citée a été vérifiée sur la documentation officielle d’Anthropic. Si vous préférez un parcours complet en vidéo avec un projet fil rouge, la formation Claude Code de Dyma reprend ces étapes en détail.

Qu’est-ce que Claude Code ?

La documentation officielle le décrit comme un outil de codage agentique qui lit votre base de code, modifie des fichiers, exécute des commandes et s’intègre à vos outils de développement. Concrètement, vous décrivez une tâche en langage naturel ; Claude explore les fichiers dont il a besoin, propose ou applique des modifications, lance vos tests et peut créer des commits.

1. Vous décrivez la tâche en langage naturel.
2. Claude explore les fichiers dont il a besoin.
3. Il modifie ou propose les changements, selon le mode de permission.
4. Il vérifie en lançant vos tests et vos commandes.
5. Il livre : vous relisez le diff, il peut créer le commit.

Il existe dans le terminal (le CLI), dans VS Code et les IDE JetBrains, dans l’application de bureau et sur le web. Toutes ces surfaces partagent le même moteur ; ce tutoriel part du terminal, la version la plus complète.

Étape 1 : installer Claude Code

Configuration requise selon la documentation : macOS 13.0 ou plus récent, Windows 10 1809 ou plus récent (ou Windows Server 2019), Ubuntu 20.04, Debian 10 ou Alpine 3.19 au minimum, 4 Go de RAM et une connexion internet.

macOS, Linux et WSL

Ouvrez un terminal et lancez l’installateur natif, la méthode recommandée :

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

Windows

Dans PowerShell (l’invite affiche PS C:\) :

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

Dans l’invite de commandes CMD (l’invite affiche C:\ sans PS) :

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

Inutile d’être administrateur. Git for Windows est recommandé : Claude Code utilise alors Git Bash, sinon PowerShell. Vous pouvez aussi l’installer dans WSL avec la commande Linux.

Avec un gestionnaire de paquets

# macOS (Homebrew)
brew install --cask claude-code

# Windows (WinGet)
winget install Anthropic.ClaudeCode

L’installation native se met à jour seule en arrière-plan, pas celles de Homebrew et WinGet : lancez brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode de temps en temps.

Vérifier l’installation

Ouvrez une nouvelle fenêtre de terminal, puis :

claude --version
claude doctor

La première affiche un numéro de version, la seconde diagnostique l’installation et vos réglages sans ouvrir de session. Si claude est introuvable, le dossier d’installation n’est pas encore dans votre PATH.

Étape 2 : se connecter avec le bon compte

Claude Code exige un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit de claude.ai ne donne pas accès à Claude Code. Vous avez donc trois options :

Les prix actuels figurent sur claude.com/pricing. La connexion se fait au premier lancement de claude, dans votre navigateur, et vos identifiants sont ensuite conservés. Pour changer de compte, tapez /login dans une session.

Étape 3 : premier lancement dans un projet

Placez-vous à la racine d’un projet existant et lancez Claude Code :

cd /chemin/vers/votre-projet
claude

L’invite affiche la version, le modèle courant et le dossier de travail. Tapez / pour lister les commandes et /exit pour quitter. Variantes utiles :

claude "corrige l'erreur de build"   # démarre avec une première demande
claude -p "explique cette fonction"  # requête unique, puis sortie
claude -c                            # reprend la dernière conversation du dossier
claude -r                            # choisit une conversation à reprendre

Étape 4 : faire explorer le projet avant de le modifier

Commencez par des questions. Vous n’avez rien à copier-coller : Claude Code lit lui-même les fichiers dont il a besoin.

que fait ce projet ?
quelles technologies utilise-t-il ?
où se trouve le point d'entrée principal ?
explique-moi l'organisation des dossiers

La documentation recommande de laisser Claude comprendre le code avant de le changer, et d’être précis : « corrige le bug de connexion où l’utilisateur voit un écran blanc après un mauvais mot de passe » plutôt que « corrige le bug ». Une demande vague déclenche une exploration large, donc plus de jetons consommés.

Étape 5 : votre première modification

Planifier d’abord

Pour un changement de plus de quelques lignes, passez en mode plan. Claude lit, explore et rédige un plan sans toucher à votre code source. Préfixez votre demande par /plan :

/plan ajoute une validation des champs au formulaire d'inscription

Quand le plan est prêt, vous choisissez : l’approuver et passer en mode auto, l’approuver en validant chaque modification une par une, ou continuer à planifier en précisant ce qui doit changer.

Comprendre les modes de permission

Le mode de la session détermine ce que Claude peut faire sans vous demander. Il s’affiche dans la barre d’état, et Maj+Tab (Shift+Tab) le fait tourner à tout moment :

Dans les versions récentes, le mode auto est le mode de départ des sessions interactives du terminal et de VS Code. Anthropic précise qu’il réduit les demandes de permission sans garantir la sécurité : sur un dépôt sensible, repassez en Manual, ou démarrez avec claude --permission-mode plan.

Étape 6 : vérifier et revenir en arrière

Donnez à Claude un moyen de contrôler son travail, comme le recommande la documentation : des tests, une sortie attendue, une capture d’écran.

lance les tests et corrige les échecs
quels fichiers ai-je modifiés ?
commite mes changements avec un message descriptif

Pour relire : /diff affiche ce qui a changé, /code-review cherche des bugs dans le diff courant et /security-review des failles dans votre branche.

Si Claude part dans la mauvaise direction, appuyez sur Échap pour l’arrêter. Chaque demande qui lance un tour crée un point de contrôle : /rewind, ou deux fois Échap quand la zone de saisie est vide, ouvre un menu pour restaurer le code, la conversation, ou les deux. Deux limites à connaître : un fichier modifié uniquement par une commande shell n’est pas suivi, et ces points de contrôle ne remplacent pas Git. Gardez l’habitude de commiter.

Étape 7 : créer le fichier CLAUDE.md avec /init

Le fichier CLAUDE.md, lu au début de chaque session, transmet ce que vous auriez sinon à réexpliquer : commandes de build et de test, conventions, organisation du projet.

/init

/init analyse votre base de code et génère un premier CLAUDE.md avec les commandes et conventions qu’il détecte. Si le fichier existe déjà, il propose des améliorations au lieu de l’écraser. Complétez-le ensuite avec ce que Claude ne peut pas deviner, et ouvrez-le à tout moment avec /memory.

Les règles d’écriture données par la documentation :

• Des consignes vérifiables : « lancer npm test avant de commiter » plutôt que « tester ses changements ».
• Moins de 200 lignes par fichier : au-delà, le contexte consommé augmente et les consignes sont moins bien suivies.
• Des sections titrées, sans consignes contradictoires.

./CLAUDE.md se partage avec l’équipe via Git, ~/.claude/CLAUDE.md vaut pour tous vos projets, et CLAUDE.local.md garde vos préférences personnelles sur un projet (à ajouter au .gitignore). Un fichier peut en importer un autre avec @chemin/vers/fichier. Si votre dépôt n’a qu’un AGENTS.md, Claude Code le lit à la place.

Un point important : Claude traite CLAUDE.md comme du contexte, pas comme une configuration imposée. Pour interdire une action à coup sûr, il faut une règle de permission ou un hook.

Étape 8 : régler les permissions

Les règles de permission sont appliquées par Claude Code, pas par le modèle. Il en existe trois sortes : allow (autorisé sans demande), ask (toujours demander) et deny (interdit). Elles sont évaluées dans l’ordre deny, puis ask, puis allow : une règle deny l’emporte toujours, même face à une règle allow plus précise.

La commande /permissions ouvre une fenêtre pour consulter et modifier les règles. Vous pouvez aussi les écrire dans un fichier de réglages. Exemple tiré de la documentation, qui autorise le lint et les tests et interdit la lecture des fichiers .env :

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

Trois fichiers, trois portées : ~/.claude/settings.json pour vous sur tous vos projets, .claude/settings.json pour l’équipe (à commiter), et .claude/settings.local.json pour vous sur un seul projet. Quand vous répondez « Yes, and don’t ask again » à une demande d’exécution de commande shell, Claude Code enregistre la règle dans ce dernier fichier.

Étape 9 : gérer le contexte

Claude Code envoie toute la conversation à chaque requête : une session qui s’allonge coûte plus cher et laisse moins de place aux fichiers utiles.

Claude Code compacte aussi automatiquement à l’approche de la limite, puis relit le CLAUDE.md racine depuis le disque. Pour une question annexe qui ne doit pas encombrer l’historique, utilisez /btw.

Étape 10 : choisir le modèle et suivre le coût

/model ouvre un sélecteur de modèle et enregistre votre choix comme modèle par défaut ; appuyez sur s sur une ligne pour changer seulement la session en cours. Vous pouvez aussi passer un alias directement :

/model sonnet
claude --model opus

Au moment où nous écrivons, le modèle par défaut des abonnements Pro, Max, Team et Enterprise est Opus 5.5. La commande /effort règle le niveau de raisonnement, de low à max.

Pour suivre la consommation, lancez /usage (/cost et /stats en sont des alias). Avec un abonnement, l’écran montre vos barres d’utilisation du forfait, des statistiques d’activité et ce qui pèse le plus sur vos limites ; le montant en dollars de la session ne sert alors pas à la facturation. Avec une clé d’API, ce montant est une estimation de votre dépense, calculée au prix catalogue.

Pour économiser, la documentation conseille /clear entre deux tâches sans rapport, des demandes précises, Sonnet pour la plupart des tâches de code (moins cher qu’Opus) et le mode plan avant un gros chantier.

Aller plus loin

Connecter des outils avec MCP

Le Model Context Protocol (MCP) est un standard ouvert qui relie Claude Code à des outils, des bases de données et des API externes. Pour ajouter un serveur distant :

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp list

Par défaut, le serveur n’est disponible que pour vous dans le projet courant. Avec --scope project, il est enregistré dans un fichier .mcp.json à la racine, partageable avec l’équipe ; avec --scope user, il vous suit dans tous vos projets. Dans une session, /mcp gère les connexions et l’authentification OAuth.

Créer un skill

Un skill est un fichier SKILL.md qui contient des instructions réutilisables. Placé dans .claude/skills/<nom>/SKILL.md (projet) ou ~/.claude/skills/<nom>/SKILL.md (personnel), il devient une commande /nom que vous pouvez lancer, et que Claude peut aussi charger de lui-même quand il le juge utile :

---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation

Les anciennes commandes de .claude/commands/ ont été fusionnées dans les skills et fonctionnent toujours. Ajoutez disable-model-invocation: true à l’en-tête d’un skill que vous seul devez déclencher, comme un déploiement.

Déléguer à des sous-agents

Un sous-agent travaille dans sa propre fenêtre de contexte et ne renvoie qu’un résumé. Il est idéal pour une recherche ou une analyse de logs qui inonderait votre conversation. Claude Code en fournit plusieurs d’office, dont Explore (recherche en lecture seule) et Plan. Pour créer le vôtre, décrivez-le à Claude, ou écrivez dans .claude/agents/ un fichier Markdown dont l’en-tête donne un nom (name), une description qui dit quand l’utiliser, et éventuellement les outils autorisés (tools) et le modèle (model).

Automatiser avec les hooks

Les hooks sont des commandes shell que Claude Code exécute à des moments précis : avant un outil (PreToolUse, qui peut le bloquer), après (PostToolUse), à la fin d’une réponse (Stop), au démarrage d’une session (SessionStart). Contrairement à une consigne de CLAUDE.md, l’action a lieu à chaque fois. Cet exemple officiel, placé dans .claude/settings.json, lance Prettier après chaque modification :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

La commande /hooks affiche les hooks configurés.

Travailler avec GitHub

Dans un dépôt hébergé sur github.com, lancez /install-github-app depuis Claude Code. Elle installe l’application GitHub Claude, enregistre le secret d’authentification et prépare la pull request du workflow ; il faut être administrateur du dépôt et avoir connecté le CLI gh. Une fois le workflow fusionné, mentionnez @claude dans une issue ou une pull request pour lui confier une tâche.

Claude Code hors du terminal

Pour apprendre de façon structurée

Pour aller plus loin, la formation Claude Code de Dyma propose 25 chapitres en vidéo, en français, du CLI jusqu’à la CI/CD, autour d’un projet fil rouge : CLI, Desktop, VS Code et cloud, contexte, permissions, CLAUDE.md, skills, MCP, sous-agents, worktrees, boucles (/goal, /loop, /schedule), workflows, hooks, plugins, GitHub et sécurité. Un essai gratuit de 7 jours permet de la découvrir.

Vous ne codez pas et voulez surtout utiliser Claude au quotidien ? La formation Claude est faite pour vous. Pour comparer plusieurs assistants et intégrer l’IA à votre façon de développer, voyez la formation IA pour développeurs.

Dyma est une plateforme de formation indépendante : elle n’est ni affiliée à Anthropic, ni partenaire, ni sponsorisée par l’éditeur de Claude Code.

Questions fréquentes