Pular para o conteúdo principal

​
Requisitos do sistema

  • Sistemas Operacionais: macOS 13.0+, Ubuntu 20.04+/Debian 10+, ou Windows 10+ (com WSL 1, WSL 2, ou Git para Windows)
  • Hardware: 4 GB+ de RAM
  • Rede: Conexão com a internet necessária (veja configuração de rede)
  • Shell: Funciona melhor em Bash ou Zsh
  • Localização: Países suportados pela Anthropic

​
Dependências adicionais

​
Instalação

To install Claude Code, use one of the following methods: Após a conclusão do processo de instalação, navegue até seu projeto e inicie Claude Code: 
cd your-awesome-project
claude
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.
Alpine Linux e outras distribuições baseadas em musl/uClibc: O instalador nativo requer libgcc, libstdc++ e ripgrep. Para Alpine: apk add libgcc libstdc++ ripgrep. Defina USE_BUILTIN_RIPGREP=0.

​
Autenticação

​
Para indivíduos

  1. Plano Claude Pro ou Max (recomendado): Inscreva-se no plano Pro ou Max do Claude para uma assinatura unificada que inclui Claude Code e Claude na web. Gerencie sua conta em um único lugar e faça login com sua conta Claude.ai.
  2. Claude Console: Conecte-se através do Claude Console e conclua o processo OAuth. Requer faturamento ativo no Console Anthropic. Um espaço de trabalho “Claude Code” é criado automaticamente para rastreamento de uso e gerenciamento de custos. Você não pode criar chaves de API para o espaço de trabalho Claude Code; é dedicado exclusivamente para uso do Claude Code.

​
Para equipes e organizações

  1. Claude para Equipes ou Empresas (recomendado): Inscreva-se em Claude para Equipes ou Claude para Empresas para faturamento centralizado, gerenciamento de equipe e acesso a Claude Code e Claude na web. Os membros da equipe fazem login com suas contas Claude.ai.
  2. Claude Console com faturamento de equipe: Configure uma Claude Console compartilhada com faturamento de equipe. Convide membros da equipe e atribua funções para rastreamento de uso.
  3. Provedores de nuvem: Configure Claude Code para usar Amazon Bedrock, Google Vertex AI ou Microsoft Foundry para implantações com sua infraestrutura de nuvem existente.

​
Instalar uma versão específica

O instalador nativo aceita um número de versão específico ou um canal de lançamento (latest ou stable). O canal que você escolhe no momento da instalação se torna seu padrão para atualizações automáticas. Veja Configurar canal de lançamento para mais informações. Para instalar a versão mais recente (padrão): 
curl -fsSL https://claude.ai/install.sh | bash
Para instalar a versão estável: 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Para instalar um número de versão específico: 
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

​
Integridade binária e assinatura de código

  • Somas de verificação SHA256 para todas as plataformas são publicadas nos manifestos de lançamento, atualmente localizados em https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json (exemplo: substitua {VERSION} por 2.0.30)
  • Binários assinados são distribuídos para as seguintes plataformas:
    • macOS: Assinado por “Anthropic PBC” e notarizado pela Apple
    • Windows: Assinado por “Anthropic, PBC”

​
Instalação NPM (descontinuada)

A instalação NPM está descontinuada. Use o método de instalação nativa quando possível. Para migrar uma instalação npm existente para nativa, execute claude install. Instalação global npm 
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, veja solução de problemas de permissão para soluções recomendadas.

​
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"

​
Atualizar Claude Code

​
Atualizações automáticas

Claude Code se atualiza automaticamente 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
Instalações do Homebrew e WinGet não se atualizam automaticamente. Use brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode para atualizar manualmente.Problema conhecido: Claude Code pode notificá-lo sobre atualizações antes que a nova versão esteja disponível nesses gerenciadores de pacotes. Se uma atualização falhar, aguarde e tente novamente mais tarde.

​
Configurar canal de lançamento

Configure qual canal de lançamento Claude Code segue para atualizações automáticas e claude update com a configuração autoUpdatesChannel:
  • "latest" (padrão): Receba novos recursos assim que forem lançados
  • "stable": Use uma versão que normalmente tem cerca de uma semana de idade, pulando lançamentos com regressões importantes
Configure isso via /config → Auto-update channel, ou adicione ao seu arquivo settings.json: 
{
  "autoUpdatesChannel": "stable"
}
Para implantações empresariais, você pode impor um canal de lançamento consistente em toda sua organização usando configurações gerenciadas.

​
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

​
Desinstalar Claude Code

Se você precisar desinstalar Claude Code, siga as instruções para seu método de instalação.

​
Instalação nativa

Remova o binário Claude Code e os arquivos de versão: macOS, Linux, WSL: 
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Windows PowerShell: 
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Windows CMD: 
del "%USERPROFILE%\.local\bin\claude.exe"
rmdir /s /q "%USERPROFILE%\.local\share\claude"

​
Instalação Homebrew

brew uninstall --cask claude-code

​
Instalação WinGet

winget uninstall Anthropic.ClaudeCode

​
Instalação NPM

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

​
Limpar arquivos de configuração (opcional)

Remover arquivos de configuração excluirá todas as suas configurações, ferramentas permitidas, configurações do servidor MCP e histórico de sessão.
Para remover as configurações e dados em cache do Claude Code: macOS, Linux, WSL: 
# Remover configurações de usuário e estado
rm -rf ~/.claude
rm ~/.claude.json

# Remover configurações específicas do projeto (execute do diretório do seu projeto)
rm -rf .claude
rm -f .mcp.json
Windows PowerShell: 
# Remover configurações de usuário e estado
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Remover configurações específicas do projeto (execute do diretório do seu projeto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force
Windows CMD: 
REM Remover configurações de usuário e estado
rmdir /s /q "%USERPROFILE%\.claude"
del "%USERPROFILE%\.claude.json"

REM Remover configurações específicas do projeto (execute do diretório do seu projeto)
rmdir /s /q ".claude"
del ".mcp.json"