# Aula 1.1: instalar e abrir o Claude Code (passo a passo)

Os três caminhos do vídeo, com os links oficiais. O do curso é o VS Code (caminho 3). Tempo: cerca de
15 minutos. Conferido em 30/10/2026.

## Antes de começar
- Uma conta em `claude.ai`. O **Claude Code exige plano pago** (o Free não inclui; o Pro inclui). Preço e data na aula 1.2 (`Material/1.2/planos-e-limites.md`).
- Windows 10 ou 11, macOS ou Linux. Não precisa ser administrador para a instalação nativa.

## Instalar e abrir (o mesmo passo a passo do vídeo e do PDF)
Conferido em 30/10/2026 nas páginas oficiais.

**Caminho 1: o app de desktop**
1. Abra https://claude.com/download e clique em **Download for Windows** (no Mac, Download for macOS).
2. Abra o instalador `.exe` que baixou e siga as telas até o fim.
3. Abra o Claude e entre com a sua conta (a mesma do claude.ai).
4. Clique na aba **Code**: é o Claude Code dentro do app. Guia: https://code.claude.com/docs/en/desktop

**Caminho 2: o terminal**
5. Windows: abra o **PowerShell** e cole `irm https://claude.ai/install.ps1 | iex`.
   Mac e Linux: `curl -fsSL https://claude.ai/install.sh | bash`.
6. Entre na pasta do projeto e digite `claude`. Guia: https://code.claude.com/docs/en/setup

**Caminho 3: o VS Code (o recomendado do curso)**
7. No VS Code, aperte `Ctrl+Shift+X` (Extensões), busque **Claude Code** e instale a extensão oficial, publicada pela **Anthropic**.
8. Clique no ícone do Claude no canto de cima do editor (com um arquivo aberto) ou na barra da esquerda.
9. Na primeira vez aparece **Sign in**: clique, autorize no navegador e pronto. Guia: https://code.claude.com/docs/en/vs-code

**Trocar o modo**
10. `Shift+Tab` troca o modo (no terminal e no VS Code; no VS Code também dá para clicar no modo embaixo da caixa de texto):
    Manual pede permissão a cada edição, Edit automatically aceita edições, **Plan** planeja antes de mexer, Auto decide com um revisor.
    **Bypass permissions** não pede permissão nenhuma: só em ambiente isolado. Guia: https://code.claude.com/docs/en/permission-modes

## Onde isso quebra
- **`claude` não é reconhecido.** Feche e abra um terminal novo: o caminho só vale em janela nova.
- **`irm` não é reconhecido, ou erro com `&&`.** Você misturou os terminais: o `irm` é do PowerShell, não do CMD.
- **Erro 403 no instalador.** Proxy ou filtro de rede bloqueando o endereço oficial. Tente outra rede ou a instalação pelo npm (`npm install -g @anthropic-ai/claude-code`, pede o Node 22 ou mais novo).
- **A extensão do VS Code não aparece.** Confira se é a publicada pela Anthropic e recarregue a janela (`Developer: Reload Window`).

## Entrega (50 XP)
O Claude Code aberto no VS Code, com login feito, e o print do `claude --version` no seu repositório `meu-claude`. Use `checklist.md`.

## Links oficiais (acesso em 30/10/2026)
- Baixar o app: https://claude.com/download
- Instalar (terminal): https://code.claude.com/docs/en/setup
- App de desktop e a aba Code: https://code.claude.com/docs/en/desktop
- Extensão do VS Code: https://code.claude.com/docs/en/vs-code
- Modos e Shift+Tab: https://code.claude.com/docs/en/permission-modes