Como Usar o SDK do Agente Claude com Seu Plano Claude?

A Anthropic permitirá executar o Claude Agent SDK usando sua assinatura Claude existente a partir de 15 de junho de 2026. Antes disso, qualquer projeto com o Agent SDK exigia uma chave de API separada, com faturamento medido pay-as-you-go, além do que você já paga pelo Claude Pro ou Max. A partir dessa data, seu plano mensal Claude incluirá um saldo de crédito específico para uso do Agent SDK. Nenhuma chave de API será necessária.

Experimente o Apidog hoje

Se você queria criar um agente personalizado — por exemplo, um bot de implantação, um assistente de pesquisa ou uma ferramenta de triagem — mas não queria cadastrar um método de cobrança separado na Anthropic apenas para prototipar, esta é a mudança principal. O plano Pro passa a incluir US$ 20/mês para uso do Agent SDK. O Max 20x inclui US$ 200. Assentos Team Premium incluem US$ 100.

O que mudou em 15 de junho de 2026

O uso do Agent SDK passa a ser deduzido de um crédito mensal vinculado ao seu plano Claude. Antes, esse uso era faturado pela API da Anthropic, com saldo separado no console.

Crédito mensal por plano, conforme o anúncio da Anthropic:

Plano	Crédito mensal do Agent SDK
Pro	US$ 20
Max 5x	US$ 100
Max 20x	US$ 200
Team Standard, por assento	US$ 20
Team Premium, por assento	US$ 100
Enterprise, baseado em uso	US$ 20
Assento Enterprise Premium	US$ 200

Regras importantes:

• Membros de assento Enterprise Standard não recebem crédito. Eles precisam usar uma chave de API ou fazer upgrade para um assento Premium.
• Os créditos são por usuário e intransferíveis. O crédito do seu assento não pode ser compartilhado com colegas.
• Créditos não utilizados não acumulam. O saldo restante é reiniciado no fim do ciclo de faturamento.
• É necessário um opt-in único. O crédito só é ativado depois que você o reivindica uma vez. Depois disso, ele é renovado automaticamente a cada mês.
• Usuários de chave de API não recebem esse crédito automaticamente. Se você autentica via ANTHROPIC_API_KEY, continua no modelo de faturamento antigo.

O que o crédito cobre

O crédito do Agent SDK cobre cargas de trabalho programáticas, automatizadas ou não interativas.

Coberto pelo crédito:

• Chamadas do Claude Agent SDK em projetos Python ou TypeScript.
• O comando claude -p no Claude Code, usado em modo não interativo.
• A integração do Claude Code com GitHub Actions.
• Aplicações de terceiros que autenticam usando o Agent SDK.

Não coberto:

• Sessões interativas do Claude Code.
• Conversas no aplicativo web ou móvel do Claude.
• Sessões Claude Cowork.

Na prática, o crédito do Agent SDK é separado do uso normal do Claude Code. Seu trabalho diário no Claude Code continua usando os limites do plano, que a Anthropic aumentou recentemente em 50% até 13 de julho.

Isso permite testar agentes personalizados sem consumir o orçamento usado para programação interativa.

Quando o crédito acabar

O crédito cobre um valor fixo em dólar por mês. O comportamento ao exceder esse valor depende da configuração de uso extra:

• Uso extra habilitado: excedentes são cobrados como pay-as-you-go nas taxas padrão da API, usando o método de pagamento do plano.
• Uso extra desabilitado: as requisições param quando o crédito acaba e só voltam no próximo ciclo.

Para protótipos, mantenha o uso extra desabilitado. Assim, você evita cobranças inesperadas.

Para automações de produção que precisam continuar rodando, habilite o uso extra.

O crédito sempre é consumido primeiro. Você só paga excedente depois que a cota mensal acaba.

Como ativar o crédito

O crédito não vem ativado por padrão. O opt-in é feito uma única vez.

Passos:

1. Faça login na conta Claude que possui a assinatura.
   • No Pro ou Max, use sua conta de usuário.
   • Em Team ou Enterprise, use a conta do assento correspondente.
2. Acesse as configurações do plano Claude Agent SDK, linkadas no artigo oficial de suporte da Anthropic.
3. Reivindique o crédito.
4. Aguarde a ativação. A partir daí, o crédito será renovado automaticamente todo mês.

