A quase toda a gente acontece o mesmo com o Claude Code: ouve dizer que é "para programadores", vê um terminal preto cheio de texto e fecha o separador. E perde a ferramenta que mais tempo lhe pouparia, porque a verdade incómoda é que não é preciso programar para lhe tirar partido.
Este guia leva-te do zero à tua primeira sessão útil: a partir da app, sem comandos estranhos e sem medo de estragar nada. Quando terminares, o Claude Code será mais uma ferramenta do teu dia a dia, e não um mistério de informáticos.
Nota
O Claude Code é um assistente que trabalha dentro dos teus ficheiros, e não numa janela de chat à parte. Por isso é que consegue organizar uma pasta, editar um documento ou montar um site: tem as mãos onde está o trabalho, e não só a conversa.
O que é o Claude Code (e o que não precisas para o usar)
Pensa na diferença entre um consultor ao telefone e um consultor sentado ao teu lado. O chat normal é o do telefone: explicas-lhe, ele explica-te, e tu executas. O Claude Code é o que está sentado ao teu lado, com acesso aos teus ficheiros: não só te diz o que fazer, fá-lo contigo e mostra-te o resultado.
O que NÃO precisas para começar: saber programar, conhecer comandos de terminal, nem ter um projeto técnico. O que AJUDA mesmo ter instalado é o Git e o Node (dois programas gratuitos), porque são a base sobre a qual ele corre. Mais nada.
Começa pela app, não pelo terminal
É aqui que a maioria se engana. Existe a versão de terminal —potente, mas intimidante— e existe a app de ambiente de trabalho, com a mesma potência mas com interface visual. Começa sempre pela app.
O arranque é de minutos:
- Instala a app de ambiente de trabalho do Claude Code.
- Garante que tens o Git e o Node (se não tiveres, a própria app guia-te).
- Abre uma pasta. Qualquer uma: os teus documentos, uma pasta de trabalho, o site em que andas a mexer.
E pronto. A partir daí falas com ele em linguagem natural, como com uma pessoa.
A tua primeira tarefa: pequena e reversível
A tentação de novato é pedir-lhe algo enorme logo no primeiro dia. Não o faças. A forma de ganhar confiança é começar com tarefas pequenas e reversíveis: coisas que, se correrem mal, não há problema.
Dica
Boas primeiras tarefas: "resume estes três documentos numa nota", "faz-me uma lista de todos os ficheiros desta pasta por data", "cria um rascunho de email a partir destas notas". Nada destrutivo, tudo fácil de verificar.
Quando quiseres que organize ficheiros, experimenta algo assim de concreto:
Vê os ficheiros desta pasta e diz-me o que há (sem mexer em nada por agora).
Depois propõe uma forma de os organizar: por tipo e por data, com nomes claros e consistentes.
Antes de renomear ou mover SEJA O QUE FOR, mostra-me o plano e espera pelo meu OK.Repara no padrão: primeiro ver, depois propor, e só atuar com a tua aprovação. Essa ordem é o que torna o Claude Code numa ferramenta de confiança.
O visor de alterações: a tua rede de segurança
Esta é a parte que tira o medo. O Claude Code nunca modifica nada às escondidas: cada alteração que propõe aparece num visor onde vês exatamente o que vai mexer —que linha, que ficheiro, o que se apaga e o que se acrescenta— e tu decides se a aplicas ou não.
Significa que o controlo é teu a todo o momento. Podes deixá-lo fazer coisas ambiciosas precisamente porque há sempre um ponto de revisão antes de algo se tornar definitivo. Rever antes de aprovar não é burocracia: é o que te permite arriscar.
CLAUDE.md: o ficheiro que separa os que voam
Se ficares apenas com um truque deste guia, que seja este. O CLAUDE.md é um ficheiro de texto que pões na tua pasta com o contexto permanente: o que é o projeto, como trabalhas, que regras queres que respeite. O Claude lê-o ao começar cada sessão, por isso deixas de te repetir.
# Sobre este espaço
Pasta de [trabalho / marca / projeto]. Uso-a para [objetivo].
## Como quero que trabalhes
- Fala comigo em português, direto e sem rodeios.
- Antes de alterações grandes, mostra-me o plano e espera pelo meu OK.
- Tarefas pequenas e reversíveis por omissão.
## Coisas em que NÃO deves mexer
- [pastas ou ficheiros sensíveis]A diferença entre um utilizador que luta com a ferramenta e um que a aproveita é quase sempre esta: o segundo escreveu quatro linhas de contexto uma vez e poupou-as para sempre.
Quando dar o salto para o terminal
Não há pressa. Quando a app te ficar pequena —porque queres lançar várias sessões em paralelo, automatizar tarefas repetidas ou trabalhar a partir do telemóvel— é aí que o terminal e as funções avançadas (memória, sessões em paralelo, subagentes) começam a fazer sentido.
A regra para escalar é a mesma que para começar: aos poucos. App primeiro, terminal depois, e agentes em paralelo só quando o anterior já te sair de forma natural. E acima de tudo, uma sessão, um objetivo: sempre que misturas temas na mesma conversa, tiras-lhe precisão.
Começa hoje com uma tarefa pequena. A curva do Claude Code não é técnica, é de confiança: assim que vês a primeira alteração bem feita e aprovada por ti, o medo desaparece e só fica o tempo que ganhas.