Como instalar o Claude Code【Windows e Mac】— configuração da API key sem assinatura e pagamento com JCB e Apple Pay

A instalação do Claude Code consiste em executar uma única linha do instalador nativo oficial. No Mac, Linux e WSL, use install.sh; no Windows, use install.ps1 no PowerShell e install.cmd no CMD (também é possível instalar com npm, mas nesse caso é necessário Node.js 22 ou superior). Normalmente, depois disso você faz login com um plano como Pro ou Max; se não quiser contratar uma assinatura, defina ANTHROPIC_BASE_URL=https://api.kunavo.com (sem adicionar /v1), ANTHROPIC_AUTH_TOKEN com uma chave de API e as quatro variáveis que fixam os modelos para iniciar sem login. Confirme se está funcionando com /status. O saldo da API pode ser pré-pago a partir de $10 usando cartões como JCB ou métodos como Apple Pay, Google Pay e Link; a tela de pagamento exibe o valor em ienes.

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

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

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール手順の一次情報は、日本語で読める Anthropic の公式ドキュメント（Configuração、Solução de problemas de instalação、3 de outubro de 2026確認）です。このページはその内容をなぞるのではなく、日本語の解説記事で食い違っている点（Node.js のバージョン、Windows の管理者権限と Git）と、公式ドキュメントが扱っていないこと——ログインせずに API キーで動かす設定と、日本からの支払い——を中心にまとめています。料金と決済手段は 3 de outubro de 2026時点の情報です。日本は Anthropic のLista de países compatíveisに、Claude.ai と API の両方で載っています（3 de outubro de 2026確認）。

Decida primeiro: fazer login com uma assinatura ou usar uma chave de API

A instalação em si é igual nos dois casos; a diferença surge após a primeira inicialização. Ao iniciar, o Claude Code solicita autenticação. Se estiver em dúvida, decida com base nestes 3 pontos:

• Você já tem uma assinatura Pro, Max, Team ou Enterprise ou uma conta Console: basta fazer login para usar. A configuração da chave de API desta página não é necessária. O plano gratuito não inclui o Claude Code.
• Não quero pagar uma mensalidade fixa; a diferença entre os meses em que uso e não uso é grande：API キーで動かし、使ったトークン分だけ払う形が合います。参考までに、Claude のサブスクは Pro が月 $20（年払いは $200 で月 $17 相当）、Max は月 $100 からで、いずれも税別です（Página de preços do Claude、3 de outubro de 2026確認）。どちらが安くなるかの分岐点は Preço do Claude Codeで試算しています。
• Quero usar o Remote Control ou a entrada de voz: ambos dependem de uma conta do claude.ai e não podem ser usados com uma chave de API. Selecione Login.

支払い手段も違います。Anthropic の Web サイトで契約するサブスクはクレジットカードかデビットカードのみで、iPhone・Android アプリから契約した場合は App Store・Google Play が決済します（Central de ajuda da Anthropic、英語版、3 de outubro de 2026確認）。Kunavo の API 残高は、JCB を含むカード、Apple Pay、Google Pay、Link でチャージします（詳しくは後半の支払いの章）。

Verificação antes da instalação

Os requisitos são os indicados na documentação oficial (3 de outubro de 2026confirmação). A coluna à direita mostra como verificá-los localmente.

Qual método usar para instalar

A documentação oficial indica o instalador nativo como “recomendado”. A principal diferença em relação aos outros métodos é a forma como as atualizações são feitas.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Independentemente do método, ao terminar, feche e reabra o terminal antes de verificar. As janelas abertas antes da instalação podem não ter carregado o novo PATH. claude doctor exibe apenas o estado da instalação e da configuração, sem iniciar uma sessão, e pode ser usado para diagnosticar problemas.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Observações sobre a instalação com npm

日本語の解説記事では今も「Node.js 18 以上」という記載をよく見かけますが、公式ドキュメントの要件はNode.js 22 ou superiorです（Documentação oficial、3 de outubro de 2026確認）。古い Node.js でも npm は EBADENGINE の警告を出すだけでインストールを止めず、claude も起動しますが、警告が出たら Node.js を上げておくほうが安全です。nvm や Volta などでバージョンを切り替えている場合は、インストールするシェルで node -v を確かめてください。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

