Instale o seu controle financeiro do zero · Não Codei
não codei · minhas finanças · guia de instalação
ver no github →
instalação para iniciantes · com o claude code

Instale o seu controle financeiro do zero

Esse guia é pra quem nunca programou. Você não vai usar terminal nem digitar comandos: o aplicativo Claude Code faz a parte técnica, e você só clica onde ele indicar e copia/cola algumas informações. No final, você tem o seu próprio site de controle financeiro, funcionando no computador e no celular, gratuito, com os dados guardados num banco só seu.

pra quem nunca programou 20 a 30 minutos 100% grátis

00Antes de começar: 3 contas grátis

Crie (ou confirme que já tem) estas 3 contas. Todas são gratuitas. Deixe as três abertas numa aba do navegador, porque o Claude vai pedir informações delas durante a instalação.

i
Não precisa configurar nada nelas agora. Só criar a conta já basta. O Claude te guia no que fazer dentro da Neon e da Vercel na hora certa.

passo 01Instale o aplicativo Claude Code

É o programa que faz todo o trabalho técnico. A instalação é "avançar, avançar, concluir".

O que fazer

  1. Acesse claude.com/claude-code
  2. Baixe a versão para o seu computador (Windows ou Mac) e instale
  3. Abra o aplicativo e entre com a sua conta Claude

passo 02Instale o Node.js

O Node.js é o "motor" que roda as ferramentas do projeto. Também é só instalar sem mudar nada.

O que fazer

  1. Acesse nodejs.org
  2. Baixe a versão LTS (o botão verde principal)
  3. Instale sem mudar nada ("avançar, avançar, concluir")
i
Se esquecer este passo, sem problema: o Claude percebe e te orienta na hora.

passo 03Crie uma pasta e abra no Claude Code

O Claude Code sempre trabalha dentro de uma pasta, que é o "espaço de trabalho" dele. Vamos criar uma vazia só pra este projeto.

O que fazer

  1. Crie uma pasta vazia no seu computador (por exemplo MinhasFinancas, dentro de Documentos)
  2. No aplicativo Claude Code, abra/selecione essa pasta como pasta de trabalho

passo 04Cole esta mensagem no Claude

Copie o texto abaixo inteiro e cole na conversa do Claude Code. É esse pedido que dá o pontapé em toda a instalação.

cole isso na conversa do claude copiar tudo ↓

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

!
O Claude vai trabalhar e, de vez em quando, pedir sua permissão para executar um comando. Pode aprovar: é assim que ele faz a parte técnica por você.

passo 05O que o Claude vai te pedir

Durante a instalação, o Claude precisa de 2 coisas que só você pode fazer. Quando ele pedir, siga o passo a passo abaixo.

pedido 01

A "connection string" do banco (Neon)

  • Entre em neon.tech e crie um projeto (qualquer nome)
  • Clique no botão Connect e copie o texto que começa com postgresql://
  • Cole na conversa quando o Claude pedir
pedido 02

Autorizar a Vercel

  • O Claude vai mostrar um link do tipo vercel.com/oauth/device?user_code=...
  • Abra o link, entre na sua conta Vercel e confirme o código
  • Volte e avise o Claude que autorizou
i
Opcional: se quiser registrar gastos pelo Telegram, diga ao Claude "quero o bot do Telegram também". Ele te guia para criar o bot com o @BotFather e configura o resto.

passo 06Pronto! Como usar

No final, o Claude te entrega um endereço tipo https://seu-app.vercel.app. A partir daí é só usar.

O que fazer

  1. Abra o endereço e digite um login (invente algo difícil de adivinhar, por exemplo maria.gastos.2026x). Esse login é a sua chave de acesso, guarde como uma senha.
  2. No celular: abra o mesmo endereço no navegador e toque em "Adicionar à tela de início". Ele vira um aplicativo.
!
Importante: o acesso é feito só pelo login, sem senha. Quem souber o seu login e o seu endereço vê os seus dados. Escolha um login complicado e não compartilhe o endereço do seu app.

Deu tudo certo se:

passo 07Se algo der errado

Nada de pânico. O Claude foi feito exatamente pra isso: diagnosticar e corrigir junto com você.

Diga ao Claude, na própria conversa, o que apareceu na tela. Pode colar a mensagem de erro ou mandar um print. Ele diagnostica e corrige, esse é exatamente o papel dele nesta instalação.

i
Dúvidas e problemas também podem ser abertos na aba Issues do repositório no GitHub.
quando o app estiver no ar

Agora é seu. Cuide dos seus gastos.

Você acabou de colocar no ar um sistema de verdade, do seu jeito, sem escrever uma linha de código. É esse o espírito: usar o Claude pra construir o que você precisa, no seu ritmo.

quero aprender mais →