Démarrer avec Claude Code en 2026 : de l'installation au premier commit

Ce qu'est réellement Claude Code

Claude Code n'est pas une interface de chat. C'est un agent en ligne de commande qui lit votre système de fichiers, exécute des commandes bash, modifie des fichiers et itère sur sa propre production jusqu'à atteindre l'objectif que vous avez décrit. Vous le démarrez dans un répertoire de projet, vous lui donnez une tâche, et il avance pas à pas — lecture du code existant, modifications, exécution des tests, retour en arrière en cas d'échec.

L'implication concrète : Claude Code est à son meilleur sur des problèmes réels et bien cadrés au sein de bases de code réelles. Lui demander d'« aider sur mon projet » conduit à la dérive. Lui demander d'« ajouter une validation d'entrée à la fonction createUser dans src/api/users.ts et de mettre à jour les tests correspondants » donne des résultats.

Étape 1 — Installer

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

Confirmez que l'installation a réussi :

claude --version
# → claude-code 1.x.x

Si une erreur de permissions surgit sur macOS ou Linux, le correctif standard consiste à ajuster les droits du répertoire global de npm plutôt que de lancer npm avec sudo. La documentation d'Anthropic couvre ce point dans la section des prérequis. Sous Windows, lancer le terminal en administrateur résout la plupart des problèmes de permissions, mais la voie WSL2 reste plus fiable pour un usage agentique soutenu.

Étape 2 — S'authentifier

claude login

La commande ouvre une fenêtre de navigateur pour boucler l'OAuth. Une fois l'opération terminée, les identifiants sont stockés dans ~/.claude/ et vous n'aurez pas à recommencer cette étape, sauf changement de compte.

Si vous utilisez directement une clé d'API — par exemple en environnement CI ou sur une machine sans accès navigateur — définissez plutôt la variable d'environnement :

export ANTHROPIC_API_KEY="sk-ant-api03-..."

L'abonnement Claude Pro embarque un quota mensuel de tokens qui couvre un usage individuel modéré. Si vous lancez Claude Code sur de grosses bases de code, écrivez beaucoup de tests ou tournez en boucle, vous atteindrez vite la limite Pro et devrez compléter avec des crédits API. La console Anthropic affiche votre usage en temps réel — consultez-la après vos premières sessions pour vous calibrer.

Étape 3 — Écrire votre CLAUDE.md

Un CLAUDE.md minimal mais efficace couvre cinq points :

# Project: [name]

## Stack
- Runtime: Node 20, TypeScript 5.3
- Framework: Next.js 14 (App Router)
- Database: PostgreSQL via Prisma
- Tests: Vitest, run with `npm test`

## Commands
- Dev server: `npm run dev`
- Build: `npm run build`
- Lint: `npm run lint` — fix before committing
- Migrate: `npx prisma migrate dev`

## Rules
- All new API routes go in src/app/api/
- Zod for all input validation — no raw req.body access
- Never touch the /legacy/ directory
- Do not remove console.error calls in error handlers

## Do not
- npm install packages without asking first
- Modify .env files
- Run database migrations without confirmation

La section « Do not » est celle que la plupart des développeurs sautent en première lecture, et c'est pourtant elle qui prévient les erreurs coûteuses. Si certains fichiers ne doivent jamais être touchés par Claude, nommez-les. Si certaines commandes ne doivent jamais s'exécuter en autonomie, dites-le explicitement.

Pour un traitement plus approfondi de la structure d'un CLAUDE.md, voyez notre billet sur l'écriture d'un CLAUDE.md qui fonctionne vraiment. Le pack Septim Starter (9 $) inclut un modèle éprouvé pour cinq types de projets courants — Next.js, Python Flask, Rails, Go et Node simple — pour ne pas démarrer d'une page blanche.

Étape 4 — Lui confier une vraie tâche

cd ~/projects/my-app
claude

Au prompt, formulez une tâche assez précise pour avoir un état de fin clair. De bonnes premières tâches pour les débutants :

• Ajouter un limiteur de débit à la route /api/login — 5 tentatives par minute et par IP, code 429 en cas de dépassement
• Écrire les tests unitaires de chaque fonction de src/lib/date-utils.ts — viser 90 % de couverture des branches
• Refactorer src/components/UserTable.tsx pour utiliser React Query au lieu d'appels fetch bruts

Claude Code lira les fichiers concernés, proposera ses changements et demandera la permission avant toute écriture sur disque ou exécution de commande. Dans la configuration par défaut, il confirme avant chaque opération d'écriture — c'est le bon mode pour apprendre. Vous pourrez assouplir ou durcir ces permissions dans ~/.claude/settings.json une fois familiarisé avec son comportement.

