# Atalhos e modos da extensão no VS Code (conferido em 30/10/2026)

Fonte principal: https://code.claude.com/docs/en/vs-code (`fonte externa`). O que não está nela
vem marcado `palpite` e deve ser conferido na sua versão. Atalhos de Mac trocam `Ctrl` por `Cmd`.

## Atalhos

| Atalho | O que faz |
|---|---|
| `Ctrl+Shift+X` | abre as extensões; busque "Claude Code" e clique em Install |
| `Ctrl+Shift+P` | paleta de comandos; "Developer: Reload Window" quando a extensão não aparece |
| `Alt+K` | insere a @-menção do arquivo e das linhas selecionadas, ex.: `@app.ts#5-10` |
| `` Ctrl+` `` | abre o terminal integrado (o `claude` ali só existe se o CLI estiver instalado) |
| `/` no painel | abre o menu de comandos: `/usage`, `/status`, `/export`, `/copy`, `/mcp`, `/tasks` |
| `/plan`, `/plan <tarefa>`, `/plan open` | entra no Plan, entra já com a tarefa, abre o arquivo do plano |
| `/plugins` | abre o gerenciador de plugins (no terminal o comando é `/plugin`) |
| `Shift` + arrastar um arquivo para o painel | vira contexto da conversa (visto na gravação; **não está na página do VS Code**, `palpite` até conferir) |

## Os quatro modos (rodapé do painel)

| Modo | Uma linha |
|---|---|
| Auto | um classificador revisa a maior parte das ações antes de executar; **não é garantia**, revise o diff |
| Manual | pede a sua aprovação antes de agir (`palpite` sobre o texto exato do rótulo; leia o painel) |
| Plan | planeja primeiro, sem editar; o plano abre como documento Markdown e você edita antes de aprovar |
| Edit automatically | aceita as edições de arquivo sem perguntar; revise o diff depois |

Combinação recomendada pelo Murilo: **Auto com Plan** (`palpite` dele). "Bypass permissions"
executa sem pedir aprovação: só em pasta de teste.

## Plan editável

- Abre como documento Markdown com comentários em linha (Claude Code 2.1.280 ou mais novo).
- Apague um passo, mude a ordem, comente, aprove. É o gate do plano com um editor de texto.
- `/plan open` abre o arquivo do plano de novo.

## Abas e avisos

- Cada conversa em aba tem histórico e contexto próprios: uma aba por assunto.
- Ponto azul = permissão pendente. Ponto laranja = terminou com a aba oculta.
- O painel abre pelo ícone do Claude (Spark) na barra do editor ou pela barra de status.

## Links
- https://code.claude.com/docs/en/vs-code
- https://code.claude.com/docs/en/permission-modes (não aberto nesta pesquisa; confirme antes de citar)
