Curso
Claude Code 101
3 h
28.3K
Usar a API do Claude da Anthropic permite ir muito além de apenas conversar com um chatbot. Você ganha o poder de integrar todos os recursos da IA Claude nos seus aplicativos.
A Anthropic surpreendeu o mundo da IA com o lançamento do Fable 5, um modelo tão poderoso que levou o governo dos EUA a restringir temporariamente o acesso pouco depois do lançamento. Embora o acesso tenha sido restabelecido para usuários no mundo todo, a forma de acessá-lo mudou.
Agora, a Anthropic está restringindo o Fable 5 exclusivamente ao acesso via API com créditos de uso medido (com o corte entrando em vigor após uma breve extensão de cinco dias).
Isso significa que precisamos repensar como interagimos com a IA. Modelos potentes e ferramentas de codificação autônoma exigem muito mais recursos computacionais do que planos de consumo com tarifa fixa conseguem oferecer.
Neste tutorial, vou preparar você para essa nova realidade mostrando como usar a API do Claude.
Vou ensinar exatamente como configurar o Claude Code com a Anthropic Developer API. Ao migrar hoje para o modelo de pagamento conforme o uso, você garante acesso ininterrupto a modelos de ponta como o Fable 5, elimina limites invisíveis de taxa e aprende a executar sessões complexas de codificação direto do seu terminal.
Se você quer um guia rápido de referência, recomendo conferir o cheat sheet da API do Claude em Python.
Por que você precisa da API do Claude em vez da assinatura Claude Pro
Para muita gente, o plano Claude Pro de US$ 20 mensais era a forma ideal de acessar IA de alto nível. Preço fixo e acesso estável.
No entanto, a ascensão das ferramentas de codificação automatizada mudou completamente essa conta. Workflows agentizados exigem muito mais recursos do que uma assinatura padrão consegue oferecer, tornando a API do Claude a única opção viável para desenvolvedores sérios.
Abaixo estão três motivos principais para abandonar a assinatura e usar o Claude Code direto pela API.
Exaustão de tokens com ferramentas agentizadas
Planos padrão sofrem para acompanhar ferramentas como o Claude Code por causa de como elas funcionam.
Diferente de um chat na web, uma ferramenta de desenvolvimento automatizada precisa escanear constantemente todo o projeto para entender no que está trabalhando.
Sempre que damos uma tarefa, ela passa por várias etapas: lê arquivos, checa estruturas e executa testes. Isso exige enviar uma grande quantidade de dados de um lado para o outro para manter a IA atualizada sobre o estado do código.
Esse processo consome tokens muito rápido. Em uma assinatura Pro, esses workflows complexos podem esgotar nosso limite de uso de várias horas em poucos minutos, interrompendo o trabalho de repente.
Protegendo sua capacidade diária de uso
Contas Claude Pro usam um pool de recursos compartilhado. Se usamos nossa conta principal para codificação via terminal, essas tarefas pesadas vão reduzir a capacidade disponível no navegador ou no app móvel.
Ninguém quer ficar sem poder ter uma conversa simples porque uma tarefa de codificação em segundo plano estourou o limite. Direcionar suas ferramentas de desenvolvimento pela API do Claude mantém seu trabalho profissional de código totalmente separado do uso cotidiano de IA.
Acesso exclusivo a modelos de alta performance
À medida que a Anthropic lança modelos feitos especificamente para engenharia pesada e trabalho autônomo, como o Claude Fable 5, ela está se afastando de planos com tarifa fixa.
Como o Fable 5 exige poder computacional imenso, a Anthropic confirmou que esse modelo, em específico, eventualmente exigirá cobrança por uso para gerenciar os altos custos operacionais.
Essa restrição é um aperitivo do futuro. Ficar preso a uma assinatura para consumidores significa, com o tempo, perder acesso aos mecanismos de raciocínio mais poderosos da Anthropic, tornando a conta da API do Claude um requisito para se manter na fronteira da tecnologia.
API do Claude vs. assinatura do Claude
A diferença entre uma assinatura para consumidores e a API para desenvolvedores se resume a uma troca entre custos previsíveis e acesso ininterrupto.
Uma assinatura do Claude nos dá uma taxa mensal fixa.
Podemos usar intensamente por um tempo e, eventualmente, bater em um limite dinâmico de uso com base na carga dos servidores. Quando o Claude Code encontra essa parede invisível no meio do projeto, ele simplesmente para de funcionar.
Somos obrigados a esperar algumas horas até o limite ser resetado para o agente concluir o código.
A API do Claude tira as rodinhas. Não há limites de mensagens por hora, nem banda compartilhada e nem períodos de espera. Se quisermos que o Fable 5 refatore uma base de código enorme por oito horas seguidas, a API vai executar cada comando sem interrupção.
Porém, essa liberdade traz um risco importante: estouro de orçamento. Usar uma assinatura pode ser frustrante ao bater no limite, mas pelo menos sabemos exatamente quanto será a fatura no fim do mês.
Isso é especialmente perigoso com modelos caros como o Fable 5.
Gestão de custos e controle de orçamento na API do Claude
Existem duas formas de controlar o orçamento ao usar a API.
A primeira é garantir que o auto-recarregamento esteja desativado. O auto-recarregamento permite que o Claude compre créditos automaticamente quando acabarem.
Como o consumo de tokens com o Claude Code é altamente imprevisível, recomendo fortemente não ativar esse recurso.
A segunda é selecionar com cuidado qual modelo está sendo usado.
O Fable 5 é extremamente capaz de resolver tarefas complexas e implementar aplicações sofisticadas. Porém, muitas vezes é exagero para tarefas simples.
Pessoalmente, gosto de usar os modelos mais baratos e só migrar para os mais caros quando os mais baratos falham em resolver uma tarefa após várias tentativas. O modelo que eu mais uso é, na verdade, o Haiku 4.5.
Para selecionar o modelo, use o comando /model.
Configuração passo a passo da API do Claude (com Fable 5)
Se você procura um tutorial dedicado da API do Claude Fable 5, recomendo conferir nosso guia separado.
Para começar, faça login na plataforma web do Claude e configure a cobrança. Em seguida, abra um terminal e instale o Claude Code com o comando:
npm install -g @anthropic-ai/claude-codeDepois de instalado, podemos executá-lo digitando claude no terminal. Na primeira execução, ele vai pedir para configurar. Certifique-se de selecionar “API usage billing” durante a configuração:
Em algum momento, o Claude vai abrir o navegador e pedir permissão para vincular sua conta e criar uma chave de API para você. Clique em “Authorize” e a conta será vinculada automaticamente.
Com a configuração concluída, já podemos começar a criar com o Claude Code:
No meu caso, o Claude Code já está rodando com o Fable 5. Se não for o seu, podemos selecionar o modelo com o comando /model e escolher o Fable 5 no menu.
Mudar o Claude Code de assinatura para API
Para quem já usa o Claude Code com assinatura e quer mudar para cobrança por uso via API, o processo é simples.
- Faça logout com o comando
/logout. - Execute o Claude Code novamente com o comando
claudee selecione o método de login “Anthropic Console account · API usage billing”.
Se acabarmos os créditos enquanto o Claude Code está no meio da implementação de um recurso, ele vai parar e avisar para você adicionar créditos.
Depois de adicionar créditos, se o Claude ainda estiver aberto, basta pedir para continuar com um prompt e ele retoma de onde parou. Se não estiver rodando, use o comando claude --continue.
Criando um projeto real com a API do Claude
O foco deste tutorial é aprender a configurar o Claude Code com a API, e não oferecer um guia detalhado de uso do Claude Code.
Se quiser se aprofundar, recomendo se inscrever no nosso curso Claude Code 101.
Visão geral do projeto
O objetivo deste projeto é criar um app em Python que permita aos usuários localizar fotos no computador com facilidade.
Hoje em dia, tiramos muitas fotos, que acabam desorganizadas e espalhadas em vários lugares. Para mim, como fotógrafo, muitas vezes é um perrengue localizar uma foto meses depois de tê-la feito.
A ideia do app é permitir que o usuário encontre as fotos descrevendo o que há na imagem ou fornecendo uma captura de tela ou referência visual.
Esse segundo modo é especialmente útil para mim, que costumo postar meu trabalho nas redes sociais. Assim, posso tirar um print do post e encontrar o arquivo original em alta qualidade.
Poderíamos deixar o Claude Code definir a arquitetura e fazer toda a implementação. Provavelmente funcionaria muito bem.
Mas, para fins didáticos, quis definir a arquitetura eu mesmo e deixar o Claude Code focar na implementação.
Arquitetura do projeto com CLAUDE.md
Para criar esse app, eu criei um arquivo CLAUDE.md descrevendo a arquitetura do projeto.
Um arquivo CLAUDE.md é uma configuração Markdown específica do projeto que o Claude Code lê no início de cada sessão para estabelecer uma memória persistente da sua arquitetura, padrões de código e preferências de workflow.
O app tem dois componentes principais:
- Um processo de ingestão de fotos que permite ao usuário selecionar uma pasta com imagens, converter essas imagens em vetores e armazená-las em um banco de dados vetorial.
- Uma entrada multimodal que permite pesquisar no banco de dados.
Para codificar imagens em vetores, usamos o modelo CLIP. Para o banco de dados, usamos o ChromaDB, que roda localmente de graça.
A intuição por trás do funcionamento é que o CLIP é treinado para converter texto e imagens em vetores (uma representação numérica dos dados), de modo que imagens visualmente semelhantes ou com conceitos similares fiquem próximas nesse mapa, enquanto imagens sem relação fiquem mais distantes.
Quando queremos localizar uma imagem, também convertemos a consulta em um vetor de busca e usamos o ChromaDB para encontrar os vetores mais próximos desse vetor de busca.
Se quiser aprender mais sobre bancos de dados vetoriais, confira este tutorial de ChromaDB: guia passo a passo.
O prompt
Com a arquitetura do projeto especificada no arquivo CLAUDE.md, iniciei um terminal naquela pasta e dei ao Claude Code rodando o modelo Fable 5 o seguinte prompt:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. O resultado
Enviei o prompt e deixei o Claude Code trabalhar. Depois de cerca de sete minutos, terminou.
Executei o app, e ficou assim:
Enviei algumas imagens que fiz este ano e depois fui ao Instagram e tirei um print de um post meu para usar como imagem de referência.
Eu incluí de propósito toda a interface para dificultar que o app encontrasse a imagem de origem. Eis o que obtive:
Tenho que dizer: funcionou muito bem, e a interface ficou exatamente como eu imaginava. Também testei a busca por texto tentando encontrar fotos do Taipei 101, o prédio mais alto de Taiwan.
Aqui estão os resultados:
Uso de tokens da API do Claude e custos no mundo real
No total, criar este projeto custou US$ 3,65 em tokens da API. Dá para ver o detalhamento do custo de uma sessão com o comando /cost:
Curiosamente, vemos que ele também usou claude-haiku-4.5 em parte do trabalho.
Isso mostra como o Fable 5 é caro.
Uma sessão de sete minutos em um projeto em branco já nos custou US$ 3,65.
Dá para imaginar quanto custaria usar o Fable 5 em um projeto existente com centenas de arquivos de código.
Claro que, no mundo real, ao construir uma aplicação que também gera receita, esses custos devem ser avaliados de forma diferente, pois se tornam um investimento.
Recursos avançados da API do Claude que você precisa conhecer
Migrar para a API abre acesso a ferramentas que o Claude.ai não oferece: cache de prompt, processamento em lote e integração de ferramentas.
Se você usa o Claude Code, roteia grandes volumes de chamadas de API ou cria sistemas agentizados que interagem com serviços externos, esses são os recursos que mais impactam seus custos e a latência.
1. Cache de prompt (redução de custos)
O cache de prompt armazena, no servidor, partes estáticas da sua janela de contexto entre chamadas à API, para que você pare de pagar para reprocessar o mesmo conteúdo a cada requisição.
Se você trabalha com o Claude Code, provavelmente envia o mesmo contexto grande em toda chamada (um arquivo CLAUDE.md, um resumo da base de código ou um system prompt longo). Segundo a documentação de cache da Anthropic, prefixos em cache reduzem o custo de entrada em até 90% e diminuem o tempo até o primeiro token, já que o prefixo pula a reingestão.
A primeira requisição paga o preço integral de entrada. Cada chamada subsequente que acerta o mesmo prefixo em cache é cobrada na tarifa reduzida.
2. A Batch API (processamento assíncrono)
A Batch API lida com cargas de trabalho que não precisam de respostas em tempo real.
Processar 10.000 tickets de suporte, gerar documentação para uma base de código inteira ou rodar evals em um grande conjunto de testes: tudo isso é apropriado para lote. A Anthropic cobra requisições em batch a 50% do custo padrão de tokens de entrada e saída, e todo o job é enviado em uma única chamada à API, sem você precisar gerenciar uma fila.
A restrição é que jobs em batch podem levar até 24 horas para concluir, e os resultados chegam juntos, não via streaming. Isso é ótimo para pipelines offline, mas inadequado para qualquer coisa voltada ao usuário final.
3. Uso de ferramentas e o Model Context Protocol (MCP)
O uso de ferramentas (às vezes chamado de function calling) permite que o Claude invoque funções externas durante a geração e incorpore os resultados na resposta.
Você define as ferramentas disponíveis em formato de schema JSON; o Claude decide quando chamá-las, quais argumentos passar e o que fazer com a saída. Assim, o Claude pode consultar um banco de dados, chamar uma API REST ou executar um script Python sem você precisar especificar exatamente onde invocar no prompt.
O Model Context Protocol (MCP) amplia isso com uma interface de servidor padronizada: em vez de definir ferramentas por projeto, o Claude se conecta a um servidor MCP local que expõe acesso a arquivos, execução de código ou leituras de banco de dados.
A Computer Use API funciona de forma diferente. O Claude interpreta uma captura de tela e emite eventos de teclado e mouse, navegando por interfaces sem acesso programático à API do aplicativo subjacente.
Conclusão
Migrar para a API do Claude é um passo necessário para rodar ferramentas de desenvolvimento automatizadas, mas exige mudar a forma como gerenciamos nossos projetos.
O Fable 5 é, sem dúvida, um modelo excepcional para código, capaz de gerar aplicações complexas e totalmente funcionais a partir de um único prompt.
Seu poder de raciocínio transforma uma visão arquitetural em realidade funcional em minutos — nada menos que impressionante.
No entanto, usar a API do Claude para alcançar esse nível de potência tem um preço. Como modelos como o Fable 5 são caros de operar, é crucial ser estratégico na seleção do modelo.
Recomendo contar com modelos mais baratos e eficientes para tarefas rotineiras e reservar o Fable 5 para quando você encarar bloqueios reais ou desafios arquiteturais complexos que exijam raciocínio mais profundo.
Como vimos no nosso projeto, mesmo em um app relativamente simples, de um só arquivo, os custos de tokens da API podem crescer rápido. Proteja seu bolso monitorando de perto o uso e, principalmente, desativando o auto-recarregamento para garantir que uma sessão de codificação automatizada não fuja do controle do seu orçamento.
Se quiser aprender mais sobre o ecossistema do Claude, recomendo conferir nosso curso Claude 101.
