Créer des fonctionnalités IA avec l'API Claude : guide pratique

Un guide pratique pour intégrer l'API Claude dans de vraies applications : authentification, conception des prompts, sorties structurées, gestion des erreurs et maîtrise des coûts.

Hamza El Haissouf

2 min de lectureFR

Démarrer : clé d'API et installation du SDK

# Node.js
npm install @anthropic-ai/sdk

# Python
pip install anthropic

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

Votre premier appel à l'API

const message = await client.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "Analyze this job listing for red flags: ..." }
  ],
});

console.log(message.content[0].text);

Concevoir des prompts pour des sorties fiables et structurées

La clé d'une fonctionnalité IA prête pour la production, c'est une sortie prévisible. Demandez toujours du JSON :

const response = await client.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 2048,
  system: `You are a job listing analyzer. Always respond in valid JSON.
  Schema: { "risk_score": number (1-100), "flags": string[], "summary": string }`,
  messages: [{ role: "user", content: jobDescription }],
});

const analysis = JSON.parse(response.content[0].text);

Conseils pour une sortie structurée fiable :

Définissez le schéma JSON exact dans le prompt système
Utilisez des exemples (few-shot) pour les sorties complexes
Réglez la température entre 0,2 et 0,3 pour les tâches d'analyse
Validez la sortie avec un validateur de schéma (zod, ajv)

Construire un moteur de notation (exemple Jobisque)

Dans Jobisque, Claude note les offres d'emploi selon 5 dimensions. L'astuce consiste à utiliser une notation pondérée :

const weights = {
  requirements_realism: 0.25,
  compensation_transparency: 0.20,
  company_legitimacy: 0.25,
  role_clarity: 0.15,
  red_flag_language: 0.15,
};

const overallScore = Object.entries(scores).reduce(
  (total, [key, value]) => total + value * weights[key], 0
);

Maîtriser les coûts

Les tarifs par token évoluent régulièrement : consultez la page de tarification officielle d'Anthropic pour les prix à jour de chaque modèle.

Stratégies pour réduire les coûts :

Utilisez Haiku pour les tâches simples (classification, extraction)
Mettez les prompts système en cache : la mise en cache des prompts d'Anthropic réduit les coûts jusqu'à 90 % pour les prompts système répétés
Limitez max_tokens à ce dont vous avez réellement besoin
Regroupez les requêtes quand c'est possible

Gérer les erreurs en production

try {
  const response = await client.messages.create({ ... });
} catch (error) {
  if (error.status === 429) {
    // Limite de débit atteinte : appliquer un délai exponentiel
    await sleep(Math.pow(2, retryCount) * 1000);
  } else if (error.status === 529) {
    // API surchargée : réponse en cache ou mise en file d'attente
  }
}

Vous voulez intégrer l'IA à votre produit ? Réservez un appel pour cadrer le projet.

Hamza El Haissouf

Développeur full-stack depuis 6 ans · Maroc

Je conçois des assistants WhatsApp et des sites web pour les cliniques privées et les entreprises de logistique. À distance, en français et en anglais.

Voir les projets À propos LinkedIn