Uma página em vez do terminal

O que é e porque importa

Trabalhas uma hora com o Claude Code e o resultado está no terminal: linhas de texto, tabelas feitas de traços, um diff com três ecrãs. Para ti serve. Mas o teu sócio, o teu cliente ou quem te revê o código não o lê, e acabas a colar pedaços num chat, dez mensagens seguidas.

Os artifacts resolvem isto. Um artifact é uma página web a sério que o Claude Code publica a partir da tua sessão no claude.ai, num endereço privado. Lá dentro está o trabalho da sessão: uma comparação de opções, um gráfico, um diff com notas, uma checklist que se vai marcando enquanto o Claude trabalha. Abres no browser, e quando o Claude a volta a publicar atualiza-se ali mesmo, também para quem a tem aberta.

Usa-o quando uma coisa se percebe melhor a olhar para ela do que a lê-la linha a linha. E sabe o que não é: é uma página só, estática, sem servidor por trás. Não pode ter várias páginas ligadas, não pode fazer as pessoas entrar com uma conta, não guarda dados. Não é o teu site. Para uma ferramenta interna com backend (a parte que corre num servidor e guarda os dados) tens de a pôr online nos teus próprios servidores.

1. O que precisas

Os artifacts só funcionam se todas estas condições se verificarem. Se faltar uma, o Claude escreve-te um ficheiro HTML no computador ou diz-te que não consegue publicar.

• Uma subscrição do Claude: Pro, Max, Team ou Enterprise. Em Team e Enterprise estão ligados por defeito, mas um Owner (quem gere a organização) pode desligá-los para todos.
• Entrar com a tua conta claude.ai: no Claude Code escreve /login. Uma sessão que usa uma chave API, o token de um gateway ou as credenciais de um fornecedor cloud não consegue publicar.
• O Claude através da API da Anthropic. Os artifacts não existem se usas o Claude a partir do Amazon Bedrock, do Google Cloud ou do Microsoft Foundry.
• Nenhuma regra especial sobre dados na tua organização: se estiverem ativas as chaves de cifragem geridas pelo cliente (CMEK), HIPAA ou Zero Data Retention (nenhum dado guardado), não há artifacts.
• O Claude Code no terminal ou na app de desktop do Claude, na versão mais recente. Estão desligados por defeito quando lanças o Claude Code com -p a partir dos teus scripts e no Agent SDK.

2. Como a pedir

Não precisas de um comando. Pedes com palavras normais: dizes «artifact» ou «página» e descreves o que queres ver. Às vezes o Claude publica uma sozinho, quando percebe que o resultado se lê melhor como página. Aqui tens os quatro prompts que mais uso, para copiar. Troca as partes entre [ ] pelas tuas.

Faz-me um artifact com três versões diferentes de [o ecrã de boas-vindas], lado a lado. Faz com que sejam mesmo diferentes entre si e por baixo de cada uma escreve numa linha o que ganho e o que perco.

Transforma este plano num artifact com uma checklist. Enquanto trabalhas, marca os pontos que terminas, acrescenta uma nota nos que saltas e volta a publicar no mesmo link.

Faz-me um artifact que explique esta pull request: mostra o diff com notas à margem junto às linhas que importam e pinta os problemas por gravidade.

Faz-me um dashboard artifact com os dados que já reuniste nesta sessão: [os erros da última semana], divididos por [serviço]. Mantém-no atualizado enquanto investigas.

O Claude escreve a página num ficheiro HTML ou Markdown, numa pasta temporária fora do teu projeto, publica-a, mostra-te o link e abre-ta no browser. O título e o ícone do separador escolhe-os ele: se quiseres outros, pede-lhos. No início só tu a vês.

3. Como a voltar a encontrar

