Claude Code évolue rapidement

Certaines options peuvent changer.

Si tu rencontres un souci, contacte-moi directement sur LinkedIn !

Claude Code est l’outil de développement agentique d’Anthropic qui vit dans ton terminal et permet de transformer tes idées en code plus rapidement.

Plutôt qu’un simple assistant de complétion, Claude Code comprend l’ensemble de ta base de code, utilise tes outils shell habituels (Bash, grep, git…) et peut prendre des actions automatiques (création/édition de fichiers, exécution de commandes, commits Git, etc.) pour accélérer le développement. En d’autres termes, c’est un assistant IA intégré au terminal, conçu pour être transparent et sécurisé, te laissant le contrôle de chaque opération.

📅 Dernière mise à jour : 28 juillet 2025

SOMMAIRE

1- Installation et configuration initiale

Prérequis système

Avant d’installer Claude Code, assure-toi que ta machine remplit les conditions minimales recommandées par Anthropic :

  • Systèmes d’exploitation : macOS 10.15 ou ultérieur, Ubuntu 20.04+ / Debian 10+, ou Windows (via WSL).
  • Matériel : au moins 4 Go de RAM.
  • Logiciels : Node.js 18 ou supérieur.
  • Réseau : une connexion Internet stable (nécessaire pour l’authentification et le traitement IA).
  • Shell : Claude Code supporte les shells Unix courants (Bash, Zsh, Fish)

Si tous ces éléments sont en place, tu peux installer Claude Code.

Installation standard

Pour les étapes suivantes, tu as 2 solutions :

  • Tu ouvres ton IDE préféré et tu ouvres un terminal
  • Tu utilises le terminal de ta machine directement

Installe Claude Code globalement via npm (sans sudo)

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

Attention : n’utilises pas sudo npm install -g, car cela peut causer des problèmes de permissions et de sécurité. Cette commande télécharge et installe la dernière version de l’outil.

Vérification de l’installation

Après l’installation, vérifies que Claude Code est bien opérationnel en lançant :

claude doctor

Cette commande « doctor » vérifie la santé de ton installation et indique le type d’installation (installer npm, binaire natif, etc.). Elle est recommandée pour détecter immédiatement tout problème (permissions, PATH, etc.).

Premier démarrage et authentification

Pour la première utilisation, entres dans le répertoire de ton projet :

  • Si tu es dans ton IDE, charge ton projet.
  • Si tu es dans le terminal de ta machine, entre directement la commande :
cd votre-répertoire-projet

Et lances Claude Code

claude

Le programme te guidera alors pour t’authentifier.

Plusieurs modes d’authentification sont supportés :

  • Console Anthropic (OAuth) : méthode par défaut : un navigateur s’ouvre pour te connecter sur console.anthropic.com.
  • Application Claude (Pro/Max) : si tu as un abonnement Pro ou Max sur claude.ai, tu peux te connecter avec tes identifiants Claude.
  • Plateformes Cloud Entreprise : tu peux intégrer l’authentification via Amazon Bedrock ou Google Vertex AI (utile en entreprise).

Une fois connecté, Claude Code est prêt à l’emploi dans ton terminal.

💡 Pour en savoir plus

🔥 Astuce

Si tu utilises VSCode, une fois installé tu peux accéder à la fenêtre de Claude code avec le raccourci : Command + esc

2- Configuration avancée et optimisation

Fichier de configuration settings.json

Claude Code utilise un fichier settings.json hiérarchique pour la configuration.

Tu disposes de trois niveaux de configuration :

  • Paramètres utilisateur (~/.claude/settings.json) : s’appliquent à tous tes projets personnels.
  • Paramètres de projet (./.claude/settings.json) : versionnés dans le dépôt Git, partagés avec l’équipe.
  • Paramètres locaux (./.claude/settings.local.json) : non versionnés (souvent ignorés par Git), pour tes préférences personnelles spécifiques au projet.

Cette hiérarchie est explicitée dans la documentation officielle.

