Na aula sobre os primeiros passos no Claude Code, mostrei o arranque num computador que ainda precisava de preparação. A instalação e as permissões consumiram tempo que podia ter sido usado no projeto. O que retiro desse episódio é simples: verifica o ambiente antes da sessão e chega com uma tarefa pequena e bem definida.
Subscrição e requisitos antes de começar
Confirma o método de acesso e de instalação na documentação oficial do Claude Code. Existem subscrições elegíveis e outras formas de acesso, como a Claude Console. O instalador nativo recomendado dispensa Node.js para executar o Claude Code; o teu projeto pode precisar de dependências próprias.
Na gravação falei da minha experiência com diferentes limites de utilização. Essa comparação pertence ao contexto da aula. Ao escolheres o acesso, confirma as condições aplicáveis e acompanha o consumo do teu próprio trabalho, porque uma sessão curta de revisão e uma construção mais extensa podem exigir recursos diferentes.
Se a instalação falhar, guarda a mensagem de erro e consulta as instruções para o teu sistema operativo. Evita tentar resolver um erro de permissões dando acesso de administrador a tudo. Primeiro percebe que componente falhou e que permissão é realmente necessária para continuar.
Isolar a pasta do projeto
Nunca abras o Claude Code na pasta geral do teu utilizador. Cria uma pasta nova e dedicada só para aquele projeto, e só depois abre o terminal dentro dela. Na aula mostrei este passo em direto: criei uma pasta chamada "cloud test" e só depois de o terminal perguntar se eu confiava naquela pasta específica é que avancei.
Uma pasta dedicada mantém os ficheiros do projeto organizados, mas não é, por si só, uma barreira de segurança. As ações possíveis dependem das permissões, das ferramentas ligadas e da configuração do ambiente. Revê esses acessos e mantém fora do projeto os documentos e credenciais que não são necessários à tarefa.
Como testar uma automação antes de a entregar à equipa
Como dar contexto à IA sem despejar informação sem critério
Como planear uma aplicação com Claude Code antes de começar a programar
O risco de chaves de API expostas
Se ligares APIs de anúncios, e-mail ou bases de dados ao teu projeto e essas chaves ficarem escritas diretamente no código, quem vir esse código publicado tem acesso direto a esses recursos. Falei na aula sobre casos que vi circular de contas de anúncios esvaziadas depois de alguém publicar um projeto com chaves de API visíveis no código fonte.
O mínimo que se pode fazer é pedir ao próprio Claude Code para rever o projeto à procura de falhas de segurança e confirmar que nenhuma chave ficou exposta no código publicado no GitHub. Isto é o mínimo, não é suficiente por si só: se o projeto envolve dados que deveriam ser privados, vale a pena envolver alguém com conhecimento de programação antes de tornar isso público.
Testar em local host antes de publicar
Durante o desenvolvimento, usa um ambiente local e confirma como o servidor está exposto. Um serviço limitado ao endereço de loopback, como 127.0.0.1, é diferente de um serviço acessível na rede ou através de um túnel. Antes de partilhar um endereço, verifica os acessos e os dados apresentados.
Na aula deixei isso bem claro: construí uma landing page inteira durante a sessão e mantive-a sempre em local host, sem nunca a publicar no GitHub ou no Vercel, precisamente porque estava em direto e não queria arriscar expor as minhas próprias chaves. Plataformas como o Vercel e o Netlify tornam a publicação tão simples que às vezes se esquece a parte da segurança: uma vez online, é aí que crawlers automáticos varrem a internet à procura de subdomínios com falhas.
Usar o modo de planeamento para pedidos mais complexos
Quando fazes um pedido vago ao Claude Code, ele pode alterar partes do teu projeto sem pedir confirmação prévia. Ativar o modo de planeamento obriga a ferramenta a apresentar primeiro tudo o que tenciona fazer. Este passo dá-te espaço para reveres e rejeitares sugestões antes da aplicação de quaisquer mudanças no código.
Um participante da aula deu um exemplo concreto disto: fez um pedido e o Claude Code interpretou aquilo como uma alteração e mudou a página sem confirmar antes. Isto acontece quando o pedido é demasiado aberto, e nessas situações vale a pena ligar o plan mode, algo como: "quero agora estar em modo plano, não executar, planeia e só depois me pedes para editar". Isto dá-te espaço para rejeitar sugestões antes de qualquer alteração ser feita.
O que construir na primeira sessão
Um primeiro projeto simples, como uma landing page ou um formulário, chega para entenderes a dinâmica de pedir, rever e aprovar antes de arriscares algo complexo. Na aula, construí uma página básica com ajustes graduais e acompanhei o consumo de quota. Serve perfeitamente para ganhares prática com o fluxo de trabalho.
Na aula construí ao vivo uma landing page para a própria sessão, com um pedido inicial simples: recolher nome, e-mail e telefone, usando as cores e o tipo de letra de um site já existente como referência. Depois fui pedindo ajustes incrementais: destacar o formulário, transformar as perguntas num formulário multistep, e até uma barra de progresso que sobe mais rápido no início para dar sensação de avanço. Cada pedido consumiu uma percentagem visível da quota de uso, que fui acompanhando ao longo da sessão. Isto é apenas um exemplo do tipo de exercício que se pode fazer numa primeira sessão, não uma receita fixa a seguir à letra.
Um pedido que podes levar para a primeira sessão
Imagina que queres organizar os pedidos comerciais da tua empresa. Antes de pedir código, escreve de onde chegam esses pedidos, quem os lê, que informação costuma faltar e o que acontece a seguir. Junta um exemplo fictício com os campos de que precisas, sem nomes, contactos ou dados de clientes reais. Já tens matéria concreta para discutir a estrutura da aplicação.
Depois, explica o que queres conseguir verificar no fim da primeira sessão. Pode ser apenas abrir uma página, registar um pedido de teste e perceber em que estado ficou. Esse objetivo pequeno permite avaliar se o agente compreendeu o processo antes de lhe pedires integrações com outros sistemas.
Por fim, indica o que ainda precisa de uma decisão tua. Se não escolheste onde guardar os dados ou quem vai ter acesso, deixa isso escrito. Pede ao agente que identifique essas decisões no plano e explique as consequências das opções. Assim, consegues rever a proposta com base no teu negócio e confirmar o passo seguinte com conhecimento do que vai ser construído.
Nota da fonte
Esta reflexão nasce da live número 141 das Sextas Ímpares, onde expliquei do zero, num computador sem nada instalado, os primeiros passos no Claude Code.
Podes ver a aula completa aqui: Os primeiros passos no Claude Code | Sextas Ímpares #141. Vale a pena ver os minutos [00:33:00] a [01:24:00], sobre os riscos de segurança e chaves de API expostas, e a partir de [02:17:00], onde construo a landing page passo a passo.
Referência técnica complementar: instalação e requisitos do Claude Code.