Retour aux ressources
// guide · outils

Les bases de Claude Code

Un agent qui code dans ton terminal, avec accès à tes fichiers, à git et à tes commandes. Ce n'est pas de l'autocomplétion : c'est un collègue qui lit le repo, propose un plan, édite, et lance les tests. Voici le mental model et les réflexes qui comptent.

Guide20 juil. 2026~10 min · intermédiaire
Claude CodeCLAUDE.mdskillsMCPsubagentsgit
01

Ce que c'est, vraiment

Claude Code est un agent en ligne de commande. Tu lui parles en langage naturel, et il agit sur ton projet : il lit les fichiers, en écrit, lance des commandes, fait des commits. La différence avec un chat, c'est l'accès : il travaille sur ton vrai code, pas sur un copier-coller.

un chat / autocomplete

suggère.

tu copies-colles le contexte
ne voit qu’un fichier à la fois
ne lance rien
Claude Code

agit.

lit le repo entier au besoin
édite plusieurs fichiers
lance tests, build, git
i

C'est le même changement de posture que pour les agents applicatifs : passer de « générer une réponse » à « mener une tâche ». J'en parle dans d'un prompt à l'agentique.

02

Démarrer

Installation en une commande, puis on lance la session depuis la racine du projet — c'est important : Claude prend le dossier courant comme périmètre de travail.

shellcopier
$ npm i -g @anthropic-ai/claude-code
$ cd ~/mon-projet # toujours lancer DEPUIS la racine du projet
$ claude # ouvre la session agent dans le terminal
i

Une session Claude Code a besoin d'un accès API Anthropic (ou d'un abonnement compatible). Lance-la dans un dépôt git : tu pourras relire et annuler ses changements comme n'importe quel commit.

03

La boucle de travail

Le rythme de base : tu décris une intention, Claude explore, propose un plan, puis édite — en te montrant chaque diff avant application. Tu restes dans la boucle : tu acceptes, refuses, ou rediriges.

sessioncopier
> ajoute un bouton "exporter en CSV" sur la page factures
# Claude explore le repo, propose un plan, puis EDITE les fichiers.
# tu vois chaque diff avant qu'il soit applique -> tu acceptes ou refuses.
> lance les tests
# il execute "npm test", lit la sortie, et corrige si ca casse.
sois précis sur l'intention, pas sur l'implémentation — laisse-le proposer ;
une tâche à la fois : petites boucles > un méga-prompt ;
relis les diffs — c'est toi qui restes responsable du code.
04

CLAUDE.md — le fichier le plus important

Si tu ne retiens qu'une chose : écris un CLAUDE.md. C'est un fichier Markdown à la racine, lu automatiquement au début de chaque session, qui sert de mémoire longue du projet. Sans lui, tu réexpliques ta stack et tes conventions à chaque fois — et l'agent devine le reste, souvent mal.

CLAUDE.mdcopier
# CLAUDE.md — lu automatiquement au demarrage de chaque session
# c'est la memoire longue du projet : mets-y ce que tu redis a chaque fois
## Stack
- Next.js 15 (app router), TypeScript strict, Tailwind
- base : Postgres via Prisma
## Conventions
- composants en PascalCase dans src/components
- pas de "any", pas de console.log en commit
- tests : vitest, a lancer avec "npm test" avant tout commit
## Commandes
- dev : npm run dev
- build : npm run build

Ce qui fait un bon CLAUDE.md, ce n'est pas la longueur, c'est la densité : les décisions non évidentes, les pièges du projet, les commandes exactes. Chaque ligne t'épargne une correction répétée.

