Blog

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

Ashley Innocent

Ashley Innocent

14 maio 2026

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

Apidog para empresas

Implantação local

SSO & RBAC

Conforme SOC 2

Explorar Apidog Enterprise

A Anthropic permitirá que você execute o Claude Agent SDK em sua assinatura Claude existente a partir de 15 de junho de 2026. Antes disso, construir qualquer coisa com o Agent SDK significava 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 de 15 de junho, seu plano mensal Claude incluirá um saldo de crédito especificamente para o uso do Agent SDK. Nenhuma chave de API será necessária.

Se você sempre quis construir um agente personalizado (um bot de implantação, um assistente de pesquisa, uma ferramenta de triagem), mas não queria colocar um cartão de cobrança separado em arquivo com a Anthropic apenas para prototipar, esta é a mudança que importa. Sua assinatura Pro agora vem com US$ 20/mês de uso do Agent SDK. O Max 20x vem com US$ 200. Assentos Team Premium vêm com US$ 100.

button

O que mudou em 15 de junho de 2026

Em resumo: o uso do Agent SDK agora é deduzido de um crédito mensal vinculado ao seu plano Claude. Anteriormente, era faturado através da API da Anthropic com um saldo de console separado.

Aqui está o crédito por plano, retirado diretamente do anúncio da Anthropic:

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

Algumas regras importantes:

O que o crédito cobre e o que não cobre

A Anthropic dividiu isso cuidadosamente. Leia com atenção; a linha entre “coberto” e “não coberto” é o que determina se sua fatura realmente muda.

Coberto pelo crédito do Agent SDK:

Não coberto (estes ainda saem do seu plano Claude regular ou permanecem separados):

Em outras palavras, o crédito do Agent SDK é especificamente para cargas de trabalho programáticas, automatizadas ou não interativas. Seu trabalho normal com o Claude Code se baseia nos limites de uso existentes do plano, que a Anthropic aumentou recentemente em 50% até 13 de julho. Dois orçamentos separados, dois propósitos separados.

Esta é uma escolha de design significativa. Isso significa que você pode experimentar um agente personalizado construído no SDK sem consumir o orçamento que você usa para codificação diária através do Claude Code.

Quando seu crédito acabar

O crédito cobre um valor fixo em dólar por mês. O que acontece quando você o excede depende de uma configuração:

Para trabalho de prototipagem, deixe o uso extra desabilitado. Você terá um sinal de parada claro e evitará contas inesperadas. Para automações de nível de produção que precisam continuar funcionando, habilite-o.

O crédito sempre é usado primeiro. Você não paga taxas de excedente até que sua cota mensal se esgote.

Como ativar

O crédito não está ativado por padrão. O opt-in é único e permanece em todos os ciclos de faturamento, mas você precisa fazê-lo uma vez.

  1. Faça login na conta Claude que possui a assinatura (a conta de usuário no Pro/Max, ou a conta de assento no Team/Enterprise).
  2. Visite as configurações do plano Claude Agent SDK (linkado no artigo de suporte oficial da Anthropic).
  3. Reivindique o crédito. Depois disso, o crédito será atualizado automaticamente a cada mês.

Se você tem múltiplos assentos em um plano de Equipe, cada usuário deve reivindicar independentemente. Administradores não podem reivindicar em nome de membros do assento.

Configurando o SDK em Python ou TypeScript

O Agent SDK está disponível em Python e TypeScript. Ambos autenticam da mesma forma contra o seu plano: através da CLI do Claude Code, em vez de uma chave de API bruta.

Python

Instalar:

pip install claude-agent-sdk

Autentique-se fazendo login no Claude Code primeiro:

claude login

Isso armazena credenciais vinculadas ao plano localmente. O SDK Python as detecta automaticamente; você não define ANTHROPIC_API_KEY para uso baseado em plano.

Um agente mínimo se parece com isto:

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)

A mesma chamada teria exigido ANTHROPIC_API_KEY e faturamento de API medido antes. Agora, ela usa seu crédito do plano.

TypeScript

Instalar:

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

Autentique-se via o mesmo login do Claude Code:

claude login

Um agente mínimo em TypeScript:

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);

Para ambientes onde o SDK não consegue encontrar as credenciais do Claude Code automaticamente (executores de CI, contêineres Docker, máquinas de desenvolvimento remotas), você pode configurá-las como variáveis de ambiente. A Anthropic publica os nomes exatos das variáveis na documentação do Agent SDK.

Se seu login do Claude Code estiver apresentando erros de configuração antes mesmo de você chegar à configuração do SDK, a correção para configuração inválida de empresa custom3p cobre a causa mais comum.

O fluxo de trabalho claude -p

Há uma segunda maneira de usar o crédito do Agent SDK que não envolve escrever código: o comando claude -p no Claude Code.

-p coloca o Claude Code em modo não interativo. Você lhe entrega um prompt, ele executa contra seu repositório e sai. Sem sessões de ida e volta. É assim que você roteiriza o Claude Code em pipelines de CI, cron jobs e Git hooks.

Um exemplo simples: um hook de pré-commit que pede ao Claude para sinalizar mudanças arriscadas.

