How much does Claude Code cost in Portugal: Pro or Max subscription, API key billed by token, and payment with MB WAY

Claude Code itself is not paid for separately: you pay for the model running behind it through one of two options. With a subscription, Claude Pro costs US$ 20 per month (US$ 17 per month on the annual plan, with US$ 200 paid upfront), and Claude Max costs US$ 100 (Max 5x) or US$ 200 (Max 20x) per month. These prices are in dollars, excluding VAT, and the standard VAT rate in mainland Portugal is 23%. The Free plan does not include Claude Code, and subscriptions on Anthropic's website can only be paid for by credit or debit card. With an API key, you pay per token, with no monthly fee, and usage does not count against any subscription limits: on Kunavo, Claude Sonnet 5 costs US$ 1,40 per million input tokens and US$ 7,00 per million output tokens (30% below Anthropic's list price), and the example session in Anthropic's documentation costs around US$ 0,258. You can top up your balance starting at US$ 10, and MB WAY is one of the payment methods offered when Stripe checkout displays the amount in euros.

To choose, simply compare the monthly fee with the cost per session: the US$ 20 for Pro buys about 77 sessions like the example on Kunavo. Those who use Claude Code every day and fit within Pro or Max limits are well served by the subscription; those who use it in bursts, or in one month but not the next, pay less with a key.

Sources, consulted on October 3, 2026: preços dos planos em claude.com/pricing e no article about Max; formas de pagamento nas billing FAQs da Anthropic; preços da Portuguese App Store; taxa de IVA no Your Europe (Comissão Europeia); câmbio de referência do ECB de October 2, 2026. Os preços por token do Kunavo vêm do catálogo de modelos, verificado a October 3, 2026.

Subscription or API key: the two options side by side

As duas vias não se somam. Segundo a Anthropic documentation on 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 article about Claude Code with Pro or 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 October 3, 2026). Retirada a variável, volta a sessão do claude.ai.

How much does a Claude subscription cost in Portugal

Anthropic’s pricing page, consulted on October 3, 2026, shows prices in dollars and warns that they exclude applicable taxes. The table combines three figures for each plan: the website price in dollars; a conversion to euros including VAT, for guidance only; and the price shown by the Portuguese App Store for the in-app purchase.

• Free: sem Claude Code. A installation documentation exige uma conta Pro, Max, Team, Enterprise ou Console.
• Pro: includes Claude Code, with the limits described below.
• Max: a página de preços diz «a partir de US$ 100»; segundo o article about 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: the Standard seat costs US$ 20 per month with annual billing or US$ 25 with monthly billing; the Premium seat costs US$ 100 or US$ 125.

Portugal consta da list of supported countries pela Anthropic, tanto para o Claude.ai como para a API.

Euros and VAT: what is known and unknown

Segundo a Anthropic, é a morada de faturação que determina o cálculo dos impostos (article about billing addresses and taxes). 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 article about 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 October 2, 2026, × 1,23) e not a quote: conta o valor que aparece no checkout (tudo consultado a October 3, 2026).

Max costs more in the App Store

