A API Claude tem nível gratuito ou só créditos?

A Claude API tem um nível gratuito?

A Claude API não tem um nível gratuito. Não existe uma franquia mensal de tokens gratuitos nem um plano que possa manter por $0. Uma conta nova recebe apenas uma pequena quantidade de créditos gratuitos para testar a API, e a documentação de preços da Anthropic não informa o montante. Depois de gastar esses créditos, os pedidos usam créditos pagos ou outros créditos concedidos para a API. Se também pagar uma subscrição Max, Ultra ou Team, esses planos incluem um crédito mensal para a API, descrito abaixo. Se investigar segurança ou alinhamento de IA, o External Researcher Access Program da Anthropic atribui $1,000 em créditos de API à conta de cada candidato aprovado, em outubro de 2026. A Anthropic analisa as candidaturas na primeira segunda-feira de cada mês e não responde às candidaturas rejeitadas.

Essa é a resposta direta. O restante deste guia explica as consequências: que partes da plataforma não têm qualquer custo, por que motivo esta é uma questão diferente do plano gratuito das aplicações Claude e qual é a forma mais económica e realista de pôr o primeiro programa a funcionar.

O que é gratuito numa conta da API Claude

Vários componentes da plataforma não têm custo de tokens, e são mais importantes do que pode parecer.

• Contagem de tokens. O endpoint de contagem de tokens é gratuito. Tem o seu próprio limite de pedidos por minuto, separado da criação de mensagens. Assim, medir um prompt não reduz o orçamento disponível para o enviar.
• A própria Console. Criar uma organização, consultar a página de utilização e abrir o playground (anteriormente Workbench) não tem custos. Executar um prompt no playground é um pedido normal à API. Essa parte cobra tokens como qualquer outra chamada.
• Operações com ficheiros. Carregar, listar e eliminar ficheiros através da Files API é gratuito. Só paga quando o conteúdo de um ficheiro entra num pedido como tokens de entrada.
• Web fetch. A ferramenta web fetch não acrescenta custos além dos tokens do conteúdo que introduz na conversa. A pesquisa na Web não é gratuita: custa $10 por 1,000 pesquisas desde October 2026.
• Execução de código, até certo limite. Cada organização recebe 1,550 horas gratuitas de contentores por mês desde October 2026. Depois disso, o custo é de $0.05 por hora e por contentor. A execução de código não tem custo adicional num pedido que inclua web search ou web fetch nas versões 20260209 ou posteriores.

Nada disso constitui um nível gratuito. Significa que a medição é transparente: paga pela inferência, não pela infraestrutura auxiliar. O web fetch gratuito combina bem com fontes de dados que também sejam gratuitas, e executar análises de ações e opções com uma API de dados de mercado sem chave é um exemplo prático em que o único custo são os tokens que os dados obtidos acrescentam ao prompt.

Calcule o custo de um prompt antes de o enviar

Como a contagem é gratuita, pode determinar primeiro o tamanho de um pedido. A contagem é uma estimativa, e a documentação da Anthropic indica que o número de tokens usado por um pedido real pode variar ligeiramente. Este é o mesmo endpoint que os SDKs utilizam e aceita o mesmo corpo que uma mensagem real, com algumas exceções: rejeita pedidos que incluam ferramentas do servidor, como pesquisa na Web, obtenção de conteúdo da Web ou execução de código, o conector MCP, ou imagens e PDFs enviados por URL ou ID de ficheiro. Para os contabilizar, envie imagens e PDFs em base64.

Para o exemplo abaixo, utilize uma chave associada a um workspace. Se a sua chave não estiver associada a um workspace, envie também anthropic-workspace-id com o ID do workspace. Se omitir esse campo, a resposta será HTTP 400 com invalid_request_error.

