Automatiser n8n avec Claude Code

Claude Code est un agent IA de développement qui tourne dans votre terminal. Vous lui decrivez une tache en langage naturel, il propose un plan, puis exécute : édition de fichiers, commandes shell, appels API, recherche dans le code, avec un système de permissions pour garder le controle.

L'architecture d'un projet Claude Code

Les fichiers cles

Les Skills

Les Skills sont des modules de connaissances installés globalement dans ~/.claude/skills/. Claude les charge automatiquement quand ils sont pertinents. Ils lui apprennent des méthodes, des bonnes pratiques et des procedures spécifiques à un domaine.

Un projet Claude Code capable de :

• Conseiller : avant de coder, Claude cherche dans 288 templates reels pour proposer des architectures éprouvées et challenger votre approche
• Planifier : il produit un plan détaillé (nodes, connexions, prompts, error handling) que vous validez avant exécution
• Construire : il créé le workflow directement dans votre instance n8n via API
• Valider : il vérifié la structure, corrigé les erreurs, et vous liste ce qu'il reste à configurer manuellement (credentials, emails)

Le tout repose sur 4 briques :

Outils

• Warp installé (lien installation), un terminal moderne avec IA intégrée
• Claude Code CLI installé (voir étape 1)
• Un abonnement Claude (Max, ou clé API Anthropic avec minimum 5$ de credit)
• Node.js installé (pour npx) → nodejs.org

Cote n8n

• Une instance n8n opérationnelle (Cloud ou self-hosted)
• Une cle API n8n : Settings → n8n API → Create an API key
• L'URL de votre instance (ex : https://mon-instance.n8n.cloud/)

Installer n8n sur un VPS (Hostinger)

Si vous n'avez pas encore d'instance n8n, voici un tutoriel vidéo pour installer n8n sur un serveur VPS avec Hostinger :

Installer Warp

Warp est un terminal moderne ecrit en Rust, avec une interface par blocs (chaque commande et sa sortie sont regroupées), un editeur de texte intégré, et l'auto-completion intelligente.

Option A : via Homebrew (recommandé)

brew install --cask warp

Option B : téléchargement direct

1. Va sur warp.dev/download
2. Télécharge le .dmg (macOS) ou l'installeur Windows/Linux
3. Glissez Warp dans votre dossier Applications

Configuration requise : macOS 10.14+ (Intel ou Apple Silicon), Windows 10+, ou Linux.

Une fois installé, ouvrez Warp. Vous pouvez créer un compte Warp (optionnel) ou passer cette étape.

Installer Claude Code

Dans Warp, lance :

# Installer Claude Code globalement
npm install -g @anthropic-ai/claude-code

Puis connectez-vous :

# Lancer Claude Code pour la premiere fois (authentification)
claude

Claude Code va vous demander de vous connecter avec votre compte Anthropic (abonnement Max) ou une clé API.

Installer le plugin Warp pour Claude Code (optionnel)

Ce plugin ajoute des notifications natives dans Warp : quand Claude termine une tache longue, vous recevez une notification système au lieu de devoir surveiller le terminal.

Dans Claude Code, lance ces deux commandes :

/plugin marketplace add warpdotdev/claude-code-warp
/plugin install warp@claude-code-warp

Puis relancez Claude Code (/exit puis claude). Un message de confirmation apparait si le plugin est actif.

Creer la structure de dossiers

mkdir -p ~/claude-projets/automatisations
cd ~/claude-projets/automatisations

Puis lancez Claude Code dans ce dossier :

claude

Creer le fichier CLAUDE.md

Le CLAUDE.md est le briefing permanent de votre agent. Il définit comment Claude doit travailler sur ce projet : conventions, méthode, regles de sécurité, outils disponibles.

Ouvrez Claude Code et envoyez ce prompt :

Je souhaite que vous creez le fichier CLAUDE.md pour ce projet.

Contexte :
- Le but : créer des workflows n8n de haute qualité en vous appuyant sur vos capacités + des outils dédiés.
- Outils que je vais ajouter :
  1) un serveur MCP n8n (n8n-mcp)
  2) un skillset n8n (n8n-skills)
  3) une bibliothèque de templates (awesome-n8n-templates)