Par exemple, un réglage présent à la fois dans le fichier global et le fichier projet sera résolu selon la priorité (le projet l’emporte sur l’utilisateur).

Le fichier settings.json permet de définir notamment :

  • Permissions (allow/deny) : listes de règles pour autoriser ou bloquer certains outils ou commandes.
  • Environnement (env) : variables d’environnement injectées à chaque session
  • Autres options : durée de rétention des mémoires, inclusion du tag « co-authored-by Claude », etc.

Exemple avancé de settings.json

Par exemple, tu peux créer .claude/settings.json avec :

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "WebFetch"
    ]
  },
  "env": {
    "ANTHROPIC_API_KEY": "<votre_clé_api>",
    "BASH_MAX_TIMEOUT_MS": "30000"
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30
}

Ici, la section permissions autorise quelques commandes Bash sûres et interdit curl, tandis que env fixe la clé API et la durée maximale pour les commandes longues. Cette structure est conforme aux exemples de la doc.

Variables d’environnement essentielles

En complément du settings.json, Claude Code réagit à plusieurs variables d’environnement clés. Parmi les plus courantes :

  • ANTHROPIC_API_KEY : ta clé API Anthropic (envoyée dans l’en-tête des requêtes)
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS : limite le nombre maximal de tokens dans les réponses de Claude
  • BASH_MAX_TIMEOUT_MS : définit le délai maximal (en ms) que Claude peut accorder aux commandes Bash longues
  • DISABLE_TELEMETRY : met à 1 pour désactiver totalement la télémétrie statistique de Claude Code
  • CLAUDE_CODE_USE_BEDROCK : active l’usage d’Amazon Bedrock plutôt qu’Anthropic API (utile en entreprise)

Ces variables peuvent être exportées dans ton shell ou fixées dans le fichier settings.json sous env. Par exemple, export ANTHROPIC_API_KEY=xxxxx ou bien :

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_API_KEY": "xxxxx",
    "BASH_MAX_TIMEOUT_MS": "60000"
  }
}

💡 Pour en savoir plus

3- Maîtrise du fichier de mémoire CLAUDE.md

Le fichier CLAUDE.md sert de mémoire pour Claude Code : il contient les instructions, conventions et informations clés de ton projet. Claude Code le charge automatiquement au démarrage pour enrichir son contexte.

Création et Initialisation

Pour créer un fichier CLAUDE.md basique, utilises la commande slash intégrée :

/init

Cette commande génère un CLAUDE.md pré-rempli de sections standard (architecture, commandes usuelles, conventions, etc.) adapté à ton projet. Tu peux ensuite l’éditer pour détailler ta configuration.

Structure optimale du CLAUDE.md

Un bon CLAUDE.md comporte des sections claires. Voici un exemple de structure recommandée (illustratif) :

# Projet MonAppli

## Architecture et Technologies
- Stack : Node.js, Express, PostgreSQL
- Base de données : PostgreSQL
- Conteneurisation : Docker, Kubernetes

## Commandes Essentielles
- Tests : `npm test`
- Build : `npm run build`
- Déploiement : `npm run deploy`

## Conventions de Code
- Indentation : 2 espaces
- Noms de variables : camelCase
- Style de commit : Conventional Commits

## Workflows Git
- Branches de feature depuis `develop`
- Squash commits avant merge
- Tests requis avant PR

## Fichiers Critiques
- `src/auth.js` : logiques d'authentification
- `config/db.js` : config base de données

Ce canevas s’inspire des recommandations d’Anthropic : inclure les raccourcis de build/test, les standards de style, les technologies utilisées, etc.

L’objectif est de donner à Claude le maximum de contexte pertinent pour ton projet (architecture, scripts utiles, règles de codage, etc.).

Hiérarchie des fichiers CLAUDE.md

