- Préface
- Avant-propos
- Pourquoi ce guide
- À qui il s'adresse
- Ce que vous y trouverez
- Ce que vous n'y trouverez pas
- Comment le lire
- Comment ce guide a été écrit
- Retours et errata
- 1. Qu'est-ce que Claude Code
- 1.1 Un bref historique
- 1.2 Claude Code face à Lovable, Replit et aux autres environnements d'IA
- 1.3 Quand l'utiliser
- 1.4 La courbe d'apprentissage
- 1.5 La chronologie des modèles Claude
- 1.6 Modèle et harness : ce qui transforme un modèle en agent
- 1.7 Du prompt engineering au graph engineering
- 2. Installation et configuration
- 2.1 Abonnements compatibles
- 2.2 Configuration requise
- 2.3 Installation sur macOS et Linux
- 2.4 Installation sur Windows
- 2.5 Installation via WSL2 (recommandée sous Windows)
- 2.6 Installation alternative via npm
- 2.7 Vérifier l'installation
- 2.8 Authentification
- 3. Le premier projet de bout en bout
- 3.1 Étape 1 : placez-vous dans le répertoire du projet
- 3.2 Étape 2 : initialisez le projet
- 3.3 Étape 3 : relisez et personnalisez CLAUDE.md
- 3.4 Étape 4 : première requête
- 3.5 Étape 5 : quittez la session
- 3.6 Étape 6 : reprenez là où vous vous étiez arrêté
- 4. Commandes et raccourcis essentiels
- 4.1 La syntaxe par commandes : pourquoi elle fonctionne ainsi
- 4.2 Les options CLI essentielles
- 4.3 Les options CLI avancées
- 4.4 Les commandes slash : le cœur de la session interactive
- 4.5 Les commandes slash essentielles
- 4.6 Les commandes slash pour des workflows spécifiques
- 4.7 Les raccourcis clavier
- 4.8 La syntaxe @, !, / — les trois préfixes qui changent tout
- 5. Plan Mode : réfléchir avant d'écrire
- 5.1 Pourquoi c'est important
- 5.2 Comment l'activer
- 5.3 Les outils disponibles en Plan Mode
- 5.4 Exemple de workflow avec le Plan Mode
- 5.5 opusplan : le bon modèle pour chaque tâche
- 6. Prompt engineering : écrire des prompts efficaces
- 6.1 Ce qu'est le prompt engineering et pourquoi il compte en CLI
- 6.2 Anatomie d'un prompt bien construit
- 6.3 Des rôles aux contraintes structurelles (la révolution de 2026)
- 6.4 Les techniques fondamentales
- 6.5 Les spécificités de Claude Code par rapport au chat
- 6.6 Les modèles de génération 5 : ce qu'il faut retirer des prompts et ce qu'il faut ajouter
- 6.7 Exemples avant/après
- 6.8 Les anti-patterns courants
- 6.9 Promouvoir un prompt : quand il va dans CLAUDE.md ou dans une commande personnalisée
- 6.10 Bibliothèque de prompts : archivage et versionnement
- 7. Mémoire persistante : CLAUDE.md et Auto Memory
- 7.1 Générer CLAUDE.md avec /init
- 7.2 Que mettre dans CLAUDE.md
- 7.3 Exemple 1 : plugin WordPress
- 7.4 Exemple 2 : projet Node/TypeScript générique
- 7.5 CLAUDE.md hiérarchique
- 7.6 La leçon de Karpathy et les quatre règles de Forrest Chang
- 7.7 Auto Memory : ce que c'est et ce qui change
- 7.8 Prérequis et activation
- 7.9 Où vivent les mémoires
- 7.10 Anatomie du dossier de mémoire
- 7.11 Auto Memory et subagents
- 7.12 Quand la désactiver
- 7.13 CLAUDE.md ou Auto Memory : quoi utiliser et quand
- 8. La gestion du contexte
- 8.1 Ce qu'est le contexte et pourquoi il compte
- 8.2 Ce qui pèse dans le contexte
- 8.3 Les signes d'un contexte saturé
- 8.4 La commande /context : lire et agir
- 8.5 La compression : /compact et /clear
- 8.6 Les subagents : la stratégie structurelle
- 8.7 Les modèles à fenêtre de 1M de tokens : quand passer
- 8.8 Règle pratique et état d'esprit
- 8.9 Choisir la bonne architecture : tableau de décision
- 8.10 Le cache de prompt et l'observabilité de la consommation
- 9. Sécurité, permissions et garde-fous
- 9.1 Les garde-fous de Claude Code : la défense en profondeur
- 9.2 Le système de permissions
- 9.3 Configurer les permissions dans settings.json
- 9.4 Protéger les secrets
- 9.5 Les modes dangereux
- 9.6 Prompt injection
- 9.7 Les tests comme garde-fous de correction
- 9.8 Sandbox et managed settings
- 10. Skills : le mécanisme d'extension
- 10.1 Comment fonctionne une Skill
- 10.2 Les skills intégrées et le dépôt anthropics/skills
- 10.3 Les skills de la communauté : une sélection
- 10.4 Installer et gérer les skills
- 10.5 Créer une Skill personnalisée
- 10.6 La sécurité des skills tierces
- 11. MCP : intégrer des services externes
- 11.1 Ce qu'est MCP et pourquoi il existe
- 11.2 L'architecture du protocole
- 11.3 Configurer un serveur MCP existant
- 11.4 Des serveurs MCP utiles : une sélection
- 11.5 Créer un serveur MCP de zéro : publier sur WordPress
- 11.6 Considérations de sécurité et d'exploitation
- 11.7 Gérer le coût des serveurs MCP sur le contexte
- 12. Subagents : orchestrer un travail spécialisé
- 12.1 Ce qu'ils sont et pourquoi vous en avez besoin
- 12.2 Subagent ou agent principal : la différence concrète
- 12.3 Les subagents intégrés
- 12.4 Créer un subagent personnalisé
- 12.5 La hiérarchie de priorité
- 12.6 Invocation automatique ou explicite
- 12.7 Le parallélisme : les patterns de délégation multiple
- 12.8 Optimiser les coûts par le routage des modèles
- 12.9 Quand NE PAS les utiliser
- 12.10 Subagents, Skills et Hooks comparés
- 13. Hooks : automatiser le cycle de vie de Claude Code
- 13.1 Ce qu'ils sont et à quoi ils servent
- 13.2 Anatomie d'un hook
- 13.3 Les événements du cycle de vie
- 13.4 Matchers et inspection (/hooks)
- 13.5 Entrée et sortie
- 13.6 Exemples pratiques
- 13.7 Sécurité
- 13.8 Les pièges et quand NE PAS les utiliser
- 14. Plugins : des paquets distribuables
- 14.1 Les mécanismes d'extension de Claude Code : une carte
- 14.2 Ce qu'est un plugin et pourquoi il existe
- 14.3 Anatomie d'un plugin
- 14.4 Les marketplaces de plugins
- 14.5 Créer un plugin personnalisé
- 14.6 Distribuer un plugin
- 14.7 La sécurité des plugins tiers
- 14.8 Les mods : des plugins qui modifient Claude Code de l'intérieur
- 15. Workflows avancés et astuces
- 15.1 Prendre en main un dépôt existant
- 15.2 La chasse aux bugs avec le TDD
- 15.3 Refactoriser en sécurité
- 15.4 Audit de performance
- 15.5 Le mode Vim
- 15.6 Les commandes slash personnalisées
- 15.7 Le mode headless pour la CI/CD
- 15.8 Le récapitulatif de session
- 15.9 Les checkpoints Git stratégiques
- 15.10 Les forks de conversation
- 15.11 L'orchestration à grande échelle : les workflows dynamiques
- 15.12 Donner un objectif vérifiable : /goal
- 15.13 Au-delà du terminal : sessions parallèles, planifiées et à distance
- 16. Les harness : Claude Code et les autres agents de code
- 16.1 Les critères de comparaison : le schéma commun
- 16.2 Claude Code (Anthropic)
- 16.3 OpenAI Codex
- 16.4 OpenCode
- 16.5 Tableau comparatif
- 16.6 Le reste du paysage
- 16.7 Comment choisir
- 17. Conclusions : pourquoi la CLI et pas seulement le chat
- 17.1 Le contexte persistant : arrêter de se présenter à chaque fois
- 17.2 L'autonomie agentique : il exécute, il ne se contente pas de suggérer
- 17.3 L'intégration dans le vrai flux de travail
- 17.4 Quand le chat reste le bon choix
- 17.5 En résumé
- Postface
- Annexe A — Glossaire
- Annexe B — Sources
- Annexe C — Notes de version
- Annexe D — Chronologie des modèles
- À propos de l'auteur
Claude Code
Un guide pratique pour commencer à utiliser Claude Code de manière professionnelle
Un guide pratique de Claude Code, écrit avec Claude Code.
Plus de 300 pages fondées sur la documentation officielle d'Anthropic et vérifiées sur Claude Code v2.1.311 : de l'installation au Plan Mode, CLAUDE.md, la gestion du contexte, les permissions, les Skills, les subagents, les hooks, MCP et les plugins, avec de vrais exemples sur WordPress et Node.js plutôt que des démos de présentation. Il s'ouvre sur une préface écrite par Claude Opus, qui a lu le manuscrit et l'a commenté sans complaisance.
Le livre est gratuit : prix libre avec un minimum de 0 $, c'est vous qui décidez si vous contribuez et combien. La licence Creative Commons BY-SA 4.0 vous permet de le redistribuer et de le modifier, à condition de citer la source et de conserver la même licence.
Minimum price
Free!
$7.00
You pay
Author earns
About
About the Book
Version 6.2 (octobre 2026). Cette édition française est la traduction de l'édition italienne originale, revue chapitre par chapitre et mise à jour en octobre 2026 sur la documentation officielle d'Anthropic et sur Claude Code v2.1.311 : un nouveau chapitre sur les harness (Claude Code et les autres agents de code), de nouvelles sections sur la sandbox et les managed settings, les mods, les sessions parallèles, planifiées et à distance, et le passage du prompt engineering au graph engineering.
Claude Code est la CLI agentique d'Anthropic qui vit dans le terminal du développeur : elle lit le code, exécute des commandes et respecte les conventions du projet.
Ce guide pratique, pensé pour qui veut commencer à l'utiliser de manière professionnelle, couvre l'installation et la configuration, les commandes du quotidien, le Plan Mode, le prompt engineering, la gestion du contexte et des permissions, les hooks, les serveurs MCP, les subagents et les Skills personnalisées.
Tous les contenus sont vérifiés sur la documentation officielle d'Anthropic. Des exemples concrets en PHP, JavaScript et WordPress. Pas de hype : chaque chapitre dit où l'outil vaut vraiment la peine et où il ne la vaut pas.
Pour les développeurs web à l'aise avec le terminal et Git, les professionnels qui veulent intégrer l'IA à leur travail en connaissance de cause et les équipes techniques qui évaluent l'adoption d'outils d'IA agentique dans leurs processus de développement.
Feedback
Author
About the Author
Mi chiamo **Maurizio Pelizzone**, sono Senior Software Architect, Co-titolare di **Mavida snc** (Torino) dal 2001 e formatore tecnico specializzato nell'ecosistema WordPress. In oltre vent'anni ho progettato e portato in produzione più di 200 progetti web per clienti nazionali, specializzandomi in architetture WordPress enterprise, sviluppo plugin e temi custom, migrazioni di piattaforme legacy e ottimizzazione performance/security. Dal 2010 sono **Speaker ricorrente ai WordCamp italiani** (Milano, Bologna, Torino, WordCamp Italia), con talk su Custom Post Types, Hardening & Security, Solutions Architecture e Full Site Editing. **Dal 2023 ho aggiunto un "superpotere" al mio workflow: l'Intelligenza Artificiale**, usandola come leva strategica per scrivere codice più pulito, scalabile e intelligente. Non come sostituto del mestiere, ma come amplificatore: vent'anni di PHP, WordPress e architetture software mi permettono di distinguere un suggerimento brillante da una scorciatoia rischiosa, e di dirigere l'AI verso soluzioni che reggono il peso della produzione. Oggi affianco alla consulenza tecnica per PMI e aziende nazionali un'attività di **formazione su AI tools, prompt engineering, vibe coding e automazione con N8N**, convinto che la combinazione tra esperienza artigianale del codice e utilizzo consapevole dell'AI sia la direzione in cui il nostro mestiere sta evolvendo. Questa guida nasce da quella convinzione: uno strumento come Claude Code non sostituisce lo sviluppatore, ma cambia il modo in cui lavora. Per usarlo bene servono le stesse virtù di sempre — rigore, curiosità, capacità di verificare — più un po' di disciplina nuova.
Translations
Translations
Contents
Table of Contents
The Leanpub 60 Day 100% Happiness Guarantee
Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms...
Earn $8 on a $10 Purchase, and $16 on a $20 Purchase
We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.
(Yes, some authors have already earned much more than that on Leanpub.)
Learn more about writing on Leanpub
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Write and Publish on Leanpub
You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!
Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.
Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.