Task Master dans Claude Code : ton chef de projet IA dans le terminal en 5 minutes, Quentin IA Marketing

Tu connais le moment où un projet démarre et où tu passes deux jours à découper le travail avant d'écrire la première ligne. Task Master automatise ce cadrage. C'est un système de gestion de tâches piloté par IA (plus de 25 000 étoiles sur GitHub) : tu lui donnes un cahier des charges, il le découpe en tâches structurées avec leurs dépendances, te dit par où commencer, et t'aide à exécuter.

Branché en MCP dans Claude Code, il devient une commande native que tu pilotes en langage naturel, sans quitter ton terminal.

La plupart des tutos l'installent dans Cursor. Si tu es déjà sur Claude Code, voici la version directe, sans clé API, opérationnelle en cinq minutes.

Claude AI Lab

Le Claude AI Lab, c'est ma communauté Skool où je partage mes systèmes Claude et les modules plus avancés. L'entrée est gratuite.

Rejoindre le Lab →

✅Ce qu'il te faut

Claude Code installé. Une session active suffit, claude --version doit renvoyer un numéro.

Node.js 18 ou plus, vérifiable avec node --version.

Une méthode d'auth. Claude Pro ou Max (recommandé, zéro clé API), ou une clé API Anthropic.

Pourquoi Claude Code plutôt que Cursor

⚡ 3 avantages

Si tu vis déjà dans ton terminal, l'install Claude Code t'évite une couche d'outils en plus. Quatre raisons concrètes.

🔑

Zéro clé API à gérer

Avec Claude Pro ou Max, ta session Claude Code suffit. Pas de billing Anthropic Console en plus.

⌨️

Workflow terminal pur

Tu restes dans tmux, vim, iTerm ou Ghostty. Aucun passage par une interface graphique.

🔗

Synchro avec tes autres MCP

Si tu as déjà GitHub, Notion, Linear ou Stripe en MCP, Task Master cohabite proprement.

🪝

Hooks Claude Code natifs

Tu branches PostToolUse, Stop et d'autres handlers directement sur les actions Task Master.

Vérifier tes prérequis

⌨️ terminal

Deux minutes de check avant d'installer.

# Claude Code installé ?
claude --version
# si absent :
npm install -g @anthropic-ai/claude-code
claude login

# Node 18 minimum ?
node --version
# si en dessous :
nvm install 20
nvm use 20

Pour l'auth, deux options : ta session Claude Pro ou Max (rien à faire, l'option recommandée), ou une clé API Anthropic récupérée sur console.anthropic.com, dans Settings puis API Keys.

Sécurité

Ne mets jamais ta clé API dans un fichier commité sur Git. Des bots scannent GitHub en continu pour récupérer les clés exposées et pomper ton crédit.

Installer Task Master

⚡ une commande

Une seule commande dans ton terminal.

claude mcp add taskmaster-ai -- npx -y task-master-ai

Claude Code branche Task Master comme serveur MCP sur le projet courant. Pour qu'il soit disponible dans tous tes projets, ajoute --scope user.

claude mcp add taskmaster-ai --scope user -- npx -y task-master-ai

Vérifie que l'installation a pris.

claude mcp list

Tu dois voir taskmaster-ai dans la liste. Si oui, passe à la suite.

Brancher ta session Claude

🔑 zéro clé API

Lance Claude Code dans ton projet avec claude, puis tape, en langage naturel :

« Change the main model to claude-code/sonnet »

Task Master comprend qu'il doit utiliser ta session Claude Code existante au lieu d'aller chercher une clé API externe. Tu consommes ton abonnement Pro ou Max, et tu paies zéro supplément. Pour la recherche, ajoute :

« Change the research model to claude-code/opus »

Le bon réglage

Sonnet pour générer les tâches, Opus pour la recherche : meilleur ratio qualité/vitesse. Opus est plus lent mais bien plus fin sur les analyses profondes.

Pas de Pro ou Max ? Ajoute une clé API dans la section env de taskmaster-ai, dans ~/.claude.json, puis redémarre Claude Code.

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": { "ANTHROPIC_API_KEY": "ta_cle_ici" }
    }
  }
}

Optimiser le contexte

🎛️ modes d'outils

Par défaut, Task Master charge 36 outils, soit environ 21 000 tokens mobilisés en permanence dans ton contexte. Pour un usage normal, c'est trop : autant de fenêtre en moins pour ton code. Passe en mode core, sept outils, environ 5 000 tokens.

claude mcp remove taskmaster-ai
claude mcp add taskmaster-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

Les quatre modes disponibles.

🟢

core ou lean

7 outils, ~5 000 tokens. Recommandé pour la majorité.

🔵

standard

15 outils, ~10 000 tokens. Usage quotidien, bon compromis.

⚪

all (défaut)

36 outils, ~21 000 tokens. Contexte large, tu veux tout.

🎚️

custom

Tu choisis tes outils par nom. Tokens variables.

En custom, tu listes les outils voulus, par exemple --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status,parse_prd,expand_task".

Ton premier projet end-to-end

🚀 5 étapes

Task Master installé et branché, voici la boucle complète sur un vrai projet.

Crée un dossier projet et lance Claude dedans : mkdir mon-projet, cd mon-projet, claude.

Initialise Task Master. Dans la session : « Initialize taskmaster-ai in my project ». Il crée un dossier .taskmaster/ avec docs, tasks et templates.

Écris un PRD minimal. « Create a PRD at .taskmaster/docs/prd.txt for [décris ton projet en 5 à 10 lignes : objectif, contraintes techniques, critères de réussite, hors périmètre] ». Claude le rédige, tu relis et ajustes.

Fais générer les tâches. « Parse my PRD at .taskmaster/docs/prd.txt ». En 30 à 60 secondes : 10 à 30 tâches, leurs dépendances, leur complexité et leur priorité, dans .taskmaster/tasks/tasks.json.

Exécute. « What's the next task I should work on? », puis « Help me implement task 1 », puis « Mark task 1 as done ». Les tâches dépendantes se débloquent, tu enchaînes.

Les sept commandes qui couvrent 95 % de l'usage.

🟢

Initialiser

« Initialize taskmaster-ai in my project »

📝

Générer les tâches

« Parse my PRD at .taskmaster/docs/prd.txt »

📋

Voir toutes les tâches

« Show me all the tasks »

➡️

Prochaine tâche

« What's the next task I should work on? »

🔎

Détail d'une tâche

« Show me task 3 »

⚙️

Implémenter

« Help me implement task 3 »

✅

Marquer terminé

« Mark task 3 as done »

Ce qu'il faut garder en tête

🎛️

Coûts tokens

Sans le mode core, Task Master mobilise environ 21 000 tokens en permanence. Avec Pro ou Max tu ne paies rien, mais ta fenêtre de contexte est plus chargée. Passe en core dès que tu es à l'aise.

📄

Tout dépend du PRD

La qualité des tâches dépend à 80 % de la qualité du PRD. PRD vague, tâches inutilisables.

👥

Pas de collab native

Task Master tourne sur ta machine. Pour travailler à plusieurs, tu commit .taskmaster/ sur Git, mais les sessions IA ne se synchronisent pas entre membres.

⚖️

Licence

MIT plus Commons Clause. Usage commercial et modification autorisés, mais pas de revente de Task Master tel quel comme service.

L'essentiel

Le vrai levier n'est pas l'outil, c'est la boucle : cadrer un brief clair, le transformer en tâches dépendantes, exécuter sans perdre le fil. Task Master industrialise ce cadrage directement dans ton terminal, là où tu codes déjà.