Claude Code charge récursivement les mémoires CLAUDE.md depuis le répertoire courant jusqu’à la racine. Il reconnaît trois types de mémoires :

  1. Mémoire utilisateur globale ~/.claude/CLAUDE.md : instructions ou préférences valables pour tous tes projets.
  2. Mémoire projet ./CLAUDE.md (à la racine du dépôt) : instructions partagées par l’équipe sur le projet en cours.
  3. Mémoire locale projet ./CLAUDE.local.md : anciennement utilisée pour des préférences perso au sein d’un projet (dépréciée au profit des imports).

Lorsque tu lances Claude Code dans un sous-dossier d’un projet, Claude remonte l’arborescence (sans dépasser la racine /) et charge tous les CLAUDE.md ou CLAUDE.local.md qu’il trouve. Ainsi, un CLAUDE.md placé à la racine s’applique à tout le projet, alors qu’un CLAUDE.md dans un sous-dossier n’est chargé que si tu travailles dans ce sous-dossier.

Importations et Modularité

Tu peux découper ta mémoire en plusieurs fichiers Markdown grâce aux imports. Dans CLAUDE.md, indiques un chemin avec @, par exemple :

Voir @README pour le contexte du projet et @scripts/deploy.md pour les commandes de déploiement.

# Fonctions Git
- Workflow : @docs/git-workflow.md
- Préférences : @~/.claude/mes-preferences.md

Claude Code interprète @path/to/file en important le contenu du fichier référencé. Les imports acceptent à la fois des chemins relatifs et absolus (tu peux importer depuis ta home, ex. @~/.claude/…). Cela permet de factoriser le contenu : chaque sous-équipe ou individu peut maintenir des fichiers distincts sans surcharger un unique CLAUDE.md. Les imports peuvent être imbriqués (profondeur max 5).

💡 Pour en savoir plus

4- Commandes et workflows opérationnels

Commandes CLI essentielles

Claude Code offre des commandes utiles via le CLI. Parmi les principales :

  • claude : démarre le mode REPL interactif
  • claude “votre requête” : lance une tâche et affiche la réponse directement
  • claude -p “votre requête” : mode print (non interactif), renvoie la réponse puis quitte
  • claude -c : continue la dernière conversation en cours
  • claude update : met à jour Claude Code vers la dernière version (voir section maintenance).

Par exemple, claude -p “expliquer cette fonction” affichera immédiatement la réponse (utile pour de simples questions rapides).

Commandes slash intégrées

En session interactive, les commandes slash (/commande) permettent de contrôler Claude et l’environnement. Les plus utilisées sont :

  • /help : Affiche l’aide interactive
  • /init : Initialise le projet (génère un CLAUDE.md basique)
  • /clear : Efface l’historique courant pour repartir d’un contexte vierge
  • /config : Affiche ou modifie la configuration courante
  • /permissions : Affiche/édite les permissions en cours
  • /memory : Ouvre les fichiers de mémoire (CLAUDE.md, etc.) dans ton éditeur
  • /review : Demande une revue de code automatique sur les changements en cours
  • /cost : Affiche les statistiques d’utilisation des tokens dans la session

Ces commandes interactives sont décrites dans la documentation et rendent le workflow très fluide.

Workflows Recommandés

Anthropic et la communauté recommandent des workflows structurés pour tirer le meilleur de Claude Code.

Par exemple, le cycle Planifier – Coder – Vérifier - Committer (ou *Plan-Code-***Review-***Commit*) fonctionne bien :

  1. Planifier : Réfléchir avant de faire quelque chose et donc utiliser la posture d’architecte avant celle de l’implémentation. Utiliser alors le plan mode de Claude code (pour changer de mode Maj + Shift). Demandes-lui de formuler un plan d’action clair pour la fonctionnalité que tu veux créer. Cette étape de réflexion (« think hard ») améliore les chances de succès pour les tâches complexes. N’hésites pas à itérer si besoin.
  2. Coder : Une fois que le plan est proposé, Claude Code va te demander si il peut l’implémenter. Tu peux continuer en mode plan pour améliorer ou corriger ta demande si ce n’est pas bon. Si tu lui demande d’implémenter, Claude génère le code en s’appuyant sur le contexte accumulé en suivant le plan établi.
  3. Vérifier : Passe en revue le code généré en faisant une review humaine / manuel afin de valider que ce qui a été généré te conviens.
  4. Committer : Enfin, une fois le code validé, demandes à Claude de rédiger un commit/PR (claude commit ou /review), avec un message approprié. Tu pourra également utiliser les Github Action pour demander une review par Claude Code.