A documentação oficial determina que não se use sudo npm install -g. Além disso, como o binário principal é instalado como uma dependência opcional, se --omit=optional ou .npmrc tiver optional=false configurado para omitir dependências opcionais, no Mac e no Linux será exibido claude native binary not installed e o programa não iniciará.

Pontos importantes ao instalar no Windows

まず、ネットでよく見る 2 つの手順は不要です。「PowerShell を管理者として実行」と「Git for Windows を先に入れる」は、どちらも公式ドキュメントの要件ではありません。Não são necessários privilégios de administrador, e o Git for Windows é opcionalで、入っていなければ Claude Code は PowerShell でコマンドを実行します（Configuração no Windows、3 de outubro de 2026確認）。

Antes de colar o comando, verifique apenas duas coisas.

1. O que está aberto agora: PowerShell ou CMD? Se o prompt for PS C:\Users\ユーザー名>, use a linha irm para PowerShell; se for C:\Users\ユーザー名> sem PS, use a linha install.cmd para CMD. Se trocar as linhas, no PowerShell ocorrerá um erro informando que && não é reconhecido como delimitador, e no CMD ocorrerá um erro informando que irm não é reconhecido (no Windows em japonês, as mensagens podem aparecer em japonês).
2. Você não abriu o “Windows PowerShell (x86)”? A versão (x86) exibida no menu Iniciar é um processo de 32 bits; por isso, mesmo em um computador de 64 bits, ela será interrompida por Claude Code does not support 32-bit Windows.

Há três maneiras de executar no Windows. Se estiver em dúvida, pode começar pelo método nativo.

Mesmo com o Git for Windows instalado, se o Claude Code não encontrar o Git Bash, escreva o local de bash.exe em CLAUDE_CODE_GIT_BASH_PATH no arquivo de configurações do usuário env.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Quando o claude não funciona apesar de instalado

'claude' is not recognized (no Mac e no Linux, command not found: claude) significa que o local de instalação não está incluído em PATH. O instalador nativo fica em %USERPROFILE%\.local\bin\claude.exe no Windows e em ~/.local/bin/claude no Mac e no Linux. Se reabrir o terminal não resolver, verifique e adicione pelo PowerShell seguindo a documentação oficial.

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

npm で入れた場合に npm.ps1 cannot be loaded because running scripts is disabled on this system （起動時なら claude.ps1）と出るのは、PowerShell の実行ポリシーが npm の .ps1 スクリプトを止めているためです（Documentação oficial、3 de outubro de 2026確認）。現在のユーザーにだけローカルのスクリプト実行を許可する次のコマンドで解消します。ポリシーを変えたくなければ、npm.cmd・claude.cmd を使うか、PowerShell 用のネイティブインストーラーに切り替えてください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Configuração para usar com uma chave de API sem fazer login

A Kunavo é um gateway de API independente, não a Anthropic, que oferece acesso pré-pago à API de modelos como o Claude.Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「Conectar o Claude Code a um gateway de LLM」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（Configuração do modelo、3 de outubro de 2026確認）。

Há 6 configurações a definir.

No Mac e no Linux, adicione ao arquivo de configuração do shell (~/.zshrc ou ~/.bashrc) e reabra o terminal.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/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

Para testar no Windows, execute o seguinte em uma janela do PowerShell. Ele desaparecerá quando a janela for fechada.

# このウィンドウの中だけで有効（閉じると消える）
$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 não quiser digitar sempre, escreva o bloco env no arquivo de configurações do usuário ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json). Isso se aplica a todos os projetos e usa a mesma sintaxe no Mac e no Windows. Se o arquivo já contiver outras configurações, adicione apenas o bloco env.

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

Há três observações sobre onde colocar isso.

• プロジェクトの .claude/settings.json にはNão escreva a chaveでください。リポジトリにコミットされ、クローンした人全員に渡ります（Documentação oficial）。
• Se a mesma variável existir no shell e no arquivo de configuração, será usado o valor do arquivo. Se mesmo após executar export novamente nada mudar, verifique o arquivo de configuração.
• Ao usar a extensão do VS Code, coloque as mesmas variáveis em claudeCode.environmentVariables nas configurações de usuário do VS Code.