#!/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 invocação de claude -p após 15 de junho usa seu crédito do Agent SDK, não seu orçamento interativo do Claude Code. O que significa que você pode integrá-lo em fluxos de trabalho automatizados sem se preocupar em esgotar os limites que você precisa para codificação diária.

Isso combina bem com o comando /goal para loops autônomos, e com arquivos de contexto AGENTS.md para direcionar o agente de forma confiável em várias execuções.

Integração com GitHub Actions

A integração do Claude Code com GitHub Actions é a terceira carga de trabalho coberta pelo crédito do SDK. Se você integrou o Claude em revisões de PR, triagem de issues ou geração de notas de lançamento, essas execuções de fluxo de trabalho agora são faturadas contra o crédito do Agent SDK do usuário que instalou o Aplicativo GitHub.

Isso é útil para projetos como Clawsweeper, o bot de triagem do GitHub construído no Claude Code, onde a automação funciona constantemente e a fatura costumava cair na chave de API que estava anexada ao Aplicativo.

Construindo agentes reais: pareando o SDK com Apidog

O verdadeiro valor do Agent SDK é para agentes que fazem mais do que responder a texto; agentes que acessam APIs reais, consultam bancos de dados, implantam código. Para que isso funcione de forma confiável, o agente precisa de um contrato definido para cada API externa que ele toca. Sem um, o agente adivinha os formatos das requisições e você gasta seu tempo de depuração corrigindo payloads 'alucinados'.

É aqui que Apidog se encaixa no fluxo de trabalho:

  1. Defina o contrato da API primeiro no Apidog. Especifique endpoints, esquemas de requisição/resposta e payloads de exemplo. Isso se torna a fonte da verdade.
  2. Exporte OpenAPI e passe-o para seu agente como contexto.
  3. Use o SDK para conectar o agente aos endpoints reais. O agente chama sua API usando os esquemas que ele sabe que estão corretos.
  4. Valide com a CLI do Apidog. Cada execução do agente pode verificar se a API ainda retorna o que o contrato promete.

Para agentes que orquestram outras ferramentas através de servidores MCP, o fluxo de trabalho de teste de servidor MCP com Apidog é o guia correspondente. Você obtém cobertura de teste de ponta a ponta nas ferramentas que seu agente chama.

A visão geral está no guia de fluxo de trabalho de API design-first: quando o agente tem um contrato para validar, seu tempo como desenvolvedor passa para a escrita de melhores contratos e restrições, e não para a correção de bugs de esquema JSON na saída do agente.

Baixe Apidog gratuitamente se você quiser a camada de contrato para seus projetos do Agent SDK.

Quando você ainda quer uma chave de API separada

O crédito baseado em plano é o padrão certo para a maioria dos desenvolvedores. Ainda há casos em que uma chave de API autônoma faz sentido:

O guia de acesso gratuito à API do Claude cobre caminhos para o uso do Claude que não exigem um plano Pro nem uma chave de API paga.

Uma lista de verificação antes de começar

FAQ

Preciso remover minha antiga ANTHROPIC_API_KEY para que o crédito do plano funcione? O SDK usa as credenciais locais do Claude Code quando elas existem, o que significa que claude login é suficiente para mudar o SDK para faturamento baseado em plano. Se você tem ANTHROPIC_API_KEY configurada em seu ambiente para outras ferramentas, deixe-a; o SDK preferirá a autenticação do plano quando presente.

O que conta como uma “requisição” contra o crédito? O crédito é denominado em dólares, não em requisições. Cada chamada do SDK é cobrada nas mesmas taxas que a Anthropic publica para uso da API; seu saldo de crédito diminui pelo custo de cada chamada de modelo, incluindo o uso de ferramentas e tokens de contexto. Não há taxa por requisição adicional.

Posso compartilhar meu crédito com um colega de equipe? Não. Os créditos são por usuário e intransferíveis. Cada assento de Equipe ou Enterprise tem seu próprio pool de créditos.

O que acontece com meu saldo antigo do console da API da Anthropic? Ele permanece onde está. O crédito do plano é um mecanismo de faturamento separado. Se você tinha saldo pré-pago em seu console de API, isso ainda funciona para qualquer carga de trabalho de chave de API.

O Agent SDK é o mesmo que Claude Code? Não. Claude Code é a CLI oficial e as extensões de IDE que a Anthropic oferece. O Agent SDK é uma biblioteca de programação (Python ou TypeScript) para construir agentes personalizados. O crédito cobre o SDK mais o comando claude -p não interativo no Claude Code; o Claude Code interativo permanece no uso regular do seu plano.

Minha fatura do GitHub Actions mudará? Se sua Action usa a integração oficial do Claude Code com GitHub Actions e o crédito é reivindicado na conta do usuário instalador, essas execuções agora usarão o crédito do SDK em vez de qualquer faturamento de chave de API.

O crédito funciona fora do Agent SDK e claude -p? Não para as quatro superfícies cobertas (SDK em Python/TS, claude -p, GitHub Actions, aplicativos de terceiros do Agent SDK). Qualquer outro uso do Claude volta para os limites normais do seu plano ou sua chave de API, dependendo de onde a requisição se origina.

button

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs

Cadastre-se gratuitamenteBaixar