Claude Code: programar pelo terminal

Eu não sou desenvolvedor. Sou gestor de mídia que aprendeu a ler código por necessidade. Mesmo assim, o Claude Code virou minha ferramenta de automação: ele lê o repositório inteiro, entende como os scripts se conectam, propõe a mudança, aplica e roda o teste enquanto eu leio o diff. O que eu levava uma noite para fazer no braço sai em uma conversa.

Este guia explica o que ele é, como é o fluxo de trabalho, o que muda em relação a pedir código no chat, os cuidados e por que o arquivo de instruções do projeto é o que decide se ele acerta ou erra.

O que é o Claude Code

É o modo agente do Claude para programação, que roda no terminal, no editor ou no aplicativo de desktop. Em vez de você colar trechos de código no chat, ele acessa a pasta do projeto, lê os arquivos que precisa, executa comandos e edita o código diretamente, sempre pedindo sua aprovação para ações com efeito.

A diferença de categoria é essa: no chat, você é o mensageiro entre a IA e o código. No Claude Code, a IA está dentro do projeto e você é o revisor.

O fluxo de trabalho típico

Você descreve a tarefa ("o relatório semanal precisa incluir a coluna de conversões assistidas"). Ele explora o código para entender onde isso mora, apresenta um plano, aplica as mudanças arquivo por arquivo, roda os testes e mostra o resultado. Você lê o diff, aprova ou pede ajuste, e faz o commit.

Para tarefas maiores, ele mantém uma lista de passos e vai marcando o que concluiu. Quando trava, pergunta em vez de inventar, se as instruções do projeto mandarem isso.

O arquivo de instruções do projeto

Chama-se CLAUDE.md e fica na raiz do repositório. É lido no início de toda sessão. Coloque ali o que um desenvolvedor novo precisaria saber no primeiro dia: como rodar o projeto, onde ficam as coisas, convenções de nome, o que nunca fazer (não commitar chaves, não alterar a pasta X sem avisar), como rodar os testes.

É o fator que mais muda a qualidade. Sem ele, o agente adivinha as convenções e erra com frequência. Com ele, as correções caem pela metade na minha experiência.

Tarefas pequenas e verificáveis

Uma mudança por pedido, com um jeito de verificar (um teste, um comando, um resultado esperado). Pedidos grandes geram diffs grandes que ninguém consegue revisar, e diff que ninguém revisa é bug em produção.

O que ele faz bem

Scripts de automação, integrações com APIs, refatorações mecânicas, testes, documentação, correção de bugs com mensagem de erro clara, migração de código entre versões. Também é ótimo para entender um projeto que você herdou: pergunte "como esse sistema calcula o ROAS?" e ele lê e explica com referência aos arquivos.

O que exige cuidado

Ele pode executar comandos, então revise o que aprova. Nunca dê acesso a chaves de produção sem necessidade; use variáveis de ambiente e um ambiente de teste. Código gerado para segurança, pagamento e dados pessoais precisa de revisão de alguém que entende do assunto, mesmo que os testes passem. E cuidado com tarefas ambíguas: ele tende a escolher uma interpretação e seguir; se a tarefa tem duas leituras, diga qual é.

Chat, editor com IA ou Claude Code: quando usar cada um

No chat, você cola trechos e recebe trechos; serve para dúvidas pontuais e scripts de uma tela. Editores com IA (Cursor e similares) trazem o agente para dentro do editor visual, com diff lado a lado; servem bem para quem já programa e quer ver cada mudança. O Claude Code é para tarefas longas e multiarquivo, com o agente explorando o projeto sozinho.

Na prática, uso os três: chat para perguntar, Claude Code para executar, editor para ler o resultado com calma. A escolha depende menos da ferramenta e mais do tamanho da tarefa e de quanto você quer acompanhar cada passo.

Preciso saber programar?

Precisa saber ler e testar. Sem isso você aprova diffs que não entende, e o risco vai para o código que roda sozinho de madrugada. O caminho que funcionou para mim: comecei com scripts pequenos que eu conseguia ler inteiros, perguntava o que cada trecho fazia, e fui aumentando o tamanho das tarefas conforme entendia mais. Seis meses depois, mantenho uma dúzia de automações que não existiriam sem isso.

Perguntas frequentes

Fontes e método

• Documentação do Claude Code (Anthropic)
• Automações mantidas em repositório próprio desde 2025