Como instalar o Claude Code: comandos oficiais para Windows, macOS e Linux, chave de API sem assinatura, verificar /status e pagar com cartão ou Link

Em resumo: instale o Claude Code com um único comando oficial (escolha abaixo a linha para macOS/Linux, PowerShell ou CMD) e conecte-o a uma chave de API em vez de fazer login. Para isso, bastam seis variáveis: ANTHROPIC_BASE_URL=https://api.kunavo.com (sem /v1), ANTHROPIC_AUTH_TOKEN contendo a chave e quatro variáveis que fixam o modelo. Verifique o resultado com /status. Não é necessário assinar o Pro ou Max; você paga os tokens com saldo pré-pago a partir de $10, carregado com cartão (Visa, Mastercard etc.) ou Link. QRIS, GoPay, OVO e DANA não estão disponíveis.

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

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

:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 3 de outubro de 2026. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk página de instalação dan página de conexão ao gateway de LLM, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 3 de outubro de 2026.

Seis etapas do zero até o Claude Code funcionar

1. Verifique se o laptop atende aos requisitos e decida: login com conta Claude ou chave de API.
2. Execute o instalador nativo correspondente ao seu terminal.
3. Abra um terminal novo, verifique claude --version e corrija o PATH se necessário.
4. Configure a chave de API e fixe os modelos.
5. Abra a primeira sessão e confirme por meio de /status que sua chave está sendo usada.
6. Adicione saldo com cartão ou Link e comece a trabalhar.

Etapa 1: verifique os requisitos e escolha entre login ou chave de API

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut página de preços do Claude (dicek 3 de outubro de 2026), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (FAQ de cobrança do Claude, dicek 3 de outubro de 2026). Cara login dijelaskan di página oficial de autenticação.

A segunda opção, detalhada neste guia, é usar uma chave de API: sem assinatura e sem tela de login. Você paga por token realmente utilizado, portanto o custo também diminui nos meses de pouco uso. As únicas funcionalidades ausentes são Remote Control e ditado por voz, vinculadas à conta claude.ai; a lista completa de diferenças está na etapa 5.

Baru pertama kali membuka terminal? Anthropic menyediakan guia de terminal em português untuk pemula.

Etapa 2: execute o instalador

macOS, Linux e WSL

Cole a linha install.sh no início da página no Terminal, pressione Enter e aguarde a conclusão. O script é obtido diretamente de claude.ai, instala o programa em ~/.local/bin/claude e, a partir daí, o Claude Code se atualiza automaticamente em segundo plano. Na documentação oficial, esse método é identificado como “Recomendado”.

Windows: primeiro identifique seu terminal

Muitos tutoriais antigos recomendam abrir o PowerShell como “Executar como administrador” e instalar o WSL primeiro. Nenhuma das duas coisas é necessária: a documentação oficial em português afirma que a instalação no Windows funciona em um terminal comum, sem privilégios de administrador, e que o WSL é apenas uma opção. O que determina qual comando usar é a aparência do prompt:

• O prompt PS C:\Users\NamaAnda> indica PowerShell. Use a linha irm … | iex.
• O prompt C:\Users\NamaAnda> sem PS indica o Prompt de Comando (CMD). Use a linha install.cmd.
• No menu Iniciar, escolha “Windows PowerShell”, não “Windows PowerShell (x86)”. A versão x86 funciona em 32 bits e termina com Claude Code does not support 32-bit Windows, mesmo que o laptop seja de 64 bits.

Um comando usado no terminal errado fica evidente pela mensagem, como The token '&&' is not a valid statement separator (linha do CMD no PowerShell) ou 'irm' is not recognized as an internal or external command (linha do PowerShell no CMD). No Windows em português, a mensagem pode aparecer traduzida. A lista completa está na tabela de erros abaixo.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

Escolheu o WSL? Execute a linha install.sh dentro do terminal WSL e sempre abra o claude também nesse terminal WSL.

Alternativas: Homebrew, WinGet ou npm

