Como publicar um site com Claude Code13 min read
Reading Time: 8 minutesSeu site roda em localhost, o cliente pede um link e Claude Code diz que a implementação foi concluída. A etapa que falta é a implantação. Para publicar um site com Claude Code, primeiro estabeleça uma construção local reproduzível, teste a saída real e escolha um host ou fluxo de trabalho de publicação de artefato. Claude Code é um agente de codificação, não uma garantia de que os arquivos locais já estejam disponíveis na web pública.
Se várias pessoas ou agentes precisarem revisar o mesmo site antes do lançamento, leia a rota de conexão documentada de Claude Code para AgentGrid.io. Se sua equipe já possui implantação baseada em Git, mantenha essa rota.
Como publicar um site com Claude Code e AgentGrid.io
1. Conecte Claude Code como agente de codificação
Abra seu espaço de trabalho AgentGrid.io e diga ao Claude Code para executar npx @animaapp/cli@latest login. Recebe um link de verificação e um código curto; você abre o link e aprova seu nome, alcance do espaço de trabalho e recursos. Ler e escrever são suficientes para preparar um rascunho privado; reserve a publicação para uma decisão separada. Esta rota é para o ambiente compatível com terminal do Claude Code. O aplicativo de bate-papo Claude comum usa o conector AgentGrid.io do diretório Claude, portanto, a instalação desse conector não substitui a verificação da própria identidade e acesso do Claude Code.

2. Compartilhe o site funcional como um artefato de aplicativo
Depois que Claude Code tiver produzido o site, peça para ele colocar a origem do projeto e os ativos necessários no espaço de trabalho AgentGrid.io aprovado como um aplicativo e, em seguida, retorne o URL do artefato. Diga explicitamente: “Mantenha isto como um rascunho privado. Não publique ainda.” Abra o link e compare o resultado renderizado com o projeto local, incluindo fontes, imagens, rotas e interações. Mantenha segredos, pastas de dependência e saída de compilação gerada fora da origem transferida. Se Claude Code funcionou antes de se conectar e retornou um link de reivindicação, assuma a propriedade desse fluxo em vez de tratar a visualização não reivindicada como um artefato permanente da equipe.

3. Dê feedback sobre a versão compartilhada
Revise o artefato em desktops e dispositivos móveis e teste sua principal frase de chamariz, navegação, links e comportamento do formulário. Na revisão do AgentGrid.io, anexe comentários aos elementos relevantes para que Claude Code tenha um contexto acionável. Os colegas de equipe devem ter acesso ao espaço de trabalho antes de poderem abrir a URL privada. Cole esse URL exato de volta em Claude Code com as alterações solicitadas e peça para atualizar o mesmo artefato em vez de fazer um segundo rascunho. Inspecione a nova entrada do Histórico e a visualização renderizada; uma alteração nos arquivos locais do Claude Code não prova automaticamente que o artefato foi atualizado.
4. Publique a versão que você realmente revisou
Quando a equipe terminar, use o controle de publicação do AgentGrid.io para criar o site público e abrir sua URL para verificar o resultado. A publicação é diferente de compartilhar um link de artefato no escopo do espaço de trabalho, e qualquer pessoa pode visitar a implantação pública sem fazer login. Se posteriormente você solicitar que Claude Code revise o artefato, verifique o novo rascunho antes de publicar uma atualização; as edições salvas não substituem automaticamente a versão pública. Se o site ativo precisar ser desativado, o Unpublish removerá o acesso público, preservando o artefato e seu histórico de versão para trabalhos futuros.

