Preços do Claude Code 2026 — assinatura vs API, tarifas por modelo e quanto custa um mês

O Claude Code tem dois preços completamente separados, e a maior parte da confusão sobre seu custo vem de misturá-los. Uma assinatura do claude.ai inclui o serviço em uma taxa mensal fixa com limites de uso. Uma chave de API cobra por token sem taxa mensal e sem limites. Esta página apresenta os números atuais para ambos, os cálculos para decidir qual você quer e quanto um mês real realmente custa.

Tarifas verificadas em 10 de outubro de 2026 com base em claude.com/pricing e na documentação de preços da API da Anthropic. Os preços por token da Kunavo são lidos ao vivo do catálogo de modelos.

TL;DR — qual é para você

Eles não se acumulam. Enquanto uma variável de credencial estiver definida, o Claude Code usa a chave e sua assinatura fica parada — os limites dela deixam de se aplicar e o uso é cobrado da chave. Execute /status para ver qual está ativo.

Rota 1 — preços da assinatura

O Claude Code exige uma conta Pro, Max, Team, Enterprise ou Console; a documentação de configuração da Anthropic afirma que o plano gratuito do Claude.ai não inclui acesso ao Claude Code. Taxas dos planos conforme publicadas em claude.com/pricing:

O mecanismo importante é o limite, não a taxa. O uso em um plano é medido contra uma janela contínua de cinco horas e uma janela semanal, ambas compartilhadas com o Claude Chat — portanto, uma tarde no aplicativo web consome a mesma cota da sua sessão de programação. Trocar de modelo com /model não reinicia uma janela, porque as janelas abrangem todos os modelos.

Rota 2 — preços da API, por modelo

Com uma chave, não há plano nem janela: o Claude Code é cobrado como tráfego comum da Claude API. Arquivos e saída de ferramentas contam como tokens de entrada; edições, explicações e tokens de raciocínio contam como saída. Tarifas por 1M de tokens:

Uma observação sobre o Claude Sonnet 5: a Anthropic tornou sua tarifa de $2,00 / $10,00 o preço padrão permanente em 31 de agosto de 2026 — o aumento para $3 / $15 previsto para 1º de setembro foi cancelado — e a Kunavo cobra $1,40 / $7,00, 30% abaixo dele. Os detalhes completos por modelo estão no guia de preços da Claude API.

O cache faz parte do preço

O Claude Code reenvia toda a conversa a cada etapa, portanto a maior parte do que é cobrado é contexto repetido — exatamente o que o cache de prompts foi feito para tratar. Os multiplicadores publicados pela Anthropic se aplicam ao tráfego do Claude Code como a qualquer outro tráfego:

Em uma sessão aquecida, a maior parte dos tokens de entrada são leituras de cache cobradas a um décimo da tarifa, razão pela qual uma estimativa ingênua de tokens × preço superestima muito a cobrança. Isso também explica o pior padrão de custo no Claude Code: voltar depois de uma longa pausa perde o cache e reprocessa todo o contexto pelo preço integral.

Quanto um mês realmente custa

O custo acompanha as etapas agentivas, não os dias do calendário. Uma etapa é uma ida e volta do modelo dentro de uma tarefa — aproximadamente 25.000 tokens de entrada e 1.200 de saída depois de contar o prompt do sistema, a conversa e o contexto novo dos arquivos. Nas tarifas da Kunavo, sem cache:

Vinte dias assim no Sonnet 5 custam cerca de $87 — contra cerca de $124 no preço de tabela da Anthropic para o mesmo modelo. Esses números são deliberadamente pessimistas: sem cache, um único modelo para tudo.

Para comparar com implantações reais, a própria documentação de custos da Anthropic informa uma média de cerca de $13 por desenvolvedor por dia ativo e $150–250 por desenvolvedor por mês em implantações empresariais, com 90% dos usuários permanecendo abaixo de $30 por dia ativo. Esse é o preço de tabela usando uma combinação de modelos e é o número que deve orientar o orçamento da equipe.

O ponto de equilíbrio

Coloque as duas rotas na mesma escala. A $0,043 por etapa no Sonnet 5:

• $20 (Pro) compra cerca de 460 etapas agentivas por mês — aproximadamente 23 tarefas de vinte etapas.
• $100 (Max, faixa inicial) compra cerca de 2300 etapas — aproximadamente 115 tarefas.

A regra é simples: se você conclui confortavelmente algumas dezenas de tarefas reais por mês, todos os meses, a taxa fixa oferece bom valor. Se seu uso ocorre em picos — algumas semanas intensas, outras sem nada — o pagamento por token vence, porque as semanas tranquilas são gratuitas. As equipes quase sempre querem chaves de qualquer forma, para atribuição por assento e limites rígidos de gastos. Faça seus próprios cálculos na calculadora de custos.

Calculando o custo de uma sessão com os próprios números

O /usage do Claude Code mostra as quatro contagens de tokens da sessão atual. Essa é a entrada honesta para uma estimativa de custo, porque separa as leituras de cache da entrada nova:

# What one Claude Code session costs, from its own token counts.
# Run /usage in Claude Code to get the four numbers for a real session.
RATES = {  # USD per 1M tokens on Kunavo: (input, output)
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-4-6": (2.10, 10.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
    "claude-opus-5-5":   (2.80, 14.00),
}

def session_cost(model, inp, out, cache_read=0, cache_write=0):
    i, o = RATES[model]
    return (
        inp / 1e6 * i            # fresh input
        + out / 1e6 * o          # output, incl. thinking tokens
        + cache_read / 1e6 * i * 0.10   # cache reads bill at 10% of input
        + cache_write / 1e6 * i * 1.25  # 5-minute cache writes at 125%
    )

# The example session Anthropic's docs print for /usage:
print(session_cost("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))

Observe o efeito da divisão no total: nesse exemplo, a sessão contém 940.000 tokens lidos do cache contra 1.200 tokens de entrada novos, e as leituras de cache são cobradas a um décimo da tarifa de entrada.

As quatro alavancas que alteram o número

1. Deixe o cache de prompts funcionar. A entrada em cache é cobrada a 10% da tarifa de entrada, e o Claude Code relê a conversa a cada etapa, portanto este é o maior efeito individual disponível (como funciona).
2. Limpe o contexto entre tarefas não relacionadas. O contexto é reenviado a cada etapa, então uma única sessão que dura o dia todo é quadraticamente cara. Uma tarefa nova volta a ter um contexto pequeno.
3. Combine o modelo com o trabalho. Deixar o maior modelo como padrão é a causa mais comum de uma cobrança surpreendente. O Sonnet atende à maior parte do trabalho de programação; reserve o Opus para arquitetura e raciocínio difícil em várias etapas.
4. Mantenha a linha do Haiku. Sem ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, o alias haiku do Claude Code solicita um ID de modelo que a Kunavo não oferece (Haiku 5.5 a partir da v2.1.293), então /model haiku e os subagentes configurados com haiku retornam 404. Essa mesma linha direciona para fora do modelo principal as chamadas que o Claude Code faz automaticamente para gerar resumos e títulos.

Executando o Claude Code na Kunavo

O Claude Code lê ANTHROPIC_BASE_URL nativamente, portanto funciona com qualquer endpoint que ofereça a Anthropic Messages API — sem plugin, proxy ou binário modificado. Essa é a maneira compatível de manter a mesma CLI e os mesmos modelos com uma tarifa menor por token:

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

ANTHROPIC_BASE_URL é apenas a origem — o Claude Code adiciona /v1/messages por conta própria. Mantenha as linhas de modelo: o padrão integrado do Claude Code e seu alias opus resolvem ambos para o Opus mais recente e, se a Kunavo ainda não oferecer esse modelo, a primeira solicitação retornará 404. O alias sonnet já solicita o Sonnet 5.5, que a Kunavo não oferece — sem ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, a fase de execução de opusplan e qualquer subagente definido como model: sonnet retornam 404. A fixação de opus é o Opus 5.5 (claude-opus-5-5, $2,80 / $14,00 por milhão aqui), que requer o Claude Code v2.1.280 ou posterior — execute claude update em uma instalação mais antiga. Use ANTHROPIC_AUTH_TOKEN em vez de ANTHROPIC_API_KEY: os dois vão em cabeçalhos diferentes, e o segundo requer uma aprovação interativa única que nunca é solicitada novamente depois de recusada. Crie a chave sk-kn- em no painel depois de se cadastrar e carregar $10 — sem mensalidade, e o saldo não expira, portanto um mês sem uso realmente não custa nada. A configuração completa, incluindo o que deixa de funcionar por trás de um gateway, está no guia do roteador do Claude Code; os detalhes das credenciais estão no guia da chave de API do Claude Code.

Perguntas frequentes