Homebrew e WinGet também são oficiais, mas, segundo a documentação, nenhum dos dois faz atualizações automáticas por padrão. Você precisa atualizá-los manualmente:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 ou posterior (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Três hábitos que danificam uma instalação via npm: usar sudo npm install -g (a documentação o identifica como fonte de problemas de permissão e riscos de segurança), atualizar com npm update -g em vez de @latest e desativar dependências opcionais com --omit=optional ou optional=false em .npmrc. O último impede o download do pacote @anthropic-ai/claude-code-* para sua plataforma; por isso, no macOS ou Linux, claude responde claude native binary not installed.

No PowerShell, o npm às vezes trava em npm.ps1 cannot be loaded because running scripts is disabled on this system. Isso ocorre porque a política de execução bloqueia scripts .ps1. A documentação oferece três soluções: permita scripts locais para seu usuário com o comando abaixo, chame npm.cmd e claude.cmd ou abandone o npm e use o instalador nativo.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Mais um aviso: ignore instaladores .exe de terceiros encontrados em tutoriais, especialmente os que solicitam privilégios de administrador. Os comandos oficiais acima são suficientes.

Etapa 3: confirme que o Claude Code está instalado

Feche o terminal onde instalou o programa e abra um novo. A janela antiga ainda usa o PATH anterior à instalação; por isso, nela claude frequentemente ainda não é reconhecido. No terminal novo:

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor ajuda a separar dois tipos de problema: se o relatório estiver limpo, mas o Claude Code continuar sem conexão, a origem está na configuração (etapa 4), não na instalação.

Ainda aparece command not found: claude ou 'claude' is not recognized? A pasta de instalação não foi adicionada ao PATH. No macOS e Linux, essa pasta é ~/.local/bin; no Windows, %USERPROFILE%\.local\bin. Para Windows, a documentação fornece o seguinte comando do PowerShell:

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut página de solução de problemas da instalação (dicek 3 de outubro de 2026), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

Etapa 4: configure a chave de API sem assinatura

O Claude Code possui a variável integrada ANTHROPIC_BASE_URL para enviar solicitações a um gateway diferente da Anthropic, e sua documentação oficial tem uma página específica para isso. Portanto, trata-se de uma configuração compatível, não de uma modificação ou plugin. Obtenha primeiro a chave sk-kn-… (consulte a etapa 6 para ver como obter e adicionar saldo) e escolha um dos locais para armazená-la.

macOS e Linux: adicione estas seis linhas ao final de ~/.zshrc (Zsh, padrão do macOS) ou ~/.bashrc, salve e abra um terminal novo.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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

Windows, para testar primeiro: defina as variáveis em uma janela do PowerShell e execute imediatamente claude.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Todos os sistemas operacionais, permanentemente: coloque-as no bloco env do arquivo de configurações do usuário ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Isso se aplica a todos os projetos. Se o arquivo já tiver conteúdo, insira apenas o bloco env sem substituir as outras configurações.

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

Pontos importantes sobre as seis variáveis acima:

Kenapa model dikunci? Menurut documentação de configuração de modelos (dicek 3 de outubro de 2026), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 3 de outubro de 2026 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Karena itu blok di atas juga mengunci alias sonnet dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: tanpa pin itu, /model sonnet, fase eksekusi opusplan, dan subagent bermodel sonnet berakhir 404. Alias opus dikunci ke Claude Opus 5.5 (claude-opus-5-5), yang butuh Claude Code v2.1.280 atau lebih baru; kalau versi Anda lebih lama, jalankan claude update.

Tarifas do Kunavo por 1 milhão de tokens (entrada / saída): Claude Sonnet 5 $1,40 / $7,00 (preço de tabela da Anthropic: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00 e Claude Haiku 4.5 $0,70 / $3,50.

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut documentação do gateway, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

Etapa 5: abra a primeira sessão e verifique /status

Entre na pasta do projeto e digite claude. Se a chave já tiver sido lida, a sessão será aberta sem tela de login. A tela de login indica que a chave não foi carregada. A causa mais comum é a chave estar apenas em .claude/settings.json ou .claude/settings.local.json do projeto. No modo interativo, o bloco env do arquivo do projeto só é lido após o assistente inicial e a pergunta sobre confiar na pasta; por isso, na primeira inicialização o Claude Code ainda solicita login. Mova a chave para o shell ou para ~/.claude/settings.json.

Depois que a sessão for aberta, digite /status. A configuração está correta quando:

• há uma linha Anthropic base URL contendo https://api.kunavo.com (essa linha só aparece quando o gateway está configurado; sua ausência significa que ANTHROPIC_BASE_URL não foi lido); e
• há uma linha Auth token mencionando ANTHROPIC_AUTH_TOKEN. Se aparecer Login method com uma conta claude.ai, o Claude Code ainda está usando o login antigo.

Quer testar a chave antes de abrir o Claude Code? A documentação oficial usa uma solicitação que pede apenas 1 token de saída, portanto o saldo descontado é muito pequeno. O comando lê a variável do shell ativo; se sua chave estiver salva em um arquivo de configurações, execute export primeiro neste terminal. Um resultado iniciado por {"id":"msg_ indica sucesso; 401 indica que a chave foi recusada.

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 para PowerShell; funciona quando o campo id da resposta 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": "."}]}'

Alguns aspectos funcionam de maneira diferente enquanto o Claude Code usa uma chave de API e um gateway:

Etapa 6: adicione saldo com cartão ou Link (sem QRIS, GoPay, OVO ou DANA)

O que você paga no Kunavo é um saldo de API pré-pago, não uma assinatura. É desse saldo que o Claude Code desconta o valor por token depois que a chave é configurada. A sequência é:

1. Crie uma conta no Kunavo usando e-mail ou uma conta Google. O cadastro não solicita um cartão.
2. Abra Billing e escolha um valor. O mínimo é $10, sem mensalidade. Valores maiores podem receber bônus de saldo: bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
4. Abra API Keys e crie uma chave. Chaves iniciadas por sk-kn- são exibidas apenas uma vez; copie-as imediatamente para ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, conta virtual e transferência bancária não estão disponíveis. Sem um cartão que permita transações online internacionais, você não poderá adicionar saldo ao Kunavo no momento. Cartões de débito com logotipo Visa ou Mastercard também são aceitos; se forem recusados, geralmente as transações online ou internacionais ainda não foram ativadas no aplicativo do banco, e a decisão final cabe ao banco emissor.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (documentação de Adaptive Pricing da Stripe, dicek 3 de outubro de 2026). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

O saldo nunca expira e solicitações malsucedidas não o descontam. A recarga automática só funciona com cartões salvos ou Link. O Kunavo não emite nenhum documento fiscal. Esse saldo também não pode ser usado para pagar o Claude Pro ou Max. Os detalhes das tarifas de todos os modelos Claude e como pagar da Indonésia estão em preços da API do Claude; a comparação entre assinatura e chave de API especificamente para o Claude Code está em preços do Claude Code.

Quanto aproximadamente será gasto?

Cada solicitação do Claude Code reenvia o contexto da conversa, mas o trecho inicial que se repete entre solicitações recebe uma tarifa de leitura do cache muito mais baixa. O cálculo abaixo é pura aritmética de tokens com as premissas indicadas, não uma medição nem um limite superior:

• uma requisição = 40.000 tokens de entrada; 36.000 (90%) são lidos do cache, e os 4.000 restantes são gravados no cache;
• uma solicitação gera 1.000 tokens de saída;
• uma sessão = 50 solicitações, sem incluir chamadas Claude Haiku 4.5 em segundo plano;
• tarifa de leitura do cache 10% e 1,25× a tarifa de entrada (proporção Claude Sonnet 5 na Kunavo; cada modelo na tabela usa sua própria proporção).

Seus números reais variam conforme o tamanho do contexto, a frequência de acertos do cache, o tamanho das respostas e se a conversa é limpa com /clear ao mudar de tarefa. Segundo a documentação de custos da Anthropic, os processos em segundo plano do Claude Code normalmente custam menos de US$ 0,04 por sessão (verificado em 3 de outubro de 2026). A tarifa completa está na página de preços, e para estimar seu próprio padrão de uso há uma calculadora de custos de tokens do Claude (em inglês).

Como usar o Claude Code no dia a dia

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• Peça em linguagem comum, por exemplo, “explique a estrutura deste projeto” ou “corrija o erro na página de login”. O Claude Code lê os arquivos e pede permissão antes de alterar ou executar qualquer coisa.
• Use /clear ao mudar de tarefa: o histórico antigo não é enviado novamente, então os tokens por solicitação diminuem.
• Use /model para trocar de modelo. Com o pin da etapa 4, opus = claude-opus-5-5, sonnet = claude-sonnet-5 e haiku = claude-haiku-4-5.
• /status para verificar o gateway e a chave; /usage para estimar custos (com os preços de tabela, consulte a tabela na etapa 5).

Mensagens de erro e seus significados

Limitações

• Pague somente com cartão, Link ou Apple Pay/Google Pay. Não há QRIS, GoPay, OVO, DANA, ShopeePay, conta virtual ou transferência bancária; a recarga automática só funciona com um cartão salvo ou Link.
• A Kunavo não emite nenhum documento fiscal.
• Esta é uma API paga por token, não uma assinatura do Claude Pro ou Max. Com uma chave de API, o Remote Control e a ditado por voz não estão disponíveis, /fast fica desativado e a busca de ferramentas MCP fica desativada por padrão.
• Em 3 de outubro de 2026, o Sonnet 5.5 ainda não está disponível na Kunavo; sem fixar o modelo, o alias padrão pode resultar em 404.
• A documentação do Claude Code está disponível em indonésio, mas a documentação da integração da Kunavo e a versão em inglês deste guia (Install Claude Code) ainda não estão disponíveis em indonésio.

Perguntas frequentes