curl https://api.anthropic.com/v1/messages/count_tokens \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4-5",
    "system": "You are a scientist",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Uma resposta normal é uma linha de JSON, como {"input_tokens": 14}. Multiplique esse valor pela tarifa de entrada do seu modelo para obter uma estimativa aproximada do custo de entrada do pedido antes de o enviar. Faça a contagem com o modelo que vai realmente chamar, porque os modelos Claude 4.7 e posteriores geram aproximadamente 30% mais tokens para o mesmo texto do que modelos mais antigos, como Haiku 4.5. Se receber HTTP 401 com authentication_error, confirme se a chave está incorreta, revogada ou expirada. Uma chave fornecida corretamente também devolve este erro depois de expirar. Consulte a validade da chave na Console e crie uma nova, porque as chaves expiradas não podem ser reativadas. Se a chave parecer correta e a chamada continuar sem autenticação, ou se estiver a aceder ao Claude através de Bedrock, Vertex ou Foundry em vez de uma chave da Anthropic, as quatro formas de autenticar um cliente explicam o que cada uma exige e onde guardar a credencial.

Por que esta é uma questão diferente do plano gratuito nas aplicações

As pessoas pesquisam os dois temas, mas quase não têm relação entre si. O plano gratuito das aplicações Claude é um produto real que pode utilizar durante muito tempo sem cartão, com o consumo medido por uma janela de utilização móvel. o que o nível gratuito do Claude inclui explica o que está incluído e quando o limite é reposto. A API usa faturação pré-paga e não tem esse plano associado.

A consequência que mais confunde os utilizadores é que, na maioria dos planos, uma subscrição e uma chave de API são carteiras separadas. Pagar o Pro não financia uma chave, e os créditos da API não aumentam o limite de conversação. O Claude Code é onde esta separação causa mais confusão, porque pode ser executado com qualquer uma das opções: se o Claude Code está incluído no Pro explica quais os planos que o incluem e quando passa silenciosamente a faturar uma chave. Se está a escolher entre as duas opções, em vez de tentar evitar qualquer pagamento, custo da API Claude versus uma subscrição apresenta os cálculos com cargas de trabalho reais.

Existem duas exceções. Desde 7 October 2026, os planos Max e Team incluem um crédito mensal para a API. Em October 2026, o valor é de $100 no Max e de $200 no Ultra, anteriormente designado Max 20x. No Team, é de $20 por lugar Standard ou $100 por lugar Premium, partilhado e limitado a $500. Para o utilizar, associe uma organização do Console. Os novos subscritores têm primeiro de aguardar 7 dias. Não precisa de adicionar um método de pagamento à Claude Platform. O crédito cobre a API, o Agent SDK e os Managed Agents, mas não o Claude Code interativo. Também cobre claude -p quando o executa diretamente com uma chave de API da organização do Console associada. As execuções iniciadas pela Claude Code GitHub Action, por uma extensão de IDE ou pela aplicação de desktop Claude não estão cobertas. O crédito não utilizado expira no fim de cada ciclo de faturação. Quando o crédito se esgota, os pedidos são interrompidos até à chegada do crédito seguinte, salvo se também tiver comprado crédito de API ou tiver um acordo de faturação. Os planos Free, Pro e Enterprise não recebem este crédito. Por isso, consulte o que deve ponderar antes de mudar para o Max antes de comprar um plano principalmente por causa do crédito. A outra exceção é o Claude Enterprise, que combina um preço por lugar com a medição da utilização de tokens às tarifas padrão da API. como funciona o preço dos lugares do Enterprise explica o que o mínimo de lugares inclui antes de começar a medição.

Custo de um pedido depois de esgotar os créditos

Estas são as tarifas da API oficial em outubro de 2026, por milhão de tokens.

[
  {
    "label": "Haiku 4.5",
    "input_usd": 1,
    "output_usd": 5
  },
  {
    "label": "Sonnet 5",
    "input_usd": 2,
    "output_usd": 10
  },
  {
    "label": "Opus 5",
    "input_usd": 5,
    "output_usd": 25
  }
]

O Haiku 4.5 cobra 1 dólar por milhão de tokens de entrada e 5 dólares por milhão de tokens de saída. O Opus 5 cobra 5 e 25 pelos mesmos volumes, pelo que o modelo escolhido altera o custo em 5x antes de qualquer ajuste do prompt. O Sonnet 5 foi lançado a $2 e $10 como tarifa introdutória, e a Anthropic tornou entretanto esses valores no preço padrão. Por isso, o aumento para $3 e $15 previsto para 1 September 2026 não aconteceu. A saída custa cinco vezes mais do que a entrada em todos eles. Este é o dado mais útil desta página: uma resposta extensa custa mais do que uma pergunta longa. qual modelo Claude deve utilizar compara-os num trabalho concreto. O Fable 5 custa mais do que os três, com $10 por milhão de tokens de entrada e $50 por milhão de tokens de saída. Por isso, vale a pena esclarecer o que essas tarifas realmente permitem antes de lhe encaminhar qualquer tarefa rotineira. Há também três modelos mais recentes na tabela de preços: o Haiku 5.5 cobra $0.10 por milhão de tokens de entrada e $0.50 por milhão de tokens de saída para prompts até 100,000 tokens; o Sonnet 5.5 cobra $2 e $10; e o Opus 5.5 cobra $4 e $20.