De même, l’approche Test-Driven Development (TDD) est bien adaptée : on commence par demander à Claude d’écrire les tests unitaires (qui vont échouer), puis on lui demande d’écrire le code pour faire passer ces tests, en procédant par itérations jusqu’à réussir.

Ces workflows recommandés figurent dans la littérature officielle d’Anthropic et permettent de structurer l’interaction avec Claude pour des résultats fiables.

🔥 Astuce

Pour voir l’ensemble des commandes disponible, tu peux taper / dans le terminal.

Tu peux également créer tes propres commandes.

5- Gestion des permissions et sécurité

Architecture basée sur les permissions

La sécurité est au cœur de la conception de Claude Code. Par défaut, l’agent n’a que des permissions en lecture seule sur votre projet : toute action potentiellement dangereuse (écriture, exécution de scripts, commandes réseau, etc.) nécessite une autorisation explicite de l’utilisateur. Par exemple, l’exécution d’une commande Git ou d’une commande Bash sera toujours précédée d’une invite de confirmation (à moins d’être en liste blanche). Cette approche « juste ce qu’il faut » permet de balancer puissance et contrôle utilisateur.

En pratique, à chaque fois que Claude Code propose de modifier un fichier (Write, Edit, etc.) ou d’exécuter une commande Shell, tu verras un prompt Permission?. Tu as alors le choix d’approuver une seule fois, toujours autoriser, ou refuser. On parle de système d’« allowlist » : les outils autorisés fréquemment peuvent être ajoutés à la liste blanche pour accélérer les sessions.

Configuration des Permissions

Tu peux configurer manuellement l’allowlist au lancement ou dans settings.json. Par exemple, via le CLI :

# Afficher la liste actuelle
claude --allowedTools list
claude --disallowedTools list

# Autoriser des commandes sans invite
claude --allowedTools "Bash(git diff:*)" "Bash(npm test:*)"

# Bloquer des outils dangereux
claude --disallowedTools "Bash(curl:*)" "WebFetch"

Ces flags CLI correspondent aux clés allowedTools et disallowedTools des settings. Tu peux également éditer .claude/settings.json directement et y mettre des règles sous "permissions" : { "allow": [...], "deny": [...] }. Enfin, la commande interactive /permissions permet de visualiser ou modifier dynamiquement ces règles pendant une session.

Bonnes Pratiques de Sécurité

Pour une utilisation sûre de Claude Code, suis ces recommandations officielles :

  • Révises toujours les commandes proposées avant d’approuver. Claude affiche souvent une description en langage naturel des actions.
  • Évites de soumettre des entrées non fiables (code tiers, logs bruts) sans vérification.
  • Audit les modifications apportées aux fichiers critiques (config de sécurité, scripts de déploiement, etc.) avant le commit.
  • Exécutes Claude Code dans un environnement isolé (VM ou conteneur) lorsque tu travailles avec des scripts ou des sites externes.
  • Signales tout comportement suspect via la commande /bug (consulte la documentation d’Anthropic pour remonter des incidents).

Ces pratiques minimisent les risques d’erreurs ou d’attaques (comme l’injection de prompts), en suivant les principes de sécurité d’Anthropic.

