Instalação do Claude Code: passo a passo no Windows, macOS e Linux, chave de API sem assinatura e pagamento com cartão

Resposta curta: o Claude Code é instalado com uma única linha adequada ao seu terminal. No macOS, Linux e WSL, execute install.sh; no Windows PowerShell, irm … | iex; e no Prompt de Comando (CMD), a linha install.cmd; as três aparecem logo abaixo. Esse método não requer Node.js; se quiser instalar com npm, será necessário Node.js 22 ou superior. Após a instalação, há duas opções: entrar com uma conta Claude (Pro, Max, Team, Enterprise ou Console; o plano gratuito não inclui o Claude Code) ou usar uma chave de API sem contratar uma assinatura. No caminho da chave, defina ANTHROPIC_BASE_URL=https://api.kunavo.com (sem adicionar /v1 ao final), ANTHROPIC_AUTH_TOKEN e as quatro variáveis que fixam os modelos; /status na sessão mostra se a chave está ativa. Você paga apenas pelos tokens consumidos. Carregue o saldo com cartão Visa ou Mastercard, Apple Pay, Google Pay ou Link, a partir de 10 USD; não há parcelamento nem opção Papara.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un instalação ve conexão com o gateway belgelerinden 3 de outubro de 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 3 de outubro de 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: página de países compatíveis da Anthropic Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3 de outubro de 2026).

Qual linha usar em qual terminal?

A maioria das pessoas que enfrentam problemas na instalação erra o terminal, não o comando. A tabela abaixo associa seu ambiente à linha correta. Se você usa Windows, explicamos na próxima seção como identificar o terminal.

Requisitos do sistema

O que a documentação oficial de instalação exige (em 3 de outubro de 2026):

• Sistema operacional: macOS 13.0 ou mais recente; Windows 10 versão 1809 ou posterior, ou Windows Server 2019 ou posterior; no Linux, Ubuntu 20.04, Debian 10 e Alpine Linux 3.19 ou mais recentes.
• Hardware: pelo menos 4 GB de RAM e processador x64 ou ARM64. O Windows de 32 bits não é compatível.
• Shell: Bash, Zsh, PowerShell ou CMD.
• Node.js: desnecessário para o instalador nativo; apenas 22 ou superior no caminho do npm.
• Conta: se você for entrar, Pro, Max, Team, Enterprise ou Console. Com uma chave de API, não é necessária assinatura nem login.

Parte das explicações em turco encontradas na internet copia uma versão antiga desta lista: ainda há textos que indicam Node.js 18 para npm e Ubuntu 18.04 ou CentOS 7 para Linux. A documentação atual informa Node.js 22 e Ubuntu 20.04 como versões mínimas. O aviso de que “todas as etapas falharão sem um proxy fixo com saída nos EUA” também não se aplica à Turquia; pelo contrário, uma VPN aberta pode causar um erro de região (consulte os erros de download nas seções de macOS e Linux).

Instalação do Claude Code no Windows

No Windows, você não precisa de privilégios de administrador, WSL nem Git. A documentação oficial não pede que o terminal seja aberto como administrador; você pode ignorar a etapa “execute o PowerShell como administrador” presente em alguns vídeos em turco. A única coisa que você precisa saber é em qual terminal está:

• Se o prompt começar com PS C:\Users\KullaniciAdi>, como PS, você está no PowerShell: use a linha irm … | iex.
• Se não houver PS no início e aparecer apenas C:\Users\KullaniciAdi>, você está no Prompt de Comando: use a linha install.cmd.
• Não abra a entrada “Windows PowerShell (x86)” no menu Iniciar. Como é um processo de 32 bits, ele exibirá o erro Claude Code does not support 32-bit Windows até mesmo em um computador de 64 bits; selecione “Windows PowerShell”, sem o sufixo.

Colar a linha na janela errada está entre as principais causas de erros no Windows, e as mensagens não deixam isso claro. Uma linha do CMD colada no PowerShell retorna The token '&&' is not a valid statement separator. Uma linha do PowerShell colada no CMD exibe, no Windows em turco, “'irm' não é reconhecido como um comando interno ou externo, programa operável ou arquivo em lotes.” (em um sistema em inglês, 'irm' is not recognized as an internal or external command). Se você tentar a linha curl … | bash do macOS no PowerShell, verá A parameter cannot be found that matches parameter name 'fsSL' ou 'bash' is not recognized as the name of a cmdlet; em um sistema em turco, esses textos podem aparecer traduzidos. Nos três casos, a solução é a mesma: use a linha correspondente ao terminal em que você está.

