Claude Platform 101

La **Claude Developer Platform** est l'infrastructure d'Anthropic pour construire avec Claude de manière programmatique. Au lieu de discuter avec Claude dans un navigateur, vous envoyez des requêtes structurées depuis votre code et recevez des réponses structurées en retour — avec un contrôle sur chaque détail : quel modèle utiliser, combien de tokens dépenser, quels outils Claude peut utiliser, et quelles instructions système il suit.

Dire bonjour à Claude pourrait vous réchauffer le cœur, mais ce n'est pas vraiment utile. Dans cette leçon, nous allons envoyer quelque chose de réel à Claude et récupérer des informations structurées en retour — en moins de 20 lignes de code.

Vous déployez une application avec Claude. Quel modèle choisissez-vous ? Si vous optez par défaut pour le plus intelligent, votre facture API vous surprendra. Choisissez le moins cher, et la sortie pourrait ne pas être à la hauteur. Chaque modèle a des compromis différents, et le choix du bon affecte à la fois la **qualité** et le **coût**.

Vous avez effectué des appels API, mais un seul appel ne retourne qu'une réponse. Si vous voulez automatiser un flux de travail, Claude doit agir, examiner le résultat, décider de la suite et continuer. Ce modèle est ce que les gens entendent quand ils parlent de **flux de travail agentiques**.

Vos workflows existants s'appuient sur de nombreuses technologies différentes — logiciels de gestion de projet, bases de données, fichiers. Claude ne peut pas simplement vérifier ces choses lui-même. À la place, il s'appuie sur des **outils**, qui donnent à Claude accès à des données externes et à des actions.

Certaines tâches nécessitent plus qu'une réponse rapide. Claude peut travailler sur un problème avant de répondre — une fonctionnalité appelée **réflexion étendue**. Dans cette leçon, nous allons examiner ce qu'est la réflexion, comment l'activer et quand elle est vraiment utile.

Vous pouvez créer vos propres outils personnalisés, mais certaines capacités sont suffisamment courantes pour qu'Anthropic les fournisse pré-construits. Vous n'écrivez pas le code. Vous n'hébergez pas le sandbox. Vous déclarez simplement l'outil, et Anthropic l'exécute.

Les compétences** sont des dossiers d'instructions, de scripts et de ressources que Claude charge dynamiquement pour améliorer ses performances sur des tâches spécialisées. Au cœur de chaque compétence se trouve un fichier `SKILL.md` — un ensemble d'instructions packagé que vous téléchargez une fois, puis que vous attachez à n'importe quel appel `messages.create`. Vous enseignez à Claude comment _vous_ faites quelque chose : votre format de rapport de statut, votre liste de contrôle d'examen, vos notes de version. Claude lit la compétence, suit la procédure et produit un résultat à votre image.

Nous avons des outils, des compétences et des connecteurs. Alors pourquoi **MCP** existe-t-il ? À première vue, cela ressemble à une deuxième API empilée sur l'API. Question légitime — et la réponse tient à qui maintient le code d'intégration.

Chaque requête que vous envoyez à Claude a une **context window**. Un million de tokens, ça semble beaucoup, mais ça s'épuise plus vite qu'on ne le pense une fois qu'on déploie un vrai agent. C'est là que la **context management** intervient : c'est comment rester dans la fenêtre sans perdre ce qui compte.

Claude Managed Agents** est une suite d'APIs pour construire et déployer des agents à grande échelle. Vous définissez des agents avec des outils, des personas et des capacités spécifiques. Vous configurez des environnements sandbox avec les bons packages et contrôles réseau. Ensuite, vous lancez des sessions depuis votre propre application, et Claude fait le travail à l'intérieur d'un conteneur isolé avec accès complet au système de fichiers, exécution bash et recherche web.

Si vous avez construit une boucle d'agent à la main, vous connaissez la routine : boucles while, commutateurs de raison d'arrêt, exécutions d'outils. Cela fonctionne, et pour beaucoup de fonctionnalités, c'est en fait la bonne approche. Mais parfois, cette boucle va s'exécuter très longtemps — des minutes, peut-être même des heures — sur plusieurs outils, avec un état à maintenir, des fichiers à écrire, et du travail à reprendre après une interruption réseau. À ce moment-là, vous ne voulez pas exécuter la boucle sur votre serveur. Vous voulez la déléguer. C'est ce que sont les **agents gérés**.

Écrire du code qui appelle l'API Claude à la main fonctionne bien, mais il existe un chemin encore plus rapide : faire écrire le code par Claude. Dans cette leçon, nous utiliserons **Claude Code** pour compléter une intégration API à partir d'un fichier avec des stubs — en utilisant les mêmes primitives que vous avez apprises tout au long de ce cours.