Instalar Claude Code: o comando para Windows, macOS e Linux — e como usar sem assinatura

Para instalar o Claude Code basta um comando: no macOS, Linux ou WSL, rode curl -fsSL https://claude.ai/install.sh | bash; no Windows, rode irm https://claude.ai/install.ps1 | iex no PowerShell (no Prompt de Comando, o CMD, use a linha do install.cmd mais abaixo). Depois abra um terminal novo, confira com claude --version e rode claude para começar. Na primeira conexão há dois caminhos: entrar com uma conta Pro, Max, Team, Enterprise ou Console (o plano gratuito do Claude.ai não inclui o Claude Code) ou definir duas variáveis de ambiente, ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN, e usar uma chave de API paga por uso — sem assinatura nenhuma.

Comandos conferidos em 11 de setembro de 2026 na documentação oficial de instalação da Anthropic.

Antes de instalar

Instalar no macOS e no Linux

Abra o Terminal e cole:

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

É o método recomendado: instala um binário independente que se atualiza sozinho em segundo plano. O atalho fica em ~/.local/bin/claude, e um terminal que já estava aberto não enxerga o PATH novo — por isso, abra outra janela antes de testar. No WSL o comando é o mesmo.

Instalar no Windows

No Windows existem duas linhas diferentes, e a única diferença é o terminal em que você está. Se o prompt começa com PS C:\Users\SeuNome>, é o PowerShell; sem o PS, só C:\Users\SeuNome>, é o Prompt de Comando (CMD). Não precisa rodar como administrador.

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

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

Colar a linha no terminal errado é a falha mais comum. A linha do CMD no PowerShell dá The token '&&' is not a valid statement separator; a do PowerShell no CMD dá 'irm' is not recognized as an internal or external command (no Windows em português, “não é reconhecido como um comando interno ou externo”). E o curl … | bash do macOS colado no PowerShell dá A parameter cannot be found that matches parameter name 'fsSL'. Nos três casos, basta usar a linha certa.

Instalar o Git for Windows é opcional, mas recomendado: o Claude Code usa o Git Bash que vem com ele para rodar comandos; sem ele, usa o PowerShell. Se o Git estiver instalado e mesmo assim o Git Bash não for encontrado, defina CLAUDE_CODE_GIT_BASH_PATH no bloco env das configurações apontando para o bash.exe.

No WSL, rode a linha do macOS/Linux dentro do terminal do WSL e abra o claude ali mesmo — não pelo PowerShell nem pelo CMD.

Pelo gerenciador de pacotes

Funciona, com uma diferença importante: nenhum deles se atualiza sozinho por padrão. Você atualiza à mão (brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). Há também repositórios apt, dnf e apk assinados para Debian/Ubuntu, Fedora/RHEL e Alpine.

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — exige Node.js 22 ou mais novo; nunca com sudo
npm install -g @anthropic-ai/claude-code

Pelo npm, desde a versão 2.1.198 o pacote exige Node.js 22 ou mais novo; num Node antigo o npm só mostra um aviso EBADENGINE e a instalação termina. O pacote instala o mesmo binário nativo, que não usa Node.js para rodar. Nunca use sudo npm install -g: causa problemas de permissão e é um risco de segurança.

Conferir a instalação

claude --version   # imprime a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

Guarde o claude doctor: sem abrir sessão, ele mostra a saúde da instalação, erros nos arquivos de configuração e a correção sugerida — é o jeito mais rápido de saber se o problema é a instalação ou a configuração.

Se aparecer command not found: claude (ou, no Windows, que o claude não é reconhecido), a pasta de instalação não está no PATH. No macOS e no Linux, abra um terminal novo; se não resolver, adicione ~/.local/bin ao PATH no ~/.zshrc ou no ~/.bashrc. No Windows a pasta é %USERPROFILE%\.local\bin; confira e adicione pelo PowerShell:

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

Primeira conexão: assinatura ou chave de API

Caminho A — login com a assinatura

Na pasta do projeto, rode claude e siga o login no navegador com uma conta Pro, Max, Team, Enterprise ou Console. Um detalhe que costuma confundir: se a variável ANTHROPIC_API_KEY já estiver definida, o Claude Code pergunta uma vez se deve usar essa chave. Se você recusar, ele passa a ignorá-la em silêncio, sem perguntar de novo — parece que a variável não está sendo lida. Para reativar, vá em /config → Use custom API key.

Caminho B — sem assinatura, com chave paga por uso

