Tutoriel
Tuto Claude Code : le guide pratique
Claude Code est l’agent de développement d’Anthropic : il lit ton projet, modifie le code et lance des commandes. Tu peux l’utiliser dans l’app Claude de bureau (onglet Code), sur le web avec claude.ai/code, dans VS Code ou JetBrains, ou dans ton terminal. Voici l’essentiel, côté app comme côté ligne de commande.
Premiers pas avec Claude Code
Installer, lancer et reprendre une session dans le terminal
Installer
Nécessite Node.js 18+ (ou l’installateur natif).
npm install -g @anthropic-ai/claude-code
Lancer
Depuis la racine de ton projet :
cd mon-projet
claude
Mode non interactif
Une réponse puis sortie, parfait pour les scripts et les pipes.
claude -p "résume les changements"
cat log.txt | claude -p "explique"
Reprendre
-c reprend la dernière conversation, -r ouvre un sélecteur.
claude --continue
claude --resume
Claude Code dans l’app
Coder avec Claude sans terminal : app de bureau, web et IDE
Le même agent, sans terminal
Claude Code existe aussi dans l’app Claude de bureau (onglet Code, sur Mac et Windows), sur le web avec claude.ai/code et dans les extensions VS Code et JetBrains. Mêmes capacités, mêmes réglages, même CLAUDE.md.
Démarrer dans l’app
Ouvre l’onglet Code, choisis le dossier de ton projet et écris ta demande comme dans un chat. Claude lit les fichiers, propose des modifications et lance les commandes utiles.
Plusieurs sessions en parallèle
Chaque session peut travailler dans son propre worktree git : une session corrige un bug pendant qu’une autre construit une fonctionnalité, sans conflit.
Suivre et valider
Le diff montre chaque changement, les autorisations s’affichent sous forme de cartes et le mode (demande, acceptation auto, plan) se règle en un clic.
Voir le résultat en direct
L’app peut lancer ton serveur de développement et afficher ton site dans un navigateur intégré, à côté de la conversation.
Dans le cloud
Sur claude.ai/code, les sessions tournent sur des machines distantes reliées à tes dépôts GitHub : elles continuent ordinateur fermé et peuvent ouvrir une pull request.
Commandes & raccourcis
Les slash commands et touches indispensables
Slash commands essentielles
Gère ta session sans quitter le clavier.
/help /clear /compact
/init /model /memory
/config /cost /mcp
Raccourcis
Échap interrompt. Échap Échap remonte l’historique. Shift+Tab change de mode de permission.
Références et shell
@chemin ajoute un fichier au contexte. ! exécute une commande shell directement.
refactor @src/utils.ts
! npm test
Commandes personnalisées
Un fichier Markdown = une commande. $ARGUMENTS reçoit ce que tu tapes après.
.claude/commands/fix-issue.md
→ /fix-issue 123
CLAUDE.md & mémoire
Donner à Claude le contexte durable de ton projet
Le rôle de CLAUDE.md
Il est chargé automatiquement au démarrage : c’est la mémoire durable de ton projet.
Emplacements
Projet (partagé) à la racine, utilisateur pour tous tes projets, et sous-dossiers pour du contexte local.
./CLAUDE.md
~/.claude/CLAUDE.md
api/CLAUDE.md
Quoi y mettre
Commandes de build/test, conventions de code, architecture, pièges. Court, précis, à jour.
# Commandes
- pnpm dev
- pnpm test
# Style
- TypeScript strict, pas de any
Imports
Référence d’autres fichiers pour garder CLAUDE.md léger.
Voir @docs/architecture.md
Permissions & modes
Garder le contrôle : plan mode, settings, sécurité
Modes de permission
Normal (demande), acceptation auto des modifications, et mode plan (lecture seule). Shift+Tab pour basculer.
Fichiers de réglages
Trois niveaux : utilisateur, projet partagé, projet local.
~/.claude/settings.json
.claude/settings.json
.claude/settings.local.json
Règles allow / deny
Autorise les commandes sûres, interdis les fichiers sensibles.
{
"permissions": {
"allow": ["Bash(npm run test:*)"],
"deny": ["Read(./.env)"]
}
}
Sécurité
--dangerously-skip-permissions uniquement dans une sandbox ou un conteneur isolé.
Étendre Claude Code
MCP, sous-agents, hooks, skills et plugins
MCP
Model Context Protocol : branche Claude sur des outils et données externes.
claude mcp add github -- npx @modelcontextprotocol/server-github
/mcp
Sous-agents
Assistants spécialisés avec leur propre contexte.
.claude/agents/reviewer.md
/agents
Hooks
Des commandes exécutées à coup sûr à des moments clés : PreToolUse, PostToolUse, UserPromptSubmit, Stop, SessionStart…
Skills & plugins
Skills : dossiers SKILL.md chargés quand ils sont utiles. Plugins : packs installables de commandes, agents, hooks, skills et MCP.
Questions fréquentes
Peut-on utiliser Claude Code sans terminal ?
Oui. L’app Claude de bureau a un onglet Code : tu choisis le dossier de ton projet et tu écris ta demande comme dans un chat. Claude Code existe aussi sur le web (claude.ai/code) et en extension VS Code ou JetBrains.
Comment installer Claude Code dans le terminal ?
Installe Node.js 18 ou plus, puis lance « npm install -g @anthropic-ai/claude-code ». Ensuite, place-toi dans ton projet et tape « claude ».
À quoi sert le fichier CLAUDE.md ?
C’est la mémoire de ton projet : Claude Code le lit au démarrage. Mets-y les commandes de build et de test, les conventions de code et les pièges à éviter.
Claude Code peut-il modifier mes fichiers sans demander ?
Par défaut il demande avant d’agir. Les modes de permission (Shift+Tab) et les règles allow/deny de settings.json te laissent régler précisément ce qu’il peut faire seul.
Qu’est-ce que MCP ?
Le Model Context Protocol branche Claude sur des outils et des données externes (GitHub, bases de données, navigateurs…) via des serveurs MCP.