Qual a diferença entre buscar por nome e buscar por conteúdo?

Buscar por nome encontra arquivos pelo padrão do nome ou do caminho, sem olhar o que tem dentro. Buscar por conteúdo procura um texto dentro dos arquivos e diz em quais e onde ele aparece. Uma responde onde estão os arquivos assim; a outra, onde este trecho aparece.

Por que o agente le tantos arquivos antes de mudar um?

Para entender o contexto e não quebrar o que funciona. Ler os arredores mostra o padrão do projeto e as funções que já existem, o que rende mudanças mais seguras e que combinam com o resto. E cuidado, não desperdicio: a leitura e barata e evita erros caros depois.

Posso pular a exploracao para ir mais rápido?

Você acelera a exploracao apontando o arquivo certo com o atalho de arroba, mas pular por completo costuma sair caro. Sem entender o contexto, a chance de uma mudança destoar ou causar efeito colateral cresce. O melhor e dar um bom ponto de partida e deixar o agente conferir os arredores.

A busca funciona em projetos grandes sem travar?

Sim. A busca por conteúdo usa, por baixo, um mecanismo muito rápido, capaz de varrer projetos enormes em instantes. Por isso o agente consegue explorar bases grandes sem lentidao, tornando o mapeamento inicial barato mesmo quando ha milhares de arquivos.

Consigo ver o que o agente está explorando?

Sim. A tela mostra as leituras e buscas em tempo real, sem pedir aprovação, porque nada é alterado. E um bom momento para acompanhar o raciocínio e, se perceber que ele foi ao lugar errado, interromper e apontar o arquivo certo antes que ele comece a agir.

Módulo 4 - O fluxo agêntico por dentro

Como ele explora: ler e buscar

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

O que você vai aprender

Distinguir buscar por nome de arquivo de buscar por conteúdo.
Entender por que o agente le antes de agir.
Reconhecer a exploracao na tela.
Perceber que exploracao boa gera mudança segura.

Duas buscas que respondem perguntas diferentes

Explorar um projeto e responder a duas perguntas diferentes, e por isso existem duas buscas. A primeira pergunta e onde estão os arquivos de um tipo. Para isso serve a busca por nome, que encontra arquivos pelo padrão do nome ou do caminho: todos os que terminam em uma extensão, todos dentro de uma pasta, e assim por diante. Ela não olha o que tem dentro, só o nome. A segunda pergunta e onde este trecho aparece. Para isso serve a busca por conteúdo, que varre o texto dentro dos arquivos atrás de uma palavra ou padrão, dizendo em quais arquivos e linhas ele aparece.

Diagrama com três ferramentas de exploracao lado a lado: buscar por nome encontrando arquivos por padrão de nome, buscar por conteúdo encontrando uma palavra dentro dos arquivos com linhas destacadas, e ler abrindo um arquivo para entender o conteúdo completo, todas alimentando um mapa do projeto na cabeça do agente. — Buscar por nome, buscar por conteúdo e ler: as três formas de o agente mapear o projeto.

As duas buscas trabalham juntas. Imagine que você pediu para corrigir algo no login. O agente pode primeiro buscar por conteúdo a palavra login para descobrir em quais arquivos ela aparece, depois buscar por nome os arquivos de teste relacionados e, por fim, ler os arquivos mais promissores para entender de verdade o que fazem. Só depois desse mapeamento ele decide onde e como mexer. A busca por conteúdo, por baixo, usa um mecanismo de busca muito rápido, capaz de varrer projetos enormes em instantes, o que torna essa exploracao barata mesmo em bases grandes.

Por que ele le antes de agir

Uma cena que assusta iniciantes e ver o agente ler vários arquivos antes de mudar uma única linha. Parece perda de tempo, mas e o contrario: e o que torna a mudança segura. Assim como um bom eletricista estuda o quadro antes de mexer num fio, o agente le o contexto para não quebrar o que já funciona. Ele confere como o código vizinho e escrito, quais funções já existem, que padrão o projeto segue. Uma edição feita as cegas, sem esse mapeamento, teria muito mais chance de destoar do resto ou de causar um efeito colateral inesperado.

