​
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

​
Instalar e autenticar

1

Instalar 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 para seu projeto

cd your-project-directory
3

Iniciar Claude Code

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 faturamento ativo 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

claude
2

Executar um comando simples

> summarize this project
3

Gerar um guia de projeto CLAUDE.md

/init
4

Fazer commit do arquivo CLAUDE.md gerado

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

​
Solução de problemas

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

Atualmente, Claude Code não executa diretamente no Windows, e em vez disso requer WSL.

Você pode encontrar os seguintes 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 use sudo)

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 Linux começando com /usr/ em vez de /mnt/c/. Para corrigir isso, tente instalar Node via o gerenciador de pacotes da sua distribuição Linux ou via nvm.

​
Otimizar sua configuração de terminal

Claude Code funciona melhor quando seu terminal está configurado adequadamente. Siga estas diretrizes para otimizar sua experiência.

Shells suportados:

  • Bash
  • Zsh
  • Fish

​
Temas e aparência

Claude não pode controlar o tema do seu terminal. Isso é tratado pela sua aplicação de terminal. Você pode combinar o tema do Claude Code com seu terminal durante a integração ou a qualquer momento via o comando /config

​
Quebras de linha

Você tem várias opções para inserir quebras de linha no Claude Code:

  • Escape rápido: Digite \ seguido de Enter para criar uma nova linha
  • Atalho de teclado: Pressione Option+Enter (Meta+Enter) com configuração adequada

Para configurar Option+Enter no seu terminal:

Para Mac Terminal.app:

  1. Abra Configurações → Perfis → Teclado
  2. Marque “Use Option as Meta Key”

Para iTerm2 e terminal VSCode:

  1. Abra Configurações → Perfis → Teclas
  2. Em Geral, defina a tecla Option Esquerda/Direita para “Esc+”

Dica para usuários iTerm2 e VSCode: Execute /terminal-setup dentro do Claude Code para configurar automaticamente Shift+Enter como uma alternativa mais intuitiva.

​
Configuração de notificações

Nunca perca quando Claude completa uma tarefa com configuração adequada de notificações:

​
Notificações de campainha do terminal

Habilite alertas sonoros quando tarefas completam:

claude config set --global preferredNotifChannel terminal_bell

Para usuários macOS: Não esqueça de habilitar permissões de notificação em Configurações do Sistema → Notificações → [Seu App de Terminal].

​
Notificações do sistema iTerm 2

Para alertas do iTerm 2 quando tarefas completam:

  1. Abra Preferências do iTerm 2
  2. Navegue para Perfis → Terminal
  3. Habilite “Silence bell” e Filtrar Alertas → “Send escape sequence-generated alerts”
  4. Defina seu atraso de notificação preferido

Note que essas notificações são específicas do iTerm 2 e não estão disponíveis no Terminal padrão do macOS.

​
Lidando com entradas grandes

Ao trabalhar com código extenso ou instruções longas:

  • Evite colagem direta: Claude Code pode ter dificuldades com conteúdo colado muito longo
  • Use fluxos de trabalho baseados em arquivo: Escreva conteúdo em um arquivo e peça ao Claude para lê-lo
  • Esteja ciente das limitações do VS Code: O terminal do VS Code é particularmente propenso a truncar colagens longas

​
Modo Vim

Claude Code suporta um subconjunto de keybindings Vim que podem ser habilitados com /vim ou configurados via /config.

O subconjunto suportado inclui:

  • Mudança de modo: Esc (para NORMAL), i/I, a/A, o/O (para INSERT)
  • Navegação: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Edição: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)