Minhas Finanças · Guia de instalação · Não Codei
guia do vídeo · app minhas finanças

O seu app de finanças mensais, instalado pelo GitHub

Este é o mesmo app que eu uso pra organizar as minhas contas do mês. O código está aberto no meu GitHub, e quem instala não é você: é o Claude Code. Você só cria três contas grátis, cola uma mensagem e aprova o que ele pedir. No final, tem um site só seu, que abre no computador e no celular, com os dados guardados num banco que só você acessa.

pra quem nunca programou 20 a 30 minutos 100% grátis funciona com claude code ou codex
você faz  clique, conta ou cópia que só você pode fazer claude faz  parte técnica, você só aprova

00 O que você vai ter no final

Um painel pra acompanhar o mês inteiro: quanto entrou, quanto saiu, onde o dinheiro foi e se você está melhorando de um mês pro outro.

Visão geral do mês
Receitas, despesas, saldo e resultado, um calendário de saídas por dia e os gastos separados por categoria.
Lançamentos
Entradas, custos fixos e variáveis, cada um com status de pago ou pendente e dia de vencimento.
Cartão de crédito
Marque qualquer gasto como cartão e veja a fatura do mês. Compras parceladas viram uma parcela em cada mês.
Orçamento por categoria
Defina um limite por categoria e o app mostra se ela está tranquila, em atenção ou se estourou.
Mês automático
Todo dia 1º o mês novo aparece sozinho, já com os custos fixos, o orçamento e a meta do mês anterior.
Evolução mês a mês
O gráfico mostra se você está gastando menos e guardando mais, e você pode anotar o que aconteceu em cada mês.
App no celular
Abra o endereço no navegador do celular e adicione à tela de início. Ele passa a funcionar como um aplicativo.
Bot do Telegram
Mande "mercado 45,90" pro seu bot e o gasto é registrado na hora, sem abrir o app.
fase 1Preparar
01
Crie as 3 contas grátisvocê faz

Só criar a conta já basta, não precisa configurar nada dentro delas agora. Deixe as três abertas no navegador, porque o Claude vai pedir informações delas durante a instalação.

Claude
O assistente que instala tudo pra você.
claude.com ↗
Neon
O banco de dados onde ficam os seus lançamentos. Dá pra entrar com o Google.
neon.tech ↗
Vercel
O serviço que deixa o seu app no ar. Dá pra entrar com o Google.
vercel.com ↗
02
Instale o Claude Codevocê faz

É o programa que faz todo o trabalho técnico. A instalação é a de sempre: avançar, avançar, concluir.

  1. Acesse claude.com/claude-code
  2. Baixe a versão do seu computador (Windows ou Mac) e instale
  3. Abra o aplicativo e entre com a sua conta Claude
i
Primeira vez com o Claude Code? Tem um guia completo de instalação aqui: como instalar o Claude Code do zero.
03
Instale o Node.jsvocê faz

O Node.js é o motor que roda as ferramentas do projeto. Também é só instalar, sem mudar nenhuma opção.

  1. Acesse nodejs.org
  2. Baixe a versão LTS (o botão principal da página)
  3. Instale sem mudar nada
i
Esqueceu este passo? Sem problema. O Claude percebe na hora que o Node.js não está instalado e te orienta.
fase 2Instalar
04
Crie uma pasta e abra no Claude Codevocê faz

O Claude Code sempre trabalha dentro de uma pasta, que é o espaço de trabalho dele. Crie uma vazia só pra este app.

  1. Crie uma pasta vazia, por exemplo MinhasFinancas dentro de Documentos
  2. No Claude Code, abra essa pasta como pasta de trabalho
05
Cole esta mensagem na conversaclaude faz

É essa mensagem que começa toda a instalação. Ela manda o Claude baixar o código do meu GitHub e seguir o roteiro que eu deixei pronto lá dentro, no arquivo CLAUDE.md.

cole no claude code
Quero instalar o sistema Minhas Finanças deste repositório: https://github.com/junoorb36-bot/minhas-financas

Baixe o código para esta pasta (se o git não estiver disponível, use o ZIP do GitHub), leia o arquivo CLAUDE.md (ou AGENTS.md) e siga o roteiro de instalação de lá.