Git for Windows e WSL são necessários?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

Há dois motivos para escolher o WSL: precisar de ferramentas Linux ou querer executar comandos em um ambiente protegido (sandbox). A instalação nativa do Windows não tem sandbox:

Se você permanecer no WSL, faça a instalação e o uso no terminal do WSL: a linha de macOS/Linux funciona ali, e claude também é aberto a partir dali.

O comando “claude” não foi encontrado

Se, mesmo após a instalação, você vir 'claude' is not recognized (no macOS e Linux, command not found: claude), provavelmente está trabalhando em uma janela aberta antes da instalação: o instalador atualiza a variável PATH, mas o terminal antigo não a vê. Primeiro, feche e reabra o terminal. No Windows, o programa fica em %USERPROFILE%\.local\bin\claude.exe; no macOS e Linux, em ~/.local/bin/claude. Se uma nova janela também não resolver no Windows, adicione a pasta à variável PATH do usuário usando os comandos da documentação:

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1 cannot be loaded

Essa mensagem aparece apenas no caminho do npm: o npm grava um iniciador .ps1 para o PowerShell, e a política de execução de scripts do sistema (execution policy) o bloqueia. A documentação apresenta três saídas: executar os comandos com os nomes npm.cmd e claude.cmd, mudar para o instalador nativo no PowerShell ou permitir scripts locais apenas para o seu usuário:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalação no macOS e Linux