Ce que je veux dans CLAUDE.md :
- Objectif du repo
- Conventions de nommage des workflows et des nodes (claires, explicites)
- Checklist qualité avant "publish" (gestion erreurs, retries, logs, idempotence)
- Comment vous devez travailler : Conseil (templates) → Plan mode → Validation → Exécution
- Regles sécurité : ne jamais exposer des secrets, toujours utiliser des credentials n8n
- Pattern d'architecture n8n par defaut (trigger → validation → traitement → sortie → erreur)
- Comment exploiter MCP + Skills + Templates (quand les appeler, comment vérifiér)

Généré un CLAUDE.md court mais opérationnel.

Claude va créer le fichier à la racine du projet. Vous pourrez l'ajuster par la suite.

Qu'est-ce que le MCP ?

Le Model Context Protocol (MCP) est un standard qui permet à Claude Code de se connecter à des outils externes. Ici, le serveur n8n-mcp donne à Claude la capacité de :

• Chercher et comprendre les 400+ nodes n8n (parametres, operations, versions)
• Creer, modifier et supprimer des workflows directement dans votre instance
• Valider les configurations avant déploiement
• Tester les workflows et consulter les exécutions

Installation

Envoyez ce prompt à Claude Code :

Installe ce serveur MCP : https://github.com/czlonkowski/n8n-mcp

C'est un serveur MCP pour interagir avec n8n.

Claude va :

1. Creer le fichier .mcp.json à la racine du projet
2. Configurer le serveur avec npx n8n-mcp

Résultat attendu

Un fichier .mcp.json va apparaitre à la racine :

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "${N8N_API_URL}",
        "N8N_API_KEY": "${N8N_API_KEY}",
        "WEBHOOK_SECURITY_MODE": "moderate"
      }
    }
  }
}

Creer le fichier .env

Cree un fichier .env à la racine du projet avec vos identifiants n8n :

N8N_API_URL=https://ton-instance.n8n.cloud/
N8N_API_KEY=ta-cle-api-n8n

Pour trouver ces valeurs :

1. N8N_API_URL : c'est l'URL que vous voyez dans votre navigateur quand vous etes connecté à n8n
2. N8N_API_KEY : dans n8n, allez dans Settings → n8n API → Create an API key

Ajouter .env au .gitignore

Le fichier .env contient des secrets. Ne jamais le committer :

echo ".env" >> .gitignore

Vérifier la connexion

Relancez Claude Code (quittez avec /exit puis relancez claude) puis envoyez :

Vérifiez que vous pouvez vous connecter a mon instance n8n via le serveur MCP.

- Liste mes workflows existants
- Confirme que la connexion fonctionne

Si tout est OK, Claude va lister vos workflows. Sinon, vérifiéz l'URL et la clé API dans .env.

Qu'est-ce qu'un Skill ?

Les Skills sont des "modes d'emploi" que Claude charge automatiquement quand c'est pertinent. Ils lui apprennent comment bien utiliser les outils MCP pour produire des workflows de qualité.

Installation

Envoyez ce prompt à Claude Code :

Installe ces skills : https://github.com/czlonkowski/n8n-skills

Ce sont des skills pour m'aider a créer des workflows n8n de qualité.

Claude va cloner le repo et installer 7 skills dans ~/.claude/skills/ :

Vérifier l'installation

Liste les skills n8n disponibles et explique brievement à quoi sert chacun.

Pourquoi des templates ?

Sans templates, Claude improvise. Avec 288 templates reels, il peut :

• Chercher des workflows similaires à votre besoin avant de concevoir
• S'inspirer d'architectures éprouvées (nodes, connexions, prompts)
• Challenger votre approche : "Ce template fait X de cette facon, avez-vous envisagé Y ?"

C'est la brique conseil du projet.

Installation

Envoyez ce prompt à Claude Code :

Clone ce repo dans le projet : https://github.com/enescingoz/awesome-n8n-templates

C'est une bibliothèque de templates n8n pour m'aider à mieux concevoir mes workflows.