Agir sem explorar (arriscado)

Muda a primeira linha que parece certa.
Ignora o padrão do projeto.
Pode duplicar algo que já existia.

Explorar e depois agir (seguro)

Le o contexto e entende o padrão antes.
Reaproveita funções que já existem.
Faz uma mudança que combina com o resto.

🎮 Jogo da aula

Monte uma exploracao

Você pediu para corrigir algo no login. Coloque os passos de exploracao do agente em uma ordem que faz sentido.

Você pode até acelerar essa fase dando bom contexto, como viu no módulo anterior: ao apontar o arquivo certo com o atalho de arroba, o agente pula parte da busca e vai direto ao ponto. Mas, mesmo com um bom ponto de partida, deixa-lo ler os arredores costuma valer a pena. A lição prática e não se incomodar com a exploracao: quando o agente le bastante antes de agir, comemore, porque e sinal de cuidado. O tempo gasto lendo quase sempre volta em forma de menos erros depois.

Reconhecer a exploracao na tela

Saber ler o que aparece deixa você mais tranquilo. Durante a exploracao, a tela mostra o agente lendo arquivos e fazendo buscas, sem pedir aprovação, porque nada está sendo alterado. E um bom momento para acompanhar o raciocínio: quais arquivos ele achou relevantes, o que ele descobriu, para onde esta indo. Muitas vezes da para pegar cedo um mal-entendido, quando você percebe que ele foi olhar o arquivo errado, e corrigir o rumo antes que ele comece a agir. Exploracao visivel e uma janela para a cabeça do agente.

Com a exploracao entendida, a próxima aula avanca para o outro lado do fluxo: a ação. Depois de ler e buscar para montar o mapa, o agente edita, cria e roda comandos, e e ai que entram a sua aprovação e o cuidado com o que muda. A dupla explorar e agir e o coracao do trabalho do Claude Code. Você já domina metade dela; a metade que muda o projeto vem a seguir, com o detalhe extra de como o agente confere o próprio trabalho antes de dizer que terminou.

Teste rápido

Você quer descobrir em quais arquivos aparece a palavra login. Que tipo de busca resolve isso?

Perguntas frequentes

Qual a diferença entre buscar por nome e buscar por conteúdo?: Buscar por nome encontra arquivos pelo padrão do nome ou do caminho, sem olhar o que tem dentro. Buscar por conteúdo procura um texto dentro dos arquivos e diz em quais e onde ele aparece. Uma responde onde estão os arquivos assim; a outra, onde este trecho aparece.
Por que o agente le tantos arquivos antes de mudar um?: Para entender o contexto e não quebrar o que funciona. Ler os arredores mostra o padrão do projeto e as funções que já existem, o que rende mudanças mais seguras e que combinam com o resto. E cuidado, não desperdicio: a leitura e barata e evita erros caros depois.
Posso pular a exploracao para ir mais rápido?: Você acelera a exploracao apontando o arquivo certo com o atalho de arroba, mas pular por completo costuma sair caro. Sem entender o contexto, a chance de uma mudança destoar ou causar efeito colateral cresce. O melhor e dar um bom ponto de partida e deixar o agente conferir os arredores.
A busca funciona em projetos grandes sem travar?: Sim. A busca por conteúdo usa, por baixo, um mecanismo muito rápido, capaz de varrer projetos enormes em instantes. Por isso o agente consegue explorar bases grandes sem lentidao, tornando o mapeamento inicial barato mesmo quando ha milhares de arquivos.
Consigo ver o que o agente está explorando?: Sim. A tela mostra as leituras e buscas em tempo real, sem pedir aprovação, porque nada é alterado. E um bom momento para acompanhar o raciocínio e, se perceber que ele foi ao lugar errado, interromper e apontar o arquivo certo antes que ele comece a agir.

Fontes

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

← A caixa de ferramentas do agente Concluir e avançar →