Preciso decorar os nomes de todas as ferramentas?

Não. Reconhecer as principais, como ler, buscar, editar, criar e rodar, já basta para entender a tela e revisar melhor. Os nomes exatos só importam de verdade quando você for configurar permissões, e ai a documentação e o próprio curso lembram cada um. O agente escolhe as ferramentas sozinho.

Posso obrigar o agente a usar uma ferramenta específica?

Você comanda pelo objetivo, não pela ferramenta. Pode pedir, por exemplo, que ele rode os testes ou que apenas leia sem editar, e ele respeita. Mas microgerenciar cada ferramenta raramente ajuda; e mais eficaz descrever bem o objetivo e as fronteiras e deixar o agente escolher o caminho.

Por que ele usa tantas ferramentas para uma tarefa simples?

Porque, como um bom profissional, ele explora antes de agir: le, busca, entende o padrão e só então muda. Isso costuma render resultados mais seguros. Cada ferramenta de leitura e barata e não pede aprovação, então esse cuidado inicial custa pouco e evita erros.

Rodar comandos no terminal sempre pede aprovação?

Em geral sim, mas ha exceções. Comandos considerados só de leitura, como listar arquivos ou ver o status do git, correm sem pedir, porque não mudam nada. Comandos que alteram algo passam pela sua aprovação. O módulo de permissões mostra como ajustar isso com regras próprias.

O que são as ferramentas de internet e de delegar?

As de internet permitem buscar na web e abrir páginas, úteis quando o agente precisa de informação de fora do projeto. A de delegar, chamada Agent, aciona um ajudante especializado para uma parte da tarefa, com contexto próprio. Ambas tem módulos dedicados mais a frente no curso.

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

A caixa de ferramentas do agente

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

O que você vai aprender

Agrupar as ferramentas do agente por propósito.
Nomear as principais: ler, editar, escrever, rodar, buscar.
Saber quais ferramentas pedem aprovação e quais não.
Entender por que leitura não pede e ação pede.

Quatro propósitos, uma caixa

No módulo de boas-vindas você viu que o poder do agente vem das ferramentas que ele usa. Agora vamos organizar essa caixa. As ferramentas do Claude Code cabem em quatro propósitos. O primeiro e explorar: olhar o projeto sem mudar nada, lendo arquivos e buscando por nome ou por conteúdo. O segundo e agir: editar um trecho, criar um arquivo novo, rodar um comando. O terceiro e alcancar o mundo fora do projeto, como buscar na internet ou abrir uma página. O quarto e delegar, ou seja, chamar um ajudante especializado para uma parte da tarefa.

Diagrama de uma caixa de ferramentas dividida em quatro compartimentos rotulados: explorar (ler, buscar por nome, buscar por conteúdo), agir (editar, criar, rodar comandos), alcancar o mundo (buscar na internet, abrir página) e delegar (chamar um ajudante especializado). — A caixa de ferramentas do agente, organizada por propósito: explorar, agir, alcancar e delegar.

Cada ferramenta tem um nome exato, em ingles, que aparece quando o agente trabalha e que você vai usar la na frente para configurar permissões. Ler e a ferramenta Read; buscar arquivos por nome e a Glob; buscar por conteúdo dentro dos arquivos e a Grep; editar um trecho e a Edit; criar ou sobrescrever um arquivo e a Write; rodar um comando no terminal e a Bash. Ha ainda as de internet, Web Search e Web Fetch, e a de delegar, Agent. Você não precisa decorar tudo hoje, mas reconhecer esses nomes deixa a tela menos misteriosa.

O que pede aprovação e o que não pede

Aqui esta uma lógica elegante que vale entender. Nem toda ferramenta pede a sua aprovação, e a regra e simples: ferramentas que só olham, sem mudar nada, geralmente não pedem, enquanto ferramentas que alteram alguma coisa pedem. Ler um arquivo, buscar por nome e buscar por conteúdo, dentro da pasta do projeto, correm livres, porque não ha risco: nada é alterado. Já editar, criar, sobrescrever ou rodar um comando que muda algo passam pela sua aprovação no modo padrão. Assim você não é interrompido a toda leitura, mas nada é mudado nas suas costas.

