Fazer deploy de um app criado com Claude Code

Última atualização em 4 de junho de 2026

Você criou algo no Claude Code e agora quer colocar online. Este guia mostra o caminho completo: como subir seu projeto no GitHub e fazer o deploy pela plataforma Hostman.

No meio do caminho, você vai configurar o MCP — um protocolo que permite ao Claude Code interagir com sua conta do GitHub direto pela janela de chat. Com ele, dá pra criar repositórios e subir código sem precisar abrir o terminal nem digitar um comando git sequer.

Não precisa de experiência prévia com GitHub ou deploy. Só seguir os passos na ordem.

Antes de começar
Copiar link

Você vai precisar de:

  • Um projeto pronto no Claude Code e preparado para ir ao ar.
  • Uma conta no GitHub. Se ainda não tiver, a gente cria uma no Passo 1.
  • Uma conta no Hostman. Crie em hostman.com se ainda não tiver.

Passo 1. Criar uma conta no GitHub
Copiar link

O GitHub é onde o código do seu projeto vai ficar. Você precisa de uma conta lá para que o Hostman consiga acessar e fazer o deploy do seu app.

Já tem conta? Pode pular direto para o Passo 2.

  1. Acesse github.com e clique em Sign up.
  2. Cadastre-se com sua conta Google, Apple ID, ou com e-mail e senha.

Depois de criar a conta e entrar, você vai ver o painel principal do GitHub.

0902d2f9 709a 41df B496 De8fb6ff0a11.png

Passo 2. Verificar e instalar o Claude Code CLI
Copiar link

Para configurar o MCP, você precisa da versão de linha de comando do Claude Code. Isso é diferente do app Claude para desktop ou do Cowork — mesmo que esses estejam instalados, o CLI pode não estar.

Abra o terminal (ou o PowerShell no Windows) e rode:

claude --version

Se aparecer um número de versão, tá ótimo.

Se der erro de comando não encontrado, instale:

macOS

curl -fsSL https://claude.ai/install.sh | bash

Windows

irm https://claude.ai/install.ps1 | iex

No Windows, o instalador pode exibir uma mensagem dizendo que o diretório de instalação não está no PATH. Se isso acontecer, adicione manualmente com o comando abaixo:

setx PATH "$($env:PATH);C:\Users\$env:USERNAME\.local\bin"

Feche o terminal, abra de novo e rode claude --version. Se aparecer a versão, está tudo certo.

Passo 3. Gerar um token de acesso pessoal no GitHub
Copiar link

O token de acesso pessoal é o que vai permitir ao Claude Code agir no GitHub em seu nome — criar repositórios, subir código, tudo direto pelo chat.

  1. No GitHub, clique no seu avatar no canto superior direito e vá em Settings.
  2. No menu lateral, role até o fim e clique em Developer settings. Depois vá em Personal access tokens → Tokens (classic).
  3. Clique em Generate new token → Generate new token (classic). Se pedir sua senha, confirme.

Personal Access Tokens Classic 05 20 2026 10 50 Am 06 04 2026 05 00 Pm

  1. No campo Note, dê um nome para o token — por exemplo, claude-code-acesso. Assim você sabe do que se trata depois.
  2. Em Expiration, escolha o prazo de validade. Se não quiser repetir esse processo, selecione No expiration.
  3. Em Select scopes, marque as permissões necessárias: repo (para criar, editar e subir repositórios) e admin:org (só se você for trabalhar com repositórios de organizações).
  4. Clique em Generate token.

Passo 4. Configurar o servidor GitHub MCP
Copiar link

Aqui é onde a mágica acontece: você conecta o GitHub ao Claude Code via MCP, para poder criar repositórios e subir código direto pelo chat.

Vamos usar o servidor GitHub MCP local — sem precisar de GitHub Copilot, Docker ou Node.js. É só um binário que você baixa uma vez.

macOS
Copiar link

Abra o terminal e crie uma pasta para o servidor:

dir="$HOME/.local/github-mcp-server"mkdir -p "$dir"

Baixe e descompacte o binário. O comando abaixo detecta automaticamente a arquitetura do seu Mac (Apple Silicon ou Intel):

case "$(uname -m)" in
 arm64) archive="github-mcp-server_Darwin_arm64.tar.gz" ;;
 x86_64) archive="github-mcp-server_Darwin_x86_64.tar.gz" ;;
 *) echo "Unsupported architecture: $(uname -m)" && exit 1 ;;
