Nível 2 — Ferramenta de trabalho · Módulo 2.1 — VS Code: a mesa de trabalho

2.1.4 · Dando contexto: seleção, @-mention, arquivos e terminal

5 min de vídeo TODOS

Objetivo: ao final, o consultor referencia arquivos, trechos de texto e saída de terminal com precisão, e sabe ocultar seleção sensível.

O que você precisa levar desta aula

Texto selecionado no editor vai automaticamente para o Claude — use o ícone de olho para ocultar seleção sensível.
@arquivo, @pasta/, arrastar com Shift e @terminal:nome são as quatro formas de dar contexto além da seleção.
Configure regra de negação de leitura para arquivos sensíveis (.env e similares) — protege mesmo contra seleção acidental.

As formas de dar contexto

Forma	Como	Quando usar
Seleção automática	Selecione texto no editor	Sempre que a pergunta é sobre o que você está olhando
`Option/Alt+K`	Insere `@arquivo#linhas` explícito no prompt	Quando você quer registrar a referência exata no seu pedido
`@arquivo`	Digite `@` + nome (correspondência aproximada)	Referenciar um arquivo sem precisar selecionar antes
`@pasta/`	Com barra no final	Referenciar o conteúdo de uma pasta inteira
Arrastar com Shift	Soltar arquivo do sistema no prompt	Anexar rápido, sem digitar caminho
`@terminal:nome`	Nome do terminal integrado	Referenciar saída de comando sem copiar e colar

Ocultando seleção sensível

O rodapé do painel mostra quantas linhas estão selecionadas. Ao lado, um ícone de olho: clique para alternar entre "visível ao Claude" e "oculto". Use quando a tela tem algo que não deveria entrar no contexto daquela pergunta específica — reaplique aqui a aula 1.1.4 do Nível 1.

Arquivo sensível: negar leitura

Para um arquivo que nunca deveria entrar no contexto — configuração com credencial, por exemplo — configure uma regra de negação de leitura para aquele caminho. Isso bloqueia tanto seleção automática quanto @-mention explícito. Detalhe de configuração no módulo 2.3 (CLAUDE.md) e no Nível 3 (permissões).

Regra Wayon Nenhum arquivo com credencial, string de conexão ou dado sob cláusula restritiva do cliente deve estar numa pasta sem regra de negação de leitura configurada, se essa pasta é usada com o Claude Code.

📖 Referenciar arquivos e pastas

Quiz — 5 questões

1.Você selecionou três linhas de uma spec no editor e fez uma pergunta sobre elas, sem usar nenhum atalho. O Claude:

a)Já vê a seleção automaticamente — não é preciso fazer nada além de selecionar
Correto. É o comportamento padrão.
b)Não vê nada até você usar Option/Alt+K
O atalho serve para referenciar explicitamente no texto do prompt; a seleção já vai sozinha.
c)Só vê se você arrastar o arquivo também
Arrastar é uma forma alternativa de anexar; não é necessária quando você já selecionou o trecho.

Ver resposta e por quê

✅a) Correto. É o comportamento padrão.

❌b) O atalho serve para referenciar explicitamente no texto do prompt; a seleção já vai sozinha.

❌c) Arrastar é uma forma alternativa de anexar; não é necessária quando você já selecionou o trecho.

2.Uma tela tem um CPF visível que você não quer que entre no contexto desta pergunta específica.

a)Clique no ícone de olho ao lado do indicador de seleção para ocultá-la
Correto.
b)Feche o arquivo antes de perguntar
Solução extrema; existe um controle mais direto.
c)Não há como evitar; a seleção sempre vai
Existe o controle do ícone de olho, feito exatamente para isso.

Ver resposta e por quê

✅a) Correto.

❌b) Solução extrema; existe um controle mais direto.

❌c) Existe o controle do ícone de olho, feito exatamente para isso.

3.Você quer referenciar a pasta Entrada/Atas inteira, não um arquivo específico.

a)@Entrada/Atas sem barra no final
Sem a barra, a referência aponta a um arquivo, não à pasta.
b)@Entrada/Atas/ com a barra no final
Correto.
c)Não é possível referenciar uma pasta inteira, só arquivo por arquivo
É possível, com a barra final.

Ver resposta e por quê

❌a) Sem a barra, a referência aponta a um arquivo, não à pasta.

✅b) Correto.

❌c) É possível, com a barra final.

4.Você rodou um comando no terminal integrado e quer que o Claude leia a saída, sem copiar e colar.

a)Copie a saída e cole no prompt
Funciona, mas existe um caminho mais direto.
b)@terminal:nome-do-terminal
Correto. Referencia a saída pelo nome do terminal.
c)Arraste o terminal para o prompt
Terminal não é um arquivo; a forma correta é a referência por nome.

Ver resposta e por quê

❌a) Funciona, mas existe um caminho mais direto.

✅b) Correto. Referencia a saída pelo nome do terminal.

❌c) Terminal não é um arquivo; a forma correta é a referência por nome.

5.Existe um arquivo .env com credencial na pasta do projeto. A proteção recomendada é: ---

a)Renomear o arquivo para algo menos óbvio
Não impede leitura por seleção nem por @-mention.
b)Confiar que o Claude nunca vai selecionar esse arquivo por conta própria
Não é uma proteção — é uma esperança. A regra de negação é o controle real.
c)Configurar uma regra de negação de leitura para o caminho do arquivo
Correto. Bloqueia seleção automática e @-mention explícito.

Ver resposta e por quê

❌a) Não impede leitura por seleção nem por @-mention.

❌b) Não é uma proteção — é uma esperança. A regra de negação é o controle real.

✅c) Correto. Bloqueia seleção automática e @-mention explícito.