Verificar requisitos do sistema

  • Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows via WSL
  • Hardware: Mínimo de 4GB RAM
  • Software:
    • Node.js 18+
    • git 2.23+ (opcional)
    • GitHub ou GitLab CLI para fluxos de trabalho com PR (opcional)
    • ripgrep (rg) para busca aprimorada de arquivos (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 na instalação do WSL

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

  1. Problemas de detecção de OS/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 Windows do Node.js. Você pode confirmar isso com which npm e which node, que devem apontar para caminhos Linux começando com /usr/ em vez de /mnt/c/. Para corrigir isso, tente instalar o Node através do gerenciador de pacotes da sua distribuição Linux ou via nvm.

Instalar e autenticar

1

Instalar o Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Navegar até seu projeto

cd your-project-directory 
3

Iniciar o Claude Code

claude
4

Completar a autenticação

O Claude Code oferece múltiplas opções de autenticação:

  1. Console Anthropic: A opção padrão. Conecte-se através do Console Anthropic e complete o processo OAuth. Requer faturamento ativo em console.anthropic.com.
  2. Aplicativo Claude (com plano Max): Assine o plano Max do Claude para uma única assinatura que inclui tanto o 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 a inicialização, escolha a opção que corresponde ao seu tipo de assinatura.
  3. Plataformas empresariais: Configure o Claude Code para usar Amazon Bedrock ou Google Vertex AI para implantações empresariais com sua infraestrutura em nuvem existente.

Inicializar seu projeto

Para usuários iniciantes, recomendamos:

1

Iniciar o Claude Code

claude
2

Executar um comando simples

summarize this project
3

Gerar um guia do projeto CLAUDE.md

/init 
4

Fazer commit do arquivo CLAUDE.md gerado

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

Was this page helpful?