🟢 Básico & Instalação

🟢 O que é

O Claude Code é o agente de codificação da Anthropic que roda no seu terminal. Não é autocomplete nem chat: ele lê seu projeto, planeja, edita arquivos, roda comandos e testes, usa git e navega a web — sempre pedindo sua aprovação. Você fala em português; ele executa.

💡 Por que aprender

Diferente de colar código de um chat, o Claude Code trabalha dentro do repositório real — entende o contexto inteiro via CLAUDE.md, respeita seu stack e roda em qualquer sistema. É a base de tudo que vem nas próximas trilhas.

🔑 Onde você pode usar

🟢 O que é

Instalação via npm. Pré-requisitos: Node.js 18+ e, no Windows, Git Bash. O login é por assinatura (Pro/Max via navegador) ou por API key da Anthropic.

💡 Por que aprender

Node desatualizado causa falhas silenciosas. No Windows, sem o Git Bash o Claude Code não roda — é o erro nº 1 de quem começa. A ordem certa evita 90% dos problemas de instalação.

🔑 Passo a passo (ordem certa)

# 1. Instale o Git (inclui o Git Bash) → git-scm.com/download/win
# 2. Instale o Node.js LTS → nodejs.org
# 3. Confira:
node -v
npm -v
# 4. Instale o Claude Code:
npm install -g @anthropic-ai/claude-code
# 5. Rode:
claude

brew install node
npm install -g @anthropic-ai/claude-code
claude

sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code
claude

# Dentro do claude, rode:
/login        # abre o navegador → conta Pro/Max (recomendado)

# OU, via API key (pague por uso):
setx ANTHROPIC_API_KEY "sk-ant-..."   # Windows
export ANTHROPIC_API_KEY="sk-ant-..." # macOS/Linux

🟢 O que é

Você roda claude dentro da pasta do projeto e digita o pedido em linguagem natural. Ele propõe edições como diffs que você aprova ou rejeita. @ referencia arquivos e # salva algo na memória.

💡 Por que aprender

O medo de "ele vai bagunçar meu código" some quando você entende o loop de aprovação: nada é alterado sem você ver o diff. Esc interrompe na hora se ele tomar um rumo errado.

🔑 Conceitos-chave

cd meu-projeto
claude                          # abre o modo interativo
claude "corrija o bug do login" # pedido direto
claude -p "resuma o README"     # print mode: responde e sai (scripts)

🟢 O que é

Comandos que começam com / controlam a sessão (não o projeto). Digite / e veja a lista. Os mais usados gerenciam o contexto — o recurso mais escasso de uma sessão.

💡 Por que aprender

/clear e /compact são o que mantêm a sessão rápida e barata. Sem eles, o contexto enche, o Claude fica lento e "esquece" o começo. (A trilha 3 aprofunda isso.)

🔑 Os essenciais

🟢 O que é

Apertando Shift+Tab você alterna entre os modos da sessão. No modo plano (plan mode), o Claude investiga e propõe um plano — mas não edita nada até você aprovar.

💡 Por que aprender

Em tarefas grandes ou arriscadas, deixar ele "sair editando" é receita de retrabalho. Planejar primeiro alinha o caminho. O preset opusplan usa o Opus (mais forte) pra planejar e o Sonnet (mais barato/rápido) pra executar — qualidade onde importa, economia no resto.

🔑 Os 3 modos (Shift+Tab cicla)

/model opusplan   # Opus planeja, Sonnet executa

🟢 O que é

O CLAUDE.md é um arquivo na raiz do projeto com o contexto permanente: como rodar, convenções, regras, o que não fazer. O comando /init gera um pra você analisando o repo. A pasta .claude/ guarda settings, comandos, agentes e skills.

💡 Por que aprender

Sem CLAUDE.md, o Claude começa do zero a cada sessão e repete os mesmos erros. Com ele, respeita seu stack e estilo desde o primeiro prompt. É o investimento de 5 minutos que melhora todas as sessões seguintes.

🔑 Hierarquia da memória

# Projeto X
- Stack: Next.js + TypeScript + pnpm
- Rodar: `pnpm dev` · Testar: `pnpm test`
- Convenção: componentes em PascalCase, sem default export
- NUNCA commitar direto na main

Atalho: digite # sua regra na sessão pra anexar algo ao CLAUDE.md na hora.

🟢 O que é

Por padrão o Claude pede permissão antes de editar arquivos ou rodar comandos. Você define listas de allow / deny e o modo de permissão. O comando /permissions gerencia tudo.

💡 Por que aprender

Permissão é o seu cinto de segurança. Liberar comandos seguros (ex.: npm test) reduz cliques; mas nunca use bypass em máquina com dados sensíveis ou em produção.

🔑 Modos de permissão

/permissions          # abre o gerenciador
# em .claude/settings.json:
# "permissions": { "allow": ["Bash(npm test)"], "deny": ["Bash(rm -rf *)"] }

🟢 O que é

Você usa o Claude Code por assinatura (Pro/Max — uso incluído) ou por API (paga por token). /cost mostra o gasto da sessão. A escolha do modelo é o que mais mexe no custo e na velocidade.

💡 Por que aprender

Usar Opus pra tudo é caro e desnecessário. Sonnet dá conta do dia-a-dia; Opus pro que é difícil; opusplan combina os dois. Junto com /compact e /clear, você controla o gasto.

🔑 Modelos — quando usar cada um

/cost                       # gasto da sessão
/model sonnet               # troca pro Sonnet
claude --model "opus[1m]"   # abre com contexto de 1M