Por que usar ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN é enviado no cabeçalho Authorization: Bearer e fica ativo assim que é configurado. Já ANTHROPIC_API_KEY é enviado no cabeçalho x-api-key e, no modo interativo, na primeira vez solicita aprovação para seu uso. Se você recusar, a chave será ignorada sem nenhuma mensagem e não será usada até ser reativada em /config com Use custom API key. A Kunavo aceita chaves enviadas por ambos os cabeçalhos, portanto ANTHROPIC_API_KEY também funciona, mas ANTHROPIC_AUTH_TOKEN é mais confiável por não ter essa armadilha. A documentação oficial também orienta usar ANTHROPIC_AUTH_TOKEN quando o tipo de chave não for especificado.

Por que fixar o modelo (em 3 de outubro de 2026)

Documentação oficial（3 de outubro de 2026確認）によると、API キーで使う場合、既定モデルと opus エイリアスは Opus 5.5、sonnet エイリアスは Sonnet 5.5 を指します。エイリアスの行き先は新しいモデルが出るたびに変わりますが、Kunavo で同じ日から使えるとは限りません。実際、Kunavo は 3 de outubro de 2026時点で Sonnet 5.5 を提供していないので、固定せずに /model sonnet を選ぶと 404 になります。opusplan の実行フェーズや、model: sonnet を指定したサブエージェントも同じです。そのため上の設定では ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で sonnet エイリアスも固定しています。opus エイリアスも、行き先が次の Opus に変わっても困らないよう ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 で Claude Opus 5.5 に固定しています。Claude Opus 5.5 には Claude Code v2.1.280 以降が必要なので、古い場合は claude update で更新してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Claude Opus 5.5 になり、Claude Sonnet 5 をメインにした場合より 1 トークンあたりの単価が上がります。Kunavo の単価（1M トークンあたり、入力 / 出力）は、Claude Haiku 4.5 が $0.70 / $3.50、Claude Sonnet 5 が $1.40 / $7.00(Os preços da Anthropic são $2.00 / $10.00)、Claude Opus 5.5 が $2.80 / $14.00 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（Guia de compatibilidade com gateways、3 de outubro de 2026確認）。なお Anthropic のPágina de preçosでは、メインに固定している Sonnet 5 は「レガシーモデル」の欄に移っています（3 de outubro de 2026確認）。

Verifique o funcionamento em 3 etapas

1. Antes de iniciar, teste apenas a URL e a chave

É uma solicitação com apenas 1 token de saída, igual à da documentação oficial (um valor mínimo é descontado do saldo). Como ela lê as variáveis do shell, se você escreveu a chave apenas no arquivo de configuração, execute export neste terminal antes de executá-la. Se retornar um JSON iniciado por {"id":"msg_ e 200, a URL e a chave estão corretas; 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": "."}]}'

No PowerShell, faça o seguinte; se o id retornado começar com msg_, a operação foi bem-sucedida.

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": "."}]}'

2. Inicie o claude e confirme que a tela de login não aparece

Na primeira execução aparecem o assistente inicial e a confirmação de confiança na pasta, mas depois não será solicitado login pelo navegador. Se o login for solicitado, a chave não foi recebida.

Uma causa comum é ter escrito a chave apenas em .claude/settings.json ou .claude/settings.local.json do projeto. Em sessões interativas, o env das configurações do projeto é carregado somente depois que o assistente e a confirmação de confiança na pasta terminam; portanto, na primeira inicialização, a chave é tratada como ausente. Mova-a para o export do shell ou para ~/.claude/settings.json do usuário.

3. Veja as 2 linhas de /status

セッションの中で /status を実行し、Status タブを確認します（Documentação oficial、3 de outubro de 2026確認）。

• Em Anthropic base URL, deve aparecer https://api.kunavo.com. Essa linha só aparece quando o gateway está configurado; se ela não existir, ANTHROPIC_BASE_URL não chegou à sessão.
• Em Auth token, deve aparecer ANTHROPIC_AUTH_TOKEN. Se, em vez disso, aparecer Login method da conta do claude.ai, o programa está usando um login salvo.

O que muda ao usar uma chave de API