O Claude Code lê o ANTHROPIC_BASE_URL de forma nativa, então apontá-lo para qualquer endpoint da Anthropic Messages API é uma configuração suportada — sem plugin, sem proxy, sem binário modificado. O roteiro: crie a conta, recarregue o saldo (mínimo de $10), gere uma chave sk-kn- no painel de chaves (ela aparece uma vez só) e defina as variáveis. No macOS e no Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

No Windows, para testar numa janela do PowerShell:

# Vale só para esta janela do PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Para deixar fixo, o melhor lugar é o bloco env do arquivo de configurações do usuário, ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json). Ali as variáveis valem para qualquer terminal, para a extensão do editor e para processos em segundo plano. Se o arquivo já tiver outras configurações, só acrescente o bloco env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Cada uma dessas linhas tem uma pegadinha:

• ANTHROPIC_BASE_URL leva só o domínio. O Claude Code acrescenta /v1/messages; com /v1 no final a requisição vai para /v1/v1/messages e volta 404.
• Use ANTHROPIC_AUTH_TOKEN, não ANTHROPIC_API_KEY. Elas vão em cabeçalhos HTTP diferentes: a primeira manda Authorization: Bearer e vale na hora; a segunda manda x-api-key e ainda passa pela aprovação única descrita acima.
• Escreva o nome exato do modelo em ANTHROPIC_MODEL. A Kunavo só reconhece o nome idêntico e não traduz nomes antigos com data no sufixo.
• ANTHROPIC_DEFAULT_HAIKU_MODEL cobre as chamadas de fundo que o Claude Code faz sozinho (resumos, títulos). Apontar para o Haiku é economia sem esforço.

Nunca coloque a chave no .claude/settings.json do projeto — esse arquivo vai para o git e para quem clonar o repositório. Na extensão do VS Code, as variáveis ficam em claudeCode.environmentVariables, nas configurações de usuário do próprio VS Code, porque a extensão confere a credencial antes de iniciar.

Tarifas por 1M de tokens, lidas do catálogo:

Para trocar de modelo dentro da sessão, use /model com o nome completo (por exemplo /model claude-opus-5) ou abra o Claude Code com claude --model claude-opus-5. Quanto custa um mês de uso e quando a assinatura compensa mais está no guia de preço do Claude Code.

Como saber qual caminho está ativo

Dentro do Claude Code, rode /status. Uma linha Auth token significa que a chave está valendo; uma linha Login method com uma conta do claude.ai significa que a variável não foi lida. As duas coisas não se somam: com a variável definida, a assinatura fica parada; tire a variável e ele volta para a assinatura, sem reinstalar.

Atrás de um gateway, três coisas mudam: o Remote Control e o ditado por voz não funcionam (exigem a identidade do claude.ai); o /fast pode dizer que o modo rápido está indisponível, porque essa checagem vai direto à Anthropic, mas as requisições normais não mudam; e os números do /context viram estimativas locais. Código, ferramentas, subagentes, MCP, hooks e prompt caching funcionam igual. Os detalhes estão na documentação da integração (em inglês).

Pagar do Brasil — Pix no checkout

A assinatura do claude.ai é uma cobrança recorrente em dólar, que exige cartão internacional liberado para compras no exterior. Na rota de chave de API, a recarga passa pelo checkout do Stripe e o Pix aparece como forma de pagamento para quem paga do Brasil: o preço é em USD e o Stripe mostra o valor convertido em reais antes de você confirmar. Cartão internacional (Visa, Mastercard, American Express), Apple Pay e Link também funcionam. A carteira é pré-paga — recarga mínima de $10, saldo que não expira, requisições com falha não são cobradas — e cada chave pode ter um limite mensal de gasto. O passo a passo, tela por tela, está em como pagar a API com Pix.

Erros comuns

Depois de instalar

No primeiro uso, rode /init dentro do projeto: o Claude Code lê o repositório e gera um CLAUDE.md com os comandos de teste e as convenções que ele encontrar. Revise esse arquivo e deixe-o curto — ele é carregado em toda sessão. Entre tarefas sem relação, /clear começa uma conversa nova; numa tarefa que ficou longa, /compact resume o histórico e segue.

Sendo honesto sobre a escolha: para quem usa o Claude Code muitas horas por dia, a mensalidade da assinatura costuma sair mais barata; o pay-as-you-go compensa quando o uso oscila ou quando você não quer ficar preso à janela de 5 horas — e um mês parado custa zero. Pela Kunavo você usa capacidade compartilhada, sem cota dedicada e sem SLA contratual; quem precisa dessas garantias deve contratar direto com a Anthropic.

Perguntas frequentes