6- Intégration de Model Context Protocol (MCP)

Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) est un protocole ouvert qui permet à Claude Code de se connecter à des serveurs externes spécialisés. En gros, MCP agit comme un pont entre ton agent Claude et des outils/serveurs (base de données, API, services internes…), en fournissant du contexte spécifique au modèle. Grâce à MCP, tu peux par exemple demander à Claude d’interroger une base PostgreSQL, de créer un ticket Jira, ou d’interagir avec un CRM, tout en gardant l’IA sur la branche du modèle. Anthropic décrit MCP comme un protocole standard « USB-C » pour brancher du contexte externe sécurisé.

Important : n’installes que des serveurs MCP de confiance, surtout s’ils peuvent accéder à Internet, car ils réintroduisent un vecteur possible d’injection de prompt.

Configuration MCP

La configuration des serveurs MCP se fait via la commande claude mcp.

Quelques exemples :

- Serveur STDIO local (par ex. PostgreSQL) :

claude mcp add postgres-server /chemin/vers/postgres-server \
    --env CONN_STR="postgresql://user:pass@localhost:5432/db"

(Lance un serveur MCP local pour interroger PostgreSQL).

- Serveur SSE (Server-Sent Events) :

claude mcp add --transport sse github-server https://api.github.com/mcp

(Par exemple, pour interagir avec l’API GitHub via un pont SSE).

- Serveur HTTP :

claude mcp add --transport http linear-server https://api.linear.app/v1/mcp

(Toute URL HTTP ou HTTPS acceptant le protocole MCP).

D’autres options permettent d’ajouter des en-têtes personnalisés, de changer le scope (projet/utilisateur), etc. Une fois ajouté, tu peux lister les serveurs avec claude mcp list et les supprimer avec claude mcp remove. Anthropic recommande d’utiliser /mcp à l’intérieur de la session Claude Code pour gérer les connexions distantes et l’authentification OAuth si nécessaire.

Serveurs MCP Populaires

Dans la pratique, plusieurs serveurs MCP sont couramment utilisés :

  • PostgreSQL/MySQL : accès aux bases de données internes.
  • GitHub : gestion des issues, pull requests, commentaires (via un pont ou l’API GitHub).
  • Linear/Jira : gestion des tickets et planification agile.
  • Sentry : interroger la plateforme de monitoring d’erreurs.
  • Mémoire externe : comme un service vectoriel (ex : ChromaDB) pour stocker des informations supplémentaires.

Ces intégrations étendent considérablement les capacités de Claude Code. Par exemple, après configuration d’un serveur GitHub MCP, tu pourras exécuter :

claude -p "Créer une issue GitHub avec ce titre et ce contenu" --output-format json

et Claude Code utilisera le serveur MCP GitHub pour créer l’issue directement.

💡 Pour en savoir plus

7- Optimisation des performances

Gestion des tokens

Chaque requête à Claude Code consomme des tokens (via Anthropic API), ce qui a un coût.

Pour optimiser l’usage des tokens, suis ces conseils de la documentation :

  • Compactes la conversation quand elle devient longue. Claude compresse automatiquement le contexte à ~95% de capacité, mais tu peux aussi lancer manuellement /compact [instructions] pour recentrer sur l’essentiel.
  • Questions rapides en mode print : pour de petites requêtes, claude -p “votre question” renvoie le résultat directement sans dialogue prolongé.
  • Choisis le bon modèle : utilises la commande /model pour passer à un modèle plus léger ou plus adapté.
  • Batching : regroupes plusieurs petites requêtes similaires en une seule.
  • Surveilles avec /cost : cette commande affiche les statistiques token de la session.

Techniques d’optimisation

  • Actives Auto-compact ou personnalises-le via /config. Tu peux ajouter un paragraphe # Summary instructions dans le CLAUDE.md pour guider l’algorithme de compactage.
  • Pour les sessions de debug, actives le mode verbose :
claude config set verbose true --global

Cela affiche en détail chaque commande Bash exécutée.

  • Pour l’automatisation, préfères le mode silencieux (print) : utiliser claude -p … —output-format json permet d’obtenir la réponse au format JSON exploitable par script.

Modes d’utilisation efficaces

Quelques exemples de réglages pratiques :

