Como instalar o Claude Code

Node.js para Claude Code: qual versão usar e como dispensá-lo

A opção com npm exige Node.js 18 ou mais recente — node -v para verificar; nvm (nvm install --lts) para corrigir. Uma versão antiga do Node é o motivo mais comum para uma instalação nova não iniciar. Se o Node não faz parte do seu conjunto de ferramentas, dispense-o: o instalador nativo abaixo fornece um binário independente que se atualiza automaticamente.

Opção 1 — npm (qualquer sistema operacional com Node.js 18 ou superior)

npm install -g @anthropic-ai/claude-code
claude --version

Se npm install -g falhar com EACCES no macOS ou Linux, não use sudo — corrija o prefixo do npm: npm config set prefix ~/.npm-global e adicione ~/.npm-global/bin ao seu PATH. No Windows, execute a instalação em um terminal normal (sem privilégios de administrador).

Opção 2 — instalador nativo para Mac, Linux e Windows (sem Node.js)

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

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

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Instale o Claude Code no Linux e no Ubuntu

No Ubuntu, Debian, Fedora ou em qualquer distribuição: o instalador nativo (curl -fsSL https://claude.ai/install.sh | bash) coloca um binário com atualização automática no seu diretório pessoal e não requer root nem Node.js. Se preferir npm, primeiro instale o Node 18 ou superior pelo NodeSource ou nvm — o Node do apt do Ubuntu costuma ser antigo demais — e depois npm install -g @anthropic-ai/claude-code. Em um servidor acessível apenas por terminal ou em um contêiner, o binário nativo é a melhor escolha; adicione as duas variáveis do gateway a ~/.bashrc e ele funcionará via SSH exatamente como funciona localmente.

A versão nativa se atualiza automaticamente e evita conflitos de versões do Node. É a melhor escolha em máquinas nas quais o Node ainda não faz parte do seu conjunto de ferramentas.

Opção 3 — aplicativo para desktop ou extensão de IDE

O aplicativo Claude para desktop inclui o Claude Code, e as extensões do VS Code e do JetBrains instalam a CLI para você no primeiro uso. Consulte o guia de web, desktop e IDE para saber o que cada interface pode e não pode fazer.

Observações sobre o Windows

O Claude Code é executado nativamente no Windows 10/11 (PowerShell ou Git Bash) e dentro do WSL. O WSL oferece uma experiência mais fluida para projetos que pressupõem um shell Unix. Se claude não for encontrado após uma instalação com npm no Windows, abra um novo terminal para que PATH seja lido novamente, ou verifique npm config get prefix e adicione sua pasta bin .

Execute o Claude Code sem login: autentique-se com uma chave de API

Execute claude e escolha /login para entrar com uma assinatura Claude Pro/Max — ou dispense completamente o login. Com ANTHROPIC_API_KEY (ou ANTHROPIC_AUTH_TOKEN) definido, o Claude Code nunca exibe a tela de login e é executado localmente usando o endpoint indicado por ANTHROPIC_BASE_URL, que também é a forma como ele funciona em máquinas que não podem abrir um navegador. Para este gateway, use a opção com chave:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

Coloque essas duas linhas em ~/.zshrc, ~/.bashrc ou no seu perfil do PowerShell para que estejam disponíveis em cada novo terminal. Dentro do Claude Code, /status mostra qual endpoint e qual chave estão ativos.

Como atualizar e desinstalar o Claude Code

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

Se a instalação funcionou, mas o Claude Code não inicia

• command not found → PATH: abra um novo shell ou adicione o diretório global de binários do npm.
• Node version erros → é necessário Node.js 18 ou mais recente; node -v para verificar, ou mude para o instalador nativo.
• Trava na primeira execução → proxy corporativo; defina HTTPS_PROXY ou a URL base do gateway se a sua rede bloquear api.anthropic.com.
• 401 / chave inválida → a chave deve ser uma chave do gateway quando ANTHROPIC_BASE_URL aponta para cá; uma chave do console da Anthropic será rejeitada.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.