Em planos Team, cada usuário precisa reivindicar o próprio crédito. Administradores não podem fazer isso em nome dos membros.

Configurando o Agent SDK em Python

O Agent SDK está disponível em Python e TypeScript. A autenticação baseada no plano usa o login do Claude Code, não uma chave de API direta.

Instale o SDK:

pip install claude-agent-sdk

Faça login no Claude Code:

claude login

Esse comando armazena credenciais locais vinculadas ao seu plano. O SDK Python deve detectá-las automaticamente. Para uso baseado em plano, você não precisa definir ANTHROPIC_API_KEY.

Exemplo mínimo:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run(
    "Review the diff in /tmp/patch.diff and flag concerns."
)

print(response.text)

Antes, essa execução exigiria ANTHROPIC_API_KEY e faturamento medido pela API. Com o crédito do plano ativado, ela consome o saldo mensal do Agent SDK.

Configurando o Agent SDK em TypeScript

Instale o pacote:

npm install @anthropic-ai/claude-agent-sdk

Faça login no Claude Code:

claude login

Exemplo mínimo:

import { Agent } from "@anthropic-ai/claude-agent-sdk";

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

Em ambientes onde o SDK não encontra automaticamente as credenciais do Claude Code — por exemplo, CI, Docker ou máquinas remotas — configure as credenciais via variáveis de ambiente. A Anthropic publica os nomes exatos na documentação do Agent SDK.

Se o claude login falhar antes da configuração do SDK, veja a correção para configuração inválida de empresa custom3p, que cobre uma causa comum desse erro.

Usando claude -p em automações

Você também pode usar o crédito do Agent SDK sem escrever código, via comando claude -p.

O -p executa o Claude Code em modo não interativo. Você passa um prompt, ele roda contra o repositório e encerra. Isso é útil para:

• pipelines de CI;
• cron jobs;
• Git hooks;
• verificações automatizadas;
• geração de relatórios.

Exemplo de hook de pré-commit:

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:\n\n$DIFF"

Cada execução de claude -p após 15 de junho usa o crédito do Agent SDK, não o orçamento interativo do Claude Code.

Esse fluxo combina bem com o comando /goal para loops autônomos e com arquivos AGENTS.md para fornecer contexto consistente ao agente.

Integração com GitHub Actions

A integração do Claude Code com GitHub Actions também é coberta pelo crédito do SDK.

Se você usa Claude para:

• revisar pull requests;
• triagem de issues;
• gerar notas de release;
• executar verificações automatizadas;

essas execuções passam a ser faturadas contra o crédito do Agent SDK do usuário que instalou o GitHub App.

Isso é relevante para projetos como Clawsweeper, o bot de triagem do GitHub construído no Claude Code, onde a automação roda com frequência e antes dependia de uma chave de API anexada ao app.

Construindo agentes reais com contratos de API

O valor do Agent SDK aumenta quando o agente faz mais do que responder texto. Exemplos:

• chamar APIs internas;
• consultar bancos de dados;
• acionar deploys;
• criar tickets;
• validar respostas de serviços;
• orquestrar ferramentas externas.

Para isso funcionar de forma confiável, o agente precisa de contratos claros para cada API que acessa. Sem contrato, ele pode inferir payloads incorretos, errar formatos de request ou interpretar respostas de forma inconsistente.

É aqui que Apidog entra no fluxo.

Um fluxo prático:

1. Defina o contrato da API no Apidog.
   
   Documente endpoints, métodos, headers, schemas de request/response e exemplos de payload.

2. Exporte a especificação OpenAPI.
   
   Use esse arquivo como contexto para o agente.

3. Conecte o Agent SDK aos endpoints reais.
   
   O agente passa a chamar a API seguindo os schemas definidos.

4. Valide as respostas com a CLI do Apidog.
   
   Cada execução pode verificar se a API ainda cumpre o contrato esperado.

Para agentes que orquestram ferramentas via servidores MCP, o fluxo de teste de servidor MCP com Apidog cobre o caminho correspondente.

A visão geral está no guia de fluxo de trabalho de API design-first: quando o agente tem um contrato validável, o esforço do desenvolvedor vai para escrever melhores contratos e restrições, não para corrigir payloads JSON inventados.

