Guide pratique

Connecter Claude API à n8n : guide complet

Claude n'a pas de nœud natif dans n8n, mais l'intégration prend 20 minutes si vous suivez les bonnes étapes. Voici comment faire ça proprement en production — avec gestion des erreurs, optimisation des coûts et monitoring.

n8nClaude APIAnthropicHTTP Request

Créer votre clé API Anthropic

Rendez-vous sur console.anthropic.com, créez un compte et générez une clé API. Copiez-la immédiatement — elle ne sera plus affichée ensuite.

Dans n8n, allez dans Credentials → New Credential → HTTP Header Auth. Nom : "Anthropic API", Header Name : "x-api-key", Header Value : votre clé. Cochez "Use credential in" → "Header Auth".

Important : ne mettez jamais votre clé en dur dans un workflow. Utilisez toujours les credentials n8n, qui sont chiffrés au repos.

Configurer le nœud HTTP Request

Claude API n'a pas de nœud natif dans n8n (contrairement à OpenAI). Vous allez utiliser le nœud HTTP Request.

Paramètres : - Method : POST - URL : https://api.anthropic.com/v1/messages - Authentication : Header Auth (votre credential Anthropic) - Headers → Add Header → "anthropic-version" : "2023-06-01" - Body : JSON

Corps de la requête : { "model": "claude-sonnet-4-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "{{ $json.inputText }}"} ] }

Remplacez $json.inputText par le champ de vos données d'entrée.

Extraire la réponse de Claude

La réponse de Claude API ressemble à ça : { "content": [{"type": "text", "text": "La réponse de Claude..."}], "usage": {"input_tokens": 42, "output_tokens": 128} }

Pour extraire le texte dans n8n, ajoutez un nœud Set après le HTTP Request : - Nom : "response_text" - Valeur : {{ $json.content[0].text }}

Et si vous voulez tracker les coûts : - "tokens_used" : {{ $json.usage.input_tokens + $json.usage.output_tokens }}

Ces métriques vous permettront de monitorer votre consommation au fil du temps.

Gérer les erreurs et les limites de taux

Claude API retourne des erreurs 429 quand vous dépassez les rate limits, et 529 en cas de surcharge. En production, vous devez les gérer.

Dans le nœud HTTP Request, activez "Continue On Fail". Ensuite ajoutez un nœud IF : - Condition : {{ $json.error !== undefined }} - Branch "true" → nœud Wait (30 secondes) → boucle vers le HTTP Request - Branch "false" → suite du workflow

Pour les timeouts, paramétrez "Timeout" à 30000ms (30 secondes). Claude Sonnet répond généralement en 3 à 8 secondes selon la longueur de la réponse.

Sur les workflows critiques, ajoutez une notification Slack en cas d'échec répété.

Optimiser les coûts avec un system prompt efficace

Chaque token coûte de l'argent. Un system prompt bien construit réduit significativement la longueur des réponses.

Au lieu de "Vous êtes un assistant helpful...", soyez direct : "Réponds en 3 phrases maximum. Format : une phrase par ligne. Pas d'introduction ni de conclusion."

Pour les tâches répétitives (classification, extraction), Claude Haiku est 6x moins cher que Sonnet avec des performances suffisantes sur les tâches simples.

Notre règle : Haiku pour classer/extraire, Sonnet pour analyser/rédiger, Opus uniquement pour les décisions complexes à fort enjeu.

Les 4 erreurs qui font perdre du temps

On les a toutes rencontrées. Autant vous éviter de les découvrir en production.

Oublier l'en-tête anthropic-version

Sans cet en-tête, l'API retourne une erreur 400. Ajoutez toujours anthropic-version: 2023-06-01 dans vos headers.

Mettre max_tokens trop bas

Si max_tokens est atteint, la réponse est tronquée sans avertissement visible. Sur des réponses longues, mettez 2048 minimum.

Ne pas gérer les rate limits

En production, ajoutez systématiquement un mécanisme de retry avec backoff. Un 429 non géré fait échouer le workflow silencieusement.

Passer des données sensibles directement

n8n stocke les exécutions dans sa base. Masquez ou ne transmettez pas de données personnelles ou confidentielles à Claude si elles ne doivent pas être stockées.

Aller plus loin

Workflows n8n + IA

Les 6 patterns d'automatisation qu'on industrialise.

Lire

Coût d'un workflow n8n IA

Combien ça coûte vraiment de faire tourner un workflow Claude en production.

Lire

Templates n8n IA pour SaaS

4 templates prêts à adapter à votre contexte.

Lire

Besoin d'aller plus vite ?

Mettre en place n8n + Claude API, c'est 20 minutes pour un prototype. Le rendre fiable en production — gestion d'erreurs, retry, monitoring, optimisation des coûts — c'est 2 à 3 jours de travail sérieux. On peut le faire à votre place, ou former votre équipe pour qu'elle le fasse elle-même.

Voir notre approche workflows n8n + IA

Questions fréquentes

Pourquoi n8n n'a pas de nœud Claude natif comme OpenAI ?

n8n a un partenariat commercial avec OpenAI, d'où le nœud natif. Pour Claude, il faut passer par le nœud HTTP Request générique. Ce n'est pas beaucoup plus complexe — la différence principale est que vous devez ajouter manuellement l'en-tête anthropic-version.

Quelle version de Claude utiliser dans n8n ?

Pour 90% des cas d'usage en workflow n8n : claude-haiku-4-5 (classification, extraction simple, reformatage) ou claude-sonnet-4-6 (analyse, rédaction, raisonnement). Evitez Opus dans les workflows automatisés — le coût et la latence ne sont pas justifiés sauf cas très spécifiques.

Comment tester mon workflow sans consommer des tokens à chaque essai ?

Créez un nœud IF au début qui vérifie une variable d'environnement TEST_MODE=true. En mode test, remplacez l'appel Claude par un nœud Set qui retourne une réponse fictive fixe. Vous déboguez la logique du workflow sans payer les tokens.

Peut-on utiliser Claude en streaming avec n8n ?

Pas nativement. n8n attend la réponse complète avant de passer au nœud suivant. Si vous avez besoin de streaming (affichage progressif), il vaut mieux construire une API dédiée en dehors de n8n et appeler celle-ci depuis n8n.

Comment monitorer les coûts Claude dans n8n ?

La réponse Claude inclut un champ usage.input_tokens et usage.output_tokens. Extrayez ces valeurs dans chaque workflow, écrivez-les dans une base de données ou une feuille Airtable, et suivez la tendance semaine par semaine. En production, définissez une alerte si le coût journalier dépasse un seuil.