Capítulo 1Programação guiada por IA

O que mudou no desenvolvimento de software, o que é um agente de código e qual é o seu novo papel nessa história.

1.1 Uma nova era de construir software

Durante décadas, criar software exigia um caminho longo: anos aprendendo sintaxe de linguagens, decorando comandos, entendendo compiladores e frameworks — tudo isso antes de conseguir construir algo útil. Quem tinha boas ideias mas não dominava código ficava de fora, ou dependia de contratar alguém.

Isso mudou. Hoje, ferramentas como o Claude Code permitem que você descreva o que quer em português e receba de volta código funcionando, testado e organizado. A barreira deixou de ser "saber digitar código" e passou a ser saber pensar sobre software: o que construir, como dividir o problema, como avaliar se o resultado está bom.

Isso não significa que conhecimento técnico virou inútil — pelo contrário. Quem entende os conceitos por trás (o que é um banco de dados, para que serve o Git, como funciona uma API) consegue dirigir a IA com muito mais precisão e pega erros que um leigo deixaria passar. É exatamente essa a proposta deste manual: te dar o conhecimento conceitual mínimo e sólido para você ser um diretor competente, mesmo sem ser um digitador de código experiente.

1.2 O que é o Claude Code, afinal?

O Claude Code é a ferramenta oficial da Anthropic para programação com IA. A definição da documentação oficial é direta: "uma ferramenta de codificação agêntica que lê seu código, edita arquivos, executa comandos e se integra às suas ferramentas de desenvolvimento". Vamos destrinchar cada pedaço dessa frase:

Onde ele roda? Em cinco superfícies, todas ligadas ao mesmo motor — suas configurações e memórias valem em todas:

• Terminal (CLI) — a forma original e mais completa. Você digita claude numa pasta e conversa ali mesmo.
• VS Code e JetBrains — extensão dentro do editor, com visualização das mudanças lado a lado.
• Aplicativo Desktop — app próprio (Windows/macOS), ótimo para revisar mudanças visualmente e rodar várias sessões em paralelo.
• Web — em claude.ai/code, sem instalar nada; roda na nuvem da Anthropic.
• Celular — pelo app do Claude (iOS) ou pelo navegador, para acompanhar e disparar tarefas de onde estiver.

1.3 Como um agente de código funciona por dentro

Entender o "motor" do Claude Code muda a forma como você conversa com ele. O funcionamento é um ciclo — chamado de loop agêntico — que se repete até a tarefa terminar:

1. Você dá um objetivo — ex.: "adicione um formulário de contato que salva as mensagens no banco".
2. O modelo pensa e planeja — decide quais passos são necessários e em que ordem.
3. Ele usa ferramentas — cada passo vira uma ação concreta: ler um arquivo, editar código, rodar um comando, buscar na web.
4. Ele observa o resultado — leu o erro do teste? Ajusta o código. O comando funcionou? Segue para o próximo passo.
5. Repete até concluir — e então te apresenta um resumo do que fez.

Um exemplo real de como isso aparece na tela (simplificado):

Repare nos nomes em negrito: Read, Grep, Edit, Bash. São as ferramentas (tools) do Claude Code — as "mãos" do agente. As principais:

1.4 Seu novo papel: de digitador a diretor

Se a IA escreve o código, o que sobra para você? Tudo o que realmente importa. Pense num diretor de cinema: ele não opera a câmera nem edita cada cena, mas sem ele o filme não existe. Suas quatro funções principais:

1. Definir o quê e o porquê

Ninguém sabe melhor que você o problema que seu software resolve. Transformar uma ideia vaga ("quero um app de finanças") em requisitos claros ("o usuário registra gastos por categoria e vê um resumo mensal") é a habilidade mais valiosa do desenvolvimento guiado por IA. É por isso que metodologias de entrevista estruturada (como um bom PRD) valem ouro antes de qualquer linha de código.

2. Dividir o problema

Pedidos gigantes ("construa o sistema inteiro") geram resultados medianos. Pedidos bem fatiados ("primeiro o cadastro de usuário; depois o login; depois o painel") geram excelência. Você é quem fatia.

3. Revisar e questionar

Você não precisa entender cada linha, mas precisa entender o comportamento: clicou, funcionou? O dado salvou? E se o usuário digitar algo errado? Pedir ao Claude que explique o que fez ("me explique essa mudança como se eu fosse iniciante") é uma prática legítima e recomendada.

4. Decidir

Banco de dados A ou B? Publicar agora ou testar mais? Aceitar essa mudança ou pedir outro caminho? A IA apresenta opções com prós e contras; a decisão final — e a responsabilidade — são suas.

1.5 O que a IA faz bem — e onde ela erra

Confiança calibrada é a marca do bom diretor. O Claude Code (especialmente com modelos de ponta como o Fable 5) é excelente em:

• Escrever código novo a partir de descrições claras, seguindo padrões do seu projeto;
• Encontrar e corrigir bugs a partir de mensagens de erro (cole o erro inteiro — ele adora);
• Explicar código existente em linguagem simples, no nível de detalhe que você pedir;
• Tarefas repetitivas e chatas: renomear coisas em 40 arquivos, escrever testes, atualizar dependências, escrever documentação;
• Trabalhar com ferramentas: Git, terminal, banco de dados — coisas que intimidam iniciantes são triviais para ele.

E onde mora o perigo:

• Ambiguidade — se o pedido permite duas interpretações, ele escolhe uma. Pode não ser a sua. Quanto mais específico o pedido, melhor o resultado.
• Alucinação — em situações raras, o modelo pode afirmar algo com confiança e estar errado (ex.: usar uma função de biblioteca que não existe naquela versão). Antídoto: pedir que ele rode e verifique em vez de só escrever.
• Escopo que cresce sozinho — às vezes ele "aproveita" para melhorar coisas que você não pediu. Bom em geral, mas revise o resumo do que foi feito.
• Decisões de negócio — ele não sabe seu orçamento, seu prazo nem seu cliente. Não delegue o que é seu.

1.6 "Vibe coding" vs. desenvolvimento guiado por IA

Você talvez já tenha ouvido o termo vibe coding: programar aceitando tudo o que a IA sugere, sem ler nem entender, "na vibe". Para protótipos descartáveis e experimentos de fim de semana, é divertido e válido. Para qualquer coisa que vá ao ar com usuários e dados reais, é receita de dor: bugs invisíveis, falhas de segurança e um código que ninguém — nem você, nem a IA em sessões futuras — consegue evoluir com confiança.

O caminho profissional, que este manual ensina, adiciona três disciplinas ao processo:

1. Planejar antes de codar — usar o modo de planejamento do Claude Code (Capítulo 5) e documentos de requisitos para alinhar expectativas antes de qualquer edição;
2. Verificar depois de codar — testes, execução real, revisão de código (o Claude Code tem até revisão automatizada embutida);
3. Versionar sempre — cada avanço vira um commit no Git, criando pontos de restauração para quando algo der errado (Capítulo 7).

1.7 O ciclo de vida de um projeto — o mapa deste manual

Todo projeto de software passa pelas mesmas etapas. Veja o ciclo e onde cada capítulo deste manual te apoia:

Prefere conhecer melhor antes? Veja o que vem no manual completo.