Anthropic · ficheiro CLAUDE.md

Claude Code ✦

A colega que entende o projeto inteiro e trabalha por passos.

O Claude Code é o que usamos para construir tudo isto. Trabalha em ciclo — junta contexto, age, verifica — e vê o teu projeto inteiro, não só um ficheiro. É o mais autónomo para tarefas de ponta-a-ponta: arquitetura, refactor grande, várias horas de trabalho seguido.

como trabalhar bem

As práticas que importam

Escreve um CLAUDE.md

Um ficheiro na raiz com as regras do projeto: como se faz o build, as convenções, as decisões, o que nunca fazer. Carrega em TODA a sessão — a IA nunca esquece a 'constituição' do projeto.

Dá contexto específico

'Arranja o bug' não chega. 'O checkout falha com cartões expirados, em src/payments — escreve um teste que falhe e corrige' — isso encontra a raiz.

Pede um plano antes de codar

Para tarefas maiores, pede o plano primeiro, aprova, e só depois ela edita. Poupa horas de arrependimento.

Passos pequenos + testar

Divide em etapas e pede para correr os testes a cada passo. Megatarefas acumulam erros; passos pequenos acertam muito mais.

Guarda a memória no fim

Pede um handoff e guarda os padrões no CLAUDE.md. A próxima sessão começa fresca, sem repetir nada.

o que vale conhecer

Os mecanismos reais

CLAUDE.md

O ficheiro de instruções persistentes, que tu escreves e commitas. A lei do projeto.

Memória automática

Notas que o Claude Code guarda sozinho entre sessões (comandos, preferências descobertas).

Slash commands

Comandos como /plan, /clear, /context, /resume — controlam a sessão (planear, limpar, retomar).

Skills

Receitas reutilizáveis que invocas pelo nome — só carregam quando as usas.

Subagentes

IAs paralelas que fazem trabalho pesado em separado e voltam com um resumo.

MCP

Ligações a serviços externos (uma base de dados, o Drive, etc.) — dá-lhe poderes para lá do projeto.

Onde brilha

Refactor grande e arquitetura
Várias horas de trabalho seguido
Vários ficheiros ao mesmo tempo
Disciplina de projeto com memória

Onde ter cuidado

Em tarefas enormes o contexto enche — divide em sessões
Usa /clear quando o histórico fica ruidoso
Pede sempre verificação contra testes/critérios reais

o teu primeiro pedido

Como arrancar com Claude Code

Um molde para o teu primeiro pedido. Adapta os [campos] e cola no terminal.

Lê o CLAUDE.md primeiro. Vou criar [a ideia]. Stack: [ou 'propõe']. O que NÃO fazer: [restrições/segredos]. Antes de editares, faz-me as perguntas que faltam e propõe um plano + a primeira tarefa pequena. Só depois mexes nos ficheiros.

É o que usamos na Cosmic — esta escola foi construída assim, sessão a sessão.

Documentação oficial ↗Voltar a Criar com a IA