A página da app Claude na Portuguese App Store (consultada a October 3, 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 € more per month. 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.

How to pay for the subscription: card only

Segundo as billing FAQs, 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 (article about declined payments, consultado a October 3, 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.

Limits: what the monthly fee buys

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 (article about 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 (article about Claude Code with Pro or Max, consultado a October 3, 2026). O que fazer quando o limite acaba está em Claude Pro and Max limits (em inglês).

How much Claude Code costs via the API (per 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 October 3, 2026), à direita o preço no Kunavo (catálogo de modelos, verificado a October 3, 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 (cost documentation, consultada a October 3, 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. In Claude Opus 5.5, cache reads cost the same as in Claude Sonnet 5 (US$ 0,14 per million tokens); what makes the session more expensive is input, writing, and output. O preço de todos os modelos Claude, com as contas em euros, está em Claude API price in euros; como funciona a cache, em caching (em inglês); e o catálogo completo, na pricing page.

Example: how much a Claude Code session costs

Um cálculo que se pode refazer. O ponto de partida é a saída de exemplo do comando /usage na Anthropic cost documentation (consultada a October 3, 2026). Os pressupostos:

• The token counts come from the documentation: 1.200 input, 5.300 output, 940.000 read from the cache, and 50.000 written to the cache. For Anthropic, this is a Sonnet 4.6 session that costs US$ 0,55 at list price.
• The same counts are recalculated for the four models in the table; only the per-token price changes, and tokenizer differences are ignored.
• Cache writing is charged at the 5-minute rate: with an API key, the cache lasts 5 minutes by default (with a subscription, one hour, decreasing to 5 minutes when usage credits are spent).
• Reasoning tokens (thinking) are charged as output: the more the model thinks, the larger the output portion.
• Background requests are excluded; according to the documentation, they normally cost less than US$ 0,04 per session.

With Claude Sonnet 5, this session costs about US$ 0,258 on Kunavo (at list price, US$ 0,368). With Claude Opus 5.5, it comes to about US$ 0,384, with Claude Opus 5 it is US$ 0,645, and with Claude Haiku 4.5 it is US$ 0,129. The minimum top-up of US$ 10 covers about 38 of these sessions on Claude Sonnet 5.

This is an estimate based on a published example, not a measured cost or a cap: a long refactoring may cost several times more, and a quick question much less. To calculate the current session, /usage shows the four counts inside Claude Code; simply copy them into this 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

Attention: the dollar amount shown by /usage is calculated locally by Claude Code at list price. With Kunavo, the amount deducted from the balance is what appears in the dashboard’s usage history. To simulate other counts, use the Claude token cost calculator.

As a rough guide, the same documentation gives enterprise averages: about US$ 13 per programmer per active working day and US$ 150–250 per programmer per month, with 90% of users below US$ 30 per active day. These are Anthropic enterprise averages, not Kunavo prices.

Subscription or API key: which should you choose?

• Occasional or irregular use: API key. With the example above, US$ 20 on Kunavo covers about 77 sessions with Claude Sonnet 5, and a month with no usage costs zero.
• Daily, intensive use that fits within the limits: 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 (article about Claude Code with Pro or Max).
• They do not stack. With ANTHROPIC_AUTH_TOKEN set, Claude Code stops using the subscription; without the variable, it returns to it. With the key only export in the shell, you can switch from terminal to terminal; placed in ~/.claude/settings.json, it applies everywhere. In the same session, requests use one option or the other, not both.

The four pinned models and why

Segundo a model configuration documentation (consultada a October 3, 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 does not serve Sonnet 5.5. Daí as quatro linhas:

To use another model from the price table occasionally, enter its full name in /model, for example claude-opus-5.

Paying with MB WAY (API option only)

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 Stripe documentation on 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 October 3, 2026).

Como funciona o MB WAY no checkout, segundo a Stripe documentation on MB WAY (consultada a October 3, 2026):

• Enter the mobile number associated with the MB WAY app. Most users have a Portuguese number (+351), but MB WAY also accepts international numbers.
• A notification arrives in the MB WAY app; approve the payment in the app and return to the page. The result, paid or declined, is known immediately.
• Each MB WAY payment ranges from 0,50 € to 5.000 €. By default, each user has a cumulative daily limit of 1.000 €, which can be raised to 10.000 € in the MB WAY app.
• The bank statement shows “Stripe Inc” and the amount, not the Kunavo name: MB WAY does not accept custom descriptors.
• MB WAY does not support recurring payments or save details for future payments, so each MB WAY top-up is manual. Automatic top-up works only with a saved card or Link.

Kunavo top-up amounts against MB WAY limits, in euros for guidance only (ECB exchange rate as of October 2, 2026; the exact amount is the one shown at checkout):

Alternative: MB NET virtual card. 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 October 3, 2026). No checkout do Kunavo, seriam introduzidos no campo do cartão, mas this has not been tested: 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.

Other payment methods at the euro checkout: credit and debit cards (Visa and Mastercard), Apple Pay (Safari and iOS), Google Pay (Chrome and Android, with Google Pay configured), and Link. Unavailable: Multibanco references (Kunavo's euro checkout comes from Stripe's automatic conversion, which does not include them), PayPal, SEPA direct debit, Bizum, and Klarna, which is available only to buyers in the United States.

1. Create a Kunavo account.
2. In Billing, top up the balance: choose the amount (minimum US$ 10); with the amount shown in euros at checkout, choose MB WAY, enter your mobile phone number, and approve it in the app.
3. At /app/keys, create a key; it starts with sk-kn-.
4. Add the key to Claude Code as explained below and confirm the connection with /status.

• Minimum of US$ 10 per top-up; larger amounts receive bonuses: 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.
• Prepaid: no monthly fee, the balance does not expire, and failed requests (4xx/5xx) are not charged.
• Em comparação, os créditos de API comprados diretamente à Anthropic expiram um ano depois da compra e não são reembolsáveis (Anthropic help center, consultado a October 3, 2026).
• These payment methods only top up your Kunavo balance. They do not pay for Claude Pro, Max, the App Store, or Anthropic credits.

The complete checkout walkthrough is available at pay for Claude with MB WAY.

Connect Claude Code to Kunavo

To install Claude Code, see install Claude Code. Claude Code then reads the API address and key from environment variables. Add these six lines to your shell configuration, then open a new terminal:

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 (documentation about connecting to a gateway, consultada a October 3, 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"
  }
}

Why ANTHROPIC_AUTH_TOKEN. Kunavo accepts the key both in the Authorization: Bearer header and in x-api-key. This is the variable that determines the header: ANTHROPIC_AUTH_TOKEN is sent in Authorization: Bearer, and ANTHROPIC_API_KEY is sent in x-api-key. The difference is in Claude Code: with ANTHROPIC_AUTH_TOKEN, the key takes effect immediately; with ANTHROPIC_API_KEY, in interactive mode, Claude Code requests one-time approval before using it (same documentation).

Finally, start claude and run /status: the Anthropic base URL line should show https://api.kunavo.com, and the Auth token line should mention ANTHROPIC_AUTH_TOKEN. More settings are available in the Claude Code integration.

How to reduce Claude Code costs

1. Keep the cache warm. Com uma chave de API, a cache dura 5 minutos por defeito (cost documentation). 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. Use /clear between unrelated tasks. The documentation recommends starting over with /clear when changing topics, instead of dragging along a history that is no longer useful.
3. Sonnet by default, Opus for difficult tasks. According to the same documentation, Sonnet handles most programming tasks well and costs less than Opus; Opus is for architecture decisions and multi-step reasoning.
4. Haiku for simple work. In the configuration above, background tasks already use Claude Haiku 4.5; for simple subagents, you can set model: haiku.
5. Use less reasoning for simple tasks. Reasoning tokens are charged as output, and reasoning cannot be disabled in Opus 5.5; use /effort to lower the effort.

Good to know

• Kunavo does not issue invoices, including VAT invoices or invoices with a tax identification number. Billing contains the top-up history, including the date, amount, and status.
• With an API key, Claude Code does not use subscription limits: the cost is deducted from your Kunavo balance.
• Com ANTHROPIC_BASE_URL a apontar para um endereço que não é da Anthropic, o Remote Control fica desativado (documentation about connecting to a gateway).
• A Anthropic não endossa, não mantém nem audita produtos de gateway de terceiros (gateway documentation, consultada a October 3, 2026).
• This guide is also available in English (Claude Code pricing) and in a version for Brazil (Claude Code price).

Frequently asked questions