Preços do Claude Code 2026 — assinatura ou API, custo real e ponto de equilíbrio

O Claude Code tem dois preços completamente distintos, e quase toda a confusão sobre quanto ele custa vem da mistura entre eles. Uma assinatura do claude.ai inclui a ferramenta em um plano mensal com limites de uso. Uma chave de API cobra por token, sem assinatura e sem limite máximo. Esta página reúne os números atuais das duas opções, o cálculo para escolher, quanto custa um mês real de trabalho — e como pagar a partir da França.

Preços verificados em 3 de outubro de 2026 em comparação com claude.com/pricing e a documentação de preços da API da Anthropic. Os preços por token da Kunavo são lidos em tempo real do catálogo de modelos.

As duas opções, lado a lado

Quanto custa a assinatura

O Claude Code está incluído nas ofertas pagas do claude.ai — a documentação de instalação da Anthropic especifica que o plano gratuito não dá acesso ao Claude Code. O Pro custa $20/mês ($17/mês na cobrança anual, $200 de uma só vez) e cobre um desenvolvedor trabalhando dentro dos limites do plano. O Max começa em $100/mês, para quem atinge esses limites constantemente; seus níveis são apresentados como múltiplos do pacote Pro (5x, 20x). Team e Enterprise acrescentam cotas por assento e controles de gastos para administradores.

Dois detalhes importantes para quem está na França: a cobrança é mensal e denominada em dólares, com as tarifas de transação em moeda estrangeira do seu banco aplicadas todos os meses; e os limites de uso são compartilhados com o chat Claude, portanto uma tarde de conversa consome a mesma janela que sua sessão de código.

Quanto custa a opção de API

Aqui não há assinatura: você paga por token. Preços em USD por 1 milhão de tokens, com a tarifa pública da Anthropic ao lado para comparação direta.

A entrada armazenada em cache é cobrada a 10% da tarifa de entrada, e uma gravação de cache de 5 minutos custa 125%. Como o Claude Code relê toda a conversa a cada etapa, são esses dois coeficientes que dominam a cobrança real — mais do que a escolha do modelo.

O custo real de uma etapa

Uma “etapa agentiva” = uma ida e volta com o modelo dentro de uma tarefa: prompt do sistema + conversa + contexto de arquivos na entrada, uma edição ou explicação na saída. Medido, isso resulta em aproximadamente 25.000 tokens de entrada / 1.200 de saída. Nas tarifas da Kunavo:

O ponto de equilíbrio

Ele depende do número de etapas, não do número de dias trabalhados. A $0.043 por etapa no Sonnet 5, uma assinatura Pro de $20 equivale a aproximadamente 460 etapas por mês, ou cerca de 23 tarefas de 20 etapas. Abaixo disso, o pagamento conforme o uso é mais barato e um mês sem programar não custa nada; acima disso, a assinatura vence até os limites do plano.

Para obter seus próprios números, execute /usage no Claude Code e registre os quatro números:

# Ce qu'a coûté une session Claude Code, à partir de ses tokens.
# Lancez /usage dans Claude Code pour récupérer les quatre nombres réels.
RATES = {  # USD par 1M de tokens chez 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 cout_session(model, inp, out, cache_read=0, cache_write=0):
    i, o = RATES[model]
    return (
        inp / 1e6 * i                   # input neuf
        + out / 1e6 * o                 # output, tokens de raisonnement inclus
        + cache_read / 1e6 * i * 0.10   # lecture de cache : 10% du tarif input
        + cache_write / 1e6 * i * 1.25  # écriture de cache 5 min : 125%
    )

print(cout_session("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))

Apontando o Claude Code para a Kunavo

O Claude Code se comunica com qualquer endpoint compatível com a Anthropic. Duas variáveis de ambiente são suficientes para mudar para a opção conforme o uso sem alterar a instalação nem os hábitos de uso:

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

Mantenha as quatro linhas de modelo. O modelo padrão do Claude Code e seu alias opus apontam para o Opus mais recente e, se a Kunavo ainda não o oferecer, a primeira solicitação retornará um erro 404. A linha ANTHROPIC_DEFAULT_OPUS_MODEL fixa o alias em Opus 5.5 (claude-opus-5-5), que exige o Claude Code v2.1.280 ou posterior (caso contrário, execute claude update). Já o alias sonnet solicita o Sonnet 5.5, que a Kunavo não oferece: sem a linha ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, a fase de execução de opusplan e os subagentes definidos como sonnet falharão com um erro 404. A chave é gerada em /app/keys. O passo a passo completo está no guia de configuração da chave; se você usa o Kilo Code em vez do CLI, consulte como configurar o Kilo Code com Claude.

Quatro alavancas para pagar menos

1. Deixe o prompt caching agir. A entrada armazenada em cache custa 10% da tarifa de entrada, e o Claude Code relê toda a conversa a cada etapa: esta é, por si só, a alavanca mais forte. Consulte a documentação sobre cache.
2. Limpe o contexto entre duas tarefas sem relação. Manter uma única sessão longa faz os tokens de entrada crescerem a cada etapa.
3. Escolha o modelo de acordo com o tamanho do problema. Não deixe o maior como padrão: entre Haiku e Opus, a tabela acima mostra uma ordem de grandeza da diferença por etapa.
4. Envie as chamadas internas para o Haiku. Com ANTHROPIC_DEFAULT_HAIKU_MODEL, as chamadas auxiliares que o Claude Code faz para si mesmo usam o modelo mais barato.

Pagar a partir da França

A assinatura é uma cobrança mensal em dólares no cartão. O caminho da chave de API passa por um checkout da Stripe que aceita cartões (Visa, Mastercard, Amex), Apple Pay, Google Pay e Link para recargas com um gesto. Não há Pay by Bank na França: nesse checkout, ele é oferecido apenas a compradores do Reino Unido, Irlanda e Finlândia (na Stripe, a França ainda está em prévia privada). É uma carteira pré-paga: recarga mínima de US$ 10, e o saldo não expira — um mês sem programar não gera nenhuma cobrança. Mais detalhes na documentação de cobrança.

Está comparando com o agente da OpenAI? O mesmo cálculo para o Codex está em preço do Codex.

Perguntas frequentes