L'ecosysteme Anthropic / Claude#

Une seule marque, cinq surfaces de travail : le chat, Claude Code, l'API, les skills et le MCP. Voici quoi ouvrir, et quand.

Temps de lecture : 14 min | Niveau : Intermediaire

Ce que tu sauras faire apres#

• Choisir entre l'application Claude, Claude Code et l'API selon ta tache.
• Organiser ton travail recurrent dans un Project avec des instructions permanentes.
• Ecrire une skill (competence reutilisable) valide, avec le bon name et la bonne description.
• Brancher une source de donnees via un connecteur ou un serveur MCP.
• Empaqueter ton setup dans un plugin pour le partager a ton equipe.

1. La carte de l'ecosysteme#

La documentation officielle presente deux facons de construire avec Claude : la Messages API (acces direct au modele, tu controles ta boucle d'agent) et les Claude Managed Agents (un harnais d'agent pre-construit et heberge, fait pour les taches longues et asynchrones).

Les modeles disponibles#

Au moment de la redaction, la page d'introduction liste quatre modeles courants.

La liste des modeles change souvent. Verifie la page d'introduction avant de figer un identifiant dans ton code.

2. Claude (l'application) : Projects et instructions permanentes#

Un Project est un espace de travail autonome, avec son propre historique de conversations et sa propre base de connaissances. Tu y deposes des fichiers une fois, et Claude les retrouve dans toutes les conversations du projet.

Points verifies dans la documentation :

• Les Projects sont disponibles pour tous les utilisateurs, y compris les comptes gratuits. Les comptes gratuits peuvent creer jusqu'a cinq projets.
• Tu peux definir des instructions de projet : ton, niveau d'expertise, role a adopter.
• Sur les plans payants (Pro, Max, Team, Enterprise), le RAG (Retrieval Augmented Generation) permet de monter en volume de contenu, avec une capacite annoncee jusqu'a 10 fois superieure.
• Team et Enterprise peuvent partager un projet avec des droits Can view ou Can edit.

AVANT / APRES : un project pour ton reporting#

Avant (mauvais). A chaque nouvelle conversation, tu re-expliques ton contexte :

Je travaille sur des donnees de ventes, en PostgreSQL, il y a une table fact_ventes...

Tu perds cinq minutes par conversation, et tu oublies la moitie du contexte une fois sur deux.

Apres (bon). Tu crees un projet "Reporting ventes", tu y deposes le schema SQL, le glossaire metier et le dictionnaire de KPI. Dans les instructions du projet :

Tu es analyste data senior sur notre entrepot PostgreSQL.
Regles permanentes :
- Toujours ecrire du SQL PostgreSQL (pas MySQL, pas BigQuery).
- Les montants sont TTC sauf mention contraire.
- Les semaines vont du lundi au dimanche.
- Avant de repondre, cite les tables du schema que tu utilises.
- Si une colonne n existe pas dans le schema fourni, dis-le au lieu de l inventer.

Pourquoi c'est mieux. Le contexte est charge une fois pour toutes. Tu gagnes cinq minutes par conversation, et Claude arrete d'inventer des colonnes.

Les artifacts#

Un artifact est le resultat que Claude produit a cote de la conversation : un document, un tableau de bord, une petite application. Tu peux le rouvrir, le modifier et le partager. C'est la bonne surface quand le livrable doit etre montre a quelqu'un d'autre plutot que lu dans un chat.

3. Claude Code : l'agent qui travaille dans ton depot#

Claude Code est decrit comme un outil de codage agentique qui lit ton code, edite des fichiers, lance des commandes et s'integre a tes outils de developpement. Il tourne sur plusieurs surfaces qui partagent le meme moteur : Terminal, VS Code, JetBrains, application desktop et web (claude.ai/code).

L'installation en terminal se fait avec la commande donnee sur la page d'apercu : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://claude.ai/install.ps1 | iex en PowerShell. Ensuite tu te places dans un projet et tu lances claude. Le detail des methodes d'installation est couvert dans la section 05 de ce corpus.

Le fichier CLAUDE.md#

CLAUDE.md est un fichier markdown que tu poses a la racine du projet. Claude Code le lit au debut de chaque session. C'est la que tu mets tes standards de code, tes choix d'architecture et tes checklists de revue. Si ton depot contient deja un AGENTS.md pour un autre agent de code, Claude Code peut le lire aussi.

Template pret a copier :

# CLAUDE.md

## Stack
- Python [VERSION], [GESTIONNAIRE_DE_PAQUETS], [FRAMEWORK]
- Base : [POSTGRES_OU_BIGQUERY_OU_AUTRE]
- Orchestration : [AIRFLOW_OU_DAGSTER_OU_AUTRE]

## Regles non negociables
- Ne jamais modifier les fichiers du dossier [DOSSIER_INTERDIT].
- Toute requete SQL doit etre testee sur [ENVIRONNEMENT_DE_TEST] avant commit.
- Les noms de colonnes sont en snake_case.

## Commandes utiles
- Lancer les tests : [COMMANDE_TESTS]
- Lancer le lint : [COMMANDE_LINT]
- Lancer un DAG en local : [COMMANDE_DAG]

## Definition of done
- [ ] Tests passent
- [ ] Lint passe
- [ ] Le diff ne touche que les fichiers annonces

Les autres briques de Claude Code#

• Hooks : des commandes shell lancees avant ou apres une action de Claude Code (formater apres chaque edition, lancer le lint avant un commit).
• Subagents : plusieurs agents en parallele sur differentes parties d'une tache.
• Agent SDK : pour construire tes propres agents avec les outils de Claude Code.
• Routines : execution planifiee dans le cloud. /loop repete un prompt dans une session CLI.
• Integrations : GitHub Actions, GitLab CI/CD, Slack, Chrome.

4. Les Skills : ta competence, packagee#

Une Agent Skill est un dossier qui contient un fichier SKILL.md, et eventuellement des fichiers de reference et des scripts. Claude la declenche tout seul quand ta demande correspond a sa description.

Le mecanisme cle : la divulgation progressive#

La documentation decrit trois niveaux de chargement.

Autrement dit : tu peux installer beaucoup de skills sans saturer le contexte.

Les champs obligatoires#

Deux champs sont requis dans le frontmatter YAML : name et description.

• name : 64 caracteres maximum, uniquement des lettres minuscules, des chiffres et des tirets. Pas de balises XML. Les mots reserves anthropic et claude sont interdits.
• description : non vide, 1024 caracteres maximum, pas de balises XML. Elle doit dire ce que fait la skill ET quand l'utiliser, puisque c'est sur elle que Claude fait la correspondance.

Template pret a copier :

---
name: [nom-en-minuscules-avec-tirets]
description: [CE_QUE_FAIT_LA_SKILL]. A utiliser quand [DECLENCHEUR_1], [DECLENCHEUR_2] ou quand l utilisateur mentionne [MOT_CLE].
---

# [TITRE_LISIBLE]

## Quand utiliser cette skill
[SITUATION_1]
[SITUATION_2]

## Procedure
1. [ETAPE_1]
2. [ETAPE_2]
3. [ETAPE_3]

## Regles
- [REGLE_1]
- [REGLE_2]

## Exemple
[EXEMPLE_CONCRET]

Ou vivent les skills#

Point souvent oublie : les skills personnalisees ne se synchronisent pas entre les surfaces. Une skill uploadee sur claude.ai n'est pas disponible dans l'API, et inversement.

Des skills pre-construites existent cote API et claude.ai pour les documents : pptx, xlsx, docx, pdf. Attention : elles ne sont pas disponibles dans Claude Code.

Securite. N'utilise que des skills de sources fiables. Une skill peut faire executer du code a Claude. La documentation recommande d'auditer tous les fichiers du dossier avant usage.

5. MCP et connecteurs : brancher tes donnees#

Le MCP (Model Context Protocol) est un standard ouvert pour connecter des outils d'IA a des sources de donnees externes. Un connecteur est la version cle en main cote application : il permet a Claude d'acceder a tes applications, de recuperer tes donnees et d'y agir. Claude herite de tes permissions : si tu ne peux pas voir une donnee dans le systeme source, le connecteur non plus.

Exemples de connecteurs pre-construits cites par l'article d'aide : Linear, Slack, Google Drive. La liste complete vit dans l'annuaire des connecteurs, pas dans l'article. Les comptes gratuits sont limites a un connecteur personnalise.

Ajouter un serveur MCP dans Claude Code#

# Serveur HTTP distant (methode recommandee)
claude mcp add --transport http mon-serveur https://exemple.com/mcp

# Avec un en-tete d authentification
claude mcp add --transport http mon-api https://api.exemple.com/mcp \
  --header "Authorization: Bearer TON_TOKEN"

# Serveur local en stdio : le double tiret separe les options et la commande
claude mcp add --env MA_CLE=VALEUR --transport stdio mon-serveur -- npx -y mon-serveur-mcp

Les trois portees (--scope) :

Commandes de gestion : claude mcp list, claude mcp get <nom>, claude mcp remove <nom>, claude mcp login <nom>, claude mcp logout <nom>. Dans une session, /mcp affiche l'etat des serveurs.

6. Les plugins : empaqueter ton setup#

Un plugin Claude Code est un dossier qui contient des skills, des agents, des hooks et/ou des serveurs MCP, installes et charges comme une seule unite. Le manifeste est un fichier JSON situe a .claude-plugin/plugin.json.

Un marketplace est un depot contenant un fichier .claude-plugin/marketplace.json qui liste des plugins et ou les recuperer. C'est un catalogue, pas une boutique hebergee. La commande /plugin ouvre l'interface d'installation.

Quand utiliser un plugin plutot qu'une skill seule ? La documentation est claire : une skill, un subagent, un hook et un serveur MCP fonctionnent tres bien seuls. Le plugin sert quand tu veux plusieurs de ces composants packages ensemble, pour les donner a ton equipe ou les versionner.

Les trois portees d'installation : user (toi, tous tes projets sur cette machine), project (tout le monde dans ce depot, via .claude/settings.json commite), local (toi, ce depot seulement).

Attention au cout en contexte. Un plugin active fait partie de toutes tes sessions, pas seulement celles ou tu t'en sers. Les noms et descriptions de ses skills et agents occupent du contexte a chaque tour. Desactive avec /plugin ou claude plugin disable ce que tu n'utilises plus.

A retenir#

• claude.ai pour reflechir et analyser, Claude Code pour agir sur ton depot, l'API pour industrialiser.
• Un Project = instructions permanentes plus base de connaissances. C'est le meilleur retour sur investissement de dix minutes de configuration.
• Une skill se declenche sur sa description : soigne-la, elle doit dire quoi ET quand.
• Les skills ne se synchronisent pas entre claude.ai, l'API et Claude Code.
• MCP pour brancher tes systemes, plugin pour packager et partager plusieurs briques.
• Tout plugin active coute du contexte dans chaque session : garde ta liste courte.

Sources#

• Intro to Claude - Claude Platform Docs
• Claude Code overview
• Agent Skills - Claude Platform Docs
• Plugins overview - Claude Code
• MCP - Claude Code
• Use connectors to extend Claude's capabilities
• What are projects? - Claude Help Center