Você pode baixar o Apidog gratuitamente para usar como camada de contrato nos projetos com Agent SDK.

Quando ainda usar uma chave de API separada

O crédito baseado no plano é suficiente para muitos desenvolvedores, especialmente para protótipos e automações pessoais. Ainda assim, uma chave de API separada continua fazendo sentido em alguns cenários.

Use uma chave de API quando precisar de:

• Agentes de produção com orçamento operacional próprio.
  
  Créditos do plano têm valores mensais fixos. Para agentes que precisam escalar além disso, uma chave de API baseada em uso pode ser mais clara para finanças e operações.

• Acesso compartilhado entre várias pessoas ou organizações.
  
  Créditos são vinculados a usuários. Uma chave de API pode representar uma fonte de faturamento compartilhada.

• Assentos Enterprise Standard.
  
  Esses assentos não recebem créditos do Agent SDK. Se você está em um assento Enterprise Standard e precisa usar o SDK, a chave de API continua sendo o caminho.

O guia de acesso gratuito à API do Claude cobre alternativas para usar Claude sem um plano Pro ou uma chave paga.

Checklist antes de começar

Use esta lista para configurar o ambiente sem misturar autenticação por plano e autenticação por API.

• [ ] Confirme se seu plano é elegível:
  • Pro
  • Max 5x
  • Max 20x
  • Team Standard
  • Team Premium
  • Enterprise baseado em uso
  • Assento Enterprise Premium
• [ ] Reivindique o opt-in único do crédito do Agent SDK.
• [ ] Decida se o uso extra ficará habilitado.
  • Desabilitado para protótipos.
  • Habilitado para produção.
• [ ] Execute claude login.
• [ ] Instale o SDK em Python ou TypeScript.
• [ ] Crie um agente mínimo.
• [ ] Confirme que ele funciona sem ANTHROPIC_API_KEY.
• [ ] Execute uma chamada pequena.
• [ ] Verifique o saldo do crédito nas configurações da conta.

FAQ

Preciso remover minha antiga ANTHROPIC_API_KEY para usar o crédito do plano?

Não necessariamente. O SDK usa as credenciais locais do Claude Code quando elas existem. Em geral, executar claude login é suficiente para usar o faturamento baseado em plano. Se você mantém ANTHROPIC_API_KEY para outras ferramentas, pode deixá-la configurada.

O que conta como uma requisição contra o crédito?

O crédito é em dólares, não em número de requisições. Cada chamada do SDK é cobrada conforme as taxas publicadas pela Anthropic para uso da API. O saldo diminui de acordo com o custo da chamada, incluindo tokens de contexto, saída e uso de ferramentas.

Posso compartilhar meu crédito com outro usuário?

Não. Os créditos são por usuário e intransferíveis. Cada assento Team ou Enterprise tem seu próprio saldo.

O que acontece com meu saldo antigo no console da API da Anthropic?

Ele permanece separado. O crédito do plano é outro mecanismo de faturamento. Se você tinha saldo pré-pago no console da API, ele continua disponível para cargas de trabalho que usam chave de API.

O Agent SDK é o mesmo que Claude Code?

Não. Claude Code é a CLI oficial e o conjunto de extensões de IDE da Anthropic. O Agent SDK é uma biblioteca para criar agentes personalizados em Python ou TypeScript. O crédito cobre o SDK, o comando não interativo claude -p, GitHub Actions e apps de terceiros que usam o Agent SDK. Sessões interativas do Claude Code continuam usando os limites normais do plano.

Minha cobrança do GitHub Actions muda?

Se sua Action usa a integração oficial do Claude Code com GitHub Actions e o crédito foi reivindicado pela conta do usuário instalador, essas execuções passam a usar o crédito do SDK em vez de faturamento por chave de API.

O crédito funciona fora do Agent SDK e do claude -p?

Não para usos gerais. Ele cobre as superfícies especificadas: SDK em Python/TypeScript, claude -p, GitHub Actions e aplicativos de terceiros baseados no Agent SDK. Outros usos do Claude continuam seguindo os limites normais do plano ou o faturamento da chave de API, dependendo da origem da requisição.