Pular para o conteúdo principal

​
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+ de RAM
  • Software: Node.js 18+ (necessário apenas para instalação via NPM)
  • 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, use one of the following methods:
Alguns usuários podem ser migrados automaticamente para um método de instalação melhorado.
Após a conclusão do processo de instalação, 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 conclua o processo OAuth. Requer faturamento ativo em console.anthropic.com. Um espaço de trabalho “Claude Code” será criado automaticamente para rastreamento de uso e gerenciamento de custos. Observe que você não pode criar chaves de API para o espaço de trabalho Claude Code - ele é dedicado exclusivamente ao uso de 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 único 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 obter 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 alternativos de instalação

Claude Code oferece múltiplos métodos de instalação para se adequar a diferentes ambientes. Se você encontrar algum 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.

​
Opções de instalação nativa

A instalação nativa é o método recomendado e oferece vários benefícios:
  • Um executável independente
  • Sem dependência de Node.js
  • Estabilidade melhorada do atualizador automático
Se você tiver uma instalação existente de Claude Code, use claude install para migrar para a instalação do binário nativo. Para opções de instalação avançadas com o instalador nativo: 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.
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).
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
Certifique-se de remover quaisquer aliases ou symlinks desatualizados antes de instalar.

​
Instalação via NPM

Para ambientes onde NPM é preferido ou necessário: 
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.

​
Executando no AWS ou GCP

Por padrão, Claude Code usa a API Claude. Para detalhes sobre como 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