Aller au contenu principal

Comment créer un plugin Cowork depuis zéro (Guide 2026)

· 5 minutes de lecture
Claude Dev
Claude Dev
Claude Dev

Si vous voulez que Cowork fasse du vrai travail pour vous, les plugins sont le levier principal.

Au 2026-02-28, la trajectoire officielle est claire :

  • Anthropic a lancé Cowork le 2026-01-14
  • La création/partage de plugins custom a été annoncée le 2026-01-20
  • Des mises à jour du répertoire de plugins pour entreprises sont sorties le 2026-02-24
  • La doc d’aide sur les plugins a été mise à jour le 2026-02-25

Ce guide combine ce flux officiel avec des retours de la communauté pour vous aider à construire votre premier plugin utile depuis zéro.

Ce que votre plugin Cowork doit faire (avant l’UI)​

Un bon premier plugin résout une tâche étroite et répétitive.

Mauvaise première idée :

  • « Fais toute ma stratégie marketing »

Meilleures premières idées :

  • « Transformer des notes de réunion en actions hebdo avec owner et échéance »
  • « Résumer des logs d’incident et sortir un tableau de triage des risques »
  • « Évaluer un profil candidat et produire une scorecard structurée »

Avant de construire, écrivez ce contrat en une ligne :

Input : ce que vous fournissez.
Output : ce que le plugin doit rendre à chaque fois.

Si ce contrat n’est pas clair, votre prompt va dériver.

Étape 1) Créer la base du plugin dans Cowork​

Dans Cowork, ouvrez la zone plugins et créez un nouveau plugin.

D’après la doc officielle/support, vous pouvez généralement :

  • Créer depuis zéro dans l’UI Cowork
  • Importer depuis des fichiers locaux
  • Installer depuis le plugin directory (plugins existants)

Pour le premier, choisissez from scratch.

Étape 2) Nom et description : la précision commence ici​

Les builders de la communauté le répètent : la sélection du plugin dépend fortement de la clarté du nom et de la description.

Format recommandé :

  • Nom : rôle concret (Incident Triage Reporter)
  • Description : déclencheur + périmètre (Use when user asks to triage ops incidents from raw logs into severity, owner, and next action.)

Évitez les descriptions vagues du type « general assistant plugin ».

Pourquoi c’est important :

  • Cowork doit décider quand votre plugin est pertinent
  • Une description floue cause des activations incorrectes (ou aucune activation)

Étape 3) Écrire un contrat de prompt strict​

Les instructions du plugin doivent ressembler à un runbook de production.

Structure minimale efficace :

  1. Rôle et objectif
  2. Inputs requis
  3. Format de sortie (sections fixes/tableau/structure type JSON)
  4. Règles de décision et priorités
  5. Limites de sécurité et comportement en cas d’incertitude

Exemple :

You are Incident Triage Reporter.

Goal:
- Convert raw incident notes into a priority triage report.

Required inputs:
- incident_log
- service_name
- report_time

Output format:
- Severity: P0/P1/P2/P3
- Impact summary (max 3 bullets)
- Suspected root cause
- Immediate next action
- Owner recommendation

Rules:
- If evidence is weak, state uncertainty explicitly.
- Never invent metrics not present in input.
- Ask one clarifying question if critical context is missing.

Leçon communautaire : les prompts courts et contraints sont souvent plus robustes que les prompts longs « qui font tout ».

Étape 4) Concevoir pour un output prévisible, pas « créatif »​

Si le plugin alimente un workflow, la cohérence compte plus que le style.

Vérifications pratiques :

  • Un collègue peut-il lire le résultat en 10 secondes ?
  • Une automatisation aval peut-elle le parser ?
  • Le format reste-t-il stable sur 5 inputs très différents ?

Sinon, resserrez les règles et réduisez le scope.

Étape 5) Tester les vrais cas limites avant partage​

Ne testez pas seulement le happy path.

Au minimum ces 5 tests :

  1. Input propre et complet
  2. Champ clé manquant
  3. Données contradictoires
  4. Input très long/bruyant
  5. Input hors périmètre du plugin

Comportement attendu pour #5 : refus explicite + suggestion de redirection.

Étape 6) Partager proprement dans le workspace​

Le déploiement officiel pour équipes insiste sur le partage contrôlé et la gouvernance du workspace.

Avant publication interne :

  • Ajouter « When to use / When not to use »
  • Ajouter des exemples input/output
  • Définir un owner et les attentes de maintenance
  • Versionner le prompt (v0.1, v0.2, etc.) avec mini changelog

Vous évitez ainsi les plugins « boîte noire » après quelques semaines.

Étape 7) Itérer à partir de l’usage réel​

Après lancement, relisez les runs chaque semaine :

  • Qualité d’activation (appelé au bon moment ?)
  • Taux de correction (combien d’outputs sont réécrits)
  • Schémas d’échec (contexte manquant, hypothèses erronées)

À chaque itération, modifiez une seule variable :

  • Texte de description
  • Règle de prompt
  • Schéma de sortie

Les petites modifications contrôlées battent les réécritures totales.

Officiel vs communauté : à qui faire confiance d’abord ?​

Ordre de priorité :

  1. Docs produit/support Cowork officielles (comportement, permissions, rollout)
  2. Tutoriels/références plugins officiels (format et implémentation)
  3. Exemples communauté (utile pour edge cases et heuristiques terrain)

Le contenu communautaire est précieux, mais peut vieillir vite avec l’évolution du produit.

Conclusion​

Votre premier plugin Cowork doit être simple, étroit et fiable.

Si vous réussissez ces 3 points :

  • description de déclenchement claire
  • contrat de sortie strict
  • tests disciplinés

…vous obtiendrez vite de la valeur, et votre deuxième plugin sera beaucoup plus facile.

Sources (vérifiées le 2026-02-28)​

Officielles​

Communauté​