Sou leigo em programação: me guie passo a passo em linguagem simples, dizendo exatamente onde clicar. Já criei minhas contas na Neon e na Vercel.
!
De vez em quando o Claude vai pedir permissão pra executar um comando. Pode aprovar: é assim que ele faz a parte técnica por você.
06
Responda os 2 pedidos do Claudevocê faz

No meio da instalação, o Claude vai parar duas vezes e pedir algo que depende da sua conta pessoal. Quando ele pedir, faça assim:

pedido 1 · neon
O endereço do banco
  1. Entre em neon.tech e crie um projeto com qualquer nome
  2. Clique em Connect
  3. Copie o texto que começa com postgresql:// e cole na conversa
pedido 2 · vercel
Autorizar a publicação
  1. O Claude mostra um link do tipo vercel.com/oauth/device?user_code=...
  2. Abra o link, entre na sua conta Vercel e confirme o código
  3. Volte e avise o Claude que autorizou
!
Esse endereço do banco é pessoal. Cole só na conversa do Claude Code, nunca em grupo, comentário ou print público. Quem tiver ele consegue mexer nos seus dados.
fase 3Usar
07
Entre com o seu loginvocê faz

No final, o Claude te entrega um endereço parecido com https://seu-app.vercel.app. Abra e invente um login difícil de adivinhar, por exemplo maria.gastos.2026x. Na primeira vez, a conta é criada automaticamente.

!
O login funciona como senha. O acesso é feito só por ele, sem senha separada. Quem souber o seu login e o endereço do seu app vê os seus dados. Escolha algo complicado, guarde num lugar seguro e não compartilhe o endereço.
08
Coloque o app no celularvocê faz

Abra o mesmo endereço no navegador do celular e toque em Adicionar à tela de início (no iPhone fica no botão de compartilhar). O ícone aparece junto dos seus outros apps.

09
Bot do Telegram (opcional)claude faz

Pra registrar gastos sem abrir o app, diga na conversa: "quero o bot do Telegram também". O Claude te guia pra criar o bot com o @BotFather e configura o resto. Depois disso, é só mandar mensagem:

Você mandaO que acontece
mercado 45,90 alimentaçãoRegistra direto na categoria
comida 45,90O bot pergunta a categoria com botões
uber 23,50 lazer cartãoRegistra como gasto no cartão de crédito
+2000 freelaRegistra uma entrada
Deu tudo certo se:

? Se algo der errado

A regra é uma só: conte pro Claude, na própria conversa, o que apareceu na tela. Pode colar a mensagem de erro ou mandar um print. Diagnosticar e corrigir é exatamente o papel dele nesta instalação.

Ele está pedindo permissão toda hora. É normal?

É. Cada comando que o Claude roda no seu computador passa por você antes. Durante a instalação, pode aprovar: ele está baixando o código, instalando as dependências e publicando o app.

Apareceu um erro dizendo que o git não existe

A mensagem já prevê isso: se o git não estiver instalado, o Claude baixa o código pelo ZIP do GitHub. Se ele travar mesmo assim, responda "use o ZIP do GitHub".

O app publicou, mas a página dá erro

Copie a mensagem de erro (ou tire um print) e cole na conversa. No Windows, um problema comum é a configuração do banco chegar corrompida na Vercel. O roteiro do repositório já ensina o Claude a evitar isso, mas se acontecer ele sabe corrigir.

Fechei a conversa no meio da instalação

Abra a mesma pasta no Claude Code e diga: "Eu estava instalando o Minhas Finanças nesta pasta e a conversa fechou. Veja o que já foi feito e continue a instalação." Ele olha os arquivos e retoma de onde parou.

Uso o Codex em vez do Claude. Funciona?

Funciona. Abra a pasta no Codex no passo 4 e cole a mesma mensagem do passo 5. O repositório tem um arquivo AGENTS.md, que o Codex lê sozinho, com o mesmo roteiro de instalação.

Quanto isso vai me custar por mês?

Nada. O Neon e a Vercel têm planos gratuitos que sobram pra uso pessoal, e o código é aberto. O único requisito é ter uma conta no Claude pra fazer a instalação.

i
Ainda travado? Abra uma conversa na aba Issues do repositório contando o que aconteceu.
O código no GitHub
O repositório aberto do Minhas Finanças, com o roteiro de instalação e o README completo.
Ver no GitHub
Canal no YouTube
Tutoriais de IA pra quem não programa.
Ver o canal
Instagram
Bastidores, dicas rápidas e novidades do canal.
Seguir