GUIA PRÁTICO PARA DESENVOLVEDORES
Como Usar Claude no Desenvolvimento: Claude Code, a API e Fluxos de Agentes
O terminal é o novo IDE, e o diff continua sendo a unidade de confiança.
Os desenvolvedores usam o Claude da Anthropic de três formas distintas: como parceiro de chat para planejamento e revisão, como Claude Code rodando diretamente no terminal, e como o modelo por trás dos seus próprios produtos com tecnologia de API. Esta página percorre como usar Claude no desenvolvimento em cada um desses modos, com prompts reais para revisão de código, escrita de testes e uso de ferramentas, além dos hábitos que mantêm o código escrito por IA seguro antes de chegar à produção.
Como usar Claude no desenvolvimento se resume a três superfícies: a interface de chat do Claude AI para planejamento e revisão de código, o Claude Code para desenvolvimento agêntico nativo de terminal que lê o seu repositório e edita arquivos diretamente, e a API da Anthropic para construir uso de ferramentas e fluxos de agentes nos seus próprios produtos. A maioria dos desenvolvedores começa no chat, move a edição e os testes repetitivos para o Claude Code, e recorre à API quando está lançando um recurso com Claude. Os hábitos que mantêm o código gerado por IA seguro são os mesmos que mantêm qualquer código seguro: diffs pequenos, testes e revisão antes do merge.
Publicado em · Última revisão
Aula grátis · sem precisar de contaAs Três Formas de Usar ClaudeOs Três Modos5 minComeçar a aula grátisPrincipais pontos
- Claude para desenvolvedores abrange três superfícies: chat para planejamento e revisão de código, Claude Code para trabalho no terminal, e a API da Anthropic para construir os seus próprios recursos de uso de ferramentas e agentes.
- O Claude Code lê o seu repositório, edita arquivos em toda a base de código, executa a sua suíte de testes e pode até commitar as mudanças, tudo a partir de uma sessão normal de terminal.
- O uso de ferramentas permite que o Claude chame funções que você define, para que ele possa consultar um banco de dados, acessar uma API interna ou executar um script como parte da resposta a uma solicitação.
- A revisão de código funciona melhor quando você aponta o Claude para um diff específico e um padrão específico a verificar, não um vago 'dá uma olhada no meu código'.
- O Claude pode escrever e executar testes, mas o hábito que mantém o código gerado seguro é o mesmo que mantém o código de qualquer colaborador seguro: diffs pequenos, uma suíte de testes passando e revisão humana antes do merge.
- Comece com um arquivo CLAUDE.md: uma espinha dorsal curta do projeto que conta ao Claude a sua stack, os comandos e as convenções, para que ele pare de adivinhar.
Claude AI vs. Claude Code vs. a API da Anthropic
| Superfície | Melhor para | Onde roda |
|---|---|---|
| Claude AI (chat) | Planejamento, discussões de arquitetura, revisão de um diff ou stack trace colado | Navegador ou aplicativo desktop |
| Claude Code | Edições em vários arquivos, execução da sua suíte de testes, trabalho autônomo diretamente no seu repositório | Seu terminal, dentro do diretório do projeto |
| API da Anthropic | Construir um recurso ou agente com Claude dentro do seu próprio produto, usando uso de ferramentas | O código da sua aplicação, chamado via HTTPS |
Copie e cole
Prompts para usar hoje mesmo
Revisar o diff de um pull request com base em um padrão específico
Você está revisando o diff de um pull request de um serviço Python com FastAPI. Verifique especificamente o risco de SQL injection, a falta de validação de entrada nos corpos das requisições e quaisquer consultas ao banco de dados que não estejam parametrizadas. Liste cada problema com o arquivo e a linha, explique por que é um problema e sugira a correção. Não comente sobre formatação ou estilo.
Troque a linguagem, o framework e os riscos específicos que você quer sinalizar pela sua própria stack.
Escrever testes que sigam o seu estilo atual
Olhe os testes existentes em tests/test_orders.py e siga exatamente a mesma estrutura, fixtures e convenções de nomenclatura. Escreva testes unitários para a nova função refund_order em orders/service.py, cobrindo um reembolso bem-sucedido, uma tentativa de reembolso em um pedido já reembolsado e um reembolso que excede o valor original cobrado. Use pytest e os padrões de mock já existentes.
Aponte para o seu arquivo de teste real e o framework usado, seja pytest, Jest ou Vitest.
Depurar um teste instável com contexto completo
Este teste está falhando de forma intermitente no CI, mas passa localmente: [cole o nome do teste e o erro]. Aqui está o arquivo de teste, a função que ele exercita e os últimos três logs de falha do CI. Percorra as possíveis causas da instabilidade antes de propor uma correção, e me diga explicitamente sobre o que você ainda está incerto.
Cole os logs reais e o conteúdo dos arquivos em vez de descrever o bug de memória.
Projetar uma função de uso de ferramentas para a API da Anthropic
Estou construindo um agente com a API da Anthropic que precisa consultar o status do pedido de um cliente na nossa API REST interna. Rascunhe a definição da ferramenta, incluindo o JSON schema para os parâmetros de entrada, e me mostre o código Python que trata o bloco tool_use resultante e envia um tool_result de volta para o Claude.
Substitua a API interna e os parâmetros pelo formato do seu próprio serviço.
Rascunhar um CLAUDE.md para um novo projeto
Leia o package.json, o README e a estrutura de pastas deste repositório, depois rascunhe um arquivo CLAUDE.md documentando a nossa stack de tecnologia, os comandos para executar os testes e o servidor de desenvolvimento, as nossas convenções de nomenclatura para rotas de API e qualquer outra coisa que um novo colaborador precise saber antes de fazer a primeira alteração.
Execute isso uma vez no início de um projeto e depois atualize sempre que as convenções mudarem.
Planejar uma refatoração em vários arquivos antes de tocar no código
Quero extrair a lógica de pagamento que hoje está espalhada em três controllers para uma única classe PaymentService. Antes de escrever qualquer código, liste todos os arquivos que atualmente contêm lógica de pagamento, proponha os métodos públicos da nova classe e sinalize quaisquer diferenças de comportamento entre as três implementações atuais que a refatoração precisa preservar.
Peça o plano primeiro em qualquer mudança que afete mais de dois ou três arquivos.
Comece Aqui
As lições gratuitas que todo desenvolvedor deveria começar com
Três lições curtas levam você de simplesmente saber que o Claude existe até rodar uma sessão real do Claude Code com uma espinha dorsal de projeto já configurada, o suficiente para começar a usá-lo em trabalho real no mesmo dia.
As Três Superfícies
Como os Desenvolvedores Realmente Usam Claude
Claude para desenvolvedores não é uma ferramenta só. São três, e saber qual delas serve para a tarefa que você tem na frente é a maior parte da habilidade.
Chat do Claude AI
Bom para discussões de arquitetura, revisão de um diff ou mensagem de erro colado, e para pensar em um design antes de começar a escrever código.
Claude Code
Um agente nativo de terminal que lê o seu repositório, edita arquivos em toda a base de código, executa a sua suíte de testes e pode até commitar as mudanças, a seu comando.
API da Anthropic
O modelo mais o uso de ferramentas, para incorporar o Claude ao seu próprio produto: um bot de suporte que consulta o seu banco de dados, um assistente dentro da IDE, ou um pipeline que roda sem supervisão.
Fluxos de trabalho com agentes
Combine o uso de ferramentas com um loop: o Claude decide qual ferramenta chamar, lê o resultado e decide o próximo passo, repetindo até a tarefa estar concluída.
Claude Code
O que é o Claude Code e como começar a usá-lo?
O Claude Code é a ferramenta de linha de comando da Anthropic para trabalhar com o Claude diretamente dentro da sua base de código. Em vez de copiar código para uma janela de chat e colar a resposta de volta, você o executa a partir do diretório do seu projeto, e ele lê os seus arquivos, o seu histórico do git e a sua configuração de testes como contexto para o que você pedir.
Uma sessão típica funciona assim: você abre um terminal no seu repositório, inicia o Claude Code e descreve uma tarefa em linguagem simples, como adicionar rate limiting aos seus endpoints POST. Ele lê os arquivos relevantes, propõe e aplica as edições em quantos arquivos a mudança afetar, executa a sua suíte de testes e relata o que foi alterado e se os testes passaram.
O que diferencia o Claude Code de um plugin de editor é que ele opera sobre a tarefa inteira, não apenas a próxima linha. Ele pode planejar uma mudança em várias etapas, executar cada etapa, notar quando um teste falha e tentar uma correção, tudo dentro de uma única instrução sua. Você permanece no controle lendo o plano antes de ele ser executado e revisando o diff antes de fazer o commit.
A primeira coisa que vale configurar é um arquivo CLAUDE.md na raiz do seu projeto. É um arquivo curto, em linguagem simples, que conta ao Claude a sua stack, os comandos de build e teste, as suas convenções de nomenclatura e qualquer outra coisa que um novo colaborador precisaria saber no primeiro dia. Uma vez que ele existe, o Claude Code o lê automaticamente no início de cada sessão, em vez de ficar adivinhando.
Trabalho Real
Fluxos de Trabalho que Desenvolvedores Estão Rodando Esta Semana
Revisão de código focada em segurança
Aponte o Claude para um diff e uma classe específica de risco (bypass de autenticação, injection, entrada não validada) em vez de pedir uma revisão genérica.
Escrevendo e executando testes
O Claude lê os seus padrões de teste e framework existentes, escreve testes que seguem o seu estilo, executa-os e itera sobre as falhas.
Refatoração em vários arquivos
Para qualquer coisa que afete mais do que alguns arquivos, peça um plano primeiro: quais arquivos mudam, como fica a nova estrutura, e qual comportamento não pode mudar.
Depurando um bug difícil de reproduzir
Alimente-o com o teste que está falhando, a função testada e os logs reais da falha, e depois peça para ele raciocinar sobre as causas antes de propor uma correção.
Se orientando em uma base de código desconhecida
Peça ao Claude para rastrear uma requisição pela base de código e explicar o fluxo, o que costuma ser mais rápido do que ler o código do zero.
A API da Anthropic
Uso de ferramentas, agentes e como construir com a API da Anthropic
A API da Anthropic é como você coloca o Claude dentro do seu próprio produto, em vez de usá-lo por uma janela de chat. Você envia uma requisição com o seu prompt e recebe uma resposta de volta, no mesmo formato de qualquer API HTTP, o que significa que ela se encaixa em qualquer stack de backend que você já use, seja um serviço em Python, uma aplicação em Node, ou outra coisa completamente diferente.
O uso de ferramentas é o recurso que transforma uma simples chamada de requisição-resposta em algo mais próximo de um agente. Você descreve as ferramentas às quais o Claude tem acesso, cada uma sendo uma função com um nome, uma descrição e um JSON schema para as suas entradas, como uma função lookup_order que recebe um ID de pedido. Quando o Claude decide que precisa dessa ferramenta para responder a uma pergunta, ele retorna um bloco tool_use em vez de uma resposta simples. O seu código executa a chamada de função real, seja o que isso significar para o seu sistema, uma consulta ao banco de dados, uma chamada de API, um script, e envia o resultado de volta ao Claude como um tool_result. O Claude lê esse resultado e continua.
Um agente, no sentido prático, é apenas esse loop executado mais de uma vez: o Claude escolhe uma ferramenta, você a executa, o Claude lê o resultado e escolhe a próxima, até a tarefa estar concluída ou ele ter informação suficiente para responder. O Model Context Protocol é um padrão para descrever essas ferramentas e conexões de forma consistente, de modo que as mesmas definições de ferramentas funcionem em diferentes clientes, em vez de serem montadas do zero para cada projeto.
O streaming é a outra peça que vale conhecer: em vez de esperar pela resposta completa, a API pode enviar os tokens de volta conforme são gerados, o que é o que faz as interfaces de chat e as sugestões de código em tempo real parecerem responsivas em vez de lentas.
Mantendo Tudo Seguro
Como Manter Seguras as Mudanças de Código do Claude
Nada aqui é específico de IA. É a mesma disciplina que mantém o código de qualquer colaborador seguro, aplicada de forma consistente.
Mantenha os diffs pequenos
Peça uma mudança por vez. Um diff de cinco arquivos é revisável em dez minutos; um diff de cinquenta arquivos acaba sendo aprovado sem revisão de fato, que é exatamente quando os bugs passam.
Testes antes do merge, não depois
Peça ao Claude para escrever ou atualizar os testes como parte da mesma tarefa, e exija que eles passem antes de considerar o diff concluído.
Leia o diff você mesmo
O Claude pode explicar o que mudou e por quê, mas quem faz o commit do código ainda é o responsável por tê-lo realmente lido.
Nunca cole segredos em um prompt
Chaves de API, credenciais e dados de clientes não têm lugar no histórico de chat ou em sessões do Claude Code, do mesmo jeito que não teriam em uma mensagem no Slack.
Ensine as suas convenções uma vez
Um arquivo CLAUDE.md com a sua stack, comandos e guia de estilo reduz as correções de ida e volta que consomem uma sessão.
Por Onde Começar
O caminho inicial para desenvolvedores
Se você é novo em usar o Claude como desenvolvedor, o caminho mais rápido são três lições curtas, em ordem. Comece com As Três Formas de Usar Claude, no curso Os Três Modos, que apresenta a mesma distinção entre chat, Claude Code e API abordada acima, para que você saiba qual superfície usar antes mesmo de abrir um terminal.
A partir daí, avance para Claude Code: Construa com Palavras, também no curso Os Três Modos. A lição mostra como é uma sessão real do Claude Code: descrever uma tarefa em linguagem simples, observá-lo ler o seu repositório e aplicar as edições, e revisar o resultado antes de publicar.
A terceira parada é CLAUDE.md: a espinha dorsal do seu projeto, do curso A Configuração do Profissional. É aqui que você aprende a escrever o arquivo que impede o Claude de ficar adivinhando de novo a sua stack, os seus comandos e as suas convenções em cada sessão, o que é o único hábito que torna toda sessão seguinte mais rápida.
Depois dessas três, o restante do curso A Configuração do Profissional cobre hooks e automação, conectar o Claude à sua stack através de servidores MCP, e construir uma rotina semanal de operador, que é onde o lado de hábito diário de usar o Claude como desenvolvedor realmente se acumula.
Limites
O que o Claude erra, e onde a responsabilidade continua sendo sua
O Claude pode estar errado com confiança. Ele pode propor uma correção que passa nos testes que você deu, mas que deixa passar um caso extremo que você não pensou em testar, ou usar uma função de biblioteca que não existe. Trate a saída dele como um primeiro rascunho forte, de um colaborador rápido e bem informado, não como uma decisão já tomada.
O código gerado precisa da mesma revisão de segurança que o código escrito por humanos, e possivelmente de mais atenção nas primeiras vezes que vocês trabalham juntos, até você calibrar onde ele costuma errar na sua base de código específica. Não pule uma revisão focada em segurança em nada que toque autenticação, pagamentos ou dados de usuários só porque saiu de uma ferramenta que escreve código fluente.
Código-fonte confidencial, dados de clientes e credenciais não deveriam entrar em nenhuma ferramenta de IA sem antes verificar a política da sua organização. Se você trabalha em algum lugar com uma política de tratamento de dados ou uma obrigação de confidencialidade com clientes, essa obrigação não muda só porque quem revisa é um modelo em vez de uma pessoa.
Por fim, autonomia é um controle gradual, não um botão de ligar e desligar. O Claude Code pode executar testes e até fazer commits por conta própria, se você permitir, mas o hábito profissional é manter uma etapa de revisão humana antes de qualquer coisa chegar a uma branch compartilhada ou à produção, o mesmo filtro que você gostaria de ter no primeiro mês de pull requests de um novo contratado.
Comece a lição gratuita que explica as três formas de usar o Claude
Ler sobre como usar o Claude no desenvolvimento e realmente rodar o Claude Code no seu próprio terminal são coisas diferentes. O currículo da Nightschool AI é prático desde a primeira lição, começando com a mesma distinção entre chat, Claude Code e API abordada nesta página.
Perguntas frequentes
Como os desenvolvedores usam o Claude?
Os desenvolvedores costumam usar o Claude em três superfícies: a interface de chat do Claude AI para planejamento, discussões de design e revisão de código colado; o Claude Code para trabalho nativo de terminal, onde o Claude lê e edita um repositório real; e a API da Anthropic para incorporar o Claude, incluindo uso de ferramentas e loops de agente, aos seus próprios produtos.
O que é o Claude Code e como eu começo a usá-lo?
O Claude Code é uma ferramenta de linha de comando que roda o Claude diretamente dentro do seu projeto. Você o inicia a partir do diretório raiz do seu repositório e descreve uma tarefa em linguagem simples; ele lê os seus arquivos e o CLAUDE.md, faz as edições, executa os seus testes e relata o resultado. Configurar um arquivo CLAUDE.md antes, descrevendo a sua stack e os seus comandos, torna as primeiras sessões muito mais precisas.
O Claude é bom para revisão de código?
Sim, especialmente quando você dá a ele um diff específico e um padrão específico para verificar, como problemas de segurança, falta de validação de entrada, ou aderência às convenções da sua equipe. Ele é muito mais forte quando é pedido para verificar algo concreto do que quando recebe um vago 'revise meu código', da mesma forma que um revisor humano faz um trabalho melhor com critérios de revisão claros.
Como eu uso a API da Anthropic?
Você envia uma requisição HTTP com o seu prompt e recebe uma resposta em texto de volta, no mesmo formato de qualquer chamada de API, que você pode fazer a partir de Python, Node, ou qualquer backend que você use. Para construir algo além de uma única pergunta e resposta, você adiciona o uso de ferramentas, dando ao Claude funções que ele pode chamar, e trata a troca resultante de tool_use e tool_result no seu próprio código.
O que é uso de ferramentas no Claude?
O uso de ferramentas permite que você descreva funções que o Claude pode chamar, como consultar um pedido ou fazer uma consulta ao banco de dados, cada uma com um nome e um JSON schema para as suas entradas. Quando o Claude decide que uma ferramenta é necessária, ele retorna uma requisição tool_use em vez de uma resposta simples; o seu código executa a função real e envia o resultado de volta para que o Claude continue, o que é a base da maioria dos fluxos de trabalho com agentes.
O Claude consegue escrever testes para o meu código?
Sim. O Claude pode ler os seus padrões de teste e framework existentes, seja pytest, Jest ou Vitest, e escrever testes unitários, de integração ou end-to-end que sigam o seu estilo. No Claude Code, ele também pode executar os testes que escreve e corrigir as falhas iterativamente, em vez de entregar testes que você depois precisa depurar sozinho.
Como eu mantenho seguras as mudanças de código do Claude?
Mantenha a mesma disciplina que você esperaria de qualquer colaborador: peça diffs pequenos em vez de mudanças abrangentes, exija testes passando antes de qualquer merge, leia o diff você mesmo antes de fazer o commit, e nunca cole segredos ou dados de clientes em um prompt. Um arquivo CLAUDE.md reduz os erros que vêm do Claude tentando adivinhar as suas convenções.
Com quais linguagens de programação o Claude funciona?
O Claude funciona com as principais linguagens, incluindo Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Ruby e PHP, e entende os padrões de frameworks comuns como React, Next.js, Django e FastAPI. O Claude Code funciona com qualquer linguagem que roda em um terminal, já que ele opera diretamente sobre os seus arquivos e comandos de shell, em vez de depender de um plugin específico de linguagem.
O Claude Code é gratuito para instalar?
O Claude Code em si é gratuito para instalar. Usá-lo exige uma chave de API da Anthropic, cobrada por token, ou um plano de assinatura do Claude que inclua acesso ao Claude Code. Não há nenhuma taxa de licença adicional além disso para a ferramenta de linha de comando.
Leituras relacionadas
Saia de ler sobre o Claude e passe a executá-lo no seu terminal
A primeira lição leva minutos; o hábito é o que compensa.