Artefatos estão em beta. Eles exigem um plano Team ou Enterprise e uma sessão conectada com
/login. Consulte Disponibilidade para o conjunto completo de requisitos.
- Decidir quando usar um artefato
- Criar, atualizar e compartilhar um artefato
- Aplicar padrões de prompting para páginas mais ricas
- Aplicar seu próprio sistema de design para que os artefatos correspondam à marca do seu produto
- Entender as restrições de página e requisitos de disponibilidade
- Desabilitar ou gerenciar artefatos para sua organização
Quando usar um artefato
Use um artefato quando o texto do terminal é o meio errado para o que Claude produziu: saída que é mais fácil de visualizar e interagir do que ler linha por linha. Claude constrói a página a partir de qualquer coisa que sua sessão possa alcançar, incluindo sua base de código e dados que ela extrai através de suas ferramentas conectadas, para que a página possa mostrar coisas que levariam parágrafos para descrever. Por exemplo, peça a Claude para:- Guiar um revisor através de uma solicitação de pull com diffs anotados
- Renderizar um painel a partir de dados que a sessão já extraiu
- Dispor várias opções de design ou implementação lado a lado
- Manter uma linha do tempo de investigação que se preenche enquanto uma tarefa longa é executada
- Enviar a um colega de trabalho um link em vez de colar a saída no Slack
O que um artefato não é
Um artefato é uma captura de trabalho, não um aplicativo. É uma página única e autossuficiente sem backend, portanto não pode armazenar entrada de formulário, chamar uma API no momento da visualização ou servir múltiplas rotas. Para uma ferramenta interna hospedada com um backend, implante-a em sua própria infraestrutura. Consulte Restrições de página para o conjunto completo de limites.Criar um artefato
Claude pode publicar um artefato por conta própria quando a saída se adequa a uma página, ou você pode pedir um diretamente. Para pedir, nomeie o recurso ou descreva a saída visual que você deseja em linguagem simples. Um bom candidato é qualquer coisa mais fácil de ver do que ler como texto, como um diff anotado, um gráfico ou um conjunto de opções para comparar. Os prompts abaixo são dois exemplos; consulte O que você pode construir para mais padrões.Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai. Republicar um artefato que você já aprovou não solicita novamente.
Selecione Sim para publicar. Claude imprime a URL e seu navegador abre para a nova página. Pressione Ctrl+] a qualquer momento para reabrir o artefato mais recente do terminal.
Claude escolhe o título do artefato e um emoji para seu ícone de aba do navegador. Ambos aparecem em sua galeria de artefatos em claude.ai e em links compartilhados, portanto peça a Claude para usar um título ou ícone específico se quiser um.
Para impedir que o navegador abra automaticamente quando um novo artefato é publicado, defina CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 em seu ambiente.
Se Claude responder que não pode publicar ou escrever um arquivo HTML local sem um link, a ferramenta não está habilitada para sua sessão. Verifique os requisitos de Disponibilidade.
Atualizar um artefato
Peça a Claude para revisar a página ou deixe uma tarefa de longa duração republicar conforme faz progresso. Claude edita o arquivo subjacente e publica novamente para a mesma URL.Compartilhar um artefato
Um novo artefato é visível apenas para você. Abra-o em seu navegador e use o controle Compartilhar no cabeçalho da página para conceder acesso a pessoas específicas em sua organização ou a todos nela. O cabeçalho o nomeia como o autor do artefato, portanto qualquer pessoa com quem você o compartilhar pode ver quem publicou a página. Também vincula à sua galeria em claude.ai/code/artifacts, que lista todos os artefatos que você criou. O compartilhamento para na sua organização. Os visualizadores devem estar conectados a claude.ai como membros da mesma organização que publicou o artefato, e não há opção de tornar um artefato visível fora dela. Para enviar o conteúdo subjacente a alguém fora de sua organização, peça a Claude o arquivo HTML e compartilhe esse arquivo diretamente. Artefatos são visualizáveis, não co-editados. As pessoas com quem você compartilha veem cada versão que você publica, mas não podem alterar a página; você permanece como o único escritor.O que você pode construir
Um artefato é uma única página HTML, portanto qualquer coisa que você possa expressar em HTML, CSS e JavaScript inline está no escopo. Os padrões abaixo surgem com mais frequência.Percorrer uma mudança
Peça uma página que renderize um diff ou uma mudança de design com anotações ao lado das linhas relevantes, para que os revisores possam ler seu raciocínio ao lado do código em vez de reconstruí-lo a partir de uma descrição.Comparar alternativas
Peça várias variantes em uma página para que você possa avaliá-las uma contra a outra. Isso funciona para layouts, cópia, formas de API ou planos de implementação.Ajustar com controles interativos
Peça sliders, alternâncias ou campos de entrada vinculados ao que você está ajustando, para que você possa explorar valores diretamente em vez de descrevê-los.Trazer o resultado de volta para sua sessão
Um artefato pode atuar como um editor leve para uma decisão que você então devolve a Claude. Peça um controle de exportação que produza texto que você possa colar no terminal, para que o resultado de interagir com a página flua de volta para a sessão em vez de permanecer na página.Rastrear trabalho em progresso
Peça a Claude para manter um artefato atualizado enquanto uma tarefa longa é executada, para que qualquer pessoa com o link possa acompanhar sem ler o terminal.Melhorar o design visual
Claude aplica uma skill de design integrada quando constrói um artefato, portanto as páginas recebem uma paleta deliberada, tipografia e layout sem prompting extra. Essa skill também procura por um sistema de design existente em seu projeto antes de escolher o seu próprio. Para manter os artefatos consistentes com a marca do seu produto, registre seus tokens de design onde Claude possa encontrá-los, como o CLAUDE.md do projeto ou um arquivo de tema em seu repositório:Restrições de página
Cada artefato é uma página única e autossuficiente. Claude Code envolve o arquivo que você publica em um shell de documento HTML e o serve sob uma Política de Segurança de Conteúdo (CSP) rigorosa, que molda o que a página pode fazer.| Restrição | Efeito |
|---|---|
| Sem solicitações externas | O CSP bloqueia scripts, folhas de estilo, fontes e imagens carregadas de qualquer outro host, junto com chamadas fetch, XHR e WebSocket. Claude incorpora CSS e JavaScript e incorpora imagens como URIs de dados para que a página seja renderizada sem nenhuma solicitação externa. |
| Sem backend | Um artefato é uma página estática. Não pode armazenar dados enviados através de um formulário, autenticar visualizadores por si só ou chamar uma API no momento da visualização. |
| Página única | Links relativos não são resolvidos, porque nada é implantado ao lado da página. Para conteúdo de múltiplas seções, Claude usa âncoras na página em vez de arquivos separados. |
| Tipos de arquivo de origem | O arquivo publicado deve ser .html, .htm ou .md. Arquivos Markdown são renderizados como HTML estilizado. |
| Tamanho renderizado | A página renderizada deve ter 16 MiB ou menos. Imagens incorporadas grandes são a causa usual quando uma publicação falha por tamanho. |
- Prefira SVG ou HTML e CSS para diagramas em vez de imagens raster incorporadas
- Omita interatividade que você não precisa
- Faça a página resumir grandes conjuntos de dados em vez de incorporá-los completamente
Disponibilidade
Artefatos exigem todas as condições abaixo. Quando uma não é atendida, Claude escreve um arquivo HTML local ou diz que não pode publicar.| Requisito | Disponível quando |
|---|---|
| Plano | Team ou Enterprise. Em planos Team, artefatos estão ativados por padrão. Em planos Enterprise, um admin os habilita nas configurações de admin do claude.ai. |
| Autenticação | Conectado a claude.ai com /login. Sessões usando uma chave de API, token de gateway ou credencial de provedor de nuvem não podem publicar. |
| Provedor de modelo | API Anthropic. Não disponível em Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. |
| Política da organização | Chaves de criptografia gerenciadas pelo cliente (CMEK), HIPAA e Retenção Zero de Dados não estão habilitadas para a organização. |
| Superfície | CLI do Claude Code ou aplicativo de desktop Claude versão 1.13576.0 ou posterior. Desativado por padrão em contextos Agent SDK, GitHub Action e MCP-server, e quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido. |
Desabilitar artefatos
Para desativar artefatos para suas próprias sessões independentemente da configuração de sua organização, use qualquer um dos:| Método | Configuração |
|---|---|
| Arquivo de configurações | "disableArtifact": true |
| Variável de ambiente | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| Regra de permissão | Adicione Artifact a permissions.deny |
Gerenciar artefatos para sua organização
Admins em planos Team e Enterprise controlam artefatos a partir das configurações de admin do claude.ai. O conteúdo do artefato é armazenado em infraestrutura operada pela Anthropic e é visível apenas para membros autenticados da organização de publicação.Habilitar ou desabilitar artefatos
Para habilitar ou desabilitar artefatos para toda a organização, vá para Settings > Claude Code > Capabilities e use a alternância Artifacts. Em planos Enterprise com controle de acesso baseado em função, você pode escopo adicional de artefatos para funções específicas: vá para Settings > Roles, edite uma função e defina a permissão Artifacts sob o grupo Claude Code.Definir uma política de retenção
Para definir quanto tempo os artefatos são mantidos antes da exclusão automática, vá para Settings > Data & privacy controls. Você pode definir períodos de retenção separados para artefatos que ainda são privados para seu autor e artefatos que foram compartilhados.Revisar o log de auditoria
Publicar, compartilhar e excluir um artefato aparecem cada um no log de auditoria de sua organização sob os tipos de eventoclaude_artifact_*, a mesma família usada para artefatos criados em conversas do claude.ai.
Adicionar o domínio do visualizador à lista de permissões
O visualizador em claude.ai carrega cada artefato de uma origem*.claudeusercontent.com em sandbox. Se sua organização restringe o acesso à rede de saída, adicione esse domínio à sua lista de permissões junto com claude.ai. Consulte Requisitos de acesso à rede para a lista completa.
Listar e excluir artefatos com a API de Conformidade
A API de Conformidade fornece endpoints para listar os artefatos de uma organização, recuperar o conteúdo de uma versão específica e excluir um artefato:| Método | Endpoint |
|---|---|
GET | /v1/compliance/code/artifacts |
GET | /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id} |
DELETE | /v1/compliance/code/artifacts/{artifact_id} |
Recursos relacionados
- Procure padrões de prompting e fluxos de trabalho que se emparelham com artefatos
- Transforme um prompt de artefato que você reutiliza em uma skill para que você possa invocá-lo como um comando
- Conecte servidores MCP para que Claude possa extrair dados ao vivo para um artefato