- Mode verbeux

claude config set verbose true --global

Affiche tout (utile pour comprendre précisément les actions de Claude).

- Mode automatisé (print, JSON)

claude -p "votre tâche" --output-format json

Ne lance pas le REPL et formatte la sortie en JSON, idéal pour scripts et intégrations.

- Redémarrage minimal

Souvent, claude -p "…", ou utiliser /clear pour repartir à zéro lorsque le contexte est pollué.

8- Workflows avancés et cas d’usage

Développement de fonctionnalités complexes

Pour une fonctionnalité complexe, voici un exemple de séquence de commandes :

claude "analyser l'architecture actuelle du module auth"
claude "créer un plan détaillé pour implémenter l'authentification 2FA"
claude "implémenter le plan étape par étape avec tests"
claude commit --message "Ajoute 2FA au module auth"

Tu peux même terminer par /review pour que Claude analyse les changements finaux. Ce workflow multi-étapes (analyse, plan, code, commit) reprend le pattern Think-Plan-Code-Commit évoqué plus haut.

Débogage et Maintenance

Claude Code excelle aussi pour le debug et la maintenance :

claude "analyser l'erreur suivante: [copier-coller l'erreur ici] et proposer une solution"
claude "refactoriser ce module pour améliorer la lisibilité"
claude "optimiser ces requêtes SQL pour de meilleures performances"

Dans ces cas, Claude lit le code concerné, identifie les problèmes et suggère des corrections ou améliorations.

Documentation et Tests

Claude Code peut générer automatiquement de la documentation ou des tests :

claude "générer une documentation complète pour l'API utilisateur basée sur les routes existantes"
claude "créer des tests unitaires pour les fonctions suivantes: [liste]"
claude "créer des tests d'intégration pour ce workflow de checkout"

En lui fournissant suffisamment de contexte, Claude produit des commentaires, des README ou des scripts de test conformes à test standards.

9- Intégration en équipe

Configuration partagée

Pour standardiser l’usage de Claude Code en équipe, versionnes les fichiers de config .claude. Par exemple, ton dépôt peut contenir .claude/settings.json avec les règles communes du projet (outils autorisés, variables d’env. par défaut, etc.). Un tel fichier partagé garantit que tous les développeurs ont les mêmes permissions et scripts de base.

Bonnes pratiques collaboratives

  • Partager CLAUDE.md via Git : ainsi, chaque membre connaît les conventions et raccourcis du projet.
  • Documenter les workflows : places dans CLAUDE.md les instructions spécifiques (ex : comment démarrer un service, lister les commandes métier, etc.).
  • Standardiser les permissions : ajoutes les outils sûrs dans .claude/settings.json commun pour éviter les autorisations récurrentes.
  • Former les nouveaux venus : un petit tutoriel CLAUDE.md global peut expliquer comment utiliser Claude Code dans le contexte de votre projet.

Intégration CI/CD

Claude Code peut être intégré à tes pipelines d’intégration continue. Par exemple, il existe une Action GitHub officielle anthropic-ai/claude-code-action qui permet de lancer automatiquement des revues de code. Un workflow type .github/workflows/claude-review.yml peut contenir :

name: Claude Code Review
on:
    pull_request:
        types: [opened, synchronize]
jobs:
    review:
        runs-on: ubuntu-latest
        steps:
            - uses: actions/checkout@v3
            - name: Claude Code Review
              uses: anthropic-ai/claude-code-action@v1
              with:
                  anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}

Cela déclenche une revue automatisée via Claude Code sur chaque PR. À minima, on peut aussi simplement appeler claude -p … dans un script CI pour générer des rapports ou créer des issues.

10- Monitoring et maintenance

Surveillance de l’utilisation

Pendant tes sessions, quelques commandes permettent de suivre l’état de Claude Code :

  • /cost : affiche le nombre de tokens utilisés dans la session en cours. Utile pour surveiller la consommation.
  • /status : donne le statut du système et du compte (si disponible).
  • claude doctor : vérifie une nouvelle fois l’intégrité de l’installation (à utiliser après un update ou en cas de doute).