esac
​
url="https://github.com/github/github-mcp-server/releases/latest/download/$archive"
tarball="$dir/gh-mcp.tar.gz"
​
curl -L "$url" -o "$tarball"
tar -xzf "$tarball" -C "$dir"
rm "$tarball"
chmod +x "$dir/github-mcp-server"

Confirme que o servidor funciona:

"$dir/github-mcp-server" --version

Você vai ver um número de versão. Agora registre o servidor no Claude Code — substitua SEU_TOKEN pelo token gerado no passo anterior:

claude mcp add github -s user \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=SEU_TOKEN \
  -- /Users/SEU_USUARIO/.local/github-mcp-server/github-mcp-server stdio

Windows
Copiar link

Abra o PowerShell e crie uma pasta para o servidor:

$dir = "$env:USERPROFILE\.local\github-mcp-server"
New-Item -ItemType Directory -Force -Path $dir | Out-Null

Baixe e descompacte o binário:

$url = "https://github.com/github/github-mcp-server/releases/latest/download/github-mcp-server_Windows_x86_64.zip"
$zip = Join-Path $dir "gh-mcp.zip"

Invoke-WebRequest -Uri $url -OutFile $zip -UseBasicParsing
Expand-Archive -Path $zip -DestinationPath $dir -Force
Remove-Item $zip

Confirme que o servidor funciona:

"$dir\github-mcp-server.exe" --version

Agora registre o servidor no Claude Code — substitua SEU_TOKEN pelo seu token:

claude mcp add github -s user `
  --env GITHUB_PERSONAL_ACCESS_TOKEN=SEU_TOKEN `
  -- "$dir\github-mcp-server.exe" stdio

Verificar a conexão
Copiar link

Rode o seguinte para confirmar que o servidor está conectado:

claude mcp get github

Procure por "Status: ✓ Connected" na saída.

Em seguida, reinicie o Claude Code na pasta do seu projeto e teste o MCP no chat com a pergunta: Quais ferramentas GitHub MCP você tem disponíveis? Liste todas.

Se o Claude Code retornar uma lista de ferramentas, a integração está funcionando. Se algo parecer errado, peça ao Claude Code para verificar a configuração do MCP e explicar o problema.

Image2

Passo 5. Subir seu projeto para o GitHub
Copiar link

Com o MCP configurado, você consegue criar um repositório e subir seu código sem sair do Claude Code.

  1. Abra o chat do seu projeto e peça ao Claude Code: Crie um repositório público no GitHub chamado hostman-test-app.
  2. O Claude Code vai pedir confirmação antes de agir — confirme. Em seguida, o repositório vai aparecer na sua conta do GitHub.
  3. Depois, suba seu projeto: Suba o projeto do diretório atual para esse repositório usando o GitHub MCP.

Se os arquivos do seu projeto não estiverem na pasta raiz, especifique o diretório na mensagem.

Confirme a ação quando solicitado e, depois, abra o repositório no GitHub para verificar se os arquivos chegaram lá.

Passo 6. Fazer o deploy no Hostman App Platform
Copiar link

Agora é a hora de colocar seu app no ar.

  1. No painel do Hostman, vá em Plataforma de apps → Criar.

  2. Escolha o tipo do seu app: Frontend, Backend ou Docker. Depois selecione o framework que o projeto usa.

  1. Na etapa Repositório, clique no ícone do GitHub, faça login e autorize o acesso. Selecione o repositório na lista.

  2. Mantenha a opção Compilação pelo último commit executado ativada. Assim, o Hostman vai fazer o redeploy automaticamente toda vez que você enviar novas alterações.

  3. Escolha a região de deploy.

  4. Configure as opções do app. O que é necessário aqui depende do tipo de projeto. Em caso de dúvida, pergunte ao Claude Code. Como referência, veja a documentação do Hostman: Frontend · Backend · Dockerfile · Docker Compose..

  5. Clique em Pedido e aguarde o deploy terminar.

Seu app está no ar!
Copiar link

Quando o deploy concluir, vá até o Painel de Controle e procure a URL pública do seu app no campo Domínio. Se quiser usar um domínio próprio, acesse Configurações.

Com tudo configurado, publicar atualizações fica bem simples:

  1. Faça as alterações no seu projeto dentro do Claude Code.
  2. Peça ao Claude Code: Commite as alterações e suba para o GitHub usando o MCP.
  3. O Hostman detecta o novo commit e faz o redeploy automaticamente.

Todo o fluxo de trabalho roda pelo chat. Sem comandos git manuais, sem etapas extras.