Módulo 0 — A cabine 🟢

Objectivo: montar o ambiente único de trabalho e fazer o primeiro “olá” dentro do VSCode. O momento aha: perceber que tudo — escrever, correr, versionar, pedir ajuda à IA — acontece num só ecrã. Resultado: ambiente pronto + primeiro commit local feito a partir do terminal integrado.

1. VSCode — a bancada

O editor onde vives. Instala e conhece três zonas:

Explorer (Ctrl+Shift+E) — os ficheiros do projecto.
Terminal integrado (Ctrl+ç ou Ctrl+') — a linha de comando dentro do editor.
Paleta de comandos (Ctrl+Shift+P) — faz quase tudo escrevendo o nome.

2. Claude Code — o par de trabalho

A extensão de IA dentro do VSCode. Não é “autocompletar”: lê o teu projecto, escreve ficheiros, corre comandos e integra APIs por ti. Falas em português, ele executa.

Regra de ouro: descreve o objectivo (“cria uma página de contacto com formulário e validação”), não os passos. Revês e aprovas.

3. Terminal — PowerShell vs Bash

PowerShell — o terminal nativo do Windows.
Bash (git bash) — para comandos POSIX e scripts *.sh. Sabe em qual estás (o prompt é diferente) — alguns comandos mudam de sintaxe.

4. Git — a rede de segurança

Antes de qualquer linha de código, inicia o controlo de versões:

git init                 # arranca o repositório
git add .                # marca os ficheiros
git commit -m "início"   # guarda a primeira fotografia

Cada commit é um ponto de regresso seguro. Comita cedo e com frequência.

5. Extensões do VSCode que ajudam

Instala com Ctrl+Shift+X (escreve o nome). As que mais ajudam no nosso fluxo:

Essenciais (web)

Live Server — abre o teu HTML no navegador e recarrega sozinho a cada gravação.
Prettier — formata o código automaticamente ao gravar (fica sempre alinhado).
ESLint — apanha erros e maus hábitos em JavaScript enquanto escreves.
Auto Rename Tag — mudas <div> e a tag de fecho muda sozinha.
Color Highlight — mostra a cor real ao lado de cada #FF7A00.

Git e equipa

GitLens — vê quem mudou cada linha e quando, sem sair do editor.
GitHub Pull Requests — abre e revê PRs dentro do VSCode.
Live Share — programa em conjunto, ao vivo, no mesmo ficheiro.

Conforto

Better Comments — comentários coloridos (TODO, aviso, dúvida).
Todo Tree — junta todos os // TODO do projecto numa lista.
DotENV — realça os ficheiros .env.
Code Spell Checker — apanha erros de escrita.

E a mais importante de todas: o Claude Code (a IA) — já a tens (secção 2).

✅ Exercícios

Atalhos — abre o terminal integrado e a paleta de comandos só com teclado.
Primeiro projecto — cria uma pasta ola-vscode, abre-a no VSCode (code .), cria um index.html e faz git init + primeiro commit.
Pede à IA — pede ao Claude Code: “explica-me, em 3 linhas, o que faz o ficheiro que acabei de criar”.

Resultado esperado: git log mostra o teu primeiro commit.