Faturação da automatização no Claude Code: limites da subscrição e créditos API

Como muda a cobrança da automatização no Claude Pro e Max?#

O anúncio original de maio propunha transferir o Agent SDK e a utilização programática para um fundo mensal separado a partir de 15 de junho. A proposta não entrou em vigor: a atualização do apoio da Anthropic informa que foi suspensa.

A distinção prática é agora a autenticação. Uma execução com sessão iniciada no plano Claude pode usar os limites do plano. Uma execução autenticada com uma chave API do Claude Console usa o saldo API dessa organização. O chat e o terminal interativos continuam nos limites do plano. Não classifique uma fatura apenas por o processo ser executado sem supervisão.

Para o valor API separado de outubro e a elegibilidade atual, consulte o guia de créditos API mensais. O valor abandonado de junho já não pode ser solicitado.

Um teste simples: que saldo utiliza a execução?#

Liste as GitHub Actions, os scripts agendados, as aplicações Agent SDK e as sessões interativas. Registe a autenticação e a interface de lançamento de cada um. Uma sessão da subscrição e uma chave API são percursos de faturação diferentes, mesmo quando invocam o mesmo modelo.

Execute uma pequena tarefa de desenvolvimento e examine o registo de utilização na conta correspondente. Ver claude -p num comando não basta para inferir uma dedução de créditos API: o guia oficial distingue um processo executado pelo próprio com chave API da utilização do Claude Code iniciada por GitHub Actions, extensões IDE ou aplicação desktop.

Verifique casos como revisões noturnas de PR, scripts de pesquisa recorrentes, wrappers n8n e ferramentas de terceiros. Defina credenciais e limites de despesa antes de ativar trabalho sem supervisão.

Quantos créditos recebe e o que está incluído#

Pela política de créditos API de outubro, o Max 5x inclui $100 mensais, o Max 20x $200 e o Team $20 por lugar Standard ou $100 por lugar Premium, reunidos até $500. Free, Pro e Enterprise não são elegíveis. Esta é a referência atual que substitui a proposta abandonada de junho.

Os créditos API são atribuídos a uma organização Console associada. São separados dos limites do plano Claude e não cobrem Claude Code interativo nem a sua utilização adicional. Consulte as regras oficiais de elegibilidade e de interface de lançamento antes de orçamentar um fluxo concreto.

Para estimar custos, calcule separadamente os tokens de entrada e de saída às tarifas publicadas do modelo. Os exemplos seguintes usam os preços datados do Opus 4.8 neste artigo: $5 por milhão de tokens de entrada e $25 por milhão de saída. São exemplos aritméticos, não medições das suas execuções.

Uma execução ilustrativa com 30–50K de entrada e 15–20K de saída custa cerca de $0.50–$1. Nesse intervalo, $100 cobrem aproximadamente 100–200 execuções e $200 cerca de 200–400. Execuções longas consomem mais; curtas, menos.

O que acontece quando os créditos acabam#

Os créditos API mensais expiram em cada ciclo de faturação. Sem outros créditos disponíveis, os pedidos API param. Créditos comprados ou recarga automática podem manter a utilização API; organizações faturadas seguem o seu contrato de faturação. Isto não cria uma cobrança adicional no próprio plano Claude.

Verifique o saldo e as definições de recarga da organização Console antes de trabalho sem supervisão. Uma notificação não é um teto rígido de despesa. Mantenha um orçamento e acompanhe a utilização real, em vez de assumir que um valor mensal garante disponibilidade.

3 estratégias: o que escolher para a sua utilização#

Estratégia 1: Manter o percurso atual do plano

Se as tarefas ocasionais de desenvolvimento couberem nos limites da subscrição, a proposta suspensa de junho não justifica comprar um segundo plano nem mudar credenciais. Verifique primeiro o percurso real de utilização.

Estratégia 2: Usar créditos API elegíveis com um saldo de apoio delimitado