Proposito	Ferramenta	Pede aprovação no modo padrão?
Explorar	Ler (Read)	Não, dentro da pasta do projeto
Explorar	Buscar por nome (Glob)	Não, dentro da pasta do projeto
Explorar	Buscar conteúdo (Grep)	Não, dentro da pasta do projeto
Agir	Editar (Edit)	Sim
Agir	Criar arquivo (Write)	Sim
Agir	Rodar comando (Bash)	Sim (mas comandos só de leitura correm sem pedir)

Leitura corre livre; ação pede aprovação. Detalhe: comandos de terminal apenas de leitura também não pedem.

🎮 Jogo da aula

Explorar ou agir?

Classifique cada ferramenta conforme ela apenas explora (olha) ou age (muda algo).

Ha um detalhe fino sobre rodar comandos que vale guardar. A ferramenta de rodar comandos, a Bash, pede aprovação em geral, mas existe um conjunto de comandos considerados só de leitura, como listar arquivos ou ver o status do git, que correm sem pedir, porque não mudam nada. E a mesma lógica das outras ferramentas aplicada dentro do terminal: olhar e livre, mexer pede permissão. No módulo de permissões e segurança você vai aprender a ajustar tudo isso com precisao, até criar as suas próprias regras de o que liberar e o que sempre perguntar.

Você comanda pelo objetivo, não pela ferramenta

Uma coisa importante para tirar o peso das costas: você não precisa dizer qual ferramenta o agente deve usar. Você comanda pelo objetivo, e o Claude Code escolhe as ferramentas e a ordem sozinho. Se você pede para corrigir um bug, ele decide ler tal arquivo, buscar tal nome, editar tal trecho e rodar tal teste, tudo por conta própria. Conhecer as ferramentas serve para você entender o que ve na tela e revisar melhor, não para microgerenciar cada passo. Isso é libertador: o seu trabalho e definir o alvo e conferir o resultado.

Com essa visao da caixa de ferramentas, o que antes parecia mágica vira processo. Quando o agente le cinco arquivos antes de mudar um, você entende que ele está explorando para agir com segurança. Quando ele pede aprovação para uma edição, você sabe que atravessou a fronteira do olhar para o agir. As próximas aulas deste módulo pegam cada grupo, explorar, agir, pensar e corrigir, e mostram por dentro. Você vai sair daqui lendo a tela do Claude Code como quem le um mapa, e não como quem torce para dar certo.

Teste rápido

Por que ler um arquivo geralmente não pede a sua aprovação, mas editar pede?

Perguntas frequentes

Preciso decorar os nomes de todas as ferramentas?: Não. Reconhecer as principais, como ler, buscar, editar, criar e rodar, já basta para entender a tela e revisar melhor. Os nomes exatos só importam de verdade quando você for configurar permissões, e ai a documentação e o próprio curso lembram cada um. O agente escolhe as ferramentas sozinho.
Posso obrigar o agente a usar uma ferramenta específica?: Você comanda pelo objetivo, não pela ferramenta. Pode pedir, por exemplo, que ele rode os testes ou que apenas leia sem editar, e ele respeita. Mas microgerenciar cada ferramenta raramente ajuda; e mais eficaz descrever bem o objetivo e as fronteiras e deixar o agente escolher o caminho.
Por que ele usa tantas ferramentas para uma tarefa simples?: Porque, como um bom profissional, ele explora antes de agir: le, busca, entende o padrão e só então muda. Isso costuma render resultados mais seguros. Cada ferramenta de leitura e barata e não pede aprovação, então esse cuidado inicial custa pouco e evita erros.
Rodar comandos no terminal sempre pede aprovação?: Em geral sim, mas ha exceções. Comandos considerados só de leitura, como listar arquivos ou ver o status do git, correm sem pedir, porque não mudam nada. Comandos que alteram algo passam pela sua aprovação. O módulo de permissões mostra como ajustar isso com regras próprias.
O que são as ferramentas de internet e de delegar?: As de internet permitem buscar na web e abrir páginas, úteis quando o agente precisa de informação de fora do projeto. A de delegar, chamada Agent, aciona um ajudante especializado para uma parte da tarefa, com contexto próprio. Ambas tem módulos dedicados mais a frente no curso.

Fontes

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

← Atalhos essenciais que aceleram tudo Concluir e avançar →