Descobre o Claude Code e instala-o

Porque é que o Claude Code muda as regras do jogo

A maioria das ferramentas de IA para código limita-se a completar uma linha. Escreves o início de uma função, a ferramenta adivinha o resto. É útil, mas é assistência passiva: toda a inteligência da orquestração — o que fazer, em que ordem, como verificar — fica na tua cabeça. O Claude Code faz outra coisa: é um agente. Lê os teus ficheiros, executa comandos no teu terminal, escreve código, lança testes e raciocina em várias etapas para atingir um objetivo que lhe dás em linguagem natural.

A diferença é fundamental. Um chatbot clássico responde-te com texto que tens de copiar e colar tu mesmo. Um autocomplete propõe-te a linha seguinte. O Claude Code, por sua vez, age: se lhe pedires «corrige o bug no script de publicação», ele vai procurar o ficheiro em causa, ler o código, compreender o erro, propor uma correção, aplicá-la e voltar a executar o script para verificar que funciona. Tu supervisionas. É a passagem do papel de executante para o de diretor.

Para a Lea, isto significa que ela não vai «pedir pedaços de texto» a uma IA. Vai confiar-lhe uma missão completa — «publica este tema nas minhas 4 redes» — e o Claude orquestra tudo: pesquisa, redação, visual, publicação. E como vais descobrir, o que torna esta abordagem realmente poderosa é que ela se capitaliza: cada automatização construída fica disponível para sempre.

O ciclo agêntico: ler, executar, escrever, raciocinar

Por baixo do capô, o Claude Code funciona em ciclo: observa o estado do teu projeto, decide uma ação, executa-a, observa o resultado e depois decide o passo seguinte. Este ciclo continua até o objetivo ser atingido — ou até ele precisar de ti para decidir. É exatamente como delegar a um colaborador: dás a missão e as restrições, ele gere as etapas intermédias.

flowchart LR
  U["Tu: missão em linguagem natural"] --> C["Claude Code"]
  C --> L["Lê os teus ficheiros"]
  C --> X["Executa comandos"]
  C --> W["Escreve código"]
  L --> R["Raciocina e encadeia as etapas"]
  X --> R
  W --> R
  R --> OK["Objetivo atingido"]

Este ciclo tem uma consequência prática importante: a qualidade do que obténs depende da qualidade da missão que dás. «Escreve-me um post» produzirá um resultado medíocre. «Escreve um post LinkedIn de 150 palavras sobre o desperdício zero, tom caloroso, terminado com uma pergunta aberta» produzirá algo utilizável. Todo este curso te ensina a codificar estas precisões de uma vez por todas, em vez de as reescreveres de cada vez.

Instalar o Claude Code

O Claude Code instala-se via npm, o gestor de pacotes do Node.js. Precisas portanto de Node.js 18 ou superior — se não o tiveres, descarrega a versão LTS do site oficial do Node.js, a instalação demora dois minutos. Depois, abre um terminal e executa:

# Verificar que o Node.js está instalado (18+ obrigatório)
node --version

# Instalar o Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Entrar na pasta do teu projeto
cd mon-projet

# Lançar o Claude Code
claude

No primeiro arranque, o Claude Code pede-te para te ligares à tua conta Anthropic. Duas opções: uma subscrição Claude (Pro ou Max), ou uma chave API da consola Anthropic faturada ao consumo. Para começar, a subscrição é mais simples: uma quota mensal previsível, sem surpresas. Uma vez autenticado, estás pronto.

No Windows, o Claude Code funciona nativamente no PowerShell, mas muitos utilizadores preferem lançá-lo no WSL (Windows Subsystem for Linux) ou no Git Bash para beneficiarem de um ambiente de comandos Unix mais padrão. Se um comando shell se comportar de forma estranha, é a primeira pista a verificar.

A tua primeira sessão

Uma vez na sessão, falas com o Claude em linguagem natural, como com um colega. Mas alguns comandos integrados — os que começam por / — merecem ser conhecidos desde o primeiro dia:

• /help — lista todos os comandos disponíveis.
• /init — analisa o teu projeto e gera um primeiro ficheiro CLAUDE.md (a memória de projeto, à qual dedicamos o capítulo 8).
• /clear — apaga a conversa para recomeçares com um contexto limpo.
• /model — mostra e muda o modelo utilizado.
• Esc — interrompe o Claude em plena ação se vires que ele está a ir na direção errada.
• @caminho/ficheiro — referencia um ficheiro específico na tua mensagem para que o Claude o leia.

Tira cinco minutos para brincar: pede-lhe «lista os ficheiros desta pasta e descreve o que compreendes do projeto». Verás a mecânica em direto: ele propõe executar um comando, pede-te permissão, executa-o, lê o resultado e faz-te uma síntese. Este pedido de permissão sistemático pode parecer pesado — é precisamente o tema do capítulo 2.

Extensão VS Code ou terminal?

O Claude Code funciona de duas formas no VS Code: a extensão oficial (interface na barra lateral) ou o terminal integrado (comando claude). Ambos executam exatamente o mesmo motor — a diferença é puramente ergonómica.

Que modelo utilizar?

O Claude Code deixa-te escolher o modelo via /model. A regra simples: usa o modelo mais capaz disponível para quase tudo — raciocínio técnico, criação de skills, integrações de API, depuração. Estas tarefas exigem manter um raciocínio ao longo de muitas etapas, e é exatamente aí que os modelos mais potentes fazem a diferença.

Reserva os modelos mais leves (e mais baratos) para as tarefas simples e repetitivas: reformatar um ficheiro, renomear variáveis, gerar variantes de um texto já validado. Para este curso, mantém o modelo mais potente em tudo — a orquestração e a coordenação de subagents beneficiam diretamente disso. Um erro de raciocínio a meio de uma cadeia de 10 etapas custa muito mais caro em tempo do que a diferença de preço entre dois modelos.

O que vais construir neste curso

Cada capítulo acrescenta um tijolo ao sistema da Lea. Capítulo 2: as configurações que tornam o trabalho fluido. Capítulo 3: um primeiro skill /post que publica numa rede. Capítulo 4: a voz de marca para que os posts soem humanos. Capítulo 5: um hook que bloqueia qualquer publicação não conforme. Capítulo 6: subagents que publicam em 4 redes em paralelo. Capítulo 7: o comando final /plan-week que agenda uma semana inteira. Capítulo 8: a memória de projeto que faz com que tudo sobreviva de uma sessão para a outra.

A ordem não é inocente: é a progressão natural de qualquer automatização séria. Primeiro fazer funcionar uma vez (skill), depois tornar fiável (hook), depois escalar (subagents), depois capitalizar (memória). Poderás repetir exatamente esta sequência em qualquer outro projeto — contabilidade, apoio ao cliente, monitorização da concorrência.