Quando ele ganha do chat, IDE e automação tradicional

Field Note

Quarta-feira, 15h. Alguém do time abriu o Claude Code para perguntar a diferença entre let e const. Na mesa ao lado, outra pessoa passou a manhã copiando arquivo por arquivo para uma janela de chat, tentando achar por que o checkout quebra só com cartão vencido. As duas usaram IA. As duas usaram a ferramenta errada. A primeira pagou caro por uma resposta de dicionário. A segunda virou a cola humana entre o chat e o repositório.

Conceito

Não existe "a melhor ferramenta de IA". Existe a ferramenta certa para o formato da tarefa. São cinco opções que vale ter na cabeça:

• Chat: pergunta e resposta. Bom para conceito, rascunho, explicação, brainstorm. O contexto é o que você cola.
• Autocomplete / IDE: sugestão inline enquanto você digita. Bom quando você já sabe o que vai escrever e quer digitar menos.
• Agente (Claude Code): lê o projeto, executa ferramentas, verifica e itera. Bom quando a tarefa exige navegar o repositório, coordenar vários arquivos e checar o resultado.
• Script / automação tradicional: mesma entrada, mesma saída, sempre. Bom para o que é repetitivo e precisa ser previsível.
• Trabalho manual: às vezes a resposta é você mesmo, cinco minutos, sem IA nenhuma.

A doc oficial descreve a diferença central assim: um assistente inline enxerga o arquivo atual, enquanto o Claude Code enxerga o projeto inteiro, busca os arquivos relevantes, faz edições coordenadas, roda testes e faz commit se você pedir.

Para decidir, quatro perguntas resolvem a maioria dos casos:

1. A resposta depende do meu código? Se não, chat.
2. Envolve mais de um arquivo ou mais de um passo? Se sim, o agente começa a ganhar.
3. Existe um jeito de verificar? Teste, build, lint, screenshot comparado. A doc de boas práticas é enfática: dar ao Claude uma verificação que ele consiga rodar é o que separa uma sessão que você precisa vigiar de uma que você pode deixar andando.
4. Vai se repetir igual? Se é toda vez do mesmo jeito, vira script, hook (comando que roda automaticamente em um evento do Claude Code) ou execução não interativa com claude -p.

Tem também a divisão por modo de uso dentro do próprio Claude Code:

• Exploração: entender código, mapear dependências, responder "onde isso acontece?". Plan mode é o lugar certo.
• Execução: implementar, corrigir, refatorar com verificação.
• Automação recorrente: o mesmo pedido rodando em CI, em agenda ou num pipeline, com claude -p "..." ou tarefas agendadas.

E um limite que a própria doc reconhece: planejar tem custo. Para mudança pequena e de escopo claro (corrigir um typo, adicionar uma linha de log, renomear variável), peça direto. A regra prática da documentação é boa: se você consegue descrever o diff em uma frase, pule o plano.

Quando usar

• Bug que atravessa camadas e precisa de reprodução, leitura de log e teste.
• Entrar num repositório desconhecido e entender a arquitetura antes de tocar.
• Mudança que mexe em vários arquivos com o mesmo padrão (migrar uma API, padronizar tratamento de erro).
• Escrever testes para código que não tem teste, rodando e corrigindo até passar.
• Tarefas de git: preparar commit com mensagem decente, criar branch, resolver conflito.

Quando não usar

• Pergunta de conceito ou de sintaxe. Chat responde mais rápido e com menos custo.
• Você já sabe exatamente a linha que vai escrever. Autocomplete ou o teclado mesmo.
• A tarefa precisa dar o mesmo resultado todo dia, sem interpretação. Script ou hook. A doc diferencia bem: instrução no CLAUDE.md é pedido, hook é garantia.
• Decisão de negócio, de produto ou de pessoas que depende de contexto que não está no repositório.
• Ambiente sensível onde você não configurou permissão nem tem como reverter.

Faça agora

A prática é classificar dez tarefas reais da sua semana.

1. Liste dez tarefas que você fez ou vai fazer nos próximos dias. Precisam ser reais, não exemplos de curso. Misture coisas técnicas e não técnicas se o seu trabalho for misturado.
2. Para cada uma, responda as quatro perguntas: depende do meu código? Mais de um arquivo ou passo? Dá para verificar? Vai se repetir igual?
3. Classifique em uma destas colunas: Chat, IDE/autocomplete, Claude Code, Script/automação, Manual.
4. Escreva uma justificativa de uma linha. "Porque sim" não vale.
5. Pegue a tarefa que você marcou como Claude Code e que parece mais simples. Se você consegue descrever o diff em uma frase, anote que ela vai direto, sem plan mode.
6. Guarde a matriz. Ela vira referência quando bater a dúvida "abro o terminal ou o chat?".

Um formato que funciona:

| # | Tarefa                                | Ferramenta   | Por quê                                      |
| 1 | Entender módulo de pagamentos legado  | Claude Code  | Vários arquivos, preciso de mapa e testes    |
| 2 | Explicar o que é OAuth para o time    | Chat         | Conceito, não depende do repo                |
| 3 | Rodar lint antes de todo commit       | Script/hook  | Repetitivo e precisa ser garantido           |

Armadilhas

• Agente para tudo. Sessão de agente carrega contexto do projeto, ferramentas e raciocínio em várias etapas. Para pergunta simples, é canhão para matar mosquito, e o consumo acompanha.
• Chat para tarefa de repositório. Você vira o transportador de contexto: copia, cola, copia o erro, cola de novo. O agente faria isso sozinho e com menos erro de transcrição.
• Sessão "pia da cozinha". Começa numa tarefa, pula para outra, volta para a primeira. A doc chama esse padrão de kitchen sink session e a correção é simples: /clear entre tarefas que não têm relação.
• Achar que automação recorrente precisa de conversa. Se o pedido é sempre o mesmo, ele cabe num claude -p dentro de um script, ou num hook. Não precisa de você digitando toda manhã.
• Esquecer da opção manual. Às vezes o tempo de explicar é maior que o tempo de fazer.

Material para levar

As quatro perguntas, para colar no monitor:

1. A resposta depende do meu código?          Não → Chat
2. Mais de um arquivo ou mais de um passo?    Sim → Claude Code ganha força
3. Dá para verificar (teste, build, lint)?    Não → crie a verificação antes
4. Vai se repetir sempre igual?               Sim → script, hook ou claude -p

Regras de bolso:

• Diff cabe numa frase: pede direto, sem plano.
• Diff não cabe numa frase: plan mode primeiro.
• Tem que acontecer sempre, sem exceção: hook, não instrução.
• Tarefas sem relação: /clear entre elas.
• Não sabe o que quer: chat para pensar, agente para executar.