Primeiros passos com o Claude Code
Aprenda como instalar, autenticar e começar a usar o Claude Code.
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:
- 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:
-
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 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 Windows do Node.js. Você pode confirmar isso comwhich npm
ewhich 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 vianvm
.
Instalar e autenticar
Instalar o Claude Code
Install NodeJS 18+, then run:
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.
Navegar até seu projeto
Iniciar o Claude Code
Completar a autenticação
O Claude Code oferece múltiplas 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 faturamento ativo em console.anthropic.com.
- 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.
- 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:
Iniciar o Claude Code
Executar um comando simples
Gerar um guia do projeto CLAUDE.md
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?