Ces outils sont documentés sur les pages d’Anthropic et t’aident à garder un œil sur la santé et les coûts de ton usage.

Maintenance régulière

Quelques recommandations régulières :

  • Mettre à jour Claude Code régulièrement : claude update installes la dernière version.
  • Nettoyer les historiques anciens si non utiles : la commande /clear supprime l’historique dans la session active.
  • Revoir les permissions périodiquement (/permissions) pour ajuster la liste blanche/noire selon l’évolution des besoins.
  • Optimiser CLAUDE.md : met à jour son contenu quand les process ou conventions changent.

Ces actions garantissent que votre environnement reste à jour et sécurisé.

Dépannage courant

En cas de problème, voici quelques commandes utiles :

- Permissions bloquées

Tu peux réinitialiser le mode par défaut pour demander moins souvent en faisant par exemple

claude config set --global defaultPermissionMode acceptEdits

(Cette clé existe dans settings.json pour accepter d’emblée les modifications).

- Problèmes de connexion/compte

claude doctor peut identifier des soucis, ou utilises /logout puis reconnectes-toi au bon compte (Pro/Max). Le ticket Anthropic suggère parfois de faire claude update et relancer le terminal.

- Réinitialiser la config (dernier recours)

En dernier recours, tu peux supprimer ou renommer ~/.claude/ pour repartir à zéro (réinstall, re-authentification).

11- Techniques avancées et astuces de pro

Commandes slash personnalisées

Tu peux définir tes propres commandes slash réutilisables pour toute l’équipe ou uniquement pour toi même.

Commandes de projet

Commandes stockées dans votre dépôt et partagées avec votre équipe.

Par exemple, crées un dossier .claude/commands/ dans ton projet, puis un fichier Markdown pour chaque commande :

mkdir -p .claude/commands
echo "Analyser ce code pour des problèmes de performance et proposer 3 optimisations spécifiques" \
  > .claude/commands/optimize.md

Cela crée la commande /optimize (projet) que Claude exécutera en substituant le code actuel.

Les commandes définies dans ~/.claude/commands/ seront disponibles globalement (sauf option -s local). C’est un excellent moyen de partager des routines complexes (analyse de code, scripts de revue, etc.) en interne.

Pour utiliser la nouvelle commande il suffit de taper :

/project:optimize

Commandes personnelles

Commandes disponibles dans tous tes projets.

Par exemple, créer un dossier ~/.claude/commands/ puis un fichier markdown pour chaque commande personnelle :

mkdir -p ~/.claude/commands
echo "Examiner ce code pour les vulnérabilités de sécurité :" \
  > ~/.claude/commands/security-review.md

Pour utiliser la commande il faudra taper :

/user:security-review

💡 Pour en savoir plus

Intégration avec des outils externes

N’hésites pas à combiner Claude Code avec tes scripts Bash et outils CLI habituels. Par exemple, tu peux écrire un alias ou un script shell pour envoyer des résultats ripgrep à Claude :

# Alias pour rechercher et corriger
alias search-and-fix='rg -n "TODO" | claude -p "Corriger tous les TODO listés ci-dessus"'

# Pipeline avec git
git diff | claude -p "Ci-dessus le diff d'une PR : propose des améliorations de code ou de style"

Claude saura lire le texte passé en entrée standard et y répondre. L’idée est d’automatiser tes tâches courantes en tirant parti de sa compréhension du code.

Automatisation avec scripts

Exploites Claude Code dans des scripts Bash pour des tâches répétitives. Par exemple, un script claude-review.sh pourrait automatiser une revue globale :

#!/bin/bash
echo "Exécution d'une revue de code automatisée..."
claude -p "Réviser l'ensemble des fichiers modifiés et produire un rapport de qualité" \
       --output-format json > review-report.json

Notifications