• Ctrl+] volta a abrir a qualquer momento o último artifact da sessão.
• Por baixo do prompt aparece uma pequena etiqueta com o nome da página, ou com quantas são se a sessão tiver mais de uma.
• /artifacts lista as tuas páginas e as que partilharam contigo, com as desta sessão no topo. Escolhes uma e carregas em o para a abrir no browser, c para copiar o link, Enter para a ligar à sessão em que estás (se já estiver ligada, abre-a).

A lista vem da tua conta claude.ai, por isso funciona também numa sessão nova ou depois de /clear, quando o link já desapareceu do terminal. Todas as páginas que criaste estão também na tua galeria, em claude.ai/code/artifacts.

4. Como a partilhar

Uma página nova é privada: só tu a vês. Para a mostrar, abre-a no browser e usa o botão Share no topo da página. Com quem a podes partilhar depende do plano:

• Com Pro e Max, os planos pessoais, crias um link público: qualquer pessoa o abre, mesmo sem conta claude.ai.
• Com Team e Enterprise dás-la a pessoas concretas da tua organização ou à organização inteira. Quem a abre entra no claude.ai com a conta da organização.
• Em Team e Enterprise o link público está desligado até um Owner ligar External sharing em Organization settings > Artifacts. Se depois o voltar a desligar, os links públicos já enviados deixam de abrir.

Cada publicação fica guardada como versão. No mesmo botão Share escolhes que versão os outros veem: uma concreta, ou sempre a mais recente. Assim o Claude pode continuar a trabalhar na página sem mostrar os passos a meio.

5. Como a manter atualizada

Para a mudar basta pedir: o Claude altera o ficheiro e volta a publicar no mesmo endereço. Quem tem a página aberta vê a atualização ali mesmo, e não tens de mandar um link novo.

Acrescenta por baixo do gráfico [o detalhe por país] e volta a publicar.

Numa sessão nova é diferente. Se disseres só «atualiza a página», o Claude cria outra. Dá-lhe o link, ou liga-a a partir de /artifacts:

Atualiza [o link do artifact] com os números de hoje.

Se a partilhares na tua organização, quem a vê pode deixar comentários na página, e tu podes pedir ao Claude que os leia e faça as alterações. Quem a pode editar também pode mandar um direto ao Claude, com Send to Claude ou escrevendo @claude. Quem só tem o link público não vê os comentários.

E se quiseres que os números se atualizem sozinhos sempre que alguém abre a página, sem o Claude a voltar a publicar, a página pode chamar os conectores da tua conta claude.ai, por exemplo o GitHub. É um passo a mais: explico-o no guia DASHBOARD (strikt.fit/dashboard-live).

Os erros mais comuns

• Mandar o link antes de partilhar a página. Uma página nova é privada: se não passares pelo Share e escolheres quem a vê, os outros não a conseguem abrir.
• Tratá-la como o teu site. É uma página só e estática: sem login, sem formulários que guardem dados, sem links para outras páginas (os links relativos não funcionam). Para isso precisas de um site a sério.
• Pedir «atualiza a página» numa sessão nova sem dar o link. O Claude cria outra, e ficas com duas páginas diferentes a circular.
• Pôr num link público dados que não queres a circular. O link público abre-o qualquer pessoa que o tenha: deixa de fora chaves, dados de clientes e números internos, ou partilha só dentro da tua organização.
• Enchê-la de imagens pesadas. A página tem de ficar abaixo dos 16 MiB e as imagens embutidas gastam muitos tokens: para gráficos e esquemas pede SVG ou HTML.

Checklist

• Tenho um plano Pro, Max, Team ou Enterprise e entrei com /login, não com uma chave API
• Pedi a página descrevendo o que quero ver, e o Claude deu-me um link
• Com Ctrl+] ou /artifacts volto a encontrar a página mesmo quando o link já desapareceu do terminal
• Antes de mandar o link usei o Share e escolhi quem vê a página
• Escolhi que versão da página os outros veem
• No link público não há chaves, dados de clientes nem números internos
• Para a atualizar numa sessão nova dou ao Claude o link da página

Perguntas frequentes