O Claude Code constrói o site; um comando o coloca no ar. Peça "publique isto" e ele roda npx -y lobsite --yes, que encontra a pasta gerada, envia e imprime uma linha feita para o Claude repassar, com o endereço e o link que mantém o site. Sem conta, sem pedido de login, sem arquivo de configuração para escrever antes.
Como funciona
- Peça ao Claude Code para fazer o build e publicar. Ele roda o seu build (
npm run buildou parecido) e depoisnpx -y lobsite --yesna pasta do projeto. - A CLI percebe que está rodando sob o Claude Code (pela variável
CLAUDECODEque o Claude Code define), então nunca faz perguntas e imprime linhas simples, sem cores nem animações. - O Claude repassa a última linha: a URL no ar, quando o site temporário expira e o link de resgate. Você abre o link e entra para manter o site; o endereço continua o mesmo.
Torne isso o jeito de publicar do projeto
Adicione uma linha ao CLAUDE.md do projeto, para que toda sessão publique do mesmo jeito sem precisar avisar:
Deploy with `npx -y lobsite --yes` and relay the "Tell the user:" line from the output.
O primeiro deploy escreve lobsite.toml com o nome e a pasta do site. Faça commit dele: o próximo deploy, de qualquer sessão, atualiza o mesmo site em vez de criar outro.
Um comando /deploy
Um comando de barra personalizado reduz tudo a uma tecla. Salve isto como .claude/commands/deploy.md:
Build the site, then deploy it with `npx -y lobsite --yes`.
If the build or the deploy fails, read the error's fix line and follow it.
When it succeeds, tell me the "Tell the user:" line word for word.
Depois digite /deploy. Para ele rodar sem pedir permissão toda vez, libere o comando em .claude/settings.json:
{ "permissions": { "allow": ["Bash(npx -y lobsite:*)"] } }
Ou o servidor MCP
O servidor MCP dá ao Claude Code ferramentas em vez de um comando de shell: deploy, list_sites, list_deploys, rollback, promote e whoami.
claude mcp add lobsite -- npx -y lobsite@latest mcp
Com ele, "volte o site para o deploy de ontem" também funciona: o Claude lista os deploys e coloca no ar o que você quer. Fazer login e apagar sites não são ferramentas de propósito: um precisa de você num navegador, o outro não pode ser desfeito. Mais na página de MCP.
Nenhuma pergunta quando roda sob um agente, e uma linha Tell the user: com a URL e o link de resgate.
npx lobsite mcp para agentes de código, lobsite.com/api/mcp para assistentes de chat.
Os arquivos são guardados pelo hash. Refazer o deploy de um site sem mudanças envia 0 bytes.
Veja a prévia antes de ir ao ar. Volte atrás com um clique, redirecionamentos inclusos.
Um deploy sem conta fica no ar por 6 horas. O link de resgate o mantém, de graça.
Redirecionamentos, cabeçalhos e formulários ficam no lobsite.toml e acompanham cada deploy.
Publicar a partir do Claude Code: Lobsite e GitHub Pages
| Lobsite | GitHub Pages | |
|---|---|---|
| Antes do primeiro deploy | Nada: o site vive 6 horas até você resgatá-lo | Uma conta no GitHub, um repositório e o Pages ativado |
| O que o Claude roda | Um comando | Commit, push e um workflow do Pages para a etapa de build |
| Perguntas no caminho | Nenhuma sob um agente | O Git pode pedir credenciais |
| Envio | Só os arquivos que mudaram | O build inteiro, toda vez |
| Prévia de um deploy | --preview dá a ele uma URL própria |
Não vem incluído |
| Domínio próprio | Sim, grátis | Sim, grátis |
| Código-fonte privado | Só os arquivos gerados são enviados | Pages a partir de um repositório privado exige um plano pago do GitHub |
Se o projeto já está no GitHub com domínio próprio, o GitHub Pages é uma ótima casa. O Lobsite serve quando você quer um link agora, da sessão em que está.
Perguntas frequentes
O Claude Code precisa de conta para publicar?
Não. Sem conta, o site dura 6 horas, e o Claude entrega o link de resgate que o mantém. Para publicar na sua conta, rode você mesmo npx lobsite login uma vez: ele abre um navegador para entrar, o que um agente não consegue fazer por você.
Qual pasta ele publica?
A primeira que existir entre dist/, build/, out/, _site/ ou public/, ou a pasta que você indicar (npx -y lobsite --yes site/). A escolha fica salva no lobsite.toml.
Ele vai enviar meu arquivo .env?
Não. Arquivos secretos (.env*, chaves privadas, .npmrc e afins) interrompem o deploy com um erro até serem removidos ou listados no .lobsiteignore. Nunca passe --include-secrets a partir de um agente.
O Claude Code pode publicar uma prévia sem mudar o site no ar?
Sim: npx -y lobsite --yes --preview dá ao deploy uma URL própria. Coloque-o no ar depois com npx lobsite promote <id> ou com a ferramenta promote do MCP.
O que o Claude vê quando um deploy falha?
Um erro que diz o que aconteceu, por quê e o que fazer, com um código que nunca muda. Adicione --json para uma saída legível por máquina; veja Erros.