Como eu menciono um arquivo no pedido?

Digite o atalho de arroba dentro do pedido e comece a escrever o caminho ou o nome do arquivo. Aparece um autocompletar; escolha o arquivo desejado. Assim o agente sabe exatamente onde olhar, em vez de procurar no projeto inteiro, o que deixa a resposta mais rápida e precisa.

Que tipo de imagem posso colar?

Prints de tela são os mais úteis: uma mensagem de erro, um layout torto, uma referência visual do que você quer. Você cópia a imagem e cola na conversa, e a ferramenta a insere para você referenciar no pedido. Para problemas visuais, mostrar costuma valer mais que descrever.

Quanto contexto e demais?

Passa do ponto quando você começa a colar arquivos e textos que não tem relação direta com a tarefa. Isso dilui o que importa e ocupa a janela de contexto. A regra prática e dar o essencial primeiro, o arquivo certo e o erro exato, e complementar só se o agente pedir ou parecer perdido.

Colar imagens tem algum risco?

O principal e capturar dados sensíveis sem querer: senhas, tokens ou informações de clientes que aparecem na tela. Antes de colar um print, confira o que ele mostra. Esse cuidado com o que você envia ao agente e tema do módulo de permissões e segurança.

O agente não acha os arquivos sozinho?

Acha, mas apontar economiza tempo e melhora a precisao. Quando você menciona o arquivo certo, o agente vai direto ao ponto e ainda enxerga o estilo do código dali, tendendo a seguir o padrão. E um gesto pequeno que rende respostas melhores.

Módulo 3 - A conversa com o agente

Dar o contexto certo: arquivos e imagens

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Mencionar arquivos no pedido com o atalho de arroba.
Colar imagens, como prints de erro, na conversa.
Escolher o contexto que importa, sem exagero.
Entender por que contexto demais atrapalha tanto quanto de menos.

Aponte o arquivo com o atalho de arroba

O Claude Code consegue procurar arquivos sozinho, mas você economiza tempo e melhora a precisao quando aponta o lugar certo. Para isso existe a menção de arquivo: ao digitar o atalho de arroba dentro do pedido, aparece um autocompletar de caminhos, e você escolhe o arquivo exato. Em vez de dizer procure a função de login em algum lugar, você menciona o arquivo dela e o agente vai direto ao ponto. E como dar o endereco em vez de mandar procurar a casa pela cidade inteira: mais rápido e com menos chance de erro.

Diagrama mostrando três formas de dar contexto ao Claude Code convergindo para o agente: uma menção de arquivo com o atalho de arroba abrindo um autocompletar de caminho, uma imagem de print de erro sendo colada, e uma descricao do comportamento esperado em texto. — Três formas de dar contexto: apontar o arquivo, colar uma imagem e descrever o esperado.

Apontar arquivos também ajuda o agente a respeitar o padrão do seu projeto. Quando você menciona o arquivo certo e talvez um vizinho parecido, ele ve como o código costuma ser escrito ali e tende a seguir o mesmo estilo. Isso rende mudanças que combinam com o resto, em vez de destoarem. No começo, pegue o hábito de apontar o arquivo principal envolvido em cada pedido; e um gesto pequeno que melhora muito a qualidade das respostas.

Cole a imagem: um print vale mil descricoes

Nem todo contexto e texto. As vezes a forma mais rápida de explicar um problema e mostrar. O Claude Code aceita imagens coladas direto na conversa: um print da tela com o erro, uma foto do layout que ficou torto, um diagrama do que você quer construir. Você cópia a imagem e cola na sessão; a ferramenta insere uma marca de imagem que você pode referenciar no pedido. Para um bug visual ou uma mensagem de erro cheia de detalhes, colar o print costuma ser muito mais eficiente do que tentar descrever tudo em palavras.

🎮 Jogo da aula

Contexto: ajuda ou atrapalha?

Para cada situação, diga se a afirmacao sobre dar contexto e verdadeira ou falsa.

Um cuidado ao colar imagens: não inclua dados sensíveis sem querer. Prints de tela as vezes capturam senhas, tokens, e-mails ou informações de clientes que aparecem no canto. Antes de colar, de uma olhada no que a imagem mostra. Esse cuidado vale para qualquer contexto que você fornece ao agente, e o módulo de permissões e segurança aprofunda o tema. Dar contexto e ótimo; dar contexto com atenção ao que é sensível e melhor ainda.

Contexto na medida certa

Existe uma tentacao natural de jogar tudo no pedido por segurança: dez arquivos, o log inteiro, páginas de descricao. Isso costuma piorar, não melhorar. O agente tem um limite de quanto consegue considerar de uma vez, a tal janela de contexto que você viu no módulo anterior. Enche-la de coisa irrelevante dilui o que importa e pode confundir. A arte está no meio-termo: dar o contexto essencial, o arquivo certo, a mensagem de erro exata, o comportamento esperado, e deixar o agente pedir mais se precisar, o que ele faz.

Situacao	Contexto útil	Contexto que polui
Corrigir um bug	o arquivo do bug e o erro exato	o projeto inteiro colado
Seguir o padrão	um arquivo vizinho parecido	vinte arquivos aleatorios
Explicar um erro visual	o print da tela	uma descricao vaga e longa

Contexto certo aponta o essencial; contexto que polui joga tudo por segurança.

Guarde uma regra prática: contexto e como tempero, não como prato principal. Um pouco na hora certa realca; o exagero estraga. Comece apontando o arquivo mais relevante e a informação central do problema, e observe o agente trabalhar. Se ele pedir mais ou parecer perdido, ai você complementa. Esse hábito de dar o essencial primeiro mantem a conversa enxuta, a janela de contexto saudavel e as respostas afiadas, e vai ser reforcado no módulo sobre gestão de contexto.

Teste rápido

Qual é a melhor forma de dar contexto ao Claude Code para corrigir um bug num arquivo específico?

Perguntas frequentes

Como eu menciono um arquivo no pedido?: Digite o atalho de arroba dentro do pedido e comece a escrever o caminho ou o nome do arquivo. Aparece um autocompletar; escolha o arquivo desejado. Assim o agente sabe exatamente onde olhar, em vez de procurar no projeto inteiro, o que deixa a resposta mais rápida e precisa.
Que tipo de imagem posso colar?: Prints de tela são os mais úteis: uma mensagem de erro, um layout torto, uma referência visual do que você quer. Você cópia a imagem e cola na conversa, e a ferramenta a insere para você referenciar no pedido. Para problemas visuais, mostrar costuma valer mais que descrever.
Quanto contexto e demais?: Passa do ponto quando você começa a colar arquivos e textos que não tem relação direta com a tarefa. Isso dilui o que importa e ocupa a janela de contexto. A regra prática e dar o essencial primeiro, o arquivo certo e o erro exato, e complementar só se o agente pedir ou parecer perdido.
Colar imagens tem algum risco?: O principal e capturar dados sensíveis sem querer: senhas, tokens ou informações de clientes que aparecem na tela. Antes de colar um print, confira o que ele mostra. Esse cuidado com o que você envia ao agente e tema do módulo de permissões e segurança.
O agente não acha os arquivos sozinho?: Acha, mas apontar economiza tempo e melhora a precisao. Quando você menciona o arquivo certo, o agente vai direto ao ponto e ainda enxerga o estilo do código dali, tendendo a seguir o padrão. E um gesto pequeno que rende respostas melhores.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← A arte de pedir bem Concluir e avançar →