Crédito do Claude Agent SDK: o que muda para claude -p, GitHub Actions e ferramentas de agentes de terceiros em 15 de junho

Em 15 de junho de 2026, a Anthropic muda a economia do Claude headless. claude -p, chamadas do Claude Agent SDK, Claude Code GitHub Actions e apps de terceiros criados sobre o Agent SDK deixam de consumir os limites normais da assinatura do Claude e passam a consumir um crédito mensal separado do Agent SDK (Anthropic Help Center).

Isso parece uma nota de rodapé de cobrança. Não é. Se você tem cron jobs, revisores em CI, scripts locais, integrações de agente estilo Zed ou CLIs wrapper em volta de claude -p, esta é a linha em que “incluído no meu plano” vira “medido contra um crédito em dólares”.

Minha leitura: essa é a fronteira certa de produto, mas o rollout da Anthropic deixa desenvolvedores demais descobrindo isso por modelos mentais quebrados e threads no Reddit. Programação interativa e agentes automatizados são cargas de trabalho diferentes. Não deveriam compartilhar a mesma cota. Mas, se sua equipe construiu automação discretamente em cima do Claude Code autenticado por assinatura, 15 de junho é um prazo de migração, não um anúncio de preço.

O Que Realmente Vai Para o Novo Crédito

O artigo de ajuda da Anthropic é explícito sobre a fronteira. A partir de 15 de junho, o uso do Agent SDK e de claude -p em planos de assinatura do Claude passa a consumir um novo crédito mensal do Agent SDK, separado dos limites de uso interativo (Anthropic Help Center). A documentação do Agent SDK repete o mesmo aviso no topo da página de visão geral (Claude Docs).

Coberto pelo novo crédito:

Os créditos dos planos são denominados em dólares:

A Anthropic também diz que os créditos são por usuário, não compartilhados; eles renovam com o ciclo de cobrança; crédito não usado não acumula; e o crédito precisa ser reivindicado uma vez, depois renova automaticamente (Anthropic Help Center).

Essa última parte importa para equipes. Uma conta Team com 20 engenheiros elegíveis não recebe um único balde compartilhado de automação. Cada pessoa recebe seu próprio crédito. Se uma GitHub Action compartilhada é autenticada como um usuário, o crédito desse usuário vira o gargalo.

A Quebra Prática: claude -p Não É Mais “Só Uso de CLI”

O comando que vai pegar muita gente de surpresa é claude -p.

A referência de CLI da Anthropic descreve --print / -p como “Imprimir resposta sem modo interativo”, com flags amigáveis para automação como --output-format json, --output-format stream-json, --max-turns, --json-schema e --max-budget-usd (Claude Code CLI reference). Isso o tornava uma cola perfeita para scripts:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

Depois de 15 de junho, isso é uso de crédito do Agent SDK em uma conta autenticada por assinatura. Não é uso interativo do Claude Code. Não é uso normal de chat. Não é uma porta lateral gratuita para dentro da cota do seu plano.

É por isso que a reação da comunidade está forte. Em uma thread atual no r/ClaudeCode, desenvolvedores perguntam se o crédito é baseado em tokens/modelo, até onde $200 vão realisticamente, se é preciso optar pelo recurso, como prompt caching é contado e se GitHub Actions estão incluídas (Reddit). O “ah… eu não tinha percebido que GH actions também entravam” de um comentarista é exatamente o risco: as pessoas associaram essa mudança a bibliotecas SDK, não a todo workflow headless do Claude Code.

A resposta para a pergunta sobre tokens é, na prática, sim: a Anthropic diz que o uso acima do crédito passa para créditos de uso nas tarifas padrão da API se créditos de uso estiverem habilitados. A página atual de preços da Claude API lista Fable 5 a $10 input / $50 output por milhão de tokens, Opus 4.8 a $5 / $25, Sonnet 4.6 a $3 / $15 e Haiku 4.5 a $1 / $5 (Claude API pricing). O consumo exato depende do modelo, turnos, uso de ferramentas, leituras de cache, gravações de cache e de quanto contexto do repositório o agente carrega.

Não converta $20 ou $200 em “horas”. Essa é a unidade errada. Converta seus jobs reais em rastros de tokens e custo.

GitHub Actions: Mesmo YAML, Orçamento Diferente

Claude Code GitHub Actions está claramente dentro do escopo. A documentação de GitHub Actions da Anthropic diz que a action é construída sobre o Claude Agent SDK e pode responder a menções @claude, criar PRs, implementar features, corrigir bugs ou rodar automação customizada (Claude Code GitHub Actions docs). A documentação também alerta que cada interação com Claude consome tokens de API e recomenda --max-turns, timeouts e controles de concorrência para gestão de custo.

Essa orientação importa mais agora.

Um relatório diário agendado como este:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

tem duas histórias possíveis de cobrança:

1. Se usa uma chave de API da Claude Platform, a Anthropic diz que nada muda. Continua sendo cobrança normal de API pay-as-you-go.
2. Se está usando crédito do Agent SDK autenticado por assinatura, agora ele drena primeiro o crédito do Agent SDK por usuário, depois créditos de uso se estiverem habilitados.

A documentação de configuração da action ainda enfatiza ANTHROPIC_API_KEY para uso direto de API e opções de provedores de nuvem para Bedrock e Vertex AI (Claude Code GitHub Actions docs). Para CI de produção, isso é mais limpo do que amarrar a automação de um repositório à assinatura de uma única pessoa. A Anthropic diz a mesma coisa na orientação para administradores: automação de produção em escala deve usar Claude Platform com uma chave de API para cobrança pay-as-you-go previsível (Anthropic Help Center).

Minha recomendação: se um workflow pode fazer merge de código, comentar em PRs ou rodar sem supervisão em um agendamento, coloque-o em uma chave de API com orçamentos explícitos. Guarde o crédito do Agent SDK da assinatura para automação pessoal, experimentos e tooling local.

Ferramentas de Agentes de Terceiros: A Pergunta Estilo Zed

O caso confuso é tooling de terceiros. Desenvolvedores estão perguntando: se um editor, harness local ou assistente de programação integra via Agent SDK e me deixa autenticar com minha assinatura do Claude, isso usa o novo crédito?

O artigo de ajuda da Anthropic diz que o crédito cobre “apps de terceiros que autenticam com sua assinatura do Claude por meio do Agent SDK” (Anthropic Help Center). A visão geral do Agent SDK também diz que a Anthropic geralmente não permite que desenvolvedores de terceiros ofereçam login claude.ai ou limites de taxa, a menos que tenham sido aprovados previamente, e orienta desenvolvedores a usarem métodos de autenticação por chave de API (Claude Docs).

Isso dá uma regra prática:

• Se a ferramenta usa sua chave de API da Claude Platform, esta mudança não dá a ela um crédito mensal gratuito. Continua sendo cobrança de API.
• Se a ferramenta é um app aprovado do Agent SDK autenticado por assinatura, ela consome o crédito do Agent SDK.
• Se a ferramenta está tentando tunelar por login do Claude Code, tokens OAuth, PTYs ocultos ou limites de assinatura de formas que a Anthropic não aprovou, trate-a como frágil.

A comunidade já está construindo em cima dessa ambiguidade. Um post no r/ClaudeCode descreve um “substituto drop-in de -p” baseado em hooks que mantém o trabalho dentro do Claude Code interativo e afirma evitar créditos do SDK (Reddit). Outro post no r/ClaudeAI descreve clarp, uma CLI local que inicia Claude Code interativo por baixo dos panos para imitar a saída de claude -p (Reddit). O autor enquadra isso como compatibilidade local, enquanto comentaristas levantam imediatamente dúvidas sobre risco de conta.

Esse é o debate real: isso é preservação legítima de workflow local ou bypass de cota vestido de ferramenta? Eu não construiria infraestrutura de empresa sobre esses wrappers. Mesmo que funcionem hoje, eles codificam uma premissa de cobrança que a Anthropic está tentando remover ativamente.

Como Auditar Seus Próprios Workflows Hoje

Faça isso antes de esperar um job quebrar.

Primeiro, procure por claude -p e imports do Agent SDK:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

Depois procure em CI:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

Classifique cada resultado:

Para usuários do SDK, conecte rastreamento de custo ao stream de resultados. A documentação de cost-tracking da Anthropic diz que total_cost_usd e costUSD são estimativas client-side, não dados autoritativos de cobrança, mas são úteis para insight durante desenvolvimento (Claude Docs). A mesma página diz que o SDK expõe uso de tokens por etapa, uso por modelo, tokens de leitura de cache, tokens de criação de cache e totais acumulados.

Use isso para criar um perfil de consumo:

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

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

Não use estimativas client-side de custo para cobrar seus próprios usuários. A Anthropic diz explicitamente para usar a Usage and Cost API ou o Claude Console para cobrança autoritativa (Claude Docs).

Também adicione travas rígidas. Para claude -p, use --max-turns e --max-budget-usd. Para GitHub Actions, use timeouts de workflow, controles de concorrência do GitHub e prompts enxutos. Para agentes SDK, restrinja ferramentas. Um revisor somente leitura não deveria ter Bash, Edit e Write por padrão.

As Perguntas Sobre Opt-In e Excedente

A pergunta operacional não resolvida mais importante é o opt-in. A Anthropic diz que o crédito é um opt-in único, reivindicado pela sua conta Claude uma vez, depois renovado automaticamente. Para administradores de Team e Enterprise, usuários elegíveis deveriam receber um email com detalhes e instruções antes de 15 de junho de 2026 (Anthropic Help Center).

Uma thread atual no r/Anthropic está fazendo a pergunta óbvia seguinte: o que acontece se você não optar? claude -p continua funcionando contra os limites normais da assinatura, para até você reivindicar, ou cai em créditos de uso? O artigo não deixa esse fallback claro (Reddit).

Então não desenhe arquitetura em cima de um fallback chutado. Reivindique o crédito se você for elegível. Se você é admin, diga aos usuários onde reivindicar e quais automações podem usá-lo. Se você roda workflows compartilhados, migre-os para uma chave de API.

Sobre excedente, a Anthropic é mais clara. O uso do Agent SDK drena primeiro o crédito mensal. Depois disso, o uso passa para créditos de uso nas tarifas padrão da API somente se créditos de uso estiverem habilitados. Se créditos de uso não estiverem habilitados, as solicitações do Agent SDK param até o crédito renovar (Anthropic Help Center).

Isso é bom do ponto de vista de controle de gasto. Também significa que sua automação pode falhar fechada. Projete para isso. CI deve mostrar “crédito do Agent SDK esgotado” como falha de cobrança/configuração, não como erro flaky do modelo. Scripts locais devem imprimir uma mensagem clara e sair com código diferente de zero. Agentes de longa duração devem fazer checkpoint do trabalho antes de cada turno caro.

O Resultado Para Desenvolvedores

Essa mudança não é a morte do claude -p. É o fim de fingir que um loop de agente headless tem o mesmo perfil de custo de uma pessoa sentada em uma IDE.

Para desenvolvedores individuais, o novo crédito é útil. Um usuário Pro recebe $20 de espaço mensal para scripts. Um usuário Max 20x recebe $200. Isso é suficiente para automação bem pensada, não para agentes sempre ligados e ilimitados.

Para equipes, a resposta é chata e correta: use chaves de API para automação de produção. Mantenha créditos do Agent SDK de assinatura como pessoais. Adicione logging de custo. Limite turnos. Prefira Haiku ou Sonnet quando a tarefa não precisar de um modelo frontier. Trate ferramentas wrapper que contornam a nova fronteira como experimentos, não infraestrutura.

A separação de 15 de junho resolve um problema real: seu script noturno não deveria consumir silenciosamente a mesma cota de que você precisa para programar interativamente. Ela cria outro: desenvolvedores agora precisam pensar como usuários de API sempre que Claude roda sem um humano no loop.

É uma troca justa. Mas ela só funciona se você auditar antes que o medidor comece a morder.

Leitores que quiserem testar Claude Fable 5 podem usá-lo pela OneHop: um endpoint drop-in, cerca de 30% abaixo do preço de lista, com $10 grátis para novas contas e sem exigir cartão. Veja Claude Fable 5 na OneHop ou comece com $10 grátis.

Leitura adicional: Começando com Claude Fable 5.