Para trabalho API Max ou Team elegível, verifique a organização Console associada, o valor restante e as opções de créditos comprados ou recarga automática. Estime uma execução representativa e defina um orçamento antes de ativar gastos adicionais.

Estratégia 3: Usar um orçamento API autónomo

Para automatização de produção ou faturação partilhada da equipa, compare uma configuração API Console com o percurso atual do plano. Mantenha ou cancele a subscrição pessoal segundo as necessidades interativas; uma chave API tem um orçamento de utilização separado. Teste a integração em desenvolvimento antes de alterar uma credencial funcional de produção.

Não existe um número universal de tarefas a partir do qual a migração fica mais barata. Use os custos medidos por execução e a sua taxa de conclusão.

Calculadora: quantas execuções cabem?#

Segue-se uma calculadora ilustrativa de orçamento. A coluna de $20 é um orçamento hipotético, não um direito do Pro; o Pro não é elegível para os créditos API de outubro. Os valores utilizam o Opus 4.8 (5 $ por milhão de tokens de entrada, 25 $ por milhão de tokens de saída — preços atuais à data da publicação; se estiver a ler isto muito mais tarde, consulte a página de preços da Anthropic).

Se utiliza Sonnet, multiplique os valores por cerca de 1,5 — o modelo é 1,5–2 vezes mais barato. O Haiku é 5–10 vezes mais barato, pelo que poderá fazer proporcionalmente mais execuções.

Uma estimativa simples para o seu projeto:

1. Consulte a página de acompanhamento de custos do Agent SDK para saber quanto está a gastar por semana.
2. Multiplique por 4,3 para obter o gasto mensal.
3. Compare o resultado com o saldo e a elegibilidade verificados para o percurso de faturação escolhido.

Se o valor incluído for insuficiente, compare um orçamento delimitado de créditos comprados com uma configuração API autónoma. Decida pelos custos reais, não por uma proporção fixa.

O que verificar agora#

1. Verifique o plano, a autenticação, a interface de lançamento e a utilização restante na conta correspondente.
2. Se for elegível para créditos API, siga as instruções oficiais atuais de associação e confirme a organização creditada. Não espere por um email de junho nem assuma que o valor abandonado ainda pode ser solicitado.
3. Estime a utilização mensal com execuções medidas, incluindo tentativas falhadas e releituras.
4. Decida se a utilização deve parar no saldo disponível ou se acrescenta um apoio pago delimitado. Verifique o resultado numa execução de desenvolvimento.
5. Numa equipa, pergunte ao administrador quem controla as chaves API e a despesa. Não assuma que o valor de um lugar individual é privado ou transferível.

Os prazos de 14/15 de junho são históricos e não constituem passos de configuração para o leitor atual.

Alternativas se os créditos não forem suficientes#

Se a sua automatização for intensiva, poderá valer a pena analisar os concorrentes.

OpenAI Codex CLI — incluído numa subscrição ChatGPT Plus de 20 $ por mês. Sem fundo de créditos separado nem data de transição. Suporta /hooks, /goal e perfis de permissões. Para tarefas típicas (revisão de código, refatoração com base num exemplo, testes), oferece qualidade comparável.

Cursor Ultra — por 200 $ mensais, dá-lhe um «limite programático» de 400 $ às tarifas da API. O valor anunciado não basta para provar melhor relação custo-benefício: compare a utilização elegível, os preços dos modelos, as tarefas concluídas e os termos atuais. Os créditos API da Anthropic e os limites da subscrição são separados.

Cursor Composer 2.5 — um modelo económico baseado no Kimi K2.5, a 0,50 $ por milhão de tokens de entrada e 2,50 $ por milhão de tokens de saída. Adequado como «modelo de trabalho económico» para tarefas longas e de grande volume que não exigem inteligência de topo.

Analisei as alternativas em detalhe:

• Comparação entre Codex e Claude Code
• Cursor vs. Claude Code
• Como executar ambos durante a noite com /goal