Ce qui se passe pendant la boucle agentique

Une tâche Claude Code typique enchaîne ce cycle :

1. Lecture des fichiers source pertinents pour comprendre la structure actuelle
2. Proposition d'un plan d'implémentation et liste des fichiers concernés
3. Écriture des changements fichier par fichier, avec explication
4. Exécution de la suite de tests (si elle est configurée dans CLAUDE.md) et itérations sur les échecs
5. Compte rendu de fin et liste de chaque fichier modifié

Sur des tâches simples — ajouter un champ à un formulaire, écrire un petit utilitaire, corriger une erreur de typage — l'opération tient en moins de deux minutes. Sur des tâches plus larges (refactor d'un module, ajout d'une fonctionnalité de bout en bout), comptez 5 à 15 minutes et quelques tours d'itération.

Étape 5 — Vérifier vos coûts

La console Anthropic, sur console.anthropic.com, affiche votre consommation de tokens ventilée par modèle et par date. Après deux ou trois sessions, consultez le tableau de bord pour comprendre votre rythme de consommation avant d'engager Claude Code sur des tâches plus longues.

Trois schémas tirent les coûts vers le haut sans crier gare :

• Gros fichiers en contexte. Si Claude Code lit un fichier de 10 000 lignes pour répondre à une question portant sur une seule fonction, vous avez payé 10 000 lignes de tokens d'entrée. Pointez-le sur des fichiers précis plutôt que de poser des questions larges sur l'ensemble du code.
• Reconstruction répétée du contexte. Chaque nouveau message d'une session renvoie tout l'historique de la conversation. Les longues sessions deviennent chères. Démarrez de nouvelles sessions pour des tâches sans rapport plutôt que de poursuivre la même session toute la journée.
• Lancement de sous-agents. Claude Code peut lancer des sous-agents pour du travail parallèle. Chaque sous-agent porte son propre contexte. Si vous en faites tourner plusieurs, vos coûts montent à proportion. Le guide Tokenocalypse traite ce point en détail — voir la décomposition des coûts de sous-agent.

Une tâche de code bien cadrée coûte généralement entre 0,05 et 0,40 $ de crédits API selon la taille des fichiers et la complexité. Une session où vous demandez à Claude Code de comprendre toute votre base de code avant d'agir peut coûter plusieurs dollars. Le CLAUDE.md écrit à l'étape 3 réduit nettement ce second schéma — un contexte fourni à l'avance remplace les tokens dépensés en exploration.

Erreurs fréquentes en première session

Demander à Claude Code de « regarder mon projet et me dire ce qui ne va pas »

Cela brûle la fenêtre de contexte sur une partie de pêche. La sortie ressemble à une revue de code généraliste qui peut identifier de vrais problèmes, mais à un coût en tokens conséquent. Utilisez plutôt Septim Drills (29 $) pour des exercices de revue de code structurés, ou pointez Claude Code sur un fichier précis avec une question précise.

Ne pas lire le plan avant de l'approuver

Claude Code propose un plan avant d'agir. Lisez-le. Sur des tâches complexes, le plan inclut parfois des étapes que vous ne valideriez pas — supprimer une table, retirer une couche de cache, toucher un fichier que vous aviez exclu. Repérer cela au stade du plan ne coûte rien. Le repérer après les écritures, c'est un git revert.

Le faire tourner sans gestion de version

Claude Code écrit sur disque. Ne le lancez que dans des dépôts à arbre de travail propre, pour pouvoir git diff chaque modification et git checkout . tout ce qui ne vous convient pas. Si vous n'utilisez pas encore git, initialisez un dépôt avant votre première session.

Sauter le CLAUDE.md

Sans CLAUDE.md, Claude Code déduit le contexte projet par exploration de fichiers. Cette inférence coûte des tokens et se trompe souvent sur les conventions, les commandes interdites et le runner de tests. Les 20 minutes investies à l'étape 3 vous épargneront bien davantage durant votre première semaine d'usage.

Et après

Une fois quelques tâches menées à bien, l'étape suivante naturelle consiste à étendre Claude Code avec des serveurs MCP — des intégrations qui lui ouvrent l'accès à des outils externes comme votre base de données, GitHub ou un navigateur. Voir le tutoriel serveur MCP pour une mise en pratique.

Si vous faites tourner Claude Code en équipe et souhaitez mettre en place une revue de PR automatisée, le guide d'installation revue de PR couvre la configuration de la GitHub Action de bout en bout.

Pour la maîtrise des coûts à l'échelle — une fois la phase débutant passée, en usage quotidien — voir le guide de surveillance des coûts et le billet sur la gestion du contexte.