Configurar Claude Code
Instale, autentique e comece a usar Claude Code em sua máquina de desenvolvimento.
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
Instalação padrão
To install Claude Code, run the following command:
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:
Claude Code oferece as seguintes opções de autenticação:
- Console Anthropic: A opção padrão. Conecte-se através do Console Anthropic e complete o processo OAuth. Requer cobrança ativa em console.anthropic.com.
- Aplicativo 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.
- 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
:
Métodos de instalação alternativos
Claude Code oferece múltiplos métodos de instalação para adequar 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 npm global
Método tradicional mostrado nas etapas 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 de binário nativo.
Para uma instalação nova, execute o seguinte comando:
macOS, Linux, WSL:
Windows PowerShell:
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 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 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: