Combien de tokens consomme une session typique Claude Code ?

Une session de 1 heure sur Claude Sonnet 4.6 consomme typiquement 50 000 à 200 000 tokens input et 10 000 à 50 000 tokens output, soit environ 0,5 à 2 USD si API direct, inclus dans Claude Pro pour la majorité des cas modérés.

Comment annuler une opération en cours dans Claude Code ?

Ctrl+C interrompt l'agent. Pour reprendre : claude --resume ou nouvelle session avec contexte conservé selon configuration. La session principale conserve l'historique sauf si /clear est utilisé pour repartir du contexte vierge.

Claude Code tutoriel pratique : installation, workflows, sub-agents

📚 Cet article fait partie de notre cluster IA pour PME francophones. Pour le panorama complet (Claude vs GPT-5 vs Gemini vs Mistral, prompt engineering, RAG, agents, Ollama self-hosté, coûts en F CFA), consultez : IA et LLM pour PME francophones — panorama complet 2026.

Lecture : 16 minutes · Niveau : développeur intermédiaire · Mise à jour : avril 2026

Claude Code est passé en moins d’un an d’outil de niche à standard du développement IA-assisté. Selon les enquêtes 2026, c’est l’outil le plus aimé des développeurs (46 % « most loved ») devant Cursor (19 %) et Copilot (9 %). Sa philosophie : un agent qui vit dans votre terminal, lit votre codebase, modifie des fichiers, lance des tests, gère git — par dialogue en langage naturel. Ce tutoriel couvre toute la chaîne pratique : installation Node.js, premier projet, fichier CLAUDE.md, slash commands custom, sub-agents, hooks, MCP servers, plugins, et workflows réels pour freelance ou PME ouest-africaine.

Pour le contexte stratégique (panorama outils, choix par profil), voir le pillar AI coding développeur. Pour le comparatif outils, voir Cursor vs Copilot vs Claude Code. Pour les serveurs MCP, voir MCP tutoriel.

1. Prérequis et installation

Prérequis.
– Node.js 18+ installé (node --version pour vérifier).
– Compte Anthropic : créer sur claude.ai (Pro à 20 USD/mois inclut Claude Code limited, Max plans à 100-200 USD/mois pour usage intensif).
– Alternative : compte API Anthropic avec carte de paiement (facturation au token).
– Terminal : bash, zsh, fish, ou PowerShell sur Windows.

Installation.

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

Vérification :

claude --version

Authentification.

claude

Au premier lancement, Claude Code propose d’authentifier. Choisir entre :
– Login Claude Pro/Max (recommandé pour démarrer) : ouvre un navigateur pour OAuth.
– API Key Anthropic : coller la clé depuis console.anthropic.com.

Mise à jour.

claude update

À faire 1-2 fois par mois pour bénéficier des nouvelles features (modèles, plugins, skills).

Désinstallation propre.

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude

2. Premier lancement et permissions

Démarrer dans un projet.

cd ~/projets/mon-app
claude

L’agent affiche le dossier courant et attend une instruction. Première invite :

> Décris-moi ce projet en 5 lignes

Il lit les fichiers clés (package.json, README, structure), produit une synthèse. Test simple pour valider la fluidité.

Permissions. Claude Code demande confirmation avant chaque opération potentiellement risquée (modification fichier, exécution commande shell). Trois modes :
– Default (recommandé débutant) : confirmation à chaque tool sensible.
– Allow rules : whitelist par patterns (ex. Bash(git status) toujours autorisé).
– --dangerously-skip-permissions : autonomie totale, à réserver à sandbox/CI ou prompt très précis.

Configurer les permissions persistantes.
Fichier ~/.claude/settings.json (global) ou .claude/settings.json (projet) :

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git log:*)",
      "Bash(npm test:*)",
      "Read",
      "Grep",
      "Glob"
    ]
  }
}

Modes utiles.
– Plan mode (/plan) : Claude propose un plan d’exécution sans modifier les fichiers, on valide ou ajuste avant exécution.
– Fast mode (/fast) : modèle plus rapide pour tâches simples.
– Default mode : équilibre qualité/vitesse, modèle Sonnet 4.6 typiquement.

3. Fichier CLAUDE.md : le contexte projet

C’est la clé du succès avec Claude Code. À la racine du projet, créer CLAUDE.md qui documente :
– Stack technique (langages, frameworks, versions).
– Conventions de code (tests, linting, naming).
– Architecture générale (structure dossiers, patterns).
– Contraintes (à éviter, à privilégier).
– Contexte métier minimal.

Exemple CLAUDE.md PME ouest-africaine WordPress + WooCommerce :

# Projet : boutique-dakar.sn

## Stack
- WordPress 6.7 + WooCommerce 9.x
- PHP 8.2, MariaDB 10.11
- Hébergement Hetzner CX22 (Allemagne)
- Tests : PHPUnit pour code custom, browser tests via Playwright

## Conventions
- Plugins custom dans `wp-content/plugins/dakar-*`
- Pas de modification core WordPress.
- Hooks et filters préférés à override.
- Code commenté en français, identifiers en anglais.
- Toutes les nouvelles fonctions doivent avoir un test PHPUnit.

## Patterns à éviter
- Pas de jQuery (vanilla JS uniquement).
- Pas de `eval()`, pas de `dynamic SQL` sans préparation.
- Pas de plugin payant inutile.

## Patterns privilégiés
- Caching via Redis (déjà configuré).
- Lazy loading images via attribut natif.
- Optimisation pour 3G mobile (cluster #4).

## Contexte métier
- E-commerce artisanat sénégalais avec paiements Wave / Orange Money / carte CB.
- Cibles : diaspora + clients locaux Dakar.
- Multilingue FR (principal) + EN (secondaire).

## Workflows habituels
- Pull request via GitHub Actions, déploiement automatisé.
- Backup quotidien via WP-CLI cron.

Avec ce contexte, Claude Code génère du code aligné dès la première itération. Ne pas négliger ce fichier — c’est l’investissement à plus haut ROI.

Hiérarchie multi-fichiers. Possible d’avoir CLAUDE.md à plusieurs niveaux :
– Racine projet : contexte général.
– Sous-dossier (ex. app/api/CLAUDE.md) : contexte spécifique backend.
– ~/.claude/CLAUDE.md : préférences globales utilisateur (ton, langue, format).

Claude Code lit hiérarchiquement (le plus spécifique gagne).

4. Workflows quotidiens

Workflow 1 : exploration de codebase (5-15 min).

> Lis tout le dossier src/auth et explique-moi le flow d'authentification
> Quels middlewares sont appliqués sur les routes /admin/* ?
> Trouve où est géré le rate limiting

Workflow 2 : ajout de feature simple (15-45 min).

> Ajoute un endpoint POST /api/users/avatar qui accepte un upload image, le stocke sur S3, met à jour le profil utilisateur. Génère le test PHPUnit correspondant.

Claude Code propose un plan, demande confirmation, modifie les fichiers, lance les tests, présente le diff. Reviewer puis commit.

Workflow 3 : refactoring multi-fichiers (30-90 min).

> Renomme la fonction calculateTotal en computeOrderTotal partout dans le projet, mets à jour les tests, et vérifie qu'il n'y a pas de régression.

Workflow 4 : debug.

> Ce test échoue : tests/checkout.test.js:45. Lis le code testé, identifie la cause, propose un fix.

Workflow 5 : génération tests sur code legacy.

> Lis lib/legacy/payment.php (300 lignes sans test) et génère un set de tests PHPUnit qui couvre les cas critiques.

Workflow 6 : DevOps / CI.

> Crée un workflow GitHub Actions qui lance les tests PHPUnit + Playwright sur PR ouverte, et notifie sur Slack si échec.

Workflow 7 : documentation.

> Génère le README.md de ce projet en français en lisant package.json, structure, et les commentaires existants.

Workflow 8 : migration framework (long).

> Migre ce projet de Laravel 10 vers Laravel 11. Identifie les breaking changes, applique-les un par un, lance les tests après chaque batch.

Mode plan recommandé sur tâches longues : claude /plan pour faire valider la stratégie avant action.

5. Slash commands custom

Slash commands = templates de prompts réutilisables, accessibles via /<nom>.

Slash commands built-in.
– /help : aide.
– /clear : reset contexte session.
– /plan : mode plan.
– /fast : mode rapide.
– /compact : compresser l’historique.

Créer un slash command custom.
Fichier .claude/commands/test-coverage.md (au niveau projet) :

---
description: Génère ou met à jour les tests PHPUnit pour atteindre 80% de couverture sur le module ciblé.
---

Lis le module suivant : $ARGUMENTS

Étapes :
1. Identifie les fonctions publiques sans test ou avec couverture < 80 %.
2. Génère les tests PHPUnit correspondants en respectant les conventions du projet (voir CLAUDE.md).
3. Lance la suite de tests pour valider.
4. Présente un rapport de couverture.

Usage dans Claude Code :

/test-coverage src/payment/processor.php

Slash commands utiles à créer.
– /review : review de la dernière commit.
– /security-audit : audit sécurité du module ciblé.
– /migrate-to : migration framework guidée.
– /docstring : ajout docstrings sur fonctions publiques.
– /translate-comments : traduire commentaires anglais → français.

Slash commands globaux.
Mettre les fichiers .md dans ~/.claude/commands/ pour disponibilité tous projets.

6. Sub-agents pour parallélisation

Concept. Sub-agent = mini-Claude lancé en parallèle pour une tâche isolée, avec son propre contexte. Permet de paralléliser et de protéger le contexte principal.

Sub-agents built-in.
– Explore : recherche dans codebase, isolé.
– Plan : architecture / planning sans modifier fichiers.

Créer un sub-agent custom.
Fichier .claude/agents/test-runner.md :

---
name: test-runner
description: Spécialiste lancement et debug de tests
tools: Bash, Read, Grep
---

Tu es un agent spécialisé dans :
- Lancer la suite de tests appropriée selon le projet (npm test, pytest, phpunit, go test, cargo test).
- Identifier les tests qui échouent.
- Lire le code testé pour diagnostiquer.
- Proposer un fix ciblé.

Tu n'écris jamais de feature : uniquement tests et fixes liés.

Lancement depuis Claude Code principal :

> Lance test-runner sur ce projet, identifie les échecs, propose des fixes

Le sub-agent s’exécute, retourne un rapport.

Sub-agents utiles à créer.
– code-reviewer : review code style, sécurité.
– performance-auditor : profile et propose optimisations.
– doc-generator : génère docs API.
– migration-helper : migration framework spécifique.

Limites. Les plugins-subagents (de plugins partagés) ont des restrictions sécurité (pas de hooks, pas de mcpServers configurables).

7. Hooks pour qualité et automatisation

Concept. Hooks = scripts shell déclenchés sur événements (pre-tool, post-tool, on-stop).

Configuration. Fichier ~/.claude/settings.json ou .claude/settings.json :

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'About to modify file'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/run-linter.sh"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/notify-done.sh"
          }
        ]
      }
    ]
  }
}

Cas d’usage hooks.
– PostToolUse Edit/Write → lancer prettier/eslint, refuser commit si non conforme.
– PreToolUse Bash → bloquer commandes dangereuses (rm -rf /).
– Stop → notification desktop, Slack, ou email quand l’agent finit.

Exemple hook bloquant.
Fichier .claude/hooks/check-tests.sh :

#!/bin/bash
if [ -f "package.json" ]; then
  npm test --silent
  if [ $? -ne 0 ]; then
    echo "Tests failed, blocking commit"
    exit 2
  fi
fi
exit 0

Exit code 2 = bloquant, le message va à Claude qui peut réagir.

8. MCP servers : intégrations clés

MCP (Model Context Protocol) connecte Claude Code à des outils externes : bases de données, GitHub, Slack, navigateurs, etc.

Configuration. Fichier .mcp.json à la racine du projet :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/mydb"]
    }
  }
}

Après config, Claude Code charge ces serveurs au démarrage. Vérifier avec :

> Quels outils MCP sont disponibles ?

Serveurs MCP utiles.
– filesystem : navigation fichiers.
– github : issues, PR, branches.
– postgres / sqlite : bases de données.
– puppeteer : automation navigateur.
– slack : messaging équipe.
– brave-search : recherche web.

Voir tutoriel détaillé MCP servers.

9. Plugins partagés

Concept. Plugin = bundle réutilisable contenant slash commands, sub-agents, hooks, MCP servers, configs.

Installation. Via marketplace Anthropic ou repos GitHub partagés (awesome-claude-code-plugins).

Plugins utiles 2026.
– php-wordpress : commands PHPUnit, WP-CLI, conventions.
– nextjs-vercel : déploiements, optimisations.
– python-django : migrations, tests, Django Admin.
– devops-kubernetes : kubectl, helm, monitoring.
– freelance-toolkit : facturation, tracking temps.

Créer un plugin.
1. Créer dossier mon-plugin/ avec structure : commands/, agents/, hooks/, plugin.json.
2. Documenter dans README.md.
3. Pousser sur GitHub.
4. Partager : autres devs ajoutent via claude plugins install <repo>.

10. Gestion des coûts et plans

Plans Anthropic 2026.
– Claude Free : usage limité, pas adapté Claude Code régulier.
– Claude Pro ($20/mo) : Claude Code inclus avec quota suffisant pour usage modéré.
– Claude Max ($100-200/mo) : usage intensif, modèles plus rapides, priorité.
– API Direct : facturation au token (Sonnet $3/MTok input, $15 output ; Opus $15/MTok input, $75 output environ — vérifier prix actuels).

Comparaison usages réels.
– 10 h/semaine, modèle Sonnet : ~5-15 USD/mois si API direct, couvert par Claude Pro.
– 30 h/semaine, modèle Sonnet : ~30-80 USD/mois API, ou plan Max.
– Power user (Opus + Sonnet, 40+ h/semaine) : 100-300 USD/mois API direct ou Max.

Conseils économie tokens.
– /clear régulier pour limiter contexte historique.
– /compact pour résumer.
– Sub-agents pour isoler tâches lourdes (contexte propre).
– Mode /fast quand simple suffit.
– --max-tokens flag pour limiter output.

Monitoring.
– Dashboard Anthropic console.anthropic.com (si API direct).
– Stats quotidien/mensuel.
– Alertes spending limit recommandé (50 USD/mo, 200 USD/mo selon profil).

11. Pièges fréquents

Lancer Claude Code dans /home ou /. Permission immense, contexte énorme. Toujours cd dans le projet précis avant claude.

Pas de CLAUDE.md. L’agent reproduit les anti-patterns du code existant ou invente des conventions. Investir 30 min pour rédiger CLAUDE.md = ROI immédiat.

Accepter chaque diff sans lire. Bugs production garantis sur logique métier. Toujours lire les changements avant commit.

Skip permissions sans sandbox. --dangerously-skip-permissions en prod ou sur projet réel = potentiellement destructif. Réserver à CI/sandbox.

Sub-agents en spam. Ouvrir 10 sub-agents pour 1 tâche = facturation explose. Utiliser quand vraiment justifié.

Hooks mal écrits. Un hook bloquant qui crash empêche tout. Tester hooks isolément avant déploiement.

Secrets en plain. Tokens GitHub, API keys dans .mcp.json versionné = leak garanti. Utiliser .env + .gitignore.

Ignorer les MCP servers. Ne pas connecter Claude Code à votre DB / GitHub = sous-utiliser massivement l’outil.

Pas de slash commands custom. Re-typer le même prompt 50 fois = perte de temps. Slashifier ce qui se répète.

Mises à jour ignorées. Claude Code évolue vite. claude update mensuel pour rester à jour.

FAQ

Claude Code fonctionne-t-il sous Windows ?

Oui depuis 2025. Soit en natif PowerShell ou bash, soit via WSL2 (recommandé pour fluidité Unix). Installation identique : npm install -g @anthropic-ai/claude-code.

Faut-il connaître le terminal pour utiliser Claude Code ?

Niveau basique requis : cd, ls, git. Pas besoin d’être expert sysadmin. La courbe d’apprentissage est de 1-2 semaines pour fluidité.

Combien de tokens consomme une session typique ?

Une session de 1h sur Claude Sonnet 4.6 consomme typiquement 50 000-200 000 tokens input, 10 000-50 000 output, soit environ 0,5-2 USD si API direct, inclus dans Claude Pro pour la majorité des cas.

CLAUDE.md doit-il être committé ?

Oui, dans le repo du projet. C’est partie intégrante de la doc projet. Il bénéficie à toute l’équipe utilisant Claude Code.

Peut-on utiliser plusieurs comptes Anthropic en parallèle ?

Oui via variables d’environnement ANTHROPIC_API_KEY ou commande claude login pour switcher. Utile pour séparer comptes perso/pro.

Claude Code fonctionne-t-il offline ?

Non, l’inférence est cloud. Pour usage offline : modèles locaux via Ollama + outils comme Aider ou Continue.dev avec backends locaux.

Comment annuler une opération en cours ?

Ctrl+C interrompt l’agent. Pour reprendre : claude --resume ou nouvelle session avec contexte conservé selon configuration.

Où trouver des plugins Claude Code ?

GitHub repos awesome-claude-code et awesome-claude-code-plugins maintenus par la communauté. Marketplace officiel Anthropic en construction en 2026.

Articles liés (cluster AI coding)

Voir aussi : Devenir freelance développeur AO, DevOps moderne PME guide, GitHub Actions CI/CD tutoriel PME.

Article mis à jour le 26 avril 2026. Pour signaler une erreur ou suggérer une amélioration, écrivez-nous.