guias
Ferramentas IA

Deploy com Claude Code

Como usar o Claude Code para criar e deployar apps na Veloz.

O Claude Code é um agente de programação que roda no terminal. Ele cria, edita e deploya apps — tudo via conversa.

O fluxo

Claude Code (terminal) → cria o projeto → veloz deploy → app no ar

1. Instalar

npm install -g @anthropic-ai/claude-code

2. Criar o app

Inicie o Claude Code na pasta onde quer criar o projeto:

mkdir meu-app && cd meu-app
claude

Descreva o que quer:

Crie um app Next.js com:
- Landing page com hero, features e pricing
- API route para receber emails de waitlist
- Salvar emails no Supabase
- Design moderno com Tailwind, tema escuro
- Tudo em português

O Claude Code cria todos os arquivos, instala dependências e configura o projeto.

3. Deploy

Ainda dentro do Claude Code, peça para deployar:

Instale a CLI da Veloz e faça deploy deste projeto.

O Claude Code executa:

npm install -g onveloz
veloz login
veloz deploy --yes

Ou saia do Claude Code e faça manualmente:

veloz deploy

4. Configurar

Peça ao Claude Code para configurar tudo:

Configure as variáveis de ambiente na Veloz:
- SUPABASE_URL: https://xxxx.supabase.co
- SUPABASE_KEY: eyJ...
E adicione o domínio meuapp.com.br

O Claude Code executa:

veloz env set SUPABASE_URL=https://xxxx.supabase.co
veloz env set SUPABASE_KEY=eyJ...
veloz domains add meuapp.com.br

Por que Claude Code + Veloz?

O Claude Code é o único agente que pode:

  • Ler e entender todo o seu codebase
  • Executar comandos no terminal (incluindo veloz deploy)
  • Corrigir erros automaticamente (lê logs, edita código, re-deploya)
  • Iterar até o app funcionar em produção

O loop autônomo

Você: "Adiciona uma página de blog com MDX"

Claude Code:
  1. Cria os arquivos
  2. Instala dependências
  3. Testa localmente
  4. veloz deploy
  5. Verifica se está no ar
  6. "Pronto! Blog live em https://meuapp.onveloz.com/blog"

Corrigindo erros de deploy

Se o deploy falhar, o Claude Code pode diagnosticar sozinho:

O deploy falhou. Verifique os logs com `veloz logs --build` e corrija.

O Claude Code:

  1. Roda veloz logs --build
  2. Lê o erro
  3. Edita o código
  4. Roda veloz deploy novamente

Projeto complexo: Full-stack

Crie um SaaS de gerenciamento de projetos:
- Frontend: Next.js + Tailwind + shadcn/ui
- Backend: API routes com Prisma
- Auth: NextAuth com GitHub e Google
- Banco: PostgreSQL (Neon)
- Deploy tudo na Veloz

O Claude Code cria o projeto inteiro e deploya — em uma conversa.

Integração com Git

O Claude Code também pode configurar o repositório:

Inicialize um repo git, crie o repo no GitHub e configure
deploy automático na Veloz.

git init
git add .
git commit -m "initial commit"
gh repo create meu-app --push --source=.
# + conectar GitHub App da Veloz

Próximos passos