Os caminhos reais mais baratos para experimentar

Quatro medidas resolvem quase tudo, e nenhuma exige um desconto.

• Comece pelo modelo mais pequeno que passe no seu teste. Classificação, extração, etiquetagem e encaminhamento raramente precisam de um modelo de primeira linha. Haiku 4.5 custa um quinto do preço de Opus 5 e responde mais depressa.
• Defina um limite para max_tokens. Este é o limite máximo rígido de tokens gerados, e a saída é a parte mais cara. Um classificador que responde com uma palavra não deve ter um orçamento de 16,000 tokens.
• Coloque em cache a parte do prompt que nunca muda. Uma leitura da cache custa 10% do preço base da entrada na maioria dos modelos (5% em Opus 5.5 e Sonnet 5.5, e 2.5% em Fable 5.1), e uma gravação na cache com duração de cinco minutos custa 1.25x, pelo que a cache se paga após uma única leitura. O caching faz correspondência por prefixo. Por isso, o texto estável tem de vir primeiro e a pergunta variável por último. Caso contrário, nada corresponde e paga o custo adicional da gravação sem obter qualquer benefício.
• Use processamento em lote para tudo o que não for interativo. A Message Batches API aplica um desconto de 50% tanto à entrada como à saída, e a maioria dos lotes termina em menos de uma hora. Tarefas noturnas, preenchimentos retroativos e execuções de avaliação devem ser colocados aí.

Um custo calculado para a primeira aplicação pequena

Considere um script de resumo de logs: 1,000 chamadas, cada uma enviando cerca de 800 tokens de entrada com linhas de log e recebendo cerca de 200 tokens de saída com o resumo. Isso corresponde a 800,000 tokens de entrada e 200,000 tokens de saída no Haiku 4.5.

[
  {
    "label": "Standard rates",
    "cost_usd": "1.80"
  },
  {
    "label": "Same job on the Batch API",
    "cost_usd": "0.90"
  }
]

O cálculo é 0.8 milhões de tokens de entrada a $1, mais 0.2 milhões de tokens de saída a $5. O total é de 1.80 dólares. Enviado como um batch, o mesmo trabalho custa 0.90. Um saldo de crédito inicial permite fazer muitos testes nessa escala. Por isso, a ausência de um nível gratuito só se torna um problema muito mais tarde do que as pessoas esperam. Para o tutorial completo num servidor seu, criar a primeira aplicação Claude API num VPS aborda a gestão de chaves, o streaming e os caminhos de erro.

Os níveis de utilização são limites máximos, não verbas disponíveis

A API coloca automaticamente cada organização num nível de utilização, com base no histórico de utilização e na situação da conta. Os níveis chamam-se Start, Build, Scale e Custom, e cada um define limites de taxa e um limite máximo de despesa mensal. Em outubro de 2026, os limites são $500 no Start, $1,000 no Build e $200,000 no Scale; o Custom não tem limite. Organizações novas e organizações com pouco histórico de utilização podem começar num nível Evaluation, com limites inferiores a estes, até acumularem histórico.

Interprete isto como um limite, não como um crédito. Estar no nível Start não significa que tem $500 disponíveis para gastar. Significa que não pode gastar mais de $500 num mês civil antes de a utilização ser suspensa até ao mês seguinte. Também pode definir o seu próprio limite de despesa, inferior ao limite máximo do nível. Esta deve ser a primeira medida em qualquer conta associada a um cartão, porque um ciclo descontrolado é uma forma muito mais comum de perder dinheiro do que o preço por token.

O que fazer quando o custo zero é um requisito obrigatório