Ensuite, mets à jour le CLAUDE.md pour intégrér cette nouvelle ressource :
- Ajouter la bibliothèque dans les outils disponibles
- Ajouter une étape "Conseil" en amont du Plan mode (chercher des templates similaires, challenger l'approche)
- Documenter les catégories disponibles et comment chercher dans les templates

Résultat

Un dossier awesome-n8n-templates/ avec 288 fichiers JSON organises en 19 catégories :

Tout est en place. Vérifiez que les 4 briques fonctionnent ensemble :

Vérifié que tout est opérationnel :
1. Connectez-vous a mon instance n8n et listez mes workflows
2. Montre-moi les skills n8n disponibles
3. Cherche dans awesome-n8n-templates un template qui utilise un schedule trigger + un agent IA
4. Explique-moi en 5 lignes le pattern d'architecture que vous appliqueriez pour un workflow de veille automatisé

Ce que vous devez voir :

• La liste de vos workflows n8n existants
• Les 7 skills n8n charges
• Un ou plusieurs templates trouves dans la bibliothèque
• Un plan d'architecture clair qui prouve que Claude comprend n8n

Pourquoi un Error Handler ?

En production, un workflow qui echoue silencieusement est pire qu'un workflow qui n'existe pas. n8n permet de configurer un workflow d'erreurs global qui se déclenche automatiquement quand un autre workflow plante.

Creer le workflow Error Handler

Envoyez ce prompt à Claude Code :

Cree un workflow n8n d'error handling qui :
- Se déclenche automatiquement quand un autre workflow echoue
- M'envoie un email de notification avec :
  le nom du workflow en erreur, le node qui a plante,
  le message d'erreur, la date, et un lien direct vers l'exécution dans n8n
- Format HTML propre et lisible
- Destinataire : mon-email@exemple.com

Claude va créer un workflow à 3 nodes :

Error Trigger → Code (formater email HTML) → Gmail (envoyer alerte)

Lier le Error Handler aux workflows

Creer le workflow ne suffit pas, il faut le référencer dans les settings de chaque workflow à surveiller. Claude le fait automatiquement, mais voici comment vérifiér :

• Dans n8n, ouvrez le workflow à surveiller
• Allez dans Settings (icone engrenage)
• Dans Error Workflow, sélectionnez votre workflow "Error Handler"
• Sauvegarde

Vous pouvez aussi demander à Claude de le faire via MCP :

Configure le workflow Error Handler comme errorWorkflow
pour tous mes workflows actifs.

Le fichier REX (Retour d'Expérience)

Le fichier docs/rex-automatisations.md documente chaque automatisation validée : les erreurs rencontrées, leurs corrections, et les leçons apprises. C'est une mémoire projet qui permet à Claude de ne pas répéter les memes erreurs.

Apres chaque workflow validé en production, demande :

Ajoute un REX pour le workflow [nom] dans docs/rex-automatisations.md
avec les erreurs rencontrées, les corrections et les leçons apprises.

Structure d'une entree REX

## N. Nom du workflow

**Workflow ID** : `xxx`
**Date** : AAAA-MM-JJ
**Statut** : En production

### Description
Ce que fait le workflow (3-5 lignes)

### Erreurs rencontrées et corrections
#### 1. Titre du problème
**Problème** : Ce qui ne marchait pas
**Symptome** : Ce qu'on observait
**Correction** : Ce qu'on a change
**Leçon** : Ce qu'il faut retenir pour la suite

### Decisions d'architecture
Tableau des choix techniques et leurs raisons

### Points de vigilance pour la maintenance
Liste des éléments à surveiller (credentials, IDs, etc.)

L'export des workflows valides

Le dossier workflows/ stocke les fichiers JSON de chaque workflow validé en production. C'est un backup versionné indépendant de l'instance n8n.

Apres chaque validation, demande :

Exporte le workflow [nom] dans le dossier workflows/
et mets à jour le repo git.

Avantages de l'export : backup indépendant de l'instance n8n (si crash ou migration), historique des versions via git, possibilite de restaurer un workflow sur une nouvelle instance, et documentation technique lisible (le JSON contient toute la config).

Les skills sont installés globalement dans ~/.claude/skills/ et sont disponibles dans tous les projets.

La méthode de travail

Une fois le projet installé, voici comment vous creez un workflow :

Les permissions Claude Code

Claude Code a plusieurs modes de fonctionnement :

Vous pouvez changer de mode directement dans le terminal avec les raccourcis Shift+Tab (plan mode) ou via la commande /permissions.

Consulte le REX : comment avait-on résolu le problème de [description] ?

Sources utiles