Noções Básicas dos Fluxos de Trabalho de Código do Claude
10 exemplos para você começar com os Fluxos de Trabalho Principais - 7 básicos e 3 intermediários.
Pré-requisitos / Instalação Rápida
- Claude Code instalado e conectado a um projeto real (veja o guia de instalação do Claude Code 101 se você ainda não fez isso).
- Uma base de código com uma suíte de testes ou linter já configurada - os exemplos abaixo assumem
npm test, mas substitua pelos comandos de teste/lint reais do seu projeto. - Uma sessão de terminal aberta na raiz do projeto para que as leituras de arquivo, edições e comandos do Claude Code sejam resolvidas no mesmo diretório de trabalho.
Exemplos Básicos
1. Peça ao Claude Code para localizar uma função
Descrição de uma linha: aponte o Claude Code para um símbolo e deixe que sua ferramenta de busca integrada encontre todos os lugares onde ele vive e é usado.
> Find the function that calculates the order total and show me every place it's called.- O Claude Code executa sua busca interna semelhante ao grep em todo o repositório em vez de adivinhar um caminho de arquivo apenas pelo nome.
- Ele retorna a definição mais cada local de chamada, que é o ponto de partida para qualquer edição - você não pode alterar com segurança a assinatura de uma função sem saber quem a chama.
- Nenhum arquivo é modificado nesta etapa; é pura investigação, portanto, geralmente não requer aprovação de permissão.
- Se a primeira busca não encontrar correspondências (por exemplo, a função é reexportada sob um alias), peça ao Claude Code para ampliar a busca em vez de editar "às cegas".
Relacionado: Buscando em uma Base de Código com a Ferramenta Grep Integrada do Claude Code - como a etapa de busca realmente funciona
2. Leia o arquivo antes de propor uma edição
Descrição de uma linha: o loop sempre começa com uma leitura, mesmo para um arquivo que você acha que já conhece.
> Open src/utils/pricing.ts and explain what calculateOrderTotal does.- O Claude Code lê o arquivo completo (ou a região relevante) para o contexto antes de propor qualquer alteração, em vez de confiar em um resumo da memória.
- Isso fundamenta a edição no código como ele realmente existe no momento, incluindo comentários, tratamento de casos extremos e convenções de formatação.
- Uma etapa somente leitura como esta geralmente é aprovada automaticamente, pois não toca no sistema de arquivos.
- Pular direto para "apenas conserte" sem uma etapa de leitura tende a produzir edições que ignoram as convenções locais - pedir uma leitura primeiro prepara um diff melhor.
3. Faça uma edição pequena e direcionada
Descrição de uma linha: transforme uma função localizada em uma correção de uma linha e revise o diff proposto.
- return price * quantity;
+ return Math.round(price * quantity * 100) / 100;- O Claude Code propõe a alteração como um diff em relação ao arquivo que acabou de ler, para que você possa ver exatamente o que será alterado antes que ele seja aplicado.
- Edições pequenas e direcionadas são mais fáceis de verificar visualmente do que grandes reescritas - peça a menor alteração que corrija o problema descrito.
- Dependendo do modo de permissão, a aplicação da edição pode ser aprovada automaticamente (edições de arquivo) enquanto um comando de acompanhamento, como a execução de um teste, é o que aciona uma solicitação de aprovação.
- Se o diff tocar em mais do que o bug descrito, peça ao Claude Code para restringi-lo antes de aceitar.
Relacionado: Uma Lista de Verificação para Revisar os Diffs Propostos pelo Claude Code - o que verificar antes de aprovar
4. Execute um linter para verificar a edição
Descrição de uma linha: após uma edição, execute o linter do projeto como a etapa de "execução" do loop.
> Run the linter on src/utils/pricing.ts and fix anything it flags.- O Claude Code executa o comando de lint real (
eslint,ruff,golangci-lint, o que quer que o projeto use) em vez de inspecionar o estilo visualmente. - Executar um comando bash arbitrário é o tipo de ação que comumente solicita aprovação, dependendo do seu modo de permissão.
- Falhas de lint são lidas de volta para o contexto, para que o Claude Code possa propor uma correção de acompanhamento sem que você precise colar a saída do erro.
- Mantenha o loop apertado: uma edição, uma execução de lint, uma olhada no resultado, antes de passar para a próxima alteração.
Relacionado: Como o Claude Code Decide Quando Executar um Comando vs. Pedir Permissão - por que alguns comandos solicitam e outros não
5. Execute um único teste para verificar a correção
Descrição de uma linha: restrinja a execução do teste apenas ao teste que cobre a alteração que você fez.
> Run only the pricing test file and tell me if it passes.npm test -- pricing.test.ts- Executar um único arquivo de teste fornece feedback mais rápido do que a suíte completa enquanto você ainda está iterando em uma função.
- O Claude Code lê a saída do teste diretamente, então uma falha é seguida por um diagnóstico, não apenas um relatório de aprovação/reprovação.
- Esta é a etapa de "verificação" do loop - uma edição não está concluída até que algo tenha sido realmente executado e confirmado.
- Se o teste já estava passando antes da sua edição, isso também confirma que você não introduziu uma regressão.
6. Releia um arquivo antes de uma segunda edição
Descrição de uma linha: o Claude Code relê um arquivo imediatamente antes de editá-lo novamente, mesmo dentro da mesma sessão.
> Now also update the discount logic in the same file.- O Claude Code relê o arquivo logo antes de aplicar uma segunda edição, em vez de confiar na cópia em memória da etapa 2.
- Isso protege contra o trabalho com uma versão desatualizada se o arquivo mudou desde que foi lido pela última vez - por você, um formatador ou uma chamada de ferramenta anterior.
- Você notará às vezes uma segunda leitura acontecendo automaticamente sem nenhum prompt extra de sua parte - esse é um comportamento esperado, não trabalho desperdiçado.
- Se você editou o arquivo fora do Claude Code (em seu próprio editor) entre as voltas, esta releitura é o que impede que o próximo diff sobrescreva suas alterações.
Relacionado: Por que o Claude Code Relê Arquivos Antes de Editá-los - o problema de desatualização que isso resolve
7. Aprove ou negue um prompt de permissão
Descrição de uma linha: saiba o que você está olhando quando o Claude Code pergunta antes de executar um comando.
Claude wants to run: npm test
Allow this command? (y/n)- Algumas ações - notavelmente a execução de comandos bash - podem solicitar aprovação explícita dependendo do seu modo de permissão atual, enquanto muitas leituras e edições de arquivo são aprovadas automaticamente.
- Leia o comando exato antes de aprovar; é seu único ponto de verificação contra um efeito colateral não intencional (como um script destrutivo ou uma chamada de rede).
- Se você espera executar o mesmo comando seguro repetidamente em uma sessão, a maioria dos modos de permissão permite que você o aprove uma vez para o resto da sessão, em vez de toda vez.
- Negar um prompt é uma parte normal do loop, não uma falha - o Claude Code proporá uma alternativa assim que souber que o comando foi rejeitado.
Relacionado: Como o Claude Code Decide Quando Executar um Comando vs. Pedir Permissão - o detalhamento completo dos modos de permissão
Exemplos Intermediários
8. Faça uma pequena alteração em vários arquivos em um único turno
Descrição de uma linha: renomeie ou estenda algo que tenha locais de chamada em mais de um arquivo, tudo em um único turno.
> Rename calculateOrderTotal to calculateCartTotal everywhere it's defined
and used, and update the import in checkout.ts.- O Claude Code coordena a edição em todos os arquivos afetados em um único turno, mantendo a definição da função, suas exportações e seus locais de chamada consistentes.
- Ele relê cada arquivo logo antes de editá-lo, a mesma verificação de desatualização do exemplo 6, aplicada arquivo por arquivo em todo o conjunto.
- Após as edições serem aplicadas, execute novamente a etapa de verificação do loop - uma passagem de lint e os testes relevantes - para capturar qualquer local de chamada que a busca perdeu.
- Alterações em vários arquivos são exatamente onde uma busca estreita e bem definida (exemplo 1) compensa - uma busca incompleta aqui significa um renomeio incompleto.
Relacionado: Fazendo Edições em Vários Arquivos em um Único Turno do Claude Code - uma análise mais aprofundada desse padrão
9. Execute a suíte de testes e itere em uma falha
Descrição de uma linha: deixe o Claude Code executar a suíte completa, ler uma falha e corrigi-la sem que você precise relatar o stack trace manualmente.
> Run the full test suite. If anything fails, look at the failure and fix it,
then re-run until it passes.FAIL src/checkout.test.ts
● applies discount before tax
expected 90 to equal 92.5- O Claude Code executa a suíte, lê a saída de falha como o trecho acima diretamente e propõe uma correção direcionada à asserção que falhou, em vez de uma reescrita ampla.
- Após a correção, ele reexecuta a suíte (ou pelo menos o arquivo com falha) automaticamente, fechando o loop em vez de parar em "Acho que isso deve funcionar".
- Isso só funciona quando o Claude Code tem permissão para executar o comando de teste - em um modo de permissão mais rigoroso, você pode precisar aprovar cada execução.
- Se uma correção fizer com que outro teste falhe, isso é um sinal útil - deixe o loop continuar em vez de reverter imediatamente.
Relacionado: Executando Testes e Iterando em Falhas Automaticamente - o padrão completo para este fluxo de trabalho
10. Estenda o loop com um servidor MCP
Descrição de uma linha: integre uma ferramenta externa, como um rastreador de issues, para que o loop possa começar a partir de um ticket em vez de uma descrição manual.
> Look up issue PROJ-482 and implement the fix it describes, then open a
linked test run once it passes.- Um servidor MCP (Model Context Protocol) conecta o Claude Code a ferramentas externas - rastreadores de issues, bancos de dados, APIs internas - para que a etapa de leitura possa começar a partir de um ticket em vez de um prompt que você digitou de memória.
- O restante do loop permanece inalterado: leia o código relevante, proponha uma edição, execute os testes, verifique o resultado - a ferramenta MCP apenas fornece contexto adicional ou executa uma ação externa.
- Cada chamada de ferramenta MCP está sujeita à mesma lógica de permissão que um comando bash ou edição de arquivo - espere um prompt na primeira vez que uma nova ferramenta for usada, dependendo do seu modo de permissão.
- Comece com um servidor MCP para um fluxo de trabalho (como a busca de tickets) antes de conectar vários - é mais fácil confiar na saída do loop quando você sabe exatamente quais ferramentas ele utilizou.
Relacionado: Conectando um Servidor MCP para Estender o Conjunto de Ferramentas do Claude Code - como configurar um | Navegando no REPL, Prompts e Comandos de Barra do Claude Code - noções básicas de REPL se você for novo no modelo de sessão
Versões da Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.