Gli artifact sono disponibili sui piani Pro, Max, Team ed Enterprise e richiedono una sessione autenticata con
/login. Vedi Disponibilità per l’insieme completo dei requisiti.
When to use an artifact
Usa un artifact quando il testo del terminale è il mezzo sbagliato per quello che Claude ha prodotto: output che è più facile da guardare e con cui interagire rispetto a leggere riga per riga. Claude costruisce la pagina da qualsiasi cosa la tua sessione possa raggiungere, inclusa la tua codebase e i dati che estrae attraverso i tuoi strumenti connessi, quindi la pagina può mostrare cose che richiederebbero paragrafi per descrivere. Ad esempio, chiedi a Claude di:- Guidare un revisore attraverso una pull request con diff annotati
- Renderizzare una dashboard dai dati che la sessione ha già estratto
- Disporre diverse opzioni di design o implementazione affiancate
- Mantenere una timeline di investigazione che si riempie mentre un’attività lunga viene eseguita
- Inviare a un collega un link invece di incollare l’output in Slack
- Pubblicare una bacheca di stato che estrae dati freschi attraverso i connettori MCP ogni volta che qualcuno la apre
What an artifact is not
Un artifact è una cattura del lavoro, non un’applicazione. È una singola pagina autonoma senza backend, quindi non può archiviare l’input del modulo o servire più route, e il suo unico percorso verso i dati esterni quando qualcuno la visualizza è chiamare i connettori MCP. Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi Vincoli della pagina per l’insieme completo dei limiti.Create an artifact
Claude può pubblicare un artifact da solo quando l’output si adatta a una pagina, oppure puoi chiederne uno direttamente. Per chiedere, nomina la funzione o descrivi l’output visivo che desideri in linguaggio semplice. Un buon candidato è qualsiasi cosa più facile da vedere che da leggere come testo, come un diff annotato, un grafico o un insieme di opzioni da confrontare. I prompt di seguito sono due esempi; vedi Cosa puoi costruire per altri pattern.Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai. Ripubblicare un artifact che hai già approvato non richiede di nuovo il prompt.
Seleziona Yes per pubblicare. Claude stampa l’URL e il tuo browser si apre sulla nuova pagina. Premi Ctrl+] in qualsiasi momento per riaprire l’artifact più recente dal terminale.
Claude sceglie il titolo dell’artifact e un emoji per l’icona della scheda del browser. Entrambi appaiono nella tua galleria di artifact su claude.ai e nei link condivisi, quindi chiedi a Claude di usare un titolo o un’icona specifica se ne vuoi uno.
Per impedire al browser di aprirsi automaticamente quando viene pubblicato un nuovo artifact, imposta CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 nel tuo ambiente.
Se Claude risponde che non può pubblicare, o scrive un file HTML locale senza un link, lo strumento non è abilitato per la tua sessione. Controlla i requisiti di Disponibilità.
Update an artifact
Chiedi a Claude di revisionare la pagina, o lascia che un’attività di lunga durata ripubblichi mentre fa progressi. Claude modifica il file sottostante e pubblica di nuovo allo stesso URL.Condividere un artefatto
Un nuovo artefatto è visibile solo a voi. Per condividerlo, aprite l’artefatto nel vostro browser e utilizzate il controllo Share nell’intestazione della pagina. L’intestazione vi nomina come autore dell’artefatto, quindi chiunque lo condividiate può vedere chi ha pubblicato la pagina. Inoltre, si collega alla vostra galleria su claude.ai/code/artifacts, che elenca ogni artefatto che avete creato. Chi potete condividere dipende dal vostro piano:- All’interno della vostra organizzazione: nei piani Team e Enterprise, concedete l’accesso a persone specifiche nella vostra organizzazione, oppure a tutti. I visualizzatori accedono a claude.ai come membri della vostra organizzazione per vedere la pagina.
- Pubblicamente: condividete un link che chiunque su internet può aprire, senza richiedere l’accesso a claude.ai. Nei piani Pro e Max, un link pubblico è l’unico modo per condividere un artefatto. Nei piani Team e Enterprise, la condivisione pubblica è disattivata finché un Owner non la abilita per l’organizzazione.
Consentire a qualcuno di modificare insieme a voi
Le persone con cui condividete sono visualizzatori per impostazione predefinita: vedono ogni versione che pubblicate ma non possono modificare la pagina. Nei piani Team e Enterprise, potete anche rendere qualcuno un editor. Nella finestra di dialogo di condivisione, aggiungete una persona e cambiate il suo ruolo da viewer a editor. Un editor pubblica nuove versioni nello stesso modo in cui voi aggiornate l’artefatto da un’altra sessione: forniscono a Claude l’URL dell’artefatto nella loro sessione, e Claude estrae il contenuto attuale e ripubblica con le loro modifiche. Tutti coloro che hanno la pagina aperta vedono ogni aggiornamento in tempo reale.Estrarre dati live con i connettori MCP
Un artifact può chiamare i connettori MCP ogni volta che qualcuno lo visualizza, in modo che la pagina mostri dati attuali anziché uno snapshot della sessione che l’ha creato. Le chiamate ai connettori dagli artifact sono disponibili nei piani Pro, Max, Team ed Enterprise e richiedono Claude Code v2.1.209 o versioni successive. Nelle versioni precedenti, Claude pubblica la pagina con i dati che la sessione ha raccolto durante la creazione. Per creare una pagina supportata da un connettore, nominate il connettore e i dati desiderati nel vostro prompt:.mcp.json, possono fornire dati mentre Claude crea la pagina, ma la pagina pubblicata non può chiamarli.
La pagina recupera i dati quando si carica e può aggiornarsi a intervalli regolari o quando un visualizzatore utilizza un controllo di aggiornamento sulla pagina. Le risposte vengono memorizzate nella cache del browser del visualizzatore, quindi una pagina riaperta viene renderizzata dalle risposte memorizzate immediatamente, quindi si aggiorna con risultati freschi.
Come funzionano le chiamate ai connettori per i visualizzatori
Quando una pagina pubblicata chiama un connettore, la chiamata utilizza l’account della persona che visualizza la pagina, non l’account della persona che l’ha pubblicata:- Ogni visualizzatore utilizza i propri connettori: le chiamate passano attraverso gli strumenti connessi dell’account che visualizza, quindi due persone che aprono lo stesso dashboard possono vedere dati diversi a seconda di ciò a cui i loro account possono accedere. La pagina non vede mai le credenziali di nessuno; claude.ai effettua le chiamate per conto della pagina.
- I visualizzatori approvano l’accesso per primo: claude.ai chiede a ogni visualizzatore il permesso prima della prima chiamata al connettore della pagina. Un visualizzatore che rifiuta, o che non ha connesso un connettore che la pagina utilizza, vede comunque la pagina senza le sue sezioni live.
- Le azioni utilizzano anche l’account del visualizzatore: una pagina può offrire controlli che invocano strumenti connettore con effetti collaterali, come pubblicare un messaggio o aggiornare un problema. L’azione viene eseguita attraverso l’account di chiunque selezioni il controllo.
La pagina non mostra dati live per un visualizzatore
Quando una pagina supportata da un connettore viene renderizzata ma le sue sezioni live rimangono vuote per qualcuno con cui l’avete condivisa, esaminate queste cause:- Il visualizzatore non ha connesso il connettore: i connettori sono per account, quindi ogni visualizzatore ha bisogno della propria connessione a ogni connettore che la pagina chiama. Possono aggiungerne uno in Impostazioni > Connettori su claude.ai, quindi ricaricare la pagina.
- Il visualizzatore ha rifiutato la richiesta di permesso: un rifiuto dura per il resto di quel caricamento della pagina. Ricaricare la pagina riporta la richiesta di permesso.
- Le chiamate ai connettori sono disattivate per l’organizzazione: un Proprietario controlla l’interruttore Abilita connettori artifact nelle impostazioni di amministrazione.
What you can build
Un artifact è una singola pagina HTML, quindi qualsiasi cosa tu possa esprimere in HTML, CSS e JavaScript inline è nell’ambito. I pattern di seguito si presentano più spesso.Walk through a change
Chiedi una pagina che renderizzi un diff o un cambiamento di design con annotazioni accanto alle righe rilevanti, in modo che i revisori possano leggere il tuo ragionamento accanto al codice invece di ricostruirlo da una descrizione.Compare alternatives
Chiedi diverse varianti su una pagina in modo da poter valutarle l’una contro l’altra. Questo funziona per layout, copy, forme API o piani di implementazione.Tune with interactive controls
Chiedi slider, interruttori o campi di input associati a quello che stai regolando, in modo da poter esplorare i valori direttamente invece di descriverli.Bring the result back to your session
Un artifact può agire come un editor leggero per una decisione che poi restituisci a Claude. Chiedi un controllo di esportazione che produca testo che puoi incollare nel terminale, in modo che il risultato dell’interazione con la pagina fluisca di nuovo nella sessione invece di rimanere sulla pagina.Track work in progress
Chiedi a Claude di mantenere un artifact aggiornato mentre un’attività lunga viene eseguita, in modo che chiunque abbia il link possa seguire senza leggere il terminale.Migliora la progettazione visiva
A partire da Claude Code v2.1.183, Claude applica una skill di design integrata quando costruisce un artifact, quindi le pagine ottengono una tavolozza deliberata, tipografia e layout senza prompt extra. Quella skill cerca anche un sistema di design esistente nel tuo progetto prima di scegliere il suo. Per mantenere gli artifact coerenti con il branding del tuo prodotto, registra i tuoi token di design dove Claude può trovarli, come il CLAUDE.md del progetto o un file di tema nel tuo repository:Vincoli della pagina
Ogni artifact è una singola pagina autonoma. Claude Code avvolge il file che pubblichi in una shell di documento HTML e lo serve secondo una rigorosa Content Security Policy (CSP), che modella quello che la pagina può fare.
Generare un artifact utilizza token di output come qualsiasi altra risposta, e una pagina stilizzata è più intensiva di token rispetto allo stesso contenuto come testo di terminale. CSS inline, JavaScript per controlli interattivi e soprattutto immagini incorporate come data URI sono i principali contributori. Per ridurre il costo dei token di un artifact:
- Preferisci SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate
- Ometti l’interattività che non ti serve
- Fai in modo che la pagina riassuma grandi set di dati piuttosto che incorporarli completamente
Availability
Gli artifact richiedono ogni condizione di seguito. Quando una non è soddisfatta, Claude scrive un file HTML locale o dice che non può pubblicare.Disable artifacts
Per disattivare gli artifact per le tue sessioni indipendentemente dall’impostazione della tua organizzazione, usa uno qualsiasi di:Manage artifacts for your organization
I proprietari sui piani Team e Enterprise controllano gli artifact dalle impostazioni admin di claude.ai. Il contenuto dell’artifact è archiviato su infrastruttura gestita da Anthropic ed è visibile solo ai membri autenticati dell’organizzazione che pubblica, a meno che l’artifact non sia condiviso pubblicamente.Enable or disable artifacts
Per abilitare o disabilitare gli artifact per l’intera organizzazione, vai a Settings > Claude Code > Capabilities e usa l’interruttore Artifacts. Sui piani Enterprise con controllo dell’accesso basato su ruoli, puoi inoltre limitare gli artifact a ruoli specifici: vai a Settings > Roles, modifica un ruolo e imposta l’autorizzazione Artifacts nel gruppo Claude Code.Control connector calls from artifacts
Le chiamate ai connettori dagli artifact hanno il loro interruttore dedicato, separato dall’interruttore Artifacts che attiva o disattiva gli artifact. Vai a Settings > Capabilities e usa l’interruttore Enable artifact connectors. Lo stesso interruttore governa le chiamate ai connettori dagli artifact creati nelle conversazioni di claude.ai, motivo per cui si trova sotto Settings > Capabilities piuttosto che sotto Settings > Claude Code.Control public sharing
La condivisione pubblica è disattivata per impostazione predefinita sui piani Team e Enterprise, quindi i membri possono condividere gli artifact solo all’interno dell’organizzazione finché un proprietario non la attiva. Per consentire ai membri di pubblicare artifact su link pubblici che chiunque può visualizzare senza accedere, vai a Settings > Claude Code > Capabilities e attiva External sharing sotto l’interruttore Artifacts. Disattivarla di nuovo blocca l’accesso tramite link pubblici esistenti senza modificare il pubblico di ogni artifact; l’accesso riprende se lo riabiliti.Set a retention policy
Per impostare quanto tempo gli artifact vengono conservati prima dell’eliminazione automatica, vai a Settings > Data & privacy controls. Puoi impostare periodi di conservazione separati per gli artifact che sono ancora privati al loro autore e gli artifact che sono stati condivisi.Review the audit log
La pubblicazione, la condivisione e l’eliminazione di un artifact appaiono ciascuna nel registro di audit della tua organizzazione sotto i tipi di eventoclaude_artifact_*, la stessa famiglia utilizzata per gli artifact creati nelle conversazioni di claude.ai.
Allowlist the viewer domain
Il visualizzatore su claude.ai carica ogni artifact da un’origine sandbox*.claudeusercontent.com. Se la tua organizzazione limita l’accesso alla rete in uscita, aggiungi quel dominio alla tua allowlist insieme a claude.ai. Vedi Requisiti di accesso alla rete per l’elenco completo.
List and delete artifacts with the Compliance API
La Compliance API fornisce endpoint per elencare gli artifact di un’organizzazione, recuperare il contenuto di una versione specifica e eliminare un artifact:
Per gli schemi di richiesta e risposta, vedi il riferimento della Compliance API.
Risorse correlate
- Sfoglia pattern di prompting e workflow che si abbinano agli artifact
- Trasforma un prompt di artifact che riutilizzi in una skill in modo da poterlo invocare come comando
- Connetti server MCP in modo che Claude possa estrarre dati in un artifact mentre lo crea