Les artefacts sont en version bêta. Ils nécessitent un plan Team ou Enterprise et une session connectée avec
/login. Consultez Disponibilité pour l’ensemble complet des exigences.
- Décider quand utiliser un artefact
- Créer, mettre à jour et partager un artefact
- Appliquer des modèles d’invite pour des pages plus riches
- Appliquer votre propre système de conception afin que les artefacts correspondent à la marque de votre produit
- Comprendre les contraintes de page et les exigences de disponibilité
- Désactiver ou gérer les artefacts pour votre organisation
Quand utiliser un artefact
Utilisez un artefact lorsque le texte du terminal n’est pas le bon médium pour ce que Claude a produit : une sortie qui est plus facile à regarder et avec laquelle interagir qu’à lire ligne par ligne. Claude construit la page à partir de tout ce que votre session peut atteindre, y compris votre base de code et les données qu’elle récupère via vos outils connectés, de sorte que la page peut afficher des choses qui prendraient des paragraphes à décrire. Par exemple, demandez à Claude de :- Guider un relecteur à travers une demande de tirage avec des diffs annotés
- Afficher un tableau de bord à partir des données que la session a déjà récupérées
- Disposer plusieurs options de conception ou d’implémentation côte à côte
- Maintenir une chronologie d’investigation qui se remplit pendant qu’une tâche longue s’exécute
- Envoyer à un coéquipier un lien au lieu de coller la sortie dans Slack
Ce qu’un artefact n’est pas
Un artefact est une capture de travail, pas une application. C’est une page autonome unique sans backend, elle ne peut donc pas stocker l’entrée de formulaire, appeler une API au moment de la visualisation ou servir plusieurs routes. Pour un outil interne hébergé avec un backend, déployez-le plutôt sur votre propre infrastructure. Consultez Contraintes de page pour l’ensemble complet des limites.Créer un artefact
Claude peut publier un artefact de lui-même lorsque la sortie convient à une page, ou vous pouvez en demander un directement. Pour demander, nommez la fonctionnalité ou décrivez la sortie visuelle que vous souhaitez en langage naturel. Un bon candidat est tout ce qui est plus facile à voir qu’à lire en tant que texte, comme un diff annoté, un graphique ou un ensemble d’options à comparer. Les invites ci-dessous sont deux exemples ; consultez Ce que vous pouvez créer pour plus de modèles.Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai. Republier un artefact que vous avez déjà approuvé ne demande pas à nouveau.
Sélectionnez Oui pour publier. Claude imprime l’URL, et votre navigateur s’ouvre sur la nouvelle page. Appuyez sur Ctrl+] à tout moment pour rouvrir l’artefact le plus récent à partir du terminal.
Claude choisit le titre de l’artefact et un emoji pour son icône d’onglet de navigateur. Les deux apparaissent dans votre galerie d’artefacts sur claude.ai et dans les liens partagés, donc demandez à Claude d’utiliser un titre ou une icône spécifique si vous en voulez un.
Pour empêcher le navigateur de s’ouvrir automatiquement lorsqu’un nouvel artefact est publié, définissez CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 dans votre environnement.
Si Claude répond qu’il ne peut pas publier, ou écrit un fichier HTML local sans lien, l’outil n’est pas activé pour votre session. Vérifiez les exigences de Disponibilité.
Mettre à jour un artefact
Demandez à Claude de réviser la page, ou laissez une tâche longue republier au fur et à mesure qu’elle progresse. Claude modifie le fichier sous-jacent et publie à nouveau vers la même URL.Partager un artefact
Un nouvel artefact n’est visible que pour vous. Ouvrez-le dans votre navigateur et utilisez le contrôle Partager dans l’en-tête de la page pour accorder l’accès à des personnes spécifiques de votre organisation, ou à tout le monde. L’en-tête vous nomme en tant qu’auteur de l’artefact, de sorte que quiconque vous le partagez peut voir qui a publié la page. Il renvoie également à votre galerie à claude.ai/code/artifacts, qui répertorie tous les artefacts que vous avez créés. Le partage s’arrête à votre organisation. Les spectateurs doivent se connecter à claude.ai en tant que membre de la même organisation qui a publié l’artefact, et il n’y a pas d’option pour rendre un artefact visible en dehors de celle-ci. Pour envoyer le contenu sous-jacent à quelqu’un en dehors de votre organisation, demandez à Claude le fichier HTML et partagez ce fichier directement. Les artefacts sont consultables, pas co-édités. Les personnes avec lesquelles vous le partagez voient chaque version que vous publiez mais ne peuvent pas modifier la page ; vous restez le seul rédacteur.Ce que vous pouvez créer
Un artefact est une seule page HTML, donc tout ce que vous pouvez exprimer en HTML, CSS et JavaScript en ligne est dans le champ d’application. Les modèles ci-dessous reviennent le plus souvent.Parcourir une modification
Demandez une page qui affiche un diff ou une modification de conception avec des annotations à côté des lignes pertinentes, afin que les relecteurs puissent lire votre raisonnement à côté du code au lieu de le reconstruire à partir d’une description.Comparer les alternatives
Demandez plusieurs variantes sur une page afin de pouvoir les évaluer les unes par rapport aux autres. Cela fonctionne pour les mises en page, le texte, les formes d’API ou les plans d’implémentation.Affiner avec des contrôles interactifs
Demandez des curseurs, des bascules ou des champs d’entrée liés à ce que vous ajustez, afin de pouvoir explorer les valeurs directement au lieu de les décrire.Ramener le résultat à votre session
Un artefact peut servir d’éditeur léger pour une décision que vous remettez ensuite à Claude. Demandez un contrôle d’exportation qui produit du texte que vous pouvez coller dans le terminal, afin que le résultat de l’interaction avec la page revienne à la session au lieu de rester sur la page.Suivre le travail en cours
Demandez à Claude de maintenir un artefact à jour pendant qu’une tâche longue s’exécute, afin que quiconque dispose du lien puisse suivre sans lire le terminal.Améliorer la conception visuelle
Claude applique une compétence de conception intégrée lorsqu’il construit un artefact, de sorte que les pages obtiennent une palette, une typographie et une mise en page délibérées sans invite supplémentaire. Cette compétence recherche également un système de conception existant dans votre projet avant de choisir le sien. Pour garder les artefacts cohérents avec la marque de votre produit, enregistrez vos jetons de conception où Claude peut les trouver, comme le CLAUDE.md du projet ou un fichier de thème dans votre référentiel :Contraintes de page
Chaque artefact est une page autonome unique. Claude Code enveloppe le fichier que vous publiez dans une coque de document HTML et le sert sous une politique de sécurité du contenu (CSP) stricte, qui façonne ce que la page peut faire.| Contrainte | Effet |
|---|---|
| Pas de demandes externes | La CSP bloque les scripts, les feuilles de style, les polices et les images chargées à partir de tout autre hôte, ainsi que les appels fetch, XHR et WebSocket. Claude intègre CSS et JavaScript et intègre les images en tant qu’URI de données afin que la page s’affiche sans aucune demande externe. |
| Pas de backend | Un artefact est une page statique. Il ne peut pas stocker les données soumises via un formulaire, authentifier les spectateurs lui-même ou appeler une API au moment de la visualisation. |
| Page unique | Les liens relatifs ne se résolvent pas, car rien n’est déployé à côté de la page. Pour le contenu multi-sections, Claude utilise des ancres dans la page plutôt que des fichiers séparés. |
| Types de fichiers source | Le fichier publié doit être .html, .htm ou .md. Les fichiers Markdown s’affichent en HTML stylisé. |
| Taille rendue | La page rendue doit faire 16 Mio ou moins. Les grandes images intégrées sont la cause habituelle lorsqu’une publication échoue pour la taille. |
- Préférez SVG, ou HTML et CSS, pour les diagrammes plutôt que les images raster intégrées
- Omettez l’interactivité dont vous n’avez pas besoin
- Faites en sorte que la page résume les grands ensembles de données plutôt que de les intégrer en intégralité
Disponibilité
Les artefacts nécessitent chaque condition ci-dessous. Lorsque l’une d’elles n’est pas remplie, Claude écrit un fichier HTML local ou dit qu’il ne peut pas publier à la place.| Exigence | Disponible quand |
|---|---|
| Plan | Team ou Enterprise. Sur les plans Team, les artefacts sont activés par défaut. Sur les plans Enterprise, un administrateur les active dans les paramètres d’administration de claude.ai. |
| Authentification | Connecté à claude.ai avec /login. Les sessions utilisant une clé API, un jeton de passerelle ou une identifiant de fournisseur cloud ne peuvent pas publier. |
| Fournisseur de modèle | API Anthropic. Non disponible sur Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. |
| Politique organisationnelle | Les clés de chiffrement gérées par le client (CMEK), HIPAA et Zéro rétention de données ne sont pas activées pour l’organisation. |
| Surface | CLI Claude Code, ou l’application de bureau Claude version 1.13576.0 ou ultérieure. Désactivé par défaut dans les contextes Agent SDK, GitHub Action et MCP-server, et lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC est défini. |
Désactiver les artefacts
Pour désactiver les artefacts pour vos propres sessions indépendamment du paramètre de votre organisation, utilisez l’une des options suivantes :| Méthode | Paramètre |
|---|---|
| Fichier de paramètres | "disableArtifact": true |
| Variable d’environnement | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| Règle de permission | Ajouter Artifact à permissions.deny |
Gérer les artefacts pour votre organisation
Les administrateurs sur les plans Team et Enterprise contrôlent les artefacts à partir des paramètres d’administration de claude.ai. Le contenu des artefacts est stocké sur l’infrastructure exploitée par Anthropic et n’est visible que pour les membres authentifiés de l’organisation de publication.Activer ou désactiver les artefacts
Pour activer ou désactiver les artefacts pour l’ensemble de l’organisation, allez à Paramètres > Claude Code > Capacités et utilisez le bouton bascule Artefacts. Sur les plans Enterprise avec contrôle d’accès basé sur les rôles, vous pouvez également limiter les artefacts à des rôles spécifiques : allez à Paramètres > Rôles, modifiez un rôle et définissez la permission Artefacts sous le groupe Claude Code.Définir une politique de rétention
Pour définir la durée pendant laquelle les artefacts sont conservés avant suppression automatique, allez à Paramètres > Contrôles de données et de confidentialité. Vous pouvez définir des périodes de rétention distinctes pour les artefacts qui sont encore privés pour leur auteur et les artefacts qui ont été partagés.Examiner le journal d’audit
La publication, le partage et la suppression d’un artefact apparaissent chacun dans le journal d’audit de votre organisation sous les types d’événementsclaude_artifact_*, la même famille utilisée pour les artefacts créés dans les conversations de claude.ai.
Ajouter le domaine du visualiseur à la liste blanche
Le visualiseur sur claude.ai charge chaque artefact à partir d’une origine*.claudeusercontent.com en bac à sable. Si votre organisation restreint l’accès réseau sortant, ajoutez ce domaine à votre liste blanche à côté de claude.ai. Consultez Exigences d’accès réseau pour la liste complète.
Lister et supprimer les artefacts avec l’API de conformité
L’API de conformité fournit des points de terminaison pour lister les artefacts d’une organisation, récupérer le contenu d’une version spécifique et supprimer un artefact :| Méthode | Point de terminaison |
|---|---|
GET | /v1/compliance/code/artifacts |
GET | /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id} |
DELETE | /v1/compliance/code/artifacts/{artifact_id} |
Ressources connexes
- Parcourez les modèles d’invite et flux de travail qui s’associent aux artefacts
- Transformez une invite d’artefact que vous réutilisez en compétence afin de pouvoir l’invoquer en tant que commande
- Connectez les serveurs MCP afin que Claude puisse extraire les données en direct dans un artefact