Comprendre Claude Code en 10 minutes

Ce qu’est Claude Code

Claude Code est un outil CLI d’Anthropic permettant de déléguer des tâches de codage à Claude depuis un terminal. Il lit/écrit des fichiers, exécute du shell, et orchestre des sous-agents. Source : Anthropic — « Claude Code lets developers delegate coding tasks to Claude directly from their terminal ».

Les briques fondamentales

1. Le contexte (context window)

Claude travaille dans une fenêtre limitée. Tout ce qui est lu, écrit, retourné par un outil consomme cette fenêtre. Au-delà de 80 %, le compactage automatique se déclenche, mais Claude est souvent déjà en dérive avant ce seuil. Source : .claude/rules/session-practices.md.

Règle pratique : ne jamais dépasser 50 % et espérer de bons résultats.

2. Les outils (tools)

Claude peut appeler des outils prédéfinis : Read, Write, Edit, Bash, Glob, Grep, Task (sub-agent), etc. Chaque appel d’outil est un échange structuré (JSON Schema).

3. Les sub-agents

Un sub-agent est une instance Claude lancée par l’agent principal avec son propre contexte. Le sub-agent fait son travail puis retourne uniquement la synthèse. Le contexte principal reste intact.

C’est l’outil principal pour explorer un gros codebase sans saturer la session.

4. Les slash-commands

Des commandes textuelles préfixées par /. Exemples natifs : /clear (reset session), /compact (résumer le contexte), /rewind (reculer au dernier checkpoint propre).

ulk en ajoute : /ulk:bruce, /ulk:godspeed, etc. — chacune correspond à un fichier markdown dans framework/agents/.

5. Les skills

Une skill est un dossier avec un SKILL.md qui décrit un savoir-faire (créer un PPTX, auditer l’accessibilité, déployer Vercel). Claude lit la skill avant d’exécuter la tâche pour s’aligner sur les best practices.

ulk bundle des skills tierces : Figma (7), Swift (7), Flutter (2), context-audit (1), cwb-app-icon (1, opt-in). Source : CLAUDE.md section “Community Skills”.

6. Les plugins

Bundles installables (skills + commandes + MCP). ulk s’appuie sur des plugins officiels Anthropic (/feature-dev, /simplify, /commit, /pr-review-toolkit:review-pr, /frontend-design, /claude-md-improver).

Référence : framework/agents/_shared/plugins-protocol.md.

7. MCP (Model Context Protocol)

Protocole standard pour connecter Claude à des sources externes : Figma, Linear, Notion, Cloudflare, Vercel, etc. Un serveur MCP expose des outils que Claude peut appeler.

ulk préfère CLI quand disponible (0 token réseau, exécution locale) et tombe sur MCP en fallback. Source : CLAUDE.md section “CLI Tools” — « Priority rule : CLI available → use it (0 tokens). No CLI + MCP configured → use MCP. »

Les 4 règles d’hygiène de contexte

Référence canonique : framework/agents/_shared/context-hygiene-protocol.md.

Règle	Quand l’appliquer
1. /rewind au lieu de corriger	Quand Claude part dans la mauvaise direction. La mauvaise tentative pollue tout ce qui suit.
2. /clear quand on change de tâche	Nouvelle tâche = nouvelle session. Persistance externe (issue, todo.md) avant clear.
3. Sub-agents pour explorations lourdes	Délégation = contexte propre, retour synthèse.
4. /compact proactif à 50-60 %	Avec instruction explicite (préserve X, oublie Y), avant le compact auto à 80 %.

Workflow type recommandé

1. START — lire la tâche depuis issue/todo.
2. RESEARCH (sub-agent) — explorer le code.
3. PLAN (sub-agent) — proposer une approche.
4. IMPLEMENT — exécuter, tester, commit.
5. REVIEW — mettre à jour issue/todo, /clear.

Source : .claude/rules/session-practices.md.

Mémoire persistante

Claude Code peut maintenir une mémoire entre sessions via :

• CLAUDE.md à la racine du projet — instructions du repo (chargé à chaque session).
• MEMORY.md + fichiers individuels dans memory/ — mémoire sémantique (user, feedback, project, reference).

ulk étend cela avec un Knowledge Vault Loop Obsidian-compatible (agent Lovecraft 47), qui capture/distribue/surface la mémoire entre sessions automatiquement. Source : CLAUDE.md section “Knowledge Vault Loop”.

Pour aller plus loin

• Doc officielle Claude Code : https://docs.claude.com
• Mastery tips ulk : framework/agents/_shared/claude-code-mastery.md
• Skill /context-audit (bundlée par ulk) : score de santé contexte 0-100.

TL;DR

Claude Code = CLI + outils + sub-agents + slash-commands + skills + plugins + MCP. ulk ajoute 86 agents markdown pré-faits, des protocoles partagés, et des règles d’hygiène pour ne pas saturer le contexte.