Source: https://aiprimetech.io/pt/claude-code/install/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › Instalação

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Como instalar o Claude Code

Há três formas compatíveis de instalar o Claude Code em uma máquina. Escolha uma; todas disponibilizam o mesmo comando claude .

## TLDR
- npm: npm install -g @anthropic-ai/claude-code (requer Node.js 18 ou superior).
- Instalador nativo: um comando curl (macOS/Linux) ou uma linha de PowerShell (Windows) — não requer Node.
- Verifique com claude --version, depois defina ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY para usar este gateway.

## 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.

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

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

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

Preciso do Node.js para instalar o Claude Code?

Apenas para a instalação via npm. O instalador nativo (curl no macOS/Linux, PowerShell no Windows) e o aplicativo para desktop não precisam do Node.O Claude Code funciona no Windows?

Sim, nativamente no PowerShell ou no Git Bash, e dentro do WSL. O WSL é recomendado para projetos estruturados para Unix.Posso instalar o Claude Code sem uma assinatura do Claude?

Sim. A instalação é gratuita; autentique-se com uma chave de API em vez de /login. Uma chave do gateway deste site funciona como substituição direta.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

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.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)