# 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ê.

> **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](/imagens/0e88ce6e176b5c07d9fe72da3cce14c58ee84261f2a8ed2851fd6c53429284c2.webp)

2. 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](/imagens/331c558e0d5c012bd094cf7cba4905e02eaff1da2dd54fe9113c595158f25cdf.webp)

3. 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)](/imagens/f9ec0fce163a1842661ae91fd510cd39c56bce7b2f32a33f26e34fa95dba37fc.webp)

## 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](/imagens/07f07755130a57f9f955dd8b879ef73d0b35aa2c9e75eeb26c7ad9792535e777.webp)

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](/imagens/d9f1be350661b28daef07a97ba6e56db74a00705fb953f3433c41ab280aed4a5.webp)

## 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é](/imagens/c560b0740b5c549ad6d00bfd94cc5e72b345e2f86cb4f33ad1a750724d173c30.webp)

2. 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.
3. 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.
4. 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

---
Fonte: https://help.staycloud.com/artigos/como-fazer-deploy-pelo-terminal-com-a-cli