Método de pagamento dos créditos de utilização#

Consulte a faturação do Console antes de comprar créditos API adicionais. Solicitar os créditos API incluídos não exige, por si só, adicionar um meio de pagamento; a utilização paga adicional tem requisitos próprios de faturação.

Utilização interativa e automatização: distinga os percursos#

O chat, o Claude Code interativo e o Cowork usam os limites dos respetivos planos. O Agent SDK ou claude -p também podem usar os limites da subscrição quando a sessão é iniciada com o plano. O trabalho com chave API usa a faturação Console, sujeito às regras de elegibilidade dos créditos.

Skills, subagentes, MCP, plugins e hooks não definem uma cobrança separada por si sós. Registe como o processo que os contém é autenticado e iniciado. Preserve uma configuração funcional até uma pequena execução de desenvolvimento demonstrar o percurso pretendido de utilização e faturação.

Um aviso histórico separado: descontinuação de modelos em junho#

Este é um aviso histórico separado de migração, não uma prova de que a proposta suspensa de faturação entrou em vigor. Verifique separadamente a disponibilidade dos modelos e os requisitos de migração dos pacotes antes de editar uma aplicação funcional.

O que será removido da API:

• claude-sonnet-4-20250514
• claude-opus-4-20250514

Estes IDs e as substituições sugeridas pertenciam ao aviso original. Não copie uma substituição histórica como recomendação atual: escolha um modelo disponível na documentação atual de modelos da Anthropic e teste-o em desenvolvimento.

O que mudou de nome:

• TypeScript: @anthropic-ai/claude-code → @anthropic-ai/claude-agent-sdk
• Python: claude-code-sdk → claude-agent-sdk

O aviso original indicava que os nomes antigos dos pacotes redirecionavam para os pacotes com novo nome. Consulte as orientações atuais de migração antes de depender desse comportamento histórico.

O que fazer agora:

1. Procure nos seus scripts

   grep -r 'claude-sonnet-4-20250514\|claude-opus-4-20250514\|claude-code-sdk\|@anthropic-ai/claude-code' . — se encontrar alguma ocorrência, atualize-a.

2. Atualize package.json ou requirements.txt

   Compare o pacote instalado e os IDs de modelos fixos no código com a documentação atual de migração e disponibilidade; altere só o que essa comparação exigir.

3. Execute os seus testes

   Execute os testes do Agent SDK com quaisquer nomes alterados antes de os aplicar em produção. O prazo antigo de junho não é um passo de configuração atual.

Cinco perguntas frequentes#

O valor anunciado de junho era um segundo pagamento mensal obrigatório?

Não. Foi anunciado como um valor de créditos incluído, e a alteração proposta foi depois suspensa. Não some esses valores ao preço da subscrição.

Um utilizador Pro pode solicitar os créditos API de outubro?

Não. O guia atual enumera planos Max e Team elegíveis. Pro e Enterprise não são elegíveis.

Os créditos transitam para o mês seguinte?

Não. Verifique a validade no Console e faça o orçamento dentro do ciclo de faturação.

Devo esperar pelo email antigo de junho?

Não. Use a página atual de faturação e as instruções oficiais de elegibilidade; os créditos Agent SDK abandonados estão indisponíveis.

É obrigatório alterar uma integração existente com chave API?

O anúncio, por si só, não exige uma chave nova. Verifique o saldo da organização e o percurso de faturação, preserve as credenciais funcionais e teste em desenvolvimento qualquer alteração justificada.

O que deve reter#

Há três aspetos separados a verificar: limites da subscrição, um valor API incluído elegível e utilização API paga opcional. A alteração de junho foi suspensa; não representa uma segunda fatura obrigatória.

Registe a autenticação e a interface de lançamento, meça uma execução representativa e compare o custo com o saldo verificado. Contexto limpo e instruções de projeto organizadas podem reduzir releituras, mas meça a poupança em vez de prometer uma redução fixa.