1. Comece no diretório correto do projeto
Abra Claude Code em um repositório existente ou crie uma nova pasta para um pequeno site. Diga qual estrutura, fontes de conteúdo e restrições se aplicam. Mantenha segredos longe de prompts, arquivos de origem e capturas de tela.
Neste repositório, crie um site responsivo para North Pier Repair, uma oficina de bicicletas. Páginas: Home, Serviços e Livro. Use os tokens de design e logotipo existentes. Não invente preços ou cotações de clientes. Faça com que o botão de reserva aponte para o URL de agendamento aprovado em README.md. Adicione navegação acessível, texto alternativo significativo, um título distinto e meta descrição por página e um estado claro de vazio ou erro para qualquer formulário. Antes de alterar os arquivos, descreva a implementação e os comandos que você executará. Não implante.
Revise o plano proposto de Claude Code, especialmente alterações nas dependências e configuração de compilação. Peça para deixar um README com instruções de configuração, visualização, construção e implantação. Um futuro colega de equipe deverá ser capaz de executar o projeto sem recuperar detalhes do seu histórico de bate-papo.
2. Execute o site e teste a saída construída
Faça com que Claude Code instale dependências usando o gerenciador de pacotes do projeto e execute seus comandos de teste e construção. Inicie o servidor de desenvolvimento e abra você mesmo a visualização. Uma compilação rápida não informa se o texto está correto ou se o menu móvel pode ser usado.
Execute os comandos lint, test e build de produção existentes. Relate falhas com o comando e erros relevantes, corrija apenas os problemas causados pelo funcionamento deste site e, em seguida, mostre-me as instruções de visualização local. Verifique a página de Serviços em larguras estreitas e largas. Não altere as configurações de implantação nem publique nada.
Preste atenção aos caminhos relativos da imagem, ao conteúdo dependente do ambiente, às ações do formulário e às rotas que funcionam no desenvolvimento, mas falham após uma construção estática. Se você estiver coletando dados pessoais, envolva o proprietário da análise de privacidade e segurança antes da implantação.
Que tipo de site você está publicando?
Muitas vezes, um portfólio estático ou uma página de campanha podem ser incorporados em arquivos e hospedados por um serviço de site estático. Um site com rotas de servidor, banco de dados, autenticação ou fluxo de trabalho de pagamento precisa de um ambiente que execute esses serviços e proteja suas credenciais. Peça ao Claude Code para explicar quais partes são executadas no navegador e quais requerem um servidor. O diretório de saída da compilação por si só não informará se um formulário de reserva realmente armazena envios.
Antes de escolher um host, faça com que Claude Code liste o comando de construção do projeto, o caminho de saída, os requisitos de tempo de execução e os serviços externos. Compare essa lista com o host que você já usa. Se o site precisar permanecer em um domínio de empresa, planeje DNS e a propriedade do certificado com quem controla esse domínio. Se o objetivo for apenas uma única página de explicação interativa, um artefato Claude Code pode ser suficiente; não é um substituto para um aplicativo de produção de múltiplas rotas.
3. Implante através de seu caminho de hospedagem normal
O caminho simples é submeter o código revisado a um repositório conectado a um serviço de hospedagem e, em seguida, implantar de acordo com as instruções desse serviço. Peça ao Claude Code para identificar o comando de construção correto, o diretório de saída, as variáveis de ambiente necessárias e se o site precisa de comportamento no lado do servidor. Não conceda acesso total às credenciais de produção. Use uma implantação de visualização ou de teste para aprovação e, em seguida, promova a revisão aprovada usando os controles do seu host.
Artefato Claude Code: Em contas suportadas conectadas a claude.ai, Claude Code pode disponibilizar uma página HTML ou Markdown independente como um artefato. Peça para criar o artefato, inspecionar a URL privada e escolher o público apropriado em Compartilhar. Esta é uma única página interativa sem back-end ou múltiplas rotas, e não substitui um projeto hospedado completo. Anthropic documenta opções de compartilhamento privado, organizacional e público, sujeito aos controles organizacionais aplicáveis. Verifique o link real com o visualizador pretendido, em vez de assumir seu acesso. Se os artefatos não estiverem disponíveis, verifique sua conta, autenticação e política da organização.
Artefato Claude Code versus um site hospedado
Antrópico descreve artefatos Claude Code como páginas interativas independentes em claude.ai. Você pode criar um a partir da saída da sessão, revisar seu URL privado e escolher um público de compartilhamento. É útil para um protótipo clicável, um passo a passo de alteração ou uma demonstração de página única. A Anthropic diz que um artefato não tem backend e não pode servir múltiplas rotas. Um site de marketing com páginas distintas, formulários de produção ou domínio próprio deve passar por um host apropriado.
Se um artefato for a entrega, verifique se é uma simulação ou um aplicativo funcional. Decida se deseja compartilhar uma versão fixa ou mais recente e teste o acesso do destinatário.
4. Opcional: entregue o local de trabalho para AgentGrid.io
Se a equipe quiser um artefato com versão compartilhada em vez de outro ZIP no chat, AgentGrid.io documenta uma conexão Claude Code por meio de sua CLI e aprovação humana. Conceda apenas o espaço de trabalho e os recursos de leitura/gravação necessários para o rascunho; adicione capacidade de publicação apenas para uma tarefa de publicação aprovada separadamente. Aponte Claude Code para o espaço de trabalho exato ou URL do artefato existente e peça para atualizar esse artefato, e não gerar uma nova cópia. Se a conexão não estiver disponível, importe a pasta do projeto ou ZIP manualmente.
Use AgentGrid.io somente após eu aprovar a conexão. Coloque o site atual do North Pier Repair no espaço de trabalho que nomeio como um artefato de aplicativo não publicado. Retorne a URL do artefato e verifique sua visualização. Não publique, convide outros agentes nem altere o repositório de origem. Se o acesso falhar, pare e me diga qual aprovação está faltando.
Revise o artefato renderizado e seu histórico de versão. Se o projeto depender de serviços ou segredos de back-end, verifique se o ambiente do artefato os suporta e nunca exponha credenciais em um pacote de origem pública.
5. Publique e verifique o URL público
Para AgentGrid.io, uma pessoa com permissão de publicação pode publicar o artefato do aplicativo atual e atualizar a implantação pública posteriormente; o guia de publicação distingue um link de compartilhamento de artefato privado de uma URL pública. Para um site hospedado em repositório, use o fluxo de lançamento do host. Em ambos os casos, inspecione o URL ativo enquanto estiver desconectado e no celular e, em seguida, teste a navegação, os formulários, os metadados e o HTTPS. Vincule a revisão implantada ao seu repositório ou artefato para que as alterações sejam rastreáveis.
O próprio Claude Code é um host de site?
Não. Ele pode gerar código, executar verificações e ajudar a operar ferramentas de implantação autorizadas por você. A hospedagem e o acesso público pertencem ao destino da implantação. Uma visualização local não é pública; um artefato de código precisa de suas próprias configurações de compartilhamento, enquanto um projeto hospedado precisa de suas próprias configurações de implantação.
Relacionado: compartilhando código gerado pelo agente, continuando um site Claude Designe trabalhando com artefatos Claude.
Antes de enviar o URL de lançamento
Mantenha uma nota de lançamento com a versão, resultado da compilação, destino e limitações. Abra a página pública sem sua sessão de editor. Verifique sua ação principal, a navegação móvel e se houve vazamento de dados de desenvolvimento. Corrija links ou formulários quebrados no projeto de origem e reimplante através da rota aprovada.
Para AgentGrid, diferencie o link do espaço de trabalho da URL de implementação pública. O guia de publicação observa que as edições posteriores permanecem não publicadas até que a implantação pública seja atualizada. Isso é útil durante a revisão, mas também significa que a visualização atual do espaço de trabalho pode ser diferente da versão voltada para o visitante. Verifique ambos antes de anunciar uma alteração.
Perguntas frequentes
O Claude Code pode publicar sem uma conta de hospedagem?
Ele pode criar um artefato Claude se seu plano e sessão permitirem, mas um site convencional ainda precisa de um destino de implantação e seus controles de acesso. Esclareça se a solicitação é um artefato de página única, uma publicação AgentGrid ou um projeto de repositório hospedado.
Como compartilho uma visualização local do Claude Code?
Localhost não é público. Use uma visualização do host ou um artefato aprovado e teste o acesso do destinatário antes de compartilhar.
Mantenha o código e a decisão de lançamento conectados
Crie Claude Code, revise o site de trabalho e publique uma versão aprovada. Experimente AgentGrid.io se sua próxima transferência precisar de um artefato de site inspecionável, que pessoas e agentes possam continuar juntos.

Figma
Adobe XD
Sketch
Blog


