# Aula 2.2: Claude Code no VS Code (passo a passo)

Você vai instalar a extensão, abrir o painel, escolher o modo de permissão, usar a seleção e a
@-menção com linhas como contexto, e revisar o diff antes de aceitar. Tempo: cerca de 20 minutos.
Conferido em 30/10/2026 em https://code.claude.com/docs/en/vs-code. Atalhos em `atalhos-vscode.md`,
prompts em `prompts.md`, comparação em `cli-desktop-vscode.md`.

## Antes de começar
- VS Code **1.94.0 ou mais novo** (Ajuda, Sobre). Guia de terceiro que diz 1.98 está errado em relação à doc oficial.
- Conta **paga** (Pro, Max, Team, Enterprise ou Console). Sem chave de API. O Free não serve.
- Uma **pasta de projeto** com um arquivo de código qualquer.

## Passos
1. **Instale o VS Code** em https://code.visualstudio.com (Windows: baixar, aceitar o termo, avançar até o fim).
2. **Abra uma pasta** (Arquivo, Abrir Pasta). Não use só um arquivo solto.
3. **Abra as extensões** com `Ctrl+Shift+X`, busque **Claude Code** (publicador Anthropic, `anthropic.claude-code`) e clique em Install.
4. **Não apareceu?** Reinicie o VS Code ou rode `Ctrl+Shift+P`, "Developer: Reload Window".
5. **Abra o painel:** ícone do Claude (Spark) na barra do editor ou "Claude Code" na barra de status, no rodapé.
6. **Faça login:** botão Sign in, autorize no navegador, volte ao VS Code.
7. **Escolha o modo** no rodapé do painel: Auto, Manual, Plan ou Edit automatically (`atalhos-vscode.md`). Para tarefa nova, comece em **Plan**.
8. **Selecione uma função** no editor e pressione `Alt+K`: entra a @-menção com o arquivo e as linhas, como `@app.ts#5-10`.
9. **Cole o prompt 1** (`prompts.md`). No Plan, o plano abre como documento: edite, apague um passo, mude a ordem e só então aprove.
10. **Leia o diff** (verde entra, vermelho sai) antes de aceitar a edição.
11. **Digite `/`** no painel e veja os comandos (`/usage`, `/status`, `/export`, `/mcp`). Para gastos, `/usage`.
12. **Capture** o diff revisado e faça o commit. Essa é a entrega.

## Terminal integrado
`` Ctrl+` `` abre o terminal. A extensão **não** coloca o `claude` no PATH: para rodar `claude` ali,
instale o CLI (aula 1.1). `claude -p "pedido"` roda um pedido e sai, bom para automação.

## Onde isso quebra
- **Extensão não aparece depois de instalar.** Reinicie ou "Developer: Reload Window".
- **`claude` não é reconhecido no terminal do VS Code.** Normal: a extensão não instala o CLI. Veja a aula 1.1.
- **VS Code antigo.** Abaixo de 1.94 a extensão não carrega. Atualize.
- **Plano abre sem o editor de comentários.** O plano como documento editável pede Claude Code 2.1.280 ou mais novo.
- **Modo Auto não é garantia.** Segundo a doc, um classificador revisa a maior parte das ações. Revise o diff mesmo assim. "Auto com Plan" é a recomendação do Murilo (`palpite`), não da doc.
- **Bypass permissions.** Executa sem pedir aprovação. Só em pasta de teste. Comandos `rm` perigosos passaram a ser negados nesse modo na 2.1.309, conforme o changelog; não conte com isso como proteção.
- **`claude -p` não mostra a pergunta de confiança da pasta** (relato de terceiro no TabNews, 27/10/2026; confirmar na sua versão). Quem automatiza precisa saber o que autorizou.
- **Comando citado na aula que não aparece no `/`.** `/rewind` e `/compact` não estão na página do VS Code (conferido em 30/10/2026); confira o menu da sua versão.

## Entrega (40 XP)
Uma mudança real no seu projeto, feita pela extensão, com o diff revisado antes de aceitar,
capturado (print) e commitado. Use `checklist.md`.

## Links oficiais (acesso em 30/10/2026)
- Extensão no VS Code: https://code.claude.com/docs/en/vs-code
- Instalação do CLI: https://code.claude.com/docs/en/setup
- Modos de permissão: https://code.claude.com/docs/en/permission-modes (link provável, abra e confirme)
- Plugins: https://code.claude.com/docs/en/discover-plugins
- Marketplace do VS Code: https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code