Claude Code sem saber programar: como comecei e o que aprendi

Carlos Imlau, AI Product Builder · Formador certificado (CCP) · IA aplicada ao trabalho · 2026-10-17

Dá para usar o Claude Code sem saber programar? Sim. O que precisas de aprender não é a escrever código, é a dirigir a IA: dizer o que queres, verificar o resultado e decidir o que fica. A IA escreve o código; tu decides o produto. Não sou programador e foi assim que reconstruí o Tapinfy, a minha app de marcações, em cerca de um mês.

Comecei como tanta gente: copiava código do ChatGPT, colava no editor e quase sempre corria mal. Hoje trabalho com sete terminais abertos, cada um num projeto diferente, com o Claude a trabalhar em cada um. Neste artigo explico o que mudou.

O que é o Claude Code?

O Claude Code é o agente de programação da Anthropic. Em vez de responder num chat, trabalha dentro da pasta do teu projeto: lê os ficheiros, escreve e altera código, corre comandos e pede a tua autorização antes de mexer no que importa. Podes usá-lo no terminal ou na aplicação para computador.

A diferença para um chat normal é grande. No chat, copias e colas. Com o agente, a IA vê o projeto inteiro e trabalha nele, e tu ficas com o papel de quem pede, verifica e aprova.

Preciso de saber programar para usar o Claude Code?

Não. Mas precisas de três coisas que pouca gente diz:

• Saber o que queres. Um pedido vago dá um resultado vago. "Faz uma página de marcações para uma barbearia, com 3 serviços e horários de terça a sábado" funciona; "faz uma app" não.
• Testar tudo. Abrir no browser, clicar, tentar partir. Quando algo falha, copias o erro e mandas de volta.
• Perder o medo do terminal. Em 2025 fiz a Piscine da 42 Porto e foi aí que o terminal deixou de me assustar. Não é preciso tanto: chegam meia dúzia de comandos.

Como começar com o Claude Code em 5 passos

1. Escolhe um problema pequeno e real. Algo teu, que usarias amanhã. O primeiro projeto não é o produto da tua vida.
2. Cria a pasta do projeto e um documento de contexto. Um ficheiro simples com o que é, para quem é, o que fica de fora e as regras. A IA consulta esse documento em cada etapa.
3. Pede por etapas. Primeiro a estrutura, depois um ecrã, depois o login. Pedir tudo numa mensagem é o caminho mais curto para um projeto que ninguém percebe.
4. Testa cada etapa antes de avançar. Se algo partiu, manda o erro exato. Se ficou feio, diz o que queres em vez de "melhora".
5. Guarda versões e publica. Usa o Git para poderes voltar atrás e publica cedo, nem que seja só para ti.

Que erros cometi no início?

• Copiar código sem contexto. A IA não conhecia o resto do projeto e cada resposta desfazia a anterior.
• Pedir tudo de uma vez. O resultado parecia pronto e não funcionava.
• Não testar. Achava que estava certo porque a IA dizia que estava.
• Não guardar versões. Uma alteração errada e lá se ia um dia de trabalho.

Claude Code ou ChatGPT: qual usar?

Os dois têm lugar. Uso o chat para pensar, escrever e planear, e o agente para mexer nos ficheiros. No meu fluxo atual, o Claude é a IA que mais uso e o Codex entra como revisor de código. Escolhe um agente, aprende bem a trabalhar com ele e só depois compara.

Perguntas frequentes

O Claude Code é pago?

Sim, precisa de um plano pago da Anthropic ou de créditos da API. Os preços mudam com frequência, por isso confirma os valores atuais no site oficial antes de começar.

Quanto tempo demora até conseguir publicar alguma coisa?

Depende do tamanho do que queres fazer. Uma página simples pode ficar no ar no próprio dia. O Tapinfy, que tem contas, agenda e clientes, reconstruí-o de raiz em cerca de um mês.

Preciso de um computador potente?

Não. O trabalho pesado é feito nos servidores da IA. Um computador normal, com internet, resolve.

Onde aprendo o passo a passo completo?

No SaaS Starter deixei o template e o guia que uso para construir com o Claude Code ou o Codex, do primeiro ecrã à publicação. Se preferires acompanhamento, tenho mentoria individual para construíres o teu produto comigo.