Começando com Claude Code
Aprenda como instalar, autenticar e começar a usar Claude Code.
Verificar requisitos do sistema
- Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows via WSL
- Hardware: 4GB RAM mínimo
- Software:
- 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:
-
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 usesudo
)
- Execute
-
Erros de Node não encontrado: Se você ver
exec: node: not found
ao executarclaude
, seu ambiente WSL pode estar usando uma instalação do Node.js do Windows. Você pode confirmar isso comwhich npm
ewhich 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 vianvm
.
Instalar e autenticar
Instalar Claude Code
To install Claude Code, run the following command:
Navegar para seu projeto
bash cd your-project-directory
Iniciar Claude Code
bash claude
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:
Iniciar Claude Code
bash claude
Executar um comando simples
bash summarize this project
Gerar um guia de projeto CLAUDE.md
bash /init
Fazer commit do arquivo CLAUDE.md gerado
Peça ao Claude para fazer commit do arquivo CLAUDE.md gerado para seu repositório.