• Remote Control e a entrada de voz não podem ser usados. Como ambos dependem de um ID do claude.ai, ficam desativados enquanto credenciais de autenticação do gateway, como ANTHROPIC_AUTH_TOKEN, estiverem ativas. A partir da v2.1.196, o Remote Control também é desativado se ANTHROPIC_BASE_URL apontar para um host que não seja da Anthropic.
• /fast será exibido como desativado. Ao autenticar somente com um token de bearer, o Claude Code trata o modo rápido como desativado sem consultar se ele é permitido e exibe Fast mode has been disabled by your organization.
• O número de /context será aproximado.Kunavo は /v1/messages/count_tokens を提供していないため、Claude Code は文字数ベースの推定に切り替えます（Guia de compatibilidade com gateways、3 de outubro de 2026確認）。

As configurações detalhadas da Kunavo estão na documentação de integração do Claude Code e na documentação de ANTHROPIC_BASE_URL (ambas em inglês).

Pagamento do saldo da API: JCB・Apple Pay・Google Pay・Link

Vamos resumir primeiro os pontos mais perguntados ao pagar do Japão.

São 4 etapas. Primeiro, crie uma conta na Kunavo (com endereço de e-mail ou conta do Google; não são solicitados dados do cartão no cadastro). Depois, em Billing no painel, escolha o valor da recarga. O mínimo é $10, não há mensalidade e valores maiores recebem um bônus ($100 で残高 $110、$1,000 で残高 $1,200、$5,000 で残高 $6,250). Na tela de pagamento da Stripe, escolha um dos métodos acima e pague; por fim, em API Keys, crie uma chave com sk-kn- e insira-a em ANTHROPIC_AUTH_TOKEN. A chave é exibida apenas uma vez no momento da criação, portanto copie-a imediatamente.

O saldo não expira e solicitações com falha não são cobradas. Os métodos disponíveis para pagar a assinatura do Claude no Japão, inclusive pela App Store e pelo Google Play, estão reunidos com fontes em Métodos de pagamento do Claude.

Estimativa de custo

O Claude Code executado com uma chave de API é cobrado por uso de tokens. A cada solicitação, o Claude Code envia todo o contexto da conversa, mas a parte inicial igual à anterior pode ter o preço de leitura de cache. A tabela abaixo calcula supondo que a entrada de uma solicitação tenha 40,000 tokens (dos quais 36,000 = 90% são leituras de cache e os 4,000 restantes são gravações de cache), a saída tenha 1,000 tokens e cada tarefa consista em 50 solicitações. As chamadas Claude Haiku 4.5 em segundo plano não estão incluídas. Na Kunavo, para Claude Sonnet 5, a leitura custa 10% do preço de entrada e a gravação custa 1.25 vezes esse preço (cada modelo da tabela é calculado com sua própria proporção). Não são valores medidos nem limites máximos.

O valor real varia conforme o tamanho do contexto, a eficácia do cache, o tamanho da resposta e se você executa /clear para cada tarefa. Os preços unitários de todos os modelos estão na página de preços; a estimativa para seu uso está na calculadora de custo de tokens do Claude (em inglês); e os preços unitários da API por modelo estão em Preços da API do Claude.

Erros comuns e soluções

Casos em que este método não é adequado

• É obrigatório ter uma nota fiscal eletrônica para reembolso de despesas. O checkout da Kunavo não emite faturas nem notas fiscais eletrônicas com número de registro.
• Quero pagar em lojas de conveniência ou com PayPay. Nenhum dos dois é compatível, assim como transferência bancária e cobrança pela operadora. A recarga automática só funciona com um cartão salvo ou Link.
• Quero usar o Remote Control ou a entrada de voz. Eles não podem ser usados com uma chave de API, e /fast também será exibido como desativado. Faça login com uma assinatura.
• Quero usar o Sonnet 5.5. A Kunavo não o oferece em 3 de outubro de 2026.
• Quero concluir a configuração usando apenas documentação em japonês. A documentação oficial do Claude Code pode ser lida em japonês, mas a documentação de integração da Kunavo está disponível somente em inglês.

Próximas etapas

Depois de confirmar com /status, no diretório do projeto em que trabalhará, inicie claude e crie primeiro CLAUDE.md com /init. A documentação sobre como usar o Claude Code explica em sequência o que escrever no CLAUDE.md, como reduzir os diálogos de confirmação e como criar comandos personalizados.

Perguntas frequentes