A linha install.sh acima aparece na guia “Native Install (Recommended)” da documentação oficial e também funciona exatamente assim no WSL. O Claude Code instalado dessa forma baixa sozinho as novas versões em segundo plano. Se preferir usar um gerenciador de pacotes, Homebrew e WinGet também são opções oficiais; porém, segundo a documentação, essas instalações não se atualizam por padrão, e você obtém a nova versão pelo gerenciador de pacotes:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Se vier HTML ou 403 em vez do script

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Documentação de problemas de instalação (kontrol: 3 de outubro de 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

Instalação com npm: Node.js 22 é obrigatório

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

Três hábitos causam problemas nesse caminho:

• Instalar com sudo. A documentação alerta sobre problemas de permissão e riscos de segurança ao usar sudo npm install -g.
• Atualizar com npm update -g. O correto é npm install -g @anthropic-ai/claude-code@latest.
• Desativar dependências opcionais. O executável principal vem como dependência opcional em um pacote @anthropic-ai/claude-code-* específico da plataforma. A flag --omit=optional ou optional=false em .npmrc ignora esse pacote: a instalação termina sem erro, mas, ao abrir claude no macOS e Linux, aparece claude native binary not installed.

A instalação funcionou?

Independentemente do caminho escolhido, abra um terminal novo e execute estes dois comandos:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Se claude --version exibir um número de versão, o programa está instalado. claude doctor lista o estado da instalação e problemas nos arquivos de configuração sem fazer login; se algo der errado na próxima etapa, você poderá distinguir aqui se o problema está na instalação ou na configuração.

Sem assinatura: configurar uma chave de API para o Claude Code

Na primeira abertura, claude solicita sua identidade. Se você tiver um plano Claude, entre e continue; se não tiver um plano ou preferir pagar conforme o uso em vez de uma tarifa mensal fixa, execute o Claude Code com uma chave de API. A diferença entre os dois caminhos:

O caminho da chave é uma configuração prevista pela Anthropic: ANTHROPIC_BASE_URL é uma variável integrada do Claude Code, e a documentação oficial de gateway explica como executar o Claude Code atrás de um proxy ou gateway usando essa variável. Você não instala um plug-in, patch ou cliente modificado. No macOS e Linux, adicione as seis linhas ao arquivo do shell (~/.zshrc ou ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Antes de tornar as configurações permanentes no Windows, teste em uma única sessão do PowerShell; quando a janela for fechada, as variáveis também desaparecerão:

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Se quiser que sejam válidas em todos os terminais, escreva os mesmos valores no bloco env do arquivo de configurações do usuário. Segundo a documentação, esse arquivo se aplica a todos os seus projetos; no Windows, ele fica em %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json mencionado em alguns resumos de IA não é o caminho da documentação oficial. Se o arquivo já existir, adicione apenas o bloco env sem apagar o conteúdo existente:

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

As seis variáveis e pontos de atenção

ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY? A chave do Kunavo é aceita nos dois cabeçalhos: Authorization: Bearer e x-api-key. A diferença está no comportamento do Claude Code. ANTHROPIC_AUTH_TOKEN vai para o cabeçalho Bearer e funciona sem fazer perguntas. Já ANTHROPIC_API_KEY vai para o cabeçalho x-api-key e pede sua confirmação na primeira vez no modo interativo; se você responder “não”, a chave será ignorada sem aviso, e para reativá-la será necessário acessar /config → Use custom API key. Este guia usa ANTHROPIC_AUTH_TOKEN por esse motivo.

Por que fixamos os modelos? à documentação de configuração de modelos göre (kontrol: 3 de outubro de 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3 de outubro de 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Tarifas no Kunavo (entrada / saída, por 1 milhão de tokens): Claude Sonnet 5 $1,40 / $7,00 (tarifa da Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5, responsável pelos trabalhos em segundo plano, $0,70 / $3,50.

Onde não escrever a chave e qual valor prevalece?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: documentação do gateway bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

Primeira abertura e verificação com /status

Se as variáveis estiverem no lugar correto, o comando claude abre a sessão sem mostrar a tela de login; a documentação do gateway (verificação: 3 de outubro de 2026) descreve esse comportamento quando ANTHROPIC_AUTH_TOKEN está configurado. Se a tela de login aparecer, o Claude Code não encontrou a chave. Uma causa comum é a chave estar apenas nas configurações do projeto: no modo interativo, o bloco env do arquivo .claude/settings.json ou .claude/settings.local.json do projeto só é lido depois que o assistente de primeira execução e a pergunta de confiança na pasta são concluídos. A chave deve estar em um local lido antes do assistente: no shell, com export, nas configurações do usuário em ~/.claude/settings.json ou nas configurações gerenciadas (managed settings).

Depois de iniciar a sessão, digite /status. Duas linhas fornecem informações suficientes:

• Anthropic base URL: aparece apenas quando um endereço personalizado está definido e deve mostrar https://api.kunavo.com. Se a linha não aparecer, ANTHROPIC_BASE_URL não chegou à sessão.
• Auth token: se o nome ANTHROPIC_AUTH_TOKEN aparecer ao lado, as solicitações estão sendo enviadas com uma chave de API. Se, em vez disso, houver uma linha Login method mostrando sua conta claude.ai, o Claude Code ainda está usando o login salvo; encerre a sessão, abra um novo terminal e verifique onde você escreveu as variáveis.

Testar sem abrir o Claude Code

Você também pode testar o endereço e a chave independentemente do Claude Code. O método da documentação oficial envia uma solicitação com um único token de saída; uma quantia muito pequena será descontada do seu saldo. O comando lê as variáveis do shell atual; se a chave estiver apenas no arquivo de configurações, faça export primeiro neste terminal. Se a resposta começar com {"id":"msg_, o endereço e a chave estão corretos; 401 indica que a chave foi rejeitada.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

A versão equivalente para PowerShell está abaixo; se funcionar, a resposta conterá um campo id que começa com msg_:

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

O que muda com uma chave de API?

• Remote Control e ditado por voz não ficam disponíveis. Segundo a documentação, ambos exigem uma identidade claude.ai e não funcionam quando ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ou um apiKeyHelper está ativo. A partir da v2.1.196, o Remote Control também fica desativado quando ANTHROPIC_BASE_URL aponta para um servidor fora da Anthropic.
• /fast aparece desativado. Segundo a documentação, quando apenas um bearer token está definido, o Claude Code não pergunta pelo estado do modo rápido (fast mode) e o considera desativado.
• A busca de ferramentas MCP fica desativada por padrão. documentação do MCP (kontrol: 3 de outubro de 2026) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• Os números de /context são aproximados. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, à documentação de compatibilidade do gateway göre (kontrol: 3 de outubro de 2026) bağlam kullanımını karakter sayısından tahmin eder.

Os detalhes técnicos da integração estão na documentação de integração do Claude Code em inglês; a versão em inglês deste guia é Install Claude Code.

Pagamento da Turquia: cartão, Apple Pay, Google Pay, Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Perguntas frequentes sobre os planos pagos do Claude, kontrol: 3 de outubro de 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Cadastre-se no Kunavo. Um endereço de e-mail ou uma conta do Google é suficiente; o cadastro não solicita dados do cartão.
2. Na página Billing, escolha o valor. O mínimo é 10 USD; não há assinatura nem tarifa mensal. Em valores altos, um bônus é adicionado: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. A página de pagamento da Stripe será aberta. Escolha cartão (Visa, Mastercard), Apple Pay, Google Pay ou Link; Apple Pay e Google Pay só aparecem em dispositivos e navegadores compatíveis com eles.
4. Em seguida, na página API Keys, gere uma chave que comece com sk-kn-. A chave é exibida apenas uma vez; copie-a e escreva-a imediatamente no valor ANTHROPIC_AUTH_TOKEN.

O valor aparece em liras ou em dólares?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. documentação da Adaptive Pricing da Stripe (kontrol: 3 de outubro de 2026) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

Parcelamento, Papara, transferência e Troy

• Não há parcelamento; o pagamento é feito à vista. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3 de outubro de 2026).
• Não há Papara, transferência bancária/EFT nem PayPal. Essas opções não aparecem na página de pagamento.
• Troy: Stripe'ın bandeiras de cartões aceitas sayfasında Troy geçmiyor (kontrol: 3 de outubro de 2026). Visa ya da Mastercard logolu bir kartla ödeyin.
• Não há fatura. O Kunavo não emite nenhuma fatura, incluindo e-Arşiv; o detalhamento dos seus carregamentos fica na página Billing.

Se o cartão for recusado, verifique primeiro o aplicativo móvel do seu banco: o cartão precisa estar habilitado para compras pela internet e transações internacionais. O carregamento automático só pode ser configurado com cartão salvo ou Link. O saldo não tem data de validade, e solicitações malsucedidas não são cobradas. As tarifas de todos os modelos estão no guia Preços da API do Claude.

Quanto custa uma sessão de trabalho?

No caminho da chave, o custo depende inteiramente da quantidade de tokens. Em cada solicitação, o Claude Code envia novamente o contexto da conversa; quando a parte inicial e inalterada do contexto é lida do cache, ela é contabilizada por uma tarifa muito menor. A tabela abaixo não é uma medição, mas um cálculo baseado em suposições explícitas; também não deve ser interpretada como um limite superior. Suposições:

• 40.000 tokens de entrada por solicitação; 36.000 deles (%90) são lidos do cache, e os 4.000 restantes são gravados no cache;
• 1.000 tokens de saída por solicitação;
• 50 solicitações na sessão; as Claude Haiku 4.5 chamadas em segundo plano não foram incluídas no cálculo;
• Para Claude Sonnet 5, a leitura do cache corresponde a %10 da tarifa de entrada, e a gravação no cache custa 1,25 vezes esse valor. Cada modelo da tabela foi calculado com suas próprias tarifas.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. Documentação oficial de custos (kontrol: 3 de outubro de 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

Todas as tarifas estão na página de preços. Você pode estimar seu próprio uso com a calculadora de custos de tokens do Claude (em inglês). O guia Preço do Claude Code aborda a questão de saber se uma assinatura ou a API é mais adequada.

Mensagens de erro e soluções

Limitações que você precisa conhecer

• O Kunavo não emite faturas; também não há e-Arquivo.
• O pagamento é à vista: não há parcelamento, Papara nem transferência bancária. Para o carregamento automático, é necessário um cartão salvo ou o Link.
• Isto não é uma assinatura Claude Pro ou Max, mas uma API paga por token. Com o caminho da chave, o Remote Control e a ditado por voz não funcionam, /fast aparece desativado e a busca de ferramentas MCP fica desativada por padrão.
• O Kunavo não oferece o Sonnet 5.5 em 3 de outubro de 2026; se os modelos não forem fixados, o alias sonnet retornará 404.
• A documentação oficial do Claude Code e o documento de integração do Kunavo estão disponíveis apenas em inglês (verificação: 3 de outubro de 2026).

Perguntas frequentes