​
Requisitos do sistema

  • Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows 10+ (com WSL 1, WSL 2, ou Git for 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. Claude Console: A opção padrão. Conecte-se através do Claude Console e complete o processo OAuth. Requer cobrança ativa em console.anthropic.com. Um workspace “Claude Code” será automaticamente criado para rastreamento de uso e gerenciamento de custos. Note que você não pode criar chaves de API para o workspace Claude Code - ele é dedicado exclusivamente para uso do Claude Code.
  2. Claude App (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 for 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 um dos seguintes comandos: Homebrew (macOS, Linux): 
brew install --cask claude-code
Claude Code instalado via Homebrew será atualizado automaticamente fora do diretório brew, a menos que explicitamente desabilitado com a variável de ambiente DISABLE_AUTOUPDATER (consulte a seção Atualizações automáticas).
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 libgcc, libstdc++, e ripgrep. Instale (Alpine: apk add libgcc libstdc++ 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
Windows CMD: 
REM Instalar versão estável (padrão)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Instalar versão mais recente
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Instalar número de versão específico
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
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 npm do atualizador automático
  • Alguns usuários podem ser automaticamente migrados para este método

​
Executando no AWS ou GCP

Por padrão, Claude Code usa a API Claude. 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: Defina a variável de ambiente DISABLE_AUTOUPDATER em seu shell ou arquivo settings.json: 
export DISABLE_AUTOUPDATER=1

​
Atualizar manualmente

claude update