Afin d’activer les alertes sonores lorsque les tâches sont terminées il faut configurer :

claude config set --global preferredNotifChannel terminal_bell

12- Optimisation des coûts et performances

Stratégies de réduction des coûts

Si tu utilises les formules Pro ou Max d’Anthropic, notes que le budget Claude Code est mutualisé avec tes utilisations de Claude classique. Pour référence, voici les limites annoncées :

  • Pro (20 $/mois) : de 40 à 80 heures d’utilisation avec Claude Sonnet 4
  • Max 5x Pro (100 $/mois) : de 140 à 280 heures d’utilisation avec Sonnet 4 et de 15 à 35 heures avec Opus 4
  • Max 20x Pro (200 $/mois) : de 240 à 480 heures d’utilisation avec Sonnet 5 et 24 à 40 heures avec Opus 4
  • Pour tous les abonnés : limite d’utilisation réinitialisée toutes les 5 heures + limite hebdomadaire globale réinitialisée tous les 7 jours + Limite hebdomadaire Claude Opus 4 réinitialisée tous les 7 jours

Ces chiffres proviennent du support Anthropic et donnent une idée des limites de rate limit applicables. Les utilisateurs Pro peuvent seulement utiliser le modèle Sonnet, tandis que les abonnés Max ont accès à Sonnet et Opus (penser à changer de modèle avec /model pour ne pas saturer les quotas).

Techniques d’optimisation (récapitulatif)

Quelques astuces pour consommer moins de tokens :

  • Mode Compact : raccourcis la conversation périodiquement (/compact).
  • Bon modèle : n’utilises Opus (le plus puissant) que si nécessaire. Sinon, restes sur Sonnet ou Haiku via /model.
  • Regroupement : envoie un gros prompt plutôt que 10 petits si possible.
  • Batching : combines plusieurs fichiers ou tâches dans une seule requête.
  • Surveillance : installes un moniteur d’usage pour suivre l’usage en temps réel.

La commande /cost et le tableau de suivi dans la console Anthropic sont tes alliés pour vérifier que tu restes dans les limites prévues.

Monitoring intelligent

Pour aller plus loin, tu peux intégrer des outils externes de suivi. Par exemple :

npm install -g claude-usage-monitor
claude-usage-monitor --realtime

Ces outils tierces (non officiels) affichent ta consommation en direct. Tu peux aussi configurer des alertes dans ta console Anthropic pour être prévenu avant de dépasser les quotas.

Conclusion : vers une maîtrise complète

Claude Code est une révolution pour le développement assisté par IA. Il transforme tes workflows en intégrant les capacités de Claude directement dans le terminal.

Les points clés à retenir pour en tirer le meilleur parti :

  1. Investis dans la configuration : prends le temps de configurer correctement settings.json (permissions, variables) et mets à jour régulièrement.
  2. Soignes tes mémoires CLAUDE.md : fournis à Claude un contexte riche (stack, commandes, normes) pour améliorer la pertinence de ses réponses.
  3. Adoptes des workflows : structures l’interaction (AIDD, explore-plan-code-commit, TDD, etc.) pour guider l’IA et obtenir des résultats cohérents.
  4. Maintiens le contrôle : révises toujours les actions proposées, limites les permissions aux essentiels et exécutes les scripts potentiellement dangereux en environnement isolé.
  5. Optimises constamment : surveilles les coûts (/cost), compresses le contexte (/compact) et adaptes le modèle pour réduire la consommation tout en obtenant la qualité souhaitée.

En appliquant ces bonnes pratiques avancées, Claude Code deviendra un véritable multiplicateur de productivité. L’IA agit comme un copilote dans votre terminal, te déchargeant des tâches répétitives et te permettant de te concentrer sur l’essentiel : résoudre les problèmes complexes et créer de la valeur. L’avenir du développement logiciel est agentique et avec Claude Code tu es prêt à le façonner.

Pour aller plus loin

La documentation officielle d’Anthropic (en français)

À consulter ICI.