Verificar requisitos do sistema

  • Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows via WSL
  • Hardware: 4GB RAM mínimo
  • Software:
    • Node.js 18+
    • git 2.23+ (opcional)
    • CLI do GitHub ou GitLab para fluxos de trabalho de PR (opcional)
  • Rede: Conexão com a internet necessária para autenticação e processamento de IA
  • Localização: Disponível apenas em países suportados

Solução de problemas de instalação do WSL

Atualmente, Claude Code não executa diretamente no Windows, e em vez disso requer WSL. Se você encontrar problemas no WSL:

  1. Problemas de detecção de SO/plataforma: Se você receber um erro durante a instalação, o WSL pode estar usando o npm do Windows. Tente:

    • Execute npm config set os linux antes da instalação
    • Instale com npm install -g @anthropic-ai/claude-code --force --no-os-check (NÃO use sudo)
  2. Erros de Node não encontrado: Se você ver exec: node: not found ao executar claude, seu ambiente WSL pode estar usando uma instalação do Node.js do Windows. Você pode confirmar isso com which npm e which node, que devem apontar para caminhos do Linux começando com /usr/ em vez de /mnt/c/. Para corrigir isso, tente instalar o Node via gerenciador de pacotes da sua distribuição Linux ou via nvm.

Instalar e autenticar

1

Instalar Claude Code

To install Claude Code, run the following command:

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

Navegar para seu projeto

bash cd your-project-directory

3

Iniciar Claude Code

bash claude
4

Completar autenticação

Claude Code oferece múltiplas opções de autenticação: 1. Console Anthropic: A opção padrão. Conecte através do Console Anthropic e complete o processo OAuth. Requer cobrança ativa 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.

Inicializar seu projeto

Para usuários iniciantes, recomendamos:

1

Iniciar Claude Code

bash claude
2

Executar um comando simples

bash summarize this project
3

Gerar um guia de projeto CLAUDE.md

bash /init
4

Fazer commit do arquivo CLAUDE.md gerado

Peça ao Claude para fazer commit do arquivo CLAUDE.md gerado para seu repositório.