la stack et les versions (ce que l'agent ne peut pas deviner) ;
les conventions maison : nommage, structure des dossiers, ce qui est interdit ;
les commandes exactes : dev, build, test, lint — pour qu'il vérifie son travail ;
les pièges connus : « ne touche pas à X », « la migration Y doit tourner avant Z ».

Traite-le comme du code : versionne-le, relis-le en équipe, enrichis-le dès que tu te surprends à répéter une consigne à l'agent. Un CLAUDE.md vivant, c'est un agent qui connaît ton projet au lieu de le deviner.

i

Il se décline : un CLAUDE.md global (~/.claude/CLAUDE.md) pour tes préférences perso, un par repo pour le projet, et même un par sous-dossier pour un module particulier.

05

Les skills — des savoir-faire réutilisables

Une skill, c'est une procédure que tu enseignes une fois et que Claude réutilise tout seul. Concrètement : un dossier avec un fichier SKILL.md qui décrit un savoir-faire (déployer, faire une revue de PR, générer un rapport) et, au besoin, des scripts. Claude lit la description et déclenche la skill quand la tâche correspond.

arborescencecopier
.claude/skills/
deploy-ec2/
SKILL.md # nom + description : quand et comment l'utiliser
scripts/ # scripts optionnels que la skill peut lancer
review-pr/
SKILL.md

Le SKILL.md tient en une en-tête (nom + description — c'est ce que Claude lit pour décider) et des étapes. La description est la partie critique : dis clairement quand l'utiliser.

SKILL.mdcopier
---
name: deploy-ec2
description: >
Deployer l'app sur notre EC2 via Docker + Caddy.
A utiliser quand on parle de mise en prod ou de release.
---
# Etapes
1. npm run build, verifier que ca passe
2. git push, se connecter en SSH a l'instance
3. docker compose pull && docker compose up -d
4. curl le /health, confirmer 200 avant de terminer

La différence avec CLAUDE.md : CLAUDE.md est toujours chargé (le contexte permanent), une skill n'est chargée que quand elle est pertinente. Tu ranges les procédures ponctuelles en skills pour garder le contexte léger.

06

Les superpowers

Une fois les bases en place, Claude Code débloque des capacités qui le font passer d'assistant à équipe. Trois qui changent vraiment la donne :

sessioncopier
# 1. des sous-agents qui bossent en parallele sur des taches isolees
> lance 3 agents : un qui ecrit les tests, un le back, un le front
# 2. des serveurs MCP : brancher des outils externes (GitLab, Sentry, une DB)
$ claude mcp add gitlab -- npx -y @modelcontextprotocol/server-gitlab
# 3. des slash commands : des prompts reutilisables, versionnes dans le repo
> /review # .claude/commands/review.md
> /ship
01
Sous-agents

Claude délègue des tâches isolées à des agents parallèles, chacun avec son propre contexte. Utile pour paralléliser, ou pour qu'un agent « vérificateur » relise le travail d'un autre.

02
MCP

Le Model Context Protocol branche des outils externes : GitLab, Sentry, une base de données, ton propre service. L'agent agit alors bien au-delà des fichiers.

03
Slash commands

Des prompts réutilisables, versionnés dans .claude/commands. /review, /ship : tes workflows deviennent une commande, partagée avec l'équipe.

04
Hooks

Des scripts déclenchés automatiquement à des moments clés (avant un commit, après une édition) : lint, formatage, garde-fous — sans y penser.

i

Les sous-agents et MCP sont exactement les mêmes idées que côté produit : donner des outils et faire collaborer plusieurs agents. Je les creuse dans donner des outils à un agent.

07

Le garder sur les rails

01
Petits pas

Une fonctionnalité par boucle. Un agent lâché sur « refais toute l'app » dérive ; sur une tâche cadrée, il est chirurgical.

02
Git comme filet

Commits fréquents. Un changement qui dérape se réverte en une commande — tu n'as jamais peur de le laisser essayer.

03
Fais-lui vérifier

Demande-lui de lancer les tests et le build. Un agent qui lit sa propre sortie d'erreur se corrige seul.

04
Tu valides

Les diffs passent sous tes yeux. Pour les actions destructrices, garde la main — c'est du human-in-the-loop.

!

Ne le laisse pas courir sans relire, surtout sur des commandes qui suppriment ou déploient. Le même principe que côté produit : human-in-the-loop en vrai.

08

Sources & ressources

01Claude Code — Overview (doc officielle)Le point d'entrée : installation, surfaces (terminal, IDE, desktop, web) et ce que l'agent sait faire.02Best practices for Claude CodeLes patterns d'Anthropic : explorer puis planifier puis coder, donner un moyen de vérifier, gérer le contexte.03CLAUDE.md — How Claude remembers your projectOù placer les CLAUDE.md, comment ils se chargent et se cumulent, et ce qu'il faut y mettre (ou pas).04Slash commands referenceLa liste complète : /init, /memory, /permissions, /clear, /compact, /rewind — celles qu'on utilise vraiment.05Extend Claude with skillsLe format SKILL.md, le chargement à la demande, et la frontière avec CLAUDE.md.06Connect Claude Code to tools via MCPBrancher des serveurs MCP (issue tracker, base, monitoring) et les portées de configuration.07Configure permissionsLe système d'autorisations : règles allow/ask/deny, modes, et politiques d'équipe versionnées.

Claude Code n'est pas magique : c'est un collègue rapide qui a besoin d'un cadre. Le cœur, c'est le CLAUDE.md — la mémoire du projet. Ensuite les skills capitalisent tes savoir-faire, et les superpowers (sous-agents, MCP, commandes) en font une équipe. Petites boucles, commits fréquents, diffs relus : c'est ce qui le fait passer de gadget à multiplicateur.