Quanto custa o Claude Code em Portugal: subscrição Pro ou Max, chave de API ao token e pagamento com MB WAY

O Claude Code em si não se paga à parte: paga-se o modelo que trabalha por trás, por uma de duas vias. Com uma subscrição, o Claude Pro custa US$ 20 por mês (US$ 17 por mês no plano anual, com US$ 200 pagos de uma vez) e o Claude Max US$ 100 (Max 5x) ou US$ 200 (Max 20x) por mês. São preços em dólares sem IVA, e a taxa normal do IVA em Portugal continental é de 23%. O plano Free não inclui o Claude Code, e no site da Anthropic a subscrição só se paga com cartão de crédito ou de débito. Com uma chave de API, paga-se ao token, sem mensalidade, e o uso não gasta os limites de nenhuma subscrição: no Kunavo, o Claude Sonnet 5 custa US$ 1,40 por milhão de tokens de entrada e US$ 7,00 por milhão de tokens de saída (30% abaixo do preço de lista da Anthropic), e a sessão de exemplo da documentação da Anthropic fica em cerca de US$ 0,258. O saldo carrega-se a partir de US$ 10, e o MB WAY é uma das formas de pagamento oferecidas quando o checkout do Stripe mostra o valor em euros.

Para escolher, basta pôr a mensalidade ao lado do custo por sessão: os US$ 20 do Pro compram no Kunavo cerca de 77 sessões como a do exemplo. Quem usa o Claude Code todos os dias e cabe nos limites do Pro ou do Max fica bem servido com a subscrição; quem o usa aos bocados, ou num mês sim e noutro não, paga menos com uma chave.

Fontes, consultadas a 3 de outubro de 2026: preços dos planos em claude.com/pricing e no artigo sobre o Max; formas de pagamento nas perguntas frequentes de faturação da Anthropic; preços da App Store portuguesa; taxa de IVA no Your Europe (Comissão Europeia); câmbio de referência do BCE de 2 de outubro de 2026. Os preços por token do Kunavo vêm do catálogo de modelos, verificado a 3 de outubro de 2026.

Subscrição ou chave de API: as duas vias lado a lado

As duas vias não se somam. Segundo a documentação da Anthropic sobre gateways, quando está definida uma credencial como ANTHROPIC_AUTH_TOKEN, os pedidos levam essa credencial em vez da sessão do claude.ai, e os limites da subscrição deixam de se aplicar; quem paga é o dono da chave. O artigo sobre o Claude Code com Pro ou Max diz o mesmo de ANTHROPIC_API_KEY: com ela definida, o Claude Code cobra o uso pela API e não pela subscrição (ambos consultados a 3 de outubro de 2026). Retirada a variável, volta a sessão do claude.ai.

Quanto custa a subscrição do Claude em Portugal

A página de preços da Anthropic, consultada a 3 de outubro de 2026, mostra os preços em dólares e avisa que não incluem os impostos aplicáveis. O quadro junta três números por plano: o preço no site, em dólares; uma conversão para euros com IVA, só para orientação; e o preço que a App Store portuguesa mostra para a compra dentro da app.

• Free: sem Claude Code. A documentação de instalação exige uma conta Pro, Max, Team, Enterprise ou Console.
• Pro: inclui o Claude Code, com os limites descritos mais abaixo.
• Max: a página de preços diz «a partir de US$ 100»; segundo o artigo sobre o Max, o Max 5x custa US$ 100 e o Max 20x US$ 200 por mês, e estes preços valem só para subscrições feitas no site.
• Team: o lugar Standard custa US$ 20 por mês com pagamento anual ou US$ 25 com pagamento mensal; o lugar Premium, US$ 100 ou US$ 125.

Portugal consta da lista de países suportados pela Anthropic, tanto para o Claude.ai como para a API.

Euros e IVA: o que se sabe e o que não se sabe

