​
Requisitos do sistema

  • Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows 10+ (com WSL 1, WSL 2, ou Git para Windows)
  • Hardware: 4GB+ RAM
  • Software: Node.js 18+
  • Rede: Conexão com a internet necessária para autenticação e processamento de IA
  • Shell: Funciona melhor em Bash, Zsh ou Fish
  • Localização: Países suportados pela Anthropic

​
Dependências adicionais

​
Instalação padrão

To install Claude Code, run the following command:

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

NÃO use sudo npm install -g pois isso pode levar a problemas de permissão e riscos de segurança. Se você encontrar erros de permissão, consulte configurar Claude Code para soluções recomendadas.

Alguns usuários podem ser automaticamente migrados para um método de instalação aprimorado. Execute claude doctor após a instalação para verificar seu tipo de instalação.

Após o processo de instalação ser concluído, navegue até seu projeto e inicie Claude Code:

cd your-awesome-project
claude

Claude Code oferece as seguintes opções de autenticação:

  1. Console Anthropic: A opção padrão. Conecte-se através do Console Anthropic e complete o processo OAuth. Requer faturamento ativo em console.anthropic.com.
  2. App Claude (com plano Pro ou Max): Assine o plano Pro ou Max do Claude para uma assinatura unificada que inclui tanto Claude Code quanto a interface web. Obtenha mais valor pelo mesmo preço enquanto gerencia sua conta em um só lugar. Faça login com sua conta Claude.ai. Durante o lançamento, escolha a opção que corresponde ao seu tipo de assinatura.
  3. Plataformas empresariais: Configure Claude Code para usar Amazon Bedrock ou Google Vertex AI para implantações empresariais com sua infraestrutura de nuvem existente.

Claude Code armazena suas credenciais com segurança. Consulte Gerenciamento de Credenciais para detalhes.

​
Configuração do Windows

Opção 1: Claude Code dentro do WSL

  • Tanto WSL 1 quanto WSL 2 são suportados

Opção 2: Claude Code no Windows nativo com Git Bash

  • Requer Git para Windows
  • Para instalações portáteis do Git, especifique o caminho para seu bash.exe: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
Métodos de instalação alternativos

Claude Code oferece múltiplos métodos de instalação para adequar-se a diferentes ambientes.

Se você encontrar qualquer problema durante a instalação, consulte o guia de solução de problemas.

Execute claude doctor após a instalação para verificar seu tipo de instalação e versão.

​
Instalação global npm

Método tradicional mostrado nos passos de instalação acima

​
Instalação de binário nativo (Beta)

Se você tem uma instalação existente do Claude Code, use claude install para iniciar a instalação do binário nativo.

Para uma instalação nova, execute o seguinte comando:

macOS, Linux, WSL:

# Instalar versão estável (padrão)
curl -fsSL https://claude.ai/install.sh | bash

# Instalar versão mais recente
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Instalar número de versão específico
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Alpine Linux e outras distribuições baseadas em musl/uClibc: A compilação nativa requer que você instale ripgrep. Instale (Alpine: apk add ripgrep) e defina USE_BUILTIN_RIPGREP=0.

Windows PowerShell:

# Instalar versão estável (padrão)
irm https://claude.ai/install.ps1 | iex

# Instalar versão mais recente
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Instalar número de versão específico
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

O instalador nativo do Claude Code é suportado no macOS, Linux e Windows.

Certifique-se de remover quaisquer aliases ou symlinks desatualizados. Uma vez que sua instalação esteja completa, execute claude doctor para verificar a instalação.

​
Instalação local

  • Após instalação global via npm, use claude migrate-installer para mover para local
  • Evita problemas de permissão do atualizador automático npm
  • Alguns usuários podem ser automaticamente migrados para este método

​
Executando no AWS ou GCP

Por padrão, Claude Code usa a API da Anthropic.

Para detalhes sobre executar Claude Code no AWS ou GCP, consulte integrações de terceiros.

​
Atualizar Claude Code

​
Atualizações automáticas

Claude Code se mantém automaticamente atualizado para garantir que você tenha os recursos mais recentes e correções de segurança.

  • Verificações de atualização: Realizadas na inicialização e periodicamente durante a execução
  • Processo de atualização: Baixa e instala automaticamente em segundo plano
  • Notificações: Você verá uma notificação quando as atualizações forem instaladas
  • Aplicando atualizações: As atualizações entram em vigor na próxima vez que você iniciar Claude Code

Desabilitar atualizações automáticas:

# Via configuração
claude config set autoUpdates false --global

# Ou via variável de ambiente
export DISABLE_AUTOUPDATER=1

​
Atualizar manualmente

claude update