Se o orçamento é realmente zero e tem de continuar assim, a API não é a ferramenta certa. Nenhuma comparação de planos altera esse facto. Restam duas opções honestas. Use o plano gratuito das aplicações Claude para trabalho interativo, aceitando que o uso é limitado por janela e que não existe um endpoint programável. Ou execute um modelo de pesos abertos em hardware alugado. Nesse caso, substitui uma cobrança por token por uma cobrança de servidor que controla: executar Ollama numa VPS para alojar um LLM localmente explica a memória necessária para cada tamanho de modelo e o que os modelos pequenos conseguem realmente fazer. Se a janela de uso for a limitação real, e não o dinheiro, Claude Pro a $20 por mês aumenta esse limite nas aplicações por menos do que muitas primeiras faturas da API. No entanto, não inclui uma chave de API nem crédito de API. A opção mais próxima de chamar o Claude a partir de código é o Claude Code, incluído no Pro, que pode ser executado de forma não interativa com claude -p e está sujeito aos mesmos limites de uso. A decisão de pagar esses $20 depende da frequência com que o limite gratuito realmente o impede de trabalhar. um guia de decisão para o Pro analisa essa questão com base em padrões de uso reais. Se estiver a comparar vários fornecedores, e não apenas planos do mesmo fornecedor, planos do Claude e do ChatGPT comparados pelo preço coloca lado a lado os níveis gratuitos e pagos de ambos, incluindo qual fica mais barato para tarefas de programação. Se uma subscrição que já paga fizer parte da despesa que está a tentar eliminar, cancelar ou baixar o nível dessa subscrição mantém o mês já comprado e impede a cobrança do mês seguinte.

Para qualquer situação intermédia, a resposta prática é usar uma chave com saldo, definir um limite de despesa baixo, escolher um modelo pequeno e ativar o armazenamento em cache de prompts desde o primeiro dia.

FAQ

A Claude API é gratuita?

Não. Não existe um plano gratuito nem uma franquia mensal de tokens sem custo. As contas novas recebem uma pequena quantidade de créditos gratuitos para testar a API. Depois disso, os pedidos consomem créditos pagos ou outros créditos concedidos para a API, incluindo o crédito mensal de API incluído nos planos Max, Ultra e Team, que não exige um método de pagamento na Claude Platform, e os $1,000 em créditos de API que o Anthropic's External Researcher Access Program atribui às contas de investigadores aprovados de segurança e alinhamento de IA. Algumas partes da plataforma não têm custo, incluindo a contagem de tokens, o carregamento e a eliminação de ficheiros, e a ferramenta de obtenção de conteúdo da web, sem contar os tokens do conteúdo obtido.

Recebo créditos gratuitos quando crio uma conta para a Claude API?

Sim, uma pequena quantidade, embora a documentação de preços da Anthropic não indique o valor. Considere-a suficiente para confirmar que a integração funciona, não como um orçamento no qual possa basear o desenvolvimento. Os créditos de avaliação alargados para avaliações empresariais são obtidos através da equipa de vendas da Anthropic, não atribuídos automaticamente.

Pagar pelo Claude Pro ou Max inclui acesso à API?

O Pro não inclui, mas o Max passou a incluir algum acesso. Uma subscrição Pro e uma API key são cobradas separadamente e têm uma medição diferente: o Pro aumenta a sua franquia nas aplicações Claude e no Claude Code, e não faz mais nada. Em outubro de 2026, o Max inclui um crédito mensal de API de $100 e o Ultra inclui $200, que pode ativar ao associar uma organização da Console. Esse crédito cobre chamadas à API, mas não o Claude Code interativo, expira em cada ciclo de faturação e não altera os seus limites nas aplicações. Depois de esgotar esse crédito, uma API key consome créditos pré-pagos e fica limitada por minuto pelo número de pedidos e de tokens.

Qual é a forma mais barata de testar a Claude API?

Conte primeiro os tokens, porque esse endpoint é gratuito. Depois, execute o teste no Haiku 4.5 com um max_tokens reduzido, coloque em cache um prefixo fixo do prompt com pelo menos 4,096 tokens para que as chamadas repetidas leiam 10% do preço de entrada e envie tudo o que não for interativo através da Batch API por metade do preço. Com essas configurações, mil chamadas pequenas custam menos de um dólar em outubro de 2026.