Em resumo: você instala o Claude Code com uma única linha no terminal, sem Node.js e sem privilégios de administrador. A linha depende apenas da janela: curl -fsSL https://claude.ai/install.sh | bash no macOS, Linux e WSL, irm https://claude.ai/install.ps1 | iex no Windows PowerShell e a terceira linha abaixo no Prompt de Comando (CMD). Quem não tem uma assinatura Claude conecta o Claude Code ao Kunavo por uma chave de API: ANTHROPIC_BASE_URL=https://api.kunavo.com (sem /v1), ANTHROPIC_AUTH_TOKEN e quatro variáveis de modelo. /status mostra se isso funcionou. O pagamento é por token, usando um saldo a partir de $10, recarregado com cartão de débito ou crédito (incluindo Visa Debit e Debit Mastercard), Apple Pay, Google Pay, Link ou, na Áustria, EPS. PayPal e débito SEPA não são aceitos.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 3 de outubro de 2026 mit Configurar o Claude Code abgeglichen, die Variablen mit der Liste der Variáveis de ambiente. Kunavos Preise und Zahlungswege sind auf dem Stand vom 3 de outubro de 2026. Deutschland, Österreich und die Schweiz stehen in Anthropics Lista de países sowohl für Claude.ai als auch für die API (Stand 3 de outubro de 2026). Eine englische Fassung gibt es unter Instalar o Claude Code.
Visão geral do processo
- Instalar: execute a linha apropriada acima e depois abra uma nova janela do terminal.
- Verificar:
claude --versionexibe um número de versão. - Decidir: fazer login com uma assinatura Claude ou usar uma chave de API (comparação abaixo).
- Com uma chave de API: recarregar o saldo, criar a chave e definir seis variáveis de ambiente.
- Verificar: digite
/statusna sessão.
Requisitos: o que vale hoje
Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die página oficial de configuração am 3 de outubro de 2026 verlangt.
| Tema | Ainda é comum ler | Segundo a Anthropic |
|---|---|---|
| macOS | macOS 10.15 ou mais recente | macOS 13.0 ou mais recente |
| Windows | somente pelo WSL | nativamente no Windows 10 a partir da versão 1809 ou no Windows Server 2019; o WSL é uma opção, não uma exigência |
| Permissões | iniciar o PowerShell como administrador | não é necessário |
| Node.js | Node.js 18 ou mais recente | somente para a instalação pelo npm; nesse caso, versão 22 ou mais recente |
| npm | desatualizado | continua sendo um caminho documentado; o instalador nativo é recomendado |
| Linux | — | Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Computador e shell | — | pelo menos 4 GB de RAM, x64 ou ARM64, sem Windows de 32 bits; Bash, Zsh, PowerShell ou CMD |
| Localização | — | um país compatível com a Anthropic; Alemanha, Áustria e Suíça estão incluídas |
| Conta | — | para fazer login, Pro, Max, Team, Enterprise ou Console; com uma chave de API, nem assinatura nem login |
Instalar no macOS, Linux e WSL
Cole no terminal a linha com install.sh. Na documentação oficial, esse caminho está na aba “Native Installation (Recommended)”. O script coloca o inicializador em ~/.local/bin/claude, e a instalação passa a se atualizar sozinha em segundo plano. No WSL, a mesma linha deve ser executada no terminal do WSL.
Instalar o Claude Code no Windows
Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut Página de configuração für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.
Quem confunde as janelas recebe uma mensagem em inglês ou, em um Windows em alemão, possivelmente em alemão. A linha do CMD no PowerShell termina com The token '&&' is not a valid statement separator, e a linha do PowerShell no CMD termina com 'irm' is not recognized as an internal or external command. Em ambos os casos, significa a mesma coisa: janela errada; use a outra linha.
Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut Solução de problemas startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.
Git para Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.
Se deve ser nativo ou no WSL depende de onde seus projetos estão:
| Variante | Requisito | Sandbox | Adequada quando |
|---|---|---|---|
| Windows nativo | nenhum; Git para Windows opcional | não | seus projetos e ferramentas forem executados no próprio Windows |
| WSL 2 | WSL 2 ativado | sim | você precisar de ferramentas Linux ou quiser executar comandos em uma sandbox |
| WSL 1 | WSL 1 ativado | não | o WSL 2 não estiver disponível no computador |
Com o WSL, instale e inicie claude no terminal do WSL, não no PowerShell ou CMD.
Alternativas: Homebrew, WinGet e npm
Quem prefere gerenciar o software por um gerenciador de pacotes pode fazê-lo, com uma ressalva: segundo a documentação, as instalações do Homebrew e do WinGet não se atualizam sozinhas; portanto, você executa regularmente upgrade. O Homebrew oferece dois Casks. claude-code segue o canal estável, que fica cerca de uma semana atrasado e pula versões com grandes regressões; claude-code@latest recebe cada versão imediatamente.
# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code # aktualisiert sich nicht von selbst
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # aktualisiert sich nicht von selbstPelo npm
O npm continua sendo um caminho oficialmente descrito. O requisito é Node.js 22 ou mais recente. O pacote npm baixa o mesmo binário nativo do instalador e nem sequer precisa do Node.js em tempo de execução. Por isso, a instalação com um Node.js mais antigo não é interrompida; o npm apenas avisa com EBADENGINE. Se você ainda não tem Node.js, o instalador nativo é o caminho mais curto.
node -v # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code # niemals mit sudo
# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latestDrei Regeln aus der Página de configuração: nenhum sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.
Verificar a instalação
Para isso, abra uma nova janela do terminal. Uma janela que já estava aberta antes da instalação ainda não conhece o PATH expandido e, por isso, não encontra claude.
claude --version # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor # Diagnose von Installation und Einstellungen, startet keine Sitzungclaude doctor é a ferramenta para quando algo não está certo. Ela não inicia uma sessão, mas lista o status da instalação, erros nos arquivos de configuração e avisos com sugestões de solução. Assim, você identifica se o problema está na instalação ou na configuração.
Quando a instalação apresenta problemas
O download retorna HTML ou um 403
Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut Solução de problemas (Stand 3 de outubro de 2026) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.
“claude” não é encontrado
command not found: claude no macOS e Linux ou um claude não reconhecido no Windows significa que a pasta de instalação está ausente do PATH. Geralmente, basta abrir uma nova janela. Se isso não ajudar no macOS ou Linux, adicione ~/.local/bin a ~/.zshrc ou ~/.bashrc. No Windows, verifique e adicione a pasta conforme mostrado na solução de problemas:
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Im neuen Fenster
claude --versionO PowerShell bloqueia npm.ps1
Isso afeta apenas a variante npm. A mensagem npm.ps1 cannot be loaded because running scripts is disabled on this system significa que a política de execução bloqueia o script de inicialização do npm. Você pode chamar npm.cmd e claude.cmd, que não são abrangidos pela política, mudar para o instalador nativo ou permitir scripts locais para sua conta de usuário:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserAssinatura ou chave de API?
Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Guia do gateway Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.
| Assinatura Claude | Chave de API do Kunavo | |
|---|---|---|
| Faturamento | monatlich: Pro $20 oder $17 pro Monat bei jährlicher Zahlung ($200 im Voraus), Max ab $100, jeweils ohne etwaige Steuern (claude.com/de/pricing, Stand 3 de outubro de 2026) | por token a partir de um saldo pré-pago, recarga a partir de $10, sem cobrança mensal e sem expiração |
| Adequado para | uso diário por várias horas | uso variável; um mês sem uso não custa nada |
| Pagamento | im Web nur Kredit- oder Debitkarte, in den iOS- und Android-Apps über App Store bzw. Google Play (FAQ de cobrança da Anthropic, Stand 3 de outubro de 2026) | Cartão de débito e crédito (Visa, Mastercard), Apple Pay, Google Pay, Link; na Áustria, EPS |
| Configuração | iniciar claude e fazer login no navegador | seis variáveis de ambiente, sem login |
| Não incluído | — | Remote Control e ditado por voz |
O guia de preços do Claude Code mostra a partir de quando o Pro ou Max passa a valer mais a pena que a chave.
Configurar uma chave de API (sem assinatura)
Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics Lista de variáveis und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.
- Cadastre-se no Kunavo usando um endereço de e-mail ou uma conta do Google.
- Em Billing, recarregue pelo menos $10 (formas de pagamento na seção sobre pagamentos).
- Em API-Keys, crie uma chave. Ela começa com
sk-kn-e só é exibida uma vez; portanto, copie-a imediatamente. - Defina as variáveis conforme mostrado abaixo.
Definidos em ~/.zshrc ou ~/.bashrc, os valores valem para todo novo terminal no macOS, Linux e WSL:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # nur die Domain, ohne /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-5No PowerShell, as atribuições $env: valem apenas para a janela aberta, o que é útil para uma primeira tentativa:
# Gilt nur für dieses PowerShell-Fenster
$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"
claudeAuf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Guia do gateway (Stand 3 de outubro de 2026) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:
{
"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"
}
}A extensão do VS Code lê as variáveis de claudeCode.environmentVariables nas configurações do usuário do VS Code (comando Preferences: Open User Settings (JSON)):
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
{ "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
]
}O que cada variável faz
| Variável | Valor | Efeito | Se estiver ausente ou incorreta |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | encaminha todas as solicitações ao Kunavo; o Claude Code acrescenta /v1/messages automaticamente | Com /v1 no final, a solicitação vai para /v1/v1/messages e falha com 404. |
ANTHROPIC_AUTH_TOKEN | Sua chave (sk-kn-…) | é enviada como Authorization: Bearer e tem prioridade imediata | Quem define ANTHROPIC_API_KEY em vez disso (header x-api-key) precisa confirmar a chave uma vez no modo interativo. Se isso for recusado, o Claude Code ignora a chave sem perguntar novamente; ela pode ser reativada em /config → Use custom API key. O Kunavo aceita a chave nos dois headers. |
ANTHROPIC_MODEL | claude-sonnet-5 | Modelo inicial de cada sessão | Sem ela, a sessão inicia no modelo do pin do Opus, ou seja, Opus 5.5; se esse também estiver ausente, usa o padrão atual da Anthropic (atualmente também Opus 5.5). |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Destino de /model opus e a versão usada pelo padrão sem ANTHROPIC_MODEL | Sem ela, o alias segue a indicação da Anthropic, atualmente também Opus 5.5; assim que surgir um Opus mais recente, ele poderá apontar para um modelo que o Kunavo ainda não oferece. O Opus 5.5 exige o Claude Code a partir da versão 2.1.280; versões mais antigas são atualizadas por claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Destino de /model sonnet, da fase de execução de opusplan e dos Subagents com model: sonnet | Sem ela, o alias aponta para o Sonnet 5.5 para usuários da API, que o Kunavo atualmente (em 3 de outubro de 2026) não oferece: 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | Destino de /model haiku e modelo para funções em segundo plano | Sem ela, o alias da Anthropic decide qual Haiku será executado. |
Warum ein festes Startmodell? Laut Configuração do modelo (Stand 3 de outubro de 2026) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das custa o dobro por token que Claude Sonnet 5. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token menos que Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.
Duas coisas sobre o armazenamento. A chave nunca deve ficar no .claude/settings.json de um projeto, pois, segundo o guia do gateway, esse arquivo é commitado e chega a qualquer pessoa que clone o repositório. E se uma exportação do shell e um bloco env definirem a mesma variável, o arquivo de configurações vence. Portanto, se você alterar uma variável no shell e nada acontecer, provavelmente o valor antigo ainda está em um settings.json.
Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 3 de outubro de 2026), jeweils pro 1 Mio. Tokens:
| Modelo | Kunavo (entrada / saída) | Preço de tabela da Anthropic (entrada/saída) | Diferença | Função no Claude Code |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30% mais barato | Alias haiku e tarefas em segundo plano do Claude Code |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30% mais barato | Modelo principal (ANTHROPIC_MODEL) para o trabalho diário |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30% mais barato | Alias opus com o pin acima (grandes refatorações, planejamento); sem pins, é o padrão para usuários da API |
claude-opus-5 | $3,50 / $17,50 | $5,00 / $25,00 | ~30% mais barato | Sem alias; apenas de forma direcionada com /model claude-opus-5 |
Todos os modelos e tarifas do Claude estão no guia de preços da API do Claude e na página de preços.
Primeira inicialização: verificar com /status
Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, sem tela de login. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Guia do gateway: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.
Na sessão, /status mostra na aba Status de onde o Claude Code obtém o endereço e as credenciais. Duas linhas são decisivas:
| Linha | Correto | Se não |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | A linha só aparece quando um endereço de gateway está definido. Se ela estiver ausente, ANTHROPIC_BASE_URL não chegou à sessão. |
Auth token | menciona ANTHROPIC_AUTH_TOKEN | Se, em vez disso, aparecer Login method com uma conta claude.ai, a variável não foi lida e a sessão está usando sua assinatura. |
A conexão também pode ser testada sem o Claude Code, com a solicitação do guia do gateway (com o modelo definido aqui como claude-sonnet-5). Ela solicita exatamente um token de saída e, portanto, custa apenas uma quantia mínima. Os comandos leem as variáveis do shell; se seus valores estiverem apenas em settings.json, exporte-os também para o teste.
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": "."}]}'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": "."}]}'Se retornar um JSON que começa com {"id":"msg_ ou, no PowerShell, um objeto com uma id que começa com msg_, o endereço e a chave estão corretos. Um 401 significa que a chave foi rejeitada.
O que muda com uma chave de API
A maior parte permanece igual: edição de código, ferramentas, Subagents, servidores MCP, hooks e cache de prompts funcionam normalmente. Você deve conhecer quatro diferenças:
- Remote Control e ditado por voz deixam de funcionar. Segundo o guia do gateway, ambos exigem uma identidade claude.ai e ficam bloqueados enquanto
ANTHROPIC_AUTH_TOKENouANTHROPIC_API_KEYestiver ativo. O Remote Control também fica bloqueado desde a versão 2.1.196 quandoANTHROPIC_BASE_URLaponta para um host fora da Anthropic. /fastinforma que o Fast Mode não está disponível. Com apenas um token Bearer, o Claude Code o trata como desativado e nem envia a verificação de disponibilidade.- A busca de ferramentas para MCP está desativada. Laut Documentação do MCP (Stand 3 de outubro de 2026) schaltet Claude Code sie ab, sobald
ANTHROPIC_BASE_URLauf einen Drittanbieter zeigt; mitENABLE_TOOL_SEARCHlässt sie sich ausdrücklich einschalten. /contextmostra valores estimados. Kunavo bietet/v1/messages/count_tokensnicht an. Ohne diesen Endpunkt zählt Claude Code laut Guia de compatibilidade do gateway (Stand 3 de outubro de 2026) anhand der Zeichen.
Mais informações sobre a integração estão no guia de integração do Claude Code (em inglês).
Pagar sem PayPal e SEPA
Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (FAQ de faturamento). PayPal oder Venmo nimmt Anthropic laut dem Artigo de ajuda sobre cartões recusados nicht an (beides Stand 3 de outubro de 2026).
Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Documentação da Stripe sobre preços adaptativos (Stand 3 de outubro de 2026) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:
| Método de pagamento | Onde | Observação |
|---|---|---|
| Cartão (Visa, Mastercard, Amex, JCB, UnionPay) | em todos os lugares | cartões de crédito e débito, incluindo Visa Debit e Debit Mastercard; um girocard puro, não |
| Apple Pay | Safari, iPhone e iPad; não na Índia | com um cartão na Carteira, inclusive um cartão de débito Visa ou Mastercard; um girocard puro, não |
| Google Pay | Chrome e Android com o Google Pay configurado; não na Índia | com um cartão na Carteira, inclusive um cartão de débito Visa ou Mastercard; um girocard puro, não |
| Link | em todos os lugares, exceto a Índia | Serviço de pagamento da Stripe, armazena seu cartão; também permite recarga automática |
| EPS | Áustria, checkout em euros | Redirecionamento para o internet banking do seu banco |
EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.
girocard: Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen bandeiras de cartão aceitas führt (Stand 3 de outubro de 2026). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.
Não disponível: PayPal, débito direto SEPA, transferência manual (pagamento antecipado), giropay e Sofort. O Klarna é oferecido pelo checkout apenas a compradores nos EUA; quem mudar para dólares americanos fora dos EUA continuará sem ver o Klarna.
- Criar uma conta; a Kunavo não solicita nenhum cartão durante o cadastro.
- Em Billing, escolha um nível de recarga a partir de $10. Níveis maiores oferecem saldo bônus: $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
- No checkout da Stripe, escolha a forma de pagamento. Você verá o valor em euros antes da confirmação; com EPS, confirme no internet banking.
- Em API-Keys, crie uma chave e informe-a como
ANTHROPIC_AUTH_TOKEN.
O saldo é pré-pago: sem mensalidade, sem expiração, e solicitações malsucedidas não são cobradas. A recarga automática só funciona com cartão ou Link salvos; com Apple Pay, Google Pay e EPS, faça a recarga manualmente. A Kunavo não emite faturas com IVA discriminado; suas recargas podem ser consultadas em Billing. Saiba mais sobre formas de pagamento e cartões recusados: Pagar pelo Claude sem cartão de crédito.
Quanto custa uma sessão: exemplo de cálculo
Com uma chave de API, você paga pelos tokens, e o Claude Code envia todo o contexto acumulado a cada etapa. Ainda assim, esse contexto não é cobrado integralmente todas as vezes: o modelo lê do cache o início que não mudou, aplicando a tarifa menor de leitura do cache. A tabela calcula um padrão presumido; ela não é uma medição nem um limite máximo. Suponha:
- 40.000 tokens de entrada por solicitação, dos quais 36.000 (90 %) são lidos do cache e 4.000 são gravados nele pela primeira vez;
- 1.000 tokens de saída por solicitação;
- 50 dessas solicitações por sessão de trabalho, sem contar chamadas em segundo plano;
- A leitura do cache custa Claude Sonnet 5 10 % da tarifa de entrada, e a gravação no cache custa 1,25 vezes esse valor; cada modelo da tabela é calculado com seus próprios fatores.
| Modelo | Uma solicitação | 50 solicitações | 50 solicitações totalmente sem acertos de cache |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,952 | $3,15 |
| Claude Opus 5 | $0,0476 | $2,38 | $7,88 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
O valor que você realmente paga depende do tamanho do contexto, dos acertos de cache e do tamanho da resposta, além de depender de você começar novamente com /clear entre duas tarefas. Para usar seus próprios números, consulte a Calculadora de tokens do Claude (em inglês); a comparação com Pro e Max é calculada pelo Guia de preços do Claude Code.
Mensagens de erro e seus significados
| Mensagem | Significado e solução |
|---|---|
The token '&&' is not a valid statement separator | A linha do CMD está na janela do PowerShell. É lá que irm … | iex deve ser usada. |
'irm' is not recognized as an internal or external command (ou a mesma mensagem em alemão) | A linha do PowerShell está no CMD. É lá que deve ser usada a linha com install.cmd. |
Claude Code does not support 32-bit Windows | A janela aberta é “Windows PowerShell (x86)”. Escolha a entrada sem (x86). |
syntax error near unexpected token '<' ou 403 | Em vez do script, foi recebida uma página da web ou um código de erro. Verifique a VPN, o proxy e o firewall corporativo, ou tente outra rede. |
App unavailable in region | A conexão parece vir de um país não compatível. Na Alemanha, Áustria e Suíça, geralmente isso é causado por uma VPN ou proxy. |
command not found: claude ou claude não foi encontrado | A pasta de instalação não está no PATH. Abra uma nova janela; no Windows, use o comando de PATH acima. |
Aviso EBADENGINE | O Node.js é anterior à versão 22. A instalação ainda será concluída; mesmo assim, vale a pena atualizar. |
claude native binary not installed (macOS, Linux) | O npm ignorou as dependências opcionais (--omit=optional, optional=false). Remova essa configuração e instale novamente. |
npm.ps1 cannot be loaded | A política de execução bloqueia o npm. Use npm.cmd, execute a linha Set-ExecutionPolicy ou use o instalador nativo. |
| Tela de login mesmo com a chave configurada | A chave está apenas nas configurações do projeto. Defina-a com export ou em ~/.claude/settings.json e abra um novo terminal. |
ANTHROPIC_API_KEY configurada, mas sem efeito | A confirmação única foi recusada. Ative em /config → Use custom API key ou mude para ANTHROPIC_AUTH_TOKEN. |
401 | A chave foi recusada. Ela foi copiada completamente e sem espaços, ainda existe em /app/keys e está definida em ANTHROPIC_AUTH_TOKEN? |
404 | ANTHROPIC_BASE_URL termina em /v1, ou o modelo solicitado não existe na Kunavo, por exemplo após /model sonnet sem fixar o Sonnet. |
Limitações deste método
- O pagamento é por token, não uma tarifa fixa. Quem usa o Claude Code por horas todos os dias geralmente paga menos com Pro ou Max. Com uso variável, você paga apenas o que consumir, e um mês sem uso não custa nada.
- Sem uma conta claude.ai, não há Remote Control nem ditado por voz;
/fastfica desativado, e a busca de ferramentas para MCP vem desativada por padrão. - A Kunavo não oferece o Sonnet 5.5 atualmente; por isso,
/model sonnet,opusplane os subagentes do Sonnet precisam da fixação do Sonnet mostrada nos exemplos acima. - Apple Pay, Google Pay e EPS servem apenas para recargas manuais; a recarga automática só funciona com cartão ou Link. Os valores em euros incluem a tarifa de conversão da Stripe.
- A Kunavo não emite faturas com IVA discriminado.
- A documentação do Claude Code da Anthropic está disponível em alemão; o guia de integração da Kunavo está disponível apenas em inglês.
Perguntas frequentes
Como é a instalação do Claude Code?
Você abre um terminal e executa o comando oficial para o seu sistema. No macOS, Linux e WSL: curl -fsSL https://claude.ai/install.sh | bash. No Windows PowerShell: irm https://claude.ai/install.ps1 | iex. No Prompt de Comando do Windows (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Depois, abra uma nova janela do terminal e digite claude --version. Se aparecer um número de versão, o Claude Code está instalado. Essa instalação nativa se mantém atualizada em segundo plano; instalações pelo Homebrew ou WinGet precisam ser atualizadas por você.
Para instalar o Claude Code no Windows, preciso do WSL ou de privilégios de administrador?
Nenhum dos dois. O Claude Code funciona nativamente no Windows 10 a partir da versão 1809 e no Windows Server 2019 e, segundo a Anthropic, o instalador não precisa ser executado como administrador. O WSL 2 só vale a pena se você precisar de ferramentas Linux ou sandboxing; nesse caso, instale e inicie o Claude Code no terminal do WSL. O Git para Windows é opcional: com o Git, o Claude Code executa comandos no Git Bash, sem o Git no PowerShell. Problemas comuns são usar a linha do CMD na janela do PowerShell (ou vice-versa) e iniciar o item “Windows PowerShell (x86)” do menu Iniciar, que é encerrado como um processo de 32 bits.
Preciso do Node.js para usar o Claude Code?
Somente se você instalar pelo npm; nesse caso, Node.js 22 ou mais recente. Instruções antigas costumam mencionar o Node.js 18, que está desatualizado. O instalador nativo, o Homebrew e o WinGet funcionam sem Node.js. Se o seu Node.js for antigo demais, o npm emitirá o aviso EBADENGINE, mas continuará a instalação. Nunca instale com sudo e atualize com npm install -g @anthropic-ai/claude-code@latest em vez de npm update -g.
Posso usar o Claude Code sem assinatura?
Sim, com uma chave de API. Para fazer login, você precisa de Pro, Max, Team, Enterprise ou uma conta do Console; o plano gratuito do Claude não inclui o Claude Code. Com o Kunavo, você define ANTHROPIC_BASE_URL=https://api.kunavo.com e ANTHROPIC_AUTH_TOKEN, e o Claude Code inicia sem tela de login. Cada token é descontado de um saldo pré-pago, que você pode recarregar a partir de $10; não há cobrança mensal. Você não terá acesso ao Remote Control nem à ditado por voz, pois ambos exigem uma conta claude.ai.
Como configuro uma chave de API no Claude Code?
O melhor é colocá-la no bloco env de ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json); caso contrário, use linhas export em ~/.zshrc ou ~/.bashrc. Você precisa de seis valores: ANTHROPIC_BASE_URL=https://api.kunavo.com sem /v1 (caso contrário, a solicitação irá para /v1/v1/messages e falhará com 404), ANTHROPIC_AUTH_TOKEN com sua chave, além de ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 e ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5. ANTHROPIC_AUTH_TOKEN funciona imediatamente. ANTHROPIC_API_KEY também funciona, pois o Kunavo aceita a chave nos dois headers, mas no modo interativo ela precisa ser confirmada uma vez. Nunca escreva a chave no .claude/settings.json de um projeto, pois esse arquivo é compartilhado com o repositório.
Qual modelo o Claude Code usa com uma chave de API?
O modelo que você definir. Sem uma definição, segundo a Anthropic (em 3 de outubro de 2026), o Claude Code inicia para usuários da API com o Opus 5.5. O Kunavo oferece o Opus 5.5, que custa o dobro por token que Claude Sonnet 5. Com ANTHROPIC_MODEL=claude-sonnet-5, Claude Sonnet 5 se torna o modelo inicial; uma solicitação do exemplo de cálculo nesta página custa aproximadamente $0,019. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 determina o que /model opus inicia; o Opus 5.5 exige o Claude Code a partir da versão 2.1.280, e uma instalação mais antiga pode ser atualizada com claude update. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 também é necessário, pois o alias sonnet aponta para o Sonnet 5.5 para usuários da API e o Kunavo não oferece o Sonnet 5.5: sem essa linha, /model sonnet, a fase de execução do opusplan e os Subagents com model: sonnet terminam em 404. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 também se aplica às tarefas em segundo plano.
Como verifico em /status se o Claude Code está usando a chave de API?
Digite /status na sessão em execução e consulte a aba Status. A linha Anthropic base URL deve mostrar https://api.kunavo.com, e a linha Auth token deve mencionar ANTHROPIC_AUTH_TOKEN. Se a linha da URL base não aparecer, a variável não chegou à sessão. Se aparecer Login method com uma conta claude.ai, a sessão está usando sua assinatura. Se a tela de login aparecer já na primeira inicialização, provavelmente a chave está apenas nas configurações do projeto, que o Claude Code só avalia depois do assistente de configuração.
Posso pagar o Claude Code com PayPal, débito SEPA, girocard ou EPS?
Para o saldo do Kunavo: EPS sim, se você pagar em euros a partir da Áustria. PayPal e débito SEPA não estão disponíveis; Klarna apenas para compradores nos EUA. Um girocard puro falha porque a Stripe não considera girocard uma bandeira de cartão. Se o seu cartão também tiver o logotipo Visa ou Mastercard, você poderá pagar por essa rede, inclusive com Apple Pay ou Google Pay. Cartões de crédito e débito e o Link também são aceitos. O valor mínimo é $10, não há cobrança mensal e o saldo não expira; segundo a Stripe, o valor em euros inclui uma tarifa de conversão de 2–4 %. O carregamento automático só funciona com um cartão salvo ou o Link. O Kunavo não emite faturas com o IVA discriminado. Assim, você não paga uma assinatura Claude Pro ou Max; a própria Anthropic aceita apenas cartões na web, não PayPal.