Artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem uma sessão conectada com
/login. Consulte Disponibilidade para o conjunto completo de requisitos.
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
- Publicar um quadro de status que extrai dados atualizados através de conectores MCP cada vez que alguém o abre
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 ou servir múltiplas rotas, e seu único caminho para dados externos quando alguém o visualiza é chamar conectores MCP. 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ê. Para compartilhá-lo, abra o artefato no seu navegador e use o controle Compartilhar no cabeçalho da página. O cabeçalho o identifica como o autor do artefato, portanto qualquer pessoa com quem você o compartilhar pode ver quem publicou a página. Ele também vincula à sua galeria em claude.ai/code/artifacts, que lista todos os artefatos que você criou. Com quem você pode compartilhar depende do seu plano:- Dentro de sua organização: nos planos Team e Enterprise, conceda acesso a pessoas específicas em sua organização ou a todos nela. Os visualizadores fazem login em claude.ai como membros de sua organização para ver a página.
- Publicamente: compartilhe um link que qualquer pessoa na internet possa abrir, sem necessidade de login em claude.ai. Nos planos Pro e Max, um link público é a única maneira de compartilhar um artefato. Nos planos Team e Enterprise, o compartilhamento público está desativado até que um Proprietário o ative para a organização.
Deixar alguém editar com você
As pessoas com quem você compartilha são visualizadores por padrão: elas veem cada versão que você publica, mas não podem alterar a página. Nos planos Team e Enterprise, você também pode tornar alguém um editor. Na caixa de diálogo de compartilhamento, adicione uma pessoa e mude sua função de visualizador para editor. Um editor publica novas versões da mesma forma que você atualiza o artefato de outra sessão: ele fornece a URL do artefato a Claude em sua própria sessão, e Claude extrai o conteúdo atual e republica com suas alterações. Todos com a página aberta veem cada atualização em tempo real.Extrair dados ao vivo com conectores MCP
Um artefato pode chamar conectores MCP cada vez que alguém o visualiza, para que a página mostre dados atuais em vez de um instantâneo da sessão que a construiu. Chamadas de conectores de artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem Claude Code v2.1.209 ou posterior. Em versões anteriores, Claude publica a página com os dados que a sessão coletou durante sua construção. Para criar uma página com suporte de conectores, nomeie o conector e os dados que deseja em seu prompt:.mcp.json, podem fornecer dados enquanto Claude constrói a página, mas a página publicada não pode chamá-los.
A página busca dados quando carrega e pode atualizar em um intervalo ou quando um visualizador usa um controle de atualização na página. As respostas são armazenadas em cache no navegador do visualizador, para que uma página reabierta seja renderizada a partir das respostas em cache imediatamente e depois seja atualizada com resultados frescos.
Como as chamadas de conectores funcionam para visualizadores
Quando uma página publicada chama um conector, a chamada usa a conta da pessoa que está visualizando a página, não a conta da pessoa que a publicou:- Cada visualizador usa seus próprios conectores: as chamadas passam pelas ferramentas conectadas da conta de visualização, para que duas pessoas abrindo o mesmo painel possam ver dados diferentes dependendo do que suas contas podem acessar. A página nunca vê as credenciais de ninguém; claude.ai faz as chamadas em nome da página.
- Visualizadores aprovam o acesso primeiro: claude.ai pede permissão a cada visualizador antes da primeira chamada de conector da página. Um visualizador que recusa, ou que não conectou um conector que a página usa, ainda vê a página sem suas seções ao vivo.
- Ações também usam a conta do visualizador: uma página pode oferecer controles que invocam ferramentas de conectores com efeitos colaterais, como postar uma mensagem ou atualizar um problema. A ação passa pela conta de quem seleciona o controle.
A página não mostra dados ao vivo para um visualizador
Quando uma página com suporte de conectores é renderizada mas suas seções ao vivo permanecem vazias para alguém com quem você a compartilhou, trabalhe através dessas causas:- O visualizador não conectou o conector: conectores são por conta, então cada visualizador precisa de sua própria conexão com cada conector que a página chama. Eles podem adicionar um em Settings > Connectors em claude.ai e depois recarregar a página.
- O visualizador recusou a solicitação de permissão: uma recusa dura pelo resto desse carregamento de página. Recarregar a página traz a solicitação de permissão de volta.
- As chamadas de conectores estão desativadas para a organização: um Proprietário controla o alternador Enable artifact connectors nas configurações de administrador.
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
A partir do Claude Code v2.1.183, 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.
Gerar um artefato usa tokens de saída como qualquer outra resposta, e uma página estilizada é mais intensiva em tokens do que o mesmo conteúdo como texto de terminal. CSS inline, JavaScript para controles interativos e especialmente imagens incorporadas como URIs de dados são os principais contribuintes. Para reduzir o custo de token de um artefato:
- 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.Desabilitar artefatos
Para desativar artefatos para suas próprias sessões independentemente da configuração de sua organização, use qualquer um dos:Gerenciar artefatos para sua organização
Proprietários 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, a menos que o artefato seja compartilhado publicamente.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.Controlar chamadas de conector a partir de artefatos
Chamadas de conector a partir de artefatos têm sua própria alternância, separada da alternância Artifacts que ativa ou desativa artefatos. Vá para Settings > Capabilities e use a alternância Enable artifact connectors. A mesma alternância governa chamadas de conector a partir de artefatos criados em conversas do claude.ai, razão pela qual fica sob Settings > Capabilities em vez de Settings > Claude Code.Controlar compartilhamento público
O compartilhamento público está desativado por padrão em planos Team e Enterprise, portanto os membros podem compartilhar artefatos apenas dentro da organização até que um Proprietário o ative. Para permitir que os membros publiquem artefatos em links públicos que qualquer pessoa possa visualizar sem fazer login, vá para Settings > Claude Code > Capabilities e ative External sharing sob a alternância Artifacts. Desativá-lo novamente bloqueia o acesso através de links públicos existentes sem alterar o público de cada artefato; o acesso é retomado se você reativá-lo.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:
Para os esquemas de solicitação e resposta, consulte a referência da API de Conformidade.
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 para um artefato enquanto ele constrói a página