Preço do Claude Code em 2026: assinatura ou API, quanto custa um mês e qual vale mais a pena

O Claude Code é gratuito para instalar, mas não para usar, e o preço depende de como você paga. Com uma assinatura do claude.ai, ele está incluído na cota: o Claude Pro custa US$ 20 por mês (US$ 17 por mês com pagamento anual) e o Claude Max custa a partir de US$ 100 por mês, em setembro de 2026; o plano gratuito (Free) não inclui o Claude Code. Com uma chave de API, não há cota e o pagamento é por tokens: no Kunavo, o Claude Sonnet 5 custa $1,40 por milhão de tokens de entrada e $7,00 por milhão de tokens de saída, então uma interação típica do agente (cerca de 25.000 tokens de entrada e 1.200 de saída) custa aproximadamente $0,0434. Segundo a própria documentação da Anthropic, o gasto real fica em torno de US$ 13 por desenvolvedor por dia de uso. Todos os valores estão em dólares americanos (USD).

Quase toda a confusão sobre quanto custa o Claude Code vem de misturar essas duas opções. Esta página apresenta os valores atuais de ambas, o cálculo para escolher entre elas, o custo de um mês real e como apontar o Claude Code para uma API mais barata sem reinstalar nada.

Tarifas verificadas em 3 de outubro de 2026 com claude.com/pricing (planos, em setembro de 2026) e a documentação de preços da API da Anthropic. As tarifas do Kunavo são obtidas do catálogo de modelos do site.

Quanto custa o Claude Code? As duas formas de pagar

As duas opções não são cumulativas. Enquanto houver uma variável de credencial definida, o Claude Code usa a chave e deixa a assinatura de lado: os limites do plano deixam de se aplicar e o consumo é cobrado na chave. O comando /status mostra qual está ativa.

Preço do Claude Code com assinatura

O Claude Code exige uma conta Pro, Max, Team, Enterprise ou de console (API); segundo a documentação de instalação da Anthropic, o plano Free do Claude.ai não inclui o Claude Code. Preços publicados em claude.com/pricing, em setembro de 2026:

O que mais pesa não é a taxa, mas o limite. O uso de um plano é medido em uma janela móvel de cinco horas e outra semanal, ambas compartilhadas com o chat do Claude: uma tarde de conversa na web consome a mesma alocação que sua sessão de programação. Trocar de modelo com /model não reinicia a janela, pois as janelas abrangem todos os modelos. O que cada plano inclui fora da programação e quando a API vale a pena para conversar está em preços do Claude.

O Claude Code é gratuito?

A ferramenta sim; o uso, não. A CLI, as extensões para VS Code e JetBrains e toda a configuração são gratuitas: o que é pago são as chamadas ao modelo. Não existe um nível gratuito que permita ao Claude Code usar um modelo sem pagar: o plano Free do Claude.ai não o inclui, e a API é cobrada por token desde a primeira chamada.

A opção com menor compromisso é uma chave com pagamento conforme o uso: sem mensalidade, com recarga mínima de US$ 10 e saldo que não expira, portanto um mês sem programar custa US$ 0. Com esses US$ 10 e o Sonnet 5, dá para cerca de 230 etapas agênticas, aproximadamente 12 tarefas de 20 etapas. A versão longa, em inglês: is Claude Code free.

Preço do Claude Code com API, por modelo

Com uma chave, não há plano nem janelas: o Claude Code é cobrado como tráfego normal da API do Claude. Arquivos e saída das ferramentas contam como tokens de entrada; edições, explicações e raciocínio, como tokens de saída. Tarifas por milhão de tokens (entrada / saída):

No Kunavo, claude-opus-5 custa $3,50 / $17,50, 30% abaixo da tarifa oficial ($5,00 / $25,00). Se o que importa é o orçamento, Sonnet 5 executa a mesma etapa por $0,0434.

O cache também faz parte do preço

O Claude Code reenvia toda a conversa a cada etapa, portanto a maior parte do que é cobrado é contexto repetido: justamente o que o cache de prompts barateia. Multiplicadores sobre a tarifa de entrada:

Em uma sessão com o cache aquecido, a maioria dos tokens de entrada são leituras a um décimo da tarifa; por isso, multiplicar tokens pelo preço superestima muito a fatura. Isso também explica o pior padrão de gastos no Claude Code: voltar após uma pausa longa, quando o cache já expirou, obriga a processar todo o contexto novamente pelo preço integral.

Quanto custa um mês de Claude Code

O gasto acompanha as etapas agênticas, não os dias. Uma etapa é uma ida e volta ao modelo dentro de uma tarefa: cerca de 25.000 tokens de entrada (prompt do sistema, conversa e arquivos) e 1.200 de saída. Com as tarifas do Kunavo e sem cache:

Vinte dias assim com o Sonnet 5 totalizam aproximadamente $87. Com o Opus 5 à tarifa oficial da Anthropic, seriam cerca de $310; no Kunavo, $217. São valores deliberadamente pessimistas: sem cache e com um único modelo para tudo.

Para comparar com implantações reais, a documentação da Anthropic sobre os gastos do Claude Code fala em cerca de US$ 13 por desenvolvedor por dia de uso e US$ 150 a US$ 250 por desenvolvedor por mês em implantações empresariais, com 90% dos usuários abaixo de US$ 30 por dia. São valores à tarifa oficial com uma combinação de modelos e servem de referência para orçar uma equipe.

O ponto de equilíbrio

Com as duas opções no mesmo eixo, a $0,0434 por etapa com o Sonnet 5:

• US$ 20 (Pro) equivalem a cerca de 460 etapas agênticas por mês, aproximadamente 23 tarefas de 20 etapas.
• US$ 100 (Max, nível inicial) equivalem a cerca de 2.300 etapas, aproximadamente 115 tarefas.

A regra que resulta disso: se você programa com o Claude Code quase todos os dias, a assinatura geralmente sai mais barata. No ritmo médio medido pela Anthropic, um mês de trabalho ultrapassa com folga os US$ 100 do Max, e o plano cobre isso enquanto você não atingir seus limites. Se o seu uso for irregular — semanas intensas e semanas sem usar —, o pagamento conforme o uso vence, porque as semanas tranquilas não custam nada. As equipes costumam preferir chaves de qualquer forma: distribuem os gastos por pessoa e permitem um limite mensal por chave. Para fazer seu próprio cálculo, use a calculadora de preços por token (em inglês).

Calcule uma sessão com seus próprios números

O comando /usage do Claude Code mostra as quatro contagens de tokens da sessão. É o dado confiável para estimar o gasto, pois separa as leituras do cache da entrada nova:

# Cuánto costó una sesión de Claude Code, a partir de sus propios tokens.
# Ejecuta /usage dentro de Claude Code para obtener los cuatro números.
TARIFAS = {  # USD por millón de tokens en Kunavo: (entrada, salida)
    "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),
}

def gasto_sesion(modelo, entrada, salida, lectura_cache=0, escritura_cache=0):
    e, s = TARIFAS[modelo]
    return (
        entrada / 1e6 * e                   # entrada nueva
        + salida / 1e6 * s                  # salida, razonamiento incluido
        + lectura_cache / 1e6 * e * 0.10    # lectura de caché: 10 % de la entrada
        + escritura_cache / 1e6 * e * 1.25  # escritura en caché: 125 %
    )

# La sesión de ejemplo que muestra la documentación de Anthropic para /usage:
print(gasto_sesion("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))  # ≈ 0.26

Nessa sessão de exemplo, há 940.000 tokens lidos do cache contra 1.200 de entrada nova. À tarifa integral, esses 940.000 tokens custariam $1,32; como leituras do cache, custam $0,1316. Por isso, o cache, mais do que a escolha do modelo, é a maior alavanca de gastos no Claude Code.

As quatro alavancas que reduzem a fatura

1. Deixe o cache trabalhar. A entrada lida do cache custa 10% da tarifa, e o Claude Code relê a conversa a cada etapa: é o maior impacto disponível (como funciona).
2. Limpe entre tarefas sem relação. O contexto é reenviado a cada etapa, portanto uma sessão que dura o dia todo fica mais cara a cada mensagem; com /clear e uma tarefa nova, o contexto volta a ser pequeno.
3. Escolha o modelo por tarefa. Deixar o maior modelo como padrão é a causa mais comum de uma fatura inesperada: uma etapa com o Fable 5 custa 5,0 vezes o que custa uma com o Sonnet 5. O Sonnet resolve a maior parte da programação; reserve o Opus e o Fable para arquitetura e raciocínio difícil.
4. Envie as chamadas em segundo plano para o Haiku. O Claude Code faz suas próprias chamadas para resumos e títulos; ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 é uma linha e representa economia pura.

Usando o Claude Code com o Kunavo

O Claude Code lê ANTHROPIC_BASE_URL nativamente, portanto funciona contra qualquer endpoint que ofereça a Messages API da Anthropic: sem plugin, sem proxy e sem alterar a instalação. Para uma sessão no terminal:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # el origen, sin /v1
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, e um valor que já termina em /v1 acaba em um 404. Use ANTHROPIC_AUTH_TOKEN e não ANTHROPIC_API_KEY: as duas variáveis enviam a chave em cabeçalhos diferentes, e o Kunavo autentica com Authorization: Bearer, que é a que envia ANTHROPIC_AUTH_TOKEN. As linhas de modelo não são opcionais: o modelo padrão do Claude Code e seus aliases opus e sonnet acompanham os modelos mais recentes da Anthropic e, se o Kunavo ainda não oferecer algum deles, a primeira solicitação retornará um 404. O alias sonnet solicita o Sonnet 5.5, que o Kunavo não oferece: sem ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, a fase de execução do opusplan e qualquer subagente com model: sonnet acabam em 404. O alias opus fica fixado no Opus 5.5 (claude-opus-5-5), que requer o Claude Code v2.1.280 ou posterior; se sua versão for anterior, execute claude update. Para que a configuração persista, coloque as variáveis no bloco env da sua configuração de usuário:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Nunca no .claude/settings.json do projeto, que acaba no repositório. Na extensão do VS Code, as variáveis ficam em claudeCode.environmentVariables, dentro da configuração de usuário do VS Code. Para verificar, abra a aba de status com /status: uma linha «Auth token» confirma que a credencial está ativa; se aparecer «Login method» com uma conta do claude.ai, a variável não foi carregada. O guia completo está em Claude Code com Kunavo (em inglês).

A chave sk-kn- é criada no painel de chaves depois que você se cadastra e recarrega $10. O saldo é recarregado com Stripe —cartões (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link, entre outros métodos conforme o seu país; o débito direto SEPA não está disponível—, não expira e as solicitações malsucedidas não são cobradas. Cada chave aceita um limite mensal de gastos (quando atingido, a API responde com 402) e uma lista de IPs permitidos: útil para fornecer uma chave a cada desenvolvedor ou à CI sem surpresas no fim do mês.

O que muda, e o que não muda, ao usar o Claude Code com uma API

O núcleo do Claude Code — o agente, as ferramentas, os subagentes e os servidores MCP — funciona sobre a Messages API e não muda. O que muda: com uma credencial de gateway ativa, o Remote Control e a digitação por voz deixam de estar disponíveis, pois precisam de uma identidade do claude.ai.

E o que o Kunavo não substitui: ele oferece o Claude sobre capacidade compartilhada, sem cota dedicada nem SLA contratual. Se sua equipe precisar de uma cota garantida ou de um acordo de nível de serviço, contrate diretamente com a Anthropic. E se você programa com o Claude Code diariamente e cabe nos limites do plano, a assinatura provavelmente sairá mais barata; a API compensa para uso irregular, em equipes que querem distribuir e limitar os gastos e em automação.

Perguntas frequentes