Comment configurer Claude Code dans votre projet?

Claude Code est l’agent de programmation en ligne de commande d’Anthropic, lancé en aperçu de recherche limité en même temps que Claude 3.7 Sonnet, le 24 février 2025. « En ligne de commande » veut dire qu’il tourne dans votre terminal, la fenêtre de texte où vous tapez des commandes, plutôt que dans un navigateur. « Agent » veut dire qu’il fait plus que suggérer du code : il peut chercher et lire vos fichiers, les modifier, exécuter des tests et d’autres commandes, et créer des commits Git (des enregistrements de modifications), en demandant votre approbation en cours de route. Par défaut, il utilise le modèle claude-3-7-sonnet-20250219.

L’installation prend quelques minutes. Ce guide explique comment la faire avec soin, pour que l’agent connaisse votre projet et ne puisse rien faire que vous n’ayez voulu.

Avant d’installer

Vérifiez la configuration requise dans la documentation d’Anthropic :

Claude Code se paie à l’usage par l’API d’Anthropic, pas par abonnement. La documentation indique des coûts typiques de 5 $ US à 10 $ US par développeur par jour, et prévient qu’un usage intensif peut dépasser 100 $ US l’heure. Fixer une limite de dépenses dans la Console avant de commencer est une première étape raisonnable.

Étape par étape : installation et première séance

Lancez ces commandes dans votre terminal. Remplacez my-project par votre propre dossier.

# 1. Installer (ne pas utiliser sudo)
npm install -g @anthropic-ai/claude-code

# 2. Aller dans votre projet
cd my-project

# 3. Lancer Claude Code
claude

La première fois que vous lancez claude, il vous guide dans une connexion OAuth unique (une façon standard d’autoriser une application) avec votre compte Console. La documentation déconseille d’installer avec sudo, la commande qui exécute quelque chose avec des droits d’administrateur, parce que cela peut causer des problèmes de permissions et des risques de sécurité; si npm se plaint de permissions, suivez plutôt la solution donnée dans la section de configuration de la documentation.

Une fois son invite affichée, commencez par lire, pas par modifier :

résume ce projet : ce qu’il fait, comment il est organisé et comment lancer les tests

Lancez ensuite la commande à barre oblique /init. Elle écrit un fichier appelé CLAUDE.md, un guide du projet destiné à Claude. Ouvrez-le, corrigez ce qui est faux et ajoutez ce dont aurait besoin un nouveau coéquipier : comment installer les dépendances, la commande de test, les règles de style, les dossiers auxquels il ne faut pas toucher. Un court exemple, à titre d’illustration :

# Guide du projet
- Lancer les tests avec npm test
- Style de code — indentation de 2 espaces, pas de points-virgules
- Ne jamais modifier les fichiers de /legacy sans demander d'abord
- Écrire un court test pour chaque bogue corrigé

Validez CLAUDE.md dans votre dépôt, comme le recommande la documentation, pour que toutes les personnes qui utilisent Claude Code sur le projet partent du même guide.

Quelques autres commandes valent la peine d’être connues dès le premier jour : /cost indique combien de jetons la séance a utilisés, /compact condense une longue conversation pour économiser des jetons, et /clear repart à zéro entre deux tâches sans lien.

Comment lui accorder des permissions en toute sécurité?

Claude Code utilise des permissions par paliers. Lire des fichiers, lister des dossiers et chercher dans le code ne demandent aucune approbation. Exécuter une commande shell demande votre approbation chaque fois, et si vous répondez Yes, don't ask again (oui, ne plus demander), ce choix est retenu pour cette commande dans ce dossier de projet. Modifier ou créer des fichiers demande aussi une approbation, et le « ne plus demander » pour les modifications ne dure que jusqu’à la fin de la séance.

Commencez de façon stricte. Pendant les premières séances, approuvez chaque action une par une et lisez ce qu’il veut exécuter. Vous verrez vite quelles commandes sont routinières et inoffensives, typiquement votre commande de test ou de vérification du code (lint). N’autorisez que celles-là, par leur nom, dans les paramètres du projet :

# Laisser la commande de test s'exécuter sans demander
claude config add allowedTools "Bash(npm test)"

# Tenir l'agent à l'écart des dossiers dont il n'a jamais besoin
claude config add ignorePatterns "node_modules/**"

Gardez en approbation manuelle tout ce qui a des effets durables : supprimer des fichiers, installer des paquets, pousser vers GitHub, ou les commandes qui touchent des bases de données ou des serveurs. Travaillez sur une branche Git pour que chaque modification puisse être examinée et annulée.

Méfiez-vous du contenu externe. Une page Web, un ticket (issue) ou un fichier venant de quelqu’un d’autre peut contenir des consignes cachées destinées à l’IA, une attaque appelée injection de prompt. Par défaut, Claude Code bloque des commandes comme curl et wget, qui récupèrent n’importe quel contenu Web, et demande avant les opérations sensibles, mais la documentation conseille d’examiner les commandes proposées, de ne pas transmettre de texte non fiable à Claude par un tube (pipe) et de vérifier les modifications aux fichiers importants. Enfin, l’option --dangerously-skip-permissions supprime toutes les demandes d’approbation; Anthropic recommande de ne l’utiliser qu’à l’intérieur d’un conteneur Docker sans accès à Internet, jamais sur votre machine de tous les jours.