Segundo a Anthropic, é a morada de faturação que determina o cálculo dos impostos (artigo sobre morada de faturação e impostos). A taxa normal do IVA em Portugal é de 23% (Your Europe); as taxas das regiões autónomas dos Açores e da Madeira não constam desse quadro, por isso a conta acima vale para Portugal continental. O artigo sobre o Pro diz que o preço é cobrado na moeda local onde esta é suportada, que varia de região para região e que em algumas regiões o imposto já vem incluído no valor mostrado, enquanto noutras é somado no checkout. Nenhuma destas páginas diz qual é o caso de Portugal, nem se o preço aparece em euros. A coluna de orientação é, por isso, uma conta (dólares ÷ 1,1225, o câmbio de referência do BCE de 2 de outubro de 2026, × 1,23) e não é uma cotação: conta o valor que aparece no checkout (tudo consultado a 3 de outubro de 2026).

Na App Store o Max sai mais caro

A página da app Claude na App Store portuguesa (consultada a 3 de outubro de 2026) lista as compras dentro da app já em euros: Claude Pro a 22,00 € por mês ou 249,99 € por ano, Claude Max 5x a 149,99 € por mês e Claude Max 20x a 299,99 € por mês, além de créditos de utilização (Usage Credits) a 22,00 € e 49,00 €. Mesmo somando 23% de IVA ao preço do site convertido ao câmbio do BCE, o Max 5x comprado na app fica cerca de 40,41 € por mês acima. A página da Apple não indica se estes valores incluem IVA. A Anthropic avisa que os preços do Max são os das subscrições web e que no telemóvel podem variar consoante a plataforma; quem subscreve pela app paga à Apple ou à Google, não à Anthropic.

Como se paga a subscrição: só cartão

Segundo as perguntas frequentes de faturação, as subscrições compradas no site só se pagam com cartão de crédito ou de débito, e as compradas na app para iOS ou Android são cobradas pela App Store ou pelo Google Play. A Anthropic também não aceita processadores de pagamento de terceiros, como o PayPal (artigo sobre pagamentos recusados, consultado a 3 de outubro de 2026). O MB WAY e as referências Multibanco não estão, portanto, entre os métodos aceites para o Pro ou o Max. O MB WAY serve para a via da API, através do Kunavo: está explicado mais abaixo.

Limites: o que a mensalidade compra

No Pro, o limite de sessão repõe-se a cada cinco horas, e há ainda um limite semanal comum a todos os modelos (artigo sobre o Pro). O Claude e o Claude Code partilham os mesmos limites: o que se faz no chat conta para o Claude Code e vice-versa (artigo sobre o Claude Code com Pro ou Max, consultado a 3 de outubro de 2026). O que fazer quando o limite acaba está em Claude Pro and Max limits (em inglês).

Quanto custa o Claude Code via API (ao token)

Com uma chave de API não há mensalidade nem janelas de utilização: o Claude Code é cobrado como qualquer outro tráfego de API, por token. O quadro mostra dólares por milhão de tokens: à esquerda o preço de lista da Anthropic (claude.com/pricing, consultado a 3 de outubro de 2026), à direita o preço no Kunavo (catálogo de modelos, verificado a 3 de outubro de 2026). Os preços de cache são os da cache de 5 minutos.

A cada pedido, o Claude Code reenvia a conversa inteira. Com a cache de prompts, esse histórico é cobrado à tarifa de leitura de cache, muito mais baixa do que a de entrada (documentação de custos, consultada a 3 de outubro de 2026), e mesmo assim é a maior fatia da conta: no exemplo abaixo, as leituras de cache valem cerca de 51% do custo no Claude Sonnet 5. No Claude Opus 5.5, a leitura de cache custa o mesmo que no Claude Sonnet 5 (US$ 0,14 por milhão de tokens); o que encarece a sessão é a entrada, a escrita e a saída. O preço de todos os modelos Claude, com as contas em euros, está em preço da API do Claude em euros; como funciona a cache, em caching (em inglês); e o catálogo completo, na página de preços.

Exemplo: quanto custa uma sessão de Claude Code

Um cálculo que se pode refazer. O ponto de partida é a saída de exemplo do comando /usage na documentação de custos da Anthropic (consultada a 3 de outubro de 2026). Os pressupostos:

• As contagens de tokens vêm da documentação: 1.200 de entrada, 5.300 de saída, 940.000 lidos da cache e 50.000 escritos na cache. Para a Anthropic é uma sessão no Sonnet 4.6 que, a preço de lista, custa US$ 0,55.
• As mesmas contagens são recalculadas para os quatro modelos do quadro; muda só o preço por token, e as diferenças de tokenizador são ignoradas.
• A escrita de cache é cobrada à tarifa de 5 minutos: com uma chave de API, a cache dura 5 minutos por defeito (numa subscrição, uma hora, que desce para 5 minutos quando se gastam créditos de utilização).
• Os tokens de raciocínio (thinking) são cobrados como saída: quanto mais o modelo pensa, maior a parte da saída.
• Ficam de fora os pedidos em segundo plano, que segundo a documentação custam normalmente menos de US$ 0,04 por sessão.

Com o Claude Sonnet 5, esta sessão custa no Kunavo cerca de US$ 0,258 (a preço de lista, US$ 0,368). Com o Claude Opus 5.5 fica em cerca de US$ 0,384, com o Claude Opus 5 em US$ 0,645 e com o Claude Haiku 4.5 em US$ 0,129. O carregamento mínimo de US$ 10 dá para cerca de 38 sessões destas no Claude Sonnet 5.

Trata-se de uma estimativa feita sobre um exemplo publicado, não de um custo medido nem de um teto: uma refatoração longa pode gastar várias vezes mais, e uma pergunta rápida bem menos. Para fazer a conta à sessão em curso, o /usage mostra as quatro contagens dentro do Claude Code; basta copiá-las para este script:

# Custo de uma sessão do Claude Code (em dólares, preços do Kunavo),
# a partir dos quatro números que o /usage mostra.
TARIFAS = {  # por milhão de tokens: (entrada, saída, leitura de cache, escrita de cache)
    "claude-sonnet-5": (1.40, 7.00, 0.14, 1.75),
    "claude-opus-5-5": (2.80, 14.00, 0.14, 3.50),
    "claude-opus-5": (3.50, 17.50, 0.35, 4.375),
    "claude-haiku-4-5": (0.70, 3.50, 0.07, 0.875),
}

def custo_sessao(modelo, entrada, saida, leitura_cache, escrita_cache):
    i, o, r, w = TARIFAS[modelo]
    return (entrada * i + saida * o + leitura_cache * r + escrita_cache * w) / 1e6

# A sessão de exemplo da documentação de custos da Anthropic:
print(round(custo_sessao("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000), 3))  # 0.258

Atenção: o valor em dólares que o /usage mostra é calculado localmente pelo Claude Code ao preço de lista. Com o Kunavo, o que sai do saldo é o que aparece no histórico de utilização do painel. Para simular outras contagens, há a calculadora de custo de tokens do Claude.

Como ordem de grandeza, a mesma documentação dá médias de empresas: cerca de US$ 13 por programador por dia de trabalho ativo e US$ 150–250 por programador por mês, com 90% dos utilizadores abaixo de US$ 30 por dia ativo. São médias da Anthropic em ambiente empresarial, não preços do Kunavo.

Subscrição ou chave de API: qual escolher

• Uso ocasional ou irregular: chave de API. Com o exemplo acima, US$ 20 no Kunavo chegam para cerca de 77 sessões com o Claude Sonnet 5, e um mês sem uso custa zero.
• Uso diário e intenso que caiba nos limites: Pro ou Max. A subscrição compra-se no site, com cartão; para o Max, pelas contas de orientação acima (câmbio do BCE, 23% de IVA), o site fica mais barato do que a app. Quando o limite acaba, espera-se pela reposição ou ativam-se créditos de utilização (artigo sobre o Claude Code com Pro ou Max).
• Não se somam. Com ANTHROPIC_AUTH_TOKEN definido, o Claude Code deixa de usar a subscrição; sem a variável, volta a ela. Com a chave só em export na shell, pode alternar-se de terminal para terminal; colocada no ~/.claude/settings.json, vale em todos. Numa mesma sessão, os pedidos vão por uma das vias, não pelas duas.

Os quatro modelos fixados e porquê

Segundo a documentação de configuração de modelos (consultada a 3 de outubro de 2026), os aliases do Claude Code apontam para a versão recomendada e mudam com o tempo; para fixar uma versão, define-se a variável correspondente. Na API da Anthropic, o modelo predefinido e o alias opus apontam hoje para o Opus 5.5, e o alias sonnet para o Sonnet 5.5. O Kunavo serve o Opus 5.5, mas não serve o Sonnet 5.5. Daí as quatro linhas:

Para usar pontualmente outro modelo do quadro de preços, escreve-se o nome completo no /model, por exemplo claude-opus-5.

Pagar com MB WAY (só para a via da API)

O Kunavo é um gateway de API compatível com as APIs da Anthropic e da OpenAI, e o Claude Code liga-se diretamente a ele. O saldo carrega-se numa página de pagamento do Stripe. Os preços estão em dólares; a quem paga a partir de Portugal, o Stripe mostra o valor em euros, e segundo a documentação do Stripe sobre Adaptive Pricing esse câmbio inclui uma taxa de conversão de 2–4%, paga pelo comprador, e fica garantido durante 24 horas. Quem escolher pagar em dólares não paga essa taxa, mas o banco pode aplicar o seu próprio câmbio e comissões. O MB WAY só aparece com o valor em euros, porque no checkout do Stripe este método aceita apenas o euro (consultado a 3 de outubro de 2026).

Como funciona o MB WAY no checkout, segundo a documentação do Stripe sobre o MB WAY (consultada a 3 de outubro de 2026):

• Introduz-se o número de telemóvel associado à app MB WAY. A maioria dos utilizadores tem um número português (+351), mas o MB WAY também aceita números internacionais.
• Chega uma notificação à app MB WAY; aprova-se o pagamento na app e volta-se à página. O resultado, pago ou recusado, é conhecido de imediato.
• Cada pagamento MB WAY vai de 0,50 € a 5.000 €. Por predefinição, cada utilizador tem um limite diário acumulado de 1.000 €, que pode subir até 10.000 € na app MB WAY.
• No extrato bancário aparece «Stripe Inc» e o montante, não o nome do Kunavo: o MB WAY não aceita descritivos personalizados.
• O MB WAY não faz pagamentos recorrentes nem guarda os dados para pagamentos futuros, por isso cada carregamento com MB WAY é manual. O carregamento automático só funciona com um cartão guardado ou com Link.

Os montantes de carregamento do Kunavo face aos limites do MB WAY, em euros só para orientação (câmbio do BCE de 2 de outubro de 2026; o valor exato é o do checkout):

Alternativa: cartão virtual MB NET. A app MB WAY gera cartões virtuais MB NET: escolhe-se o tipo de cartão e o valor a carregar e depois introduzem-se os dados do cartão no site do comerciante (mbway.pt, consultado a 3 de outubro de 2026). No checkout do Kunavo, seriam introduzidos no campo do cartão, mas isso não foi testado: a página da SIBS não indica a rede do cartão, e o checkout pode recusá-lo. O MB WAY direto no checkout em euros é o caminho previsto.

Outras formas de pagamento no checkout em euros: cartões de crédito e de débito (Visa e Mastercard), Apple Pay (Safari e iOS), Google Pay (Chrome e Android, com o Google Pay configurado) e Link. Não disponíveis: referências Multibanco (o checkout em euros do Kunavo vem da conversão automática do Stripe, que não as inclui), PayPal, débito direto SEPA, Bizum e, nos checkouts em euros, a Klarna.

1. Criar uma conta no Kunavo.
2. Em Billing, carregar o saldo: escolher o montante (mínimo US$ 10); com o valor em euros no checkout, escolher MB WAY, introduzir o número de telemóvel e aprovar na app.
3. Em /app/keys, criar uma chave; começa por sk-kn-.
4. Pôr a chave no Claude Code como se explica a seguir e confirmar a ligação com /status.

• Mínimo de US$ 10 por carregamento; nos montantes maiores há bónus: paga US$ 100 e recebe US$ 110; paga US$ 1.000 e recebe US$ 1.200; paga US$ 5.000 e recebe US$ 6.250.
• Pré-pago: sem mensalidade, o saldo não expira e os pedidos falhados (4xx/5xx) não são cobrados.
• Em comparação, os créditos de API comprados diretamente à Anthropic expiram um ano depois da compra e não são reembolsáveis (centro de ajuda da Anthropic, consultado a 3 de outubro de 2026).
• Estas formas de pagamento só carregam o saldo do Kunavo. Não pagam o Claude Pro, o Max, a App Store nem créditos da Anthropic.

O passo a passo completo do checkout está em pagar o Claude com MB WAY.

Ligar o Claude Code ao Kunavo

Para instalar o Claude Code, ver instalar o Claude Code. Depois, o Claude Code lê o endereço da API e a chave a partir de variáveis de ambiente. Estas seis linhas vão para a configuração da shell, e a seguir abre-se um terminal novo:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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

Os mesmos valores podem ir para o bloco env do ~/.claude/settings.json pessoal, e não para o ficheiro de definições do projeto, que costuma ser versionado no git e levaria a chave com ele. Quando a mesma variável está na shell e no ficheiro de definições, vale a do ficheiro (documentação sobre ligar a um gateway, consultada a 3 de outubro de 2026).

{
  "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"
  }
}

Porquê ANTHROPIC_AUTH_TOKEN. O Kunavo aceita a chave tanto no cabeçalho Authorization: Bearer como em x-api-key. É a variável que decide o cabeçalho: ANTHROPIC_AUTH_TOKEN vai em Authorization: Bearer e ANTHROPIC_API_KEY vai em x-api-key. A diferença está no Claude Code: com ANTHROPIC_AUTH_TOKEN, a chave passa a valer de imediato; com ANTHROPIC_API_KEY, em modo interativo, o Claude Code pede uma aprovação única antes de a usar (mesma documentação).

Por fim, arranca-se o claude e executa-se /status: a linha Anthropic base URL deve mostrar https://api.kunavo.com e a linha Auth token deve referir ANTHROPIC_AUTH_TOKEN. Mais definições na integração do Claude Code.

Como reduzir o custo do Claude Code

1. Manter a cache quente. Com uma chave de API, a cache dura 5 minutos por defeito (documentação de custos). Depois de uma pausa para o café mais longa, a primeira mensagem já não lê o contexto da cache: volta a escrevê-lo. Numa conversa de 200.000 tokens com o Claude Sonnet 5, a diferença no Kunavo é entre cerca de US$ 0,028 e cerca de US$ 0,35, só nessa mensagem e a cada pausa.
2. Usar /clear entre tarefas sem relação. A documentação recomenda recomeçar com /clear ao mudar de assunto, em vez de arrastar um histórico que já não serve.
3. Sonnet por defeito, Opus para o difícil. Segundo a mesma documentação, o Sonnet resolve bem a maior parte das tarefas de programação e custa menos do que o Opus; o Opus fica para decisões de arquitetura e raciocínios em vários passos.
4. Haiku para o trabalho simples. Na configuração acima, as tarefas em segundo plano já vão para o Claude Haiku 4.5; para subagentes simples, pode definir-se model: haiku.
5. Menos raciocínio nas tarefas simples. Os tokens de raciocínio são cobrados como saída, e no Opus 5.5 o raciocínio não se pode desligar; com /effort baixa-se o esforço.

Bom saber

• O Kunavo não emite faturas, nem faturas com IVA ou NIF. Em Billing fica o histórico dos carregamentos, com data, montante e estado.
• Com uma chave de API, o Claude Code não usa os limites da subscrição: o custo sai do saldo do Kunavo.
• Com ANTHROPIC_BASE_URL a apontar para um endereço que não é da Anthropic, o Remote Control fica desativado (documentação sobre ligar a um gateway).
• A Anthropic não endossa, não mantém nem audita produtos de gateway de terceiros (documentação sobre gateways, consultada a 3 de outubro de 2026).
• Este guia existe também em inglês (Claude Code pricing) e numa versão para o Brasil (Claude Code preço).

Perguntas frequentes