Les 4 concepts clés de Claude Code que personne n'explique clairement

Pourquoi ce guide existe

La plupart des tutoriels sur Claude Code couvrent les Skills et s’arrêtent là. Certains mentionnent les sub-agents. Presque aucun n’explique clairement la différence entre les 4 mécanismes fondamentaux, et surtout, comment ils s’articulent ensemble.

Le résultat : des développeurs qui utilisent Claude Code à 20% de son potentiel. Ils connaissent claude "fais ça" mais ignorent qu’ils pourraient orchestrer un écosystème complet d’agents spécialisés, de scripts automatiques et de commandes personnalisées.

Ce guide couvre les 4 concepts distincts :

Concept	Rôle	Déclenché par
Skills	Connaissance auto-invoquée	Claude lui-même
Sub-agents	Tâches isolées, contexte séparé	Claude ou l’utilisateur
Hooks	Réactions système automatiques	Événements (PreToolUse, etc.)
Commands	Prompts manuels personnalisés	L’utilisateur (slash commands)

Concept 1 : Skills, la connaissance embarquée

Ce que c’est

Une skill est un fichier Markdown que Claude Code charge automatiquement quand il détecte qu’il en a besoin. Pas besoin de l’appeler manuellement. Claude la trouve et l’utilise tout seul.

C’est de la connaissance contextuelle. Vous décrivez un processus, des conventions, un workflow, et Claude y accède quand la situation le demande.

Comment ça marche

Les skills vivent dans .claude/skills/ (local au projet) ou ~/.claude/skills/ (global). Chaque fichier a un frontmatter qui décrit quand l’invoquer :

---
name: infographie
description: Use when the user wants to create a visual infographic
---

## Process
1. Analyze the topic and identify key data points
2. Choose layout: vertical timeline, comparison grid, or flow diagram
3. Use brand colors: #E8915A (accent), #111113 (background)
4. Generate SVG with embedded data visualization
5. Export as PNG at 1080x1350 (Instagram) or 1200x628 (LinkedIn)

## Design constraints
- Maximum 6 data points per infographic
- Font: Inter for labels, JetBrains Mono for numbers
- Always include source attribution at the bottom

Cas d’usage concrets

• Design system : skill qui charge vos couleurs, typos, composants de référence
• Processus métier : skill qui décrit votre flow de déploiement ou votre convention de nommage
• Instructions récurrentes : skill qui rappelle les règles du projet (pas de console.log, toujours tester, etc.)

Ce que ce n’est PAS

Une skill ne fait rien par elle-même. Elle n’exécute pas de code, ne lance pas de process. Elle informe Claude. C’est un fichier de référence intelligent, pas un agent.

Concept 2 : Sub-agents, les travailleurs isolés

Ce que c’est

Un sub-agent est une tâche déléguée dans un contexte séparé. Claude lance un sous-processus qui travaille de son côté, avec ses propres instructions et potentiellement un modèle différent. Seul le résultat remonte dans la conversation principale.

Pourquoi c’est puissant

Le contexte principal reste propre. Si vous demandez à Claude d’analyser 50 fichiers, de scraper 10 URLs et de rédiger un rapport, tout ça dans la même conversation, le contexte explose. Avec des sub-agents, chaque tâche est isolée.

Et surtout : vous pouvez choisir le modèle par tâche.

---
name: veille-scraper
description: Scrape latest AI news from configured sources
model: haiku
---

Scrape the following sources for articles published in the last 24h:
- Hacker News (top 30)
- TechCrunch AI section
- Anthropic blog

For each article, extract: title, URL, date, 2-sentence summary.
Return as JSON array, sorted by relevance.

• Haiku pour le scraping et les tâches mécaniques (rapide, pas cher)
• Sonnet pour les tâches business courantes
• Opus pour le raisonnement complexe et les décisions architecturales

Exemple concret : agent veille

Un sub-agent veille-scraper qui tourne sur Haiku :

1. Scrape les sources configurées (Apify, RSS, APIs)
2. Filtre par pertinence
3. Formate les résultats
4. Push dans une page Notion via MCP

Le tout en 30 secondes, sans polluer le contexte principal. Vous récupérez juste : “12 articles trouvés, pushés dans Notion.”

Quand utiliser un sub-agent vs. faire directement

Situation	Faire directement	Sub-agent
Modifier un fichier	Oui	Non
Analyser 50 fichiers	Non	Oui
Tâche mécanique répétitive	Non	✅ (Haiku)
Décision qui nécessite le contexte actuel	Oui	Non
Recherche web approfondie	Non	Oui