Ir para o conteúdo
Ajuda

Como fazer deploy pelo terminal com a CLI

Em Deploy IA › Integrações, clique em gerar setup token e copie o comando npx @staysdev/setup init. Rode no terminal, na pasta do projeto, e publique com staycloud deploy. Se preferir, cole o comando no Claude Code e peça para ele fazer o deploy por você.

4 min de leitura

Atenção: este tutorial mexe na segurança da sua conta. As mudanças descritas aqui são feitas por sua conta e risco. Confira cada passo antes de aplicar.

Para publicar pelo terminal, gere o setup token em Deploy IA › Integrações › gerar setup token, cole o comando npx @staysdev/setup init no terminal e, dentro da pasta do projeto, rode staycloud deploy. Para acompanhar, use staycloud status e staycloud logs. Se não quiser digitar os comandos, entregue o mesmo comando ao Claude Code e peça para ele fazer o deploy.

Antes de começar

  • Você precisa de acesso ao painel em dash.staycloud.com.
  • Tenha o Node.js instalado no computador (o comando npx vem com ele).
  • O setup token vale por 1 hora. Depois de conectado, o CLI renova o acesso com o uso.
  • Trate o comando com o token como uma senha: não compartilhe nem publique. A exceção é o agente de IA que roda no seu próprio computador, como o Claude Code, quando você quer que ele publique por você.

Abrir as instruções do CLI

  1. No menu da esquerda, clique em Deploy IA.Resultado: abre a página Projetos, com o menu do Deploy.

Menu da esquerda com o item Deploy IA destacado

  1. No menu do Deploy, clique em Integrações.Resultado: abre a tela Integrações, com o quadro Cloud Agent · CLI e a lista de tokens ativos.

Menu do Deploy com o item Integrações destacado

  1. No quadro Cloud Agent · CLI, clique em como usar e escolha a aba Terminal.Resultado: abre o painel Publique seu projeto, com os 4 passos do terminal.

Painel Publique seu projeto na aba Terminal, com os passos Gere o token de setup, Conecte o CLI, Publique o projeto (staycloud deploy) e Acompanhe o build (staycloud status e staycloud logs)

Gerar o comando de conexão

  1. Clique em gerar setup token (no painel como usar ou no quadro Cloud Agent · CLI).Resultado: o painel mostra o comando completo, pronto para copiar, no formato npx @staysdev/setup init --token <SEU_TOKEN> --api-url <URL>.

Quadro Cloud Agent · CLI com o botão gerar setup token destacado, o link como usar e a lista de tokens ativos com escopo, último uso e validade

Outro caminho: em Adicionar projeto › Deploy via CLI, clique em Gerar comando. O CLI cria o projeto na primeira execução.

Etapa Conecte o CLI na criação de projeto, com o comando escondido e o botão Gerar comando

Conectar e publicar

  1. Abra o terminal na pasta do projeto, cole o comando gerado e tecle Enter.Resultado: o npx baixa o CLI na hora, sem instalar nada, e conecta o projeto à sua conta.
  2. Publique o projeto: 
    staycloud deploy
    Na primeira publicação de um projeto novo, use: 
    staycloud deploy --new
    Resultado: o CLI envia o projeto e o build começa.
  3. Acompanhe o build: 
    staycloud status
staycloud logs
    Resultado: o terminal mostra o andamento e os logs da publicação.

Ou peça para o Claude fazer o deploy por você

Se não quiser rodar os comandos, o Claude Code (ou outro agente de IA que rode comandos no seu computador) usa o mesmo CLI no seu lugar.

  1. No painel como usar, escolha a aba Claude Code.Resultado: aparecem os 3 passos: gerar o token, conectar o Claude Code ao projeto e pedir o deploy.

Painel Publique seu projeto na aba Claude Code: Gere o token de conexão, Conecte o Claude Code ao seu projeto e Peça o deploy com suas palavras, com o botão gerar setup token no rodapé

  1. Clique em gerar setup token e copie o comando.Resultado: o comando npx @staysdev/setup init --token <SEU_TOKEN> --api-url <URL> fica pronto para colar.
  2. Abra o Claude Code na pasta do projeto, cole o comando e escreva o pedido, por exemplo: 
    conecte com esse comando e faça deploy na StayCloud
    Resultado: o Claude conecta o CLI, publica o projeto, acompanha o build e avisa quando o site estiver no ar. Se algo falhar, ele mostra o motivo.
  3. Depois disso, peça status, logs ou uma nova publicação com as suas palavras (por exemplo, "publique de novo" ou "mostre os logs do último deploy").

O passo a passo completo está em "Como fazer deploy com um agente de IA".

Como saber se deu certo

O staycloud status (ou o aviso do Claude) mostra a publicação concluída, e o projeto aparece em Projetos com a etiqueta no ar. Em Integrações, o token passa a aparecer na lista com o Último uso atualizado.

Se algo der errado

O token expirou

Causa: o setup token vale por 1 hora. Solução: gere um novo em Integrações › gerar setup token e rode o comando de novo (ou entregue o novo comando ao Claude).

O comando npx não é reconhecido

Causa: o Node.js não está instalado ou não está no PATH. Solução: instale o Node.js e abra um terminal novo.

Não quero mais que o CLI ou o Claude publiquem

Solução: em Integrações, remova o token na lista de tokens ativos, pelo ícone de lixeira.

Relacionados

  • Como fazer deploy com um agente de IA
  • Como publicar uma nova versão do projeto no Deploy
  • Como acompanhar os deployments e ler os logs no Deploy
Este artigo ajudou?

Viu algo errado ou desatualizado?