Como Instalar Claude Code: Guia para Mac, Windows e Linux

Resumo: Claude Code instala como um pacote npm em menos de 5 minutos no Mac, Windows ou Linux. Você precisa de Node.js 18+ e acesso ativo ao FreeClaude. Este guia cobre instalação para todas as plataformas, configuração pós-instalação, sua primeira sessão, comandos essenciais e solução de problemas comuns.

O que é Claude Code?

Claude Code é o assistente de codificação baseado em terminal de IA da Anthropic — e é categoricamente diferente de ferramentas de IA baseadas em navegador ou plugins de IDE. Em vez de colar snippets de código em uma janela de chat e aplicar manualmente as mudanças, Claude Code opera diretamente no seu terminal com acesso total ao seu sistema de arquivos, comandos de shell e ferramentas de desenvolvimento.

Isso significa que Claude Code pode:

• Ler toda a estrutura do seu projeto e entendê-la antes de fazer qualquer mudança
• Criar, modificar e deletar arquivos diretamente na sua máquina
• Executar sua suite de testes, ver as falhas e corrigi-las automaticamente
• Executar comandos git, ferramentas de build e qualquer comando de shell
• Fazer mudanças coordenadas em dezenas de arquivos em uma única sessão
• Criar commits com mensagens significativas que explicam o raciocínio por trás das mudanças

Para desenvolvedores profissionais, isso transforma IA de um ajudante para copiar e colar em um parceiro de desenvolvimento genuinamente autônomo. Recursos que anteriormente levavam uma tarde podem ser implementados em 20 minutos através de sessões agentes do Claude Code.

Pré-requisitos

Antes de instalar Claude Code, certifique-se de que você tem o seguinte:

Se você ainda não tem acesso ativo ao FreeClaude, visite freeclaude.io e complete sua primeira indicação para desbloquear downloads. O sistema de indicação é a única forma de acessar Claude Code através do FreeClaude.

Instalação no macOS

Passo 1: Instalar Node.js (se necessário)

Abra o Terminal (pressione Cmd + Space, digite "Terminal", pressione Enter). Verifique se Node.js já está instalado:

node --version

Se você vir um número de versão abaixo de 18.x ou vir "comando não encontrado", instale Node.js usando fnm (Fast Node Manager) — a abordagem recomendada:

curl -fsSL https://fnm.vercel.app/install | bash

Feche e reabra o Terminal, então execute:

fnm install --lts

Verifique: node --version agora deve mostrar 20.x ou superior.

Passo 2: Instalar Claude Code

Com Node.js pronto, instale Claude Code globalmente via npm:

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

Alternativamente, você pode baixar o binário pré-compilado diretamente da aba Downloads no seu painel do FreeClaude. A abordagem com binário não requer Node.js, mas oferece menos flexibilidade para atualizações.

Passo 3: Autenticar

Execute claude no seu terminal. No primeiro lançamento, ele pedirá para você se autenticar com suas credenciais do FreeClaude. Siga as instruções na tela — geralmente uma janela do navegador abre para autenticação OAuth, ou você cola um token do seu painel.

Apple Silicon (M1/M2/M3/M4) vs Intel

O método de instalação npm funciona identicamente em ambas as arquiteturas — npm detecta seu chip e instala o binário correto automaticamente. A abordagem com binário pré-compilado fornece downloads separados para Apple Silicon e Intel; seu painel automaticamente serve a versão correta baseado na detecção do seu dispositivo.

Instalação no Windows

Passo 1: Instalar Node.js

Abra PowerShell como Administrador (clique com o botão direito no botão Iniciar, selecione "Windows PowerShell (Admin)").

Verifique Node.js: node --version

Se não estiver instalado, use winget (incluído no Windows 10/11):

winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements

Feche completamente o PowerShell e reabra como Administrador. Verifique: node --version

Passo 2: Instalar Claude Code

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

Se você encontrar um erro de política de execução do PowerShell, execute isto primeiro:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Passo 3: Recomendação do Windows Terminal

Para a melhor experiência com Claude Code no Windows, use Windows Terminal (disponível gratuitamente na Microsoft Store) com PowerShell 7. O Command Prompt clássico funciona, mas tem limitações de exibição para formatação de saída rica do Claude Code.

WSL (Windows Subsystem for Linux) também funciona bem se você preferir um ambiente de desenvolvimento similar ao Linux no Windows.

Instalação no Linux

A instalação no Linux é geralmente a mais direta, já que a maioria das máquinas de desenvolvimento já têm Node.js e um terminal capaz.

Ubuntu/Debian

Verifique a versão do Node.js: node --version

Se estiver abaixo de 18 ou ausente, instale via NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Depois instale Claude Code: sudo npm install -g @anthropic-ai/claude-code

Fedora/RHEL/CentOS

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install -y nodejs
sudo npm install -g @anthropic-ai/claude-code

Arch Linux

sudo pacman -S nodejs npm
sudo npm install -g @anthropic-ai/claude-code

Qualquer Linux (via fnm)

curl -fsSL https://fnm.vercel.app/install | bash
Reinicie seu shell, depois:
fnm install --lts
npm install -g @anthropic-ai/claude-code

Configuração Pós-Instalação

Após instalar, complete estes passos antes de sua primeira sessão de codificação:

1. Abra uma nova janela de terminal — Isso é importante. As novas entradas PATH adicionadas pela instalação npm apenas entram em efeito em novas sessões de terminal.
2. Verifique a instalação — Digite claude --version e confirme que um número de versão aparece.
3. Execute autenticação inicial — Digite claude e siga os prompts de autenticação. Isso conecta Claude Code à sua conta FreeClaude.
4. Configure git (se ainda não feito) — Claude Code cria commits em seu nome. Certifique-se que git conhece sua identidade: git config --global user.name "Seu Nome" e git config --global user.email "voce@exemplo.com"

Sua Primeira Sessão com Claude Code

Navegue até um projeto em que você está trabalhando e inicie Claude Code:

cd ~/meu-projeto
claude

Claude Code inicia e exibe os detalhes da sua conta e status de acesso. Para sua primeira sessão, tente estes prompts introdutórios:

• "Leia este projeto e me dê um resumo da arquitetura, componentes principais e qualquer problema imediato que você notar"
• "Mostre-me a cobertura de testes e identifique áreas sem testes"
• "Encontre qualquer comentário TODO ou instruções console.log deixadas no código"
• "Quais dependências estão desatualizadas e quais atualizações seriam seguras de aplicar?"

Estes prompts dão a Claude Code a chance de se familiarizar com seu projeto antes de você pedir para ele fazer mudanças — o que geralmente produz resultados melhores do que pular direto para modificações de código.

Referência de Comandos Essenciais

Configuração e Personalização

Claude Code lê um arquivo CLAUDE.md da raiz do seu projeto, se um existir. Este arquivo funciona como um conjunto de instruções persistente que Claude Code carrega no início de cada sessão naquele projeto. Você pode usá-lo para especificar:

• Convenções de projeto, padrões de nomenclatura e preferências de estilo de código
• Requisitos de testes e expectativas de cobertura
• Procedimentos de implantação e notas de infraestrutura
• Contexto específico da equipe que Claude sempre deve estar ciente
• Caminhos de arquivo que não devem ser modificados

Execute /init em qualquer projeto para fazer com que Claude Code gere automaticamente um CLAUDE.md inicial baseado em sua análise do seu codebase. Revise e refine antes de fazer commit.

Solução de Problemas

"comando não encontrado: claude"

Feche e reabra seu terminal. Se o problema persistir, verifique se o diretório bin global do npm está no seu PATH:

npm config get prefix

Adicione o caminho de saída com /bin anexado ao seu perfil de shell (~/.zshrc, ~/.bashrc, ou equivalente).

"Falha de autenticação" ou "Não autorizado"

Verifique seu painel do FreeClaude para confirmar que seu temporizador de acesso está ativo. Se seu temporizador expirou, convide outro amigo para estendê-lo. Se o temporizador está ativo, mas a autenticação ainda falha, tente executar claude logout seguido de claude login para re-autenticar.

Respostas lentas ou timeouts

Claude Code requer uma conexão de internet estável para se comunicar com servidores Anthropic. Verifique a qualidade da sua conexão. Se em WiFi, tente uma conexão cabeada para sessões estendidas do Claude Code para evitar conexões caídas no meio da operação.

Erros de permissão ao instalar no Mac/Linux

Evite usar sudo npm install -g, pois pode causar problemas de permissão. Em vez disso, configure npm para usar um diretório gravável pelo usuário:

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
Então adicione export PATH=~/.npm-global/bin:$PATH ao seu perfil de shell.

Claude Code faz uma mudança que eu não queria

Claude Code faz commits git incrementalmente. Execute git log para ver commits recentes e git revert HEAD para desfazer o commit mais recente. Para sessões maiores, Claude Code cria commits em checkpoints lógicos, facilitando reverter para qualquer estado anterior.

Perguntas Frequentes

Claude Code funciona offline?

Não. Claude Code envia o contexto do seu código para servidores Anthropic para processamento de IA. Uma conexão de internet estável é necessária durante todas as sessões.

Meu código é enviado para Anthropic quando uso Claude Code?

Sim. O conteúdo de arquivos que Claude Code lê é enviado à API Anthropic para processamento. A política de privacidade Anthropic se aplica. Não use Claude Code em arquivos contendo segredos, credenciais ou informações altamente sensíveis de propriedade sem revisar as políticas de tratamento de dados Anthropic para seu caso de uso.

Posso usar Claude Code em um container Docker?

Sim, com imagens Docker Node.js padrão. Instale claude-code via npm no container e monte o diretório do seu projeto como um volume.

Qual versão de Node.js Claude Code requer?

Node.js 18.0 ou superior é necessário. Node.js 20 LTS ou Node.js 22 LTS são recomendados para a melhor experiência.

Como atualizo Claude Code?

Execute npm update -g @anthropic-ai/claude-code para atualizar para a versão mais recente. Você também pode executar npm install -g @anthropic-ai/claude-code@latest para forçar uma instalação de versão específica.

Posso usar Claude Code em pipelines CI/CD?

Claude Code é projetado para uso interativo de desenvolvedor. Para casos de uso de CI/CD automatizados, a API Anthropic é mais apropriada. No entanto, algumas equipes escriptam sessões não-interativas de Claude Code para tarefas de revisão específicas em pipelines de CI.

Precisa de Ajuda?

Se você encontrar problemas de instalação ou uso não cobertos aqui, contate nossa equipe de suporte via o bot FreeClaude Telegram. Você também pode visitar nossa comparação de assistente de codificação com IA para entender por que Claude Code lidera o campo, ou nosso guia de introdução se você precisar de ajuda ativando sua conta FreeClaude primeiro.

Configuração Avançada para Fluxos de Trabalho Profissionais

Uma vez que Claude Code está instalado e funcionando, estas opções de configuração melhoram significativamente a experiência para fluxos de trabalho de desenvolvimento profissional:

Criando um CLAUDE.md Global

Além de arquivos CLAUDE.md no nível do projeto, você pode criar uma configuração global de Claude Code em ~/.claude/CLAUDE.md. Este arquivo é carregado para toda sessão de Claude Code independentemente do projeto e é ideal para preferências pessoais que se aplicam universalmente:

• Seu estilo de comentário de código preferido
• Preferências de linguagem de programação padrão
• Convenções pessoais para formato de mensagem de commit
• Lembretes sobre ferramentas que você sempre quer que Claude use (como executar testes antes de fazer commit)
• Qualquer contexto pessoal sobre a configuração do seu ambiente de desenvolvimento

Configurando Seleção de Modelo

Claude Code pode ser configurado para usar um modelo específico como padrão usando a flag --model ou configurando-a em configuração:

• claude --model claude-opus-4-7 — Use Opus para capacidade máxima
• claude --model claude-sonnet-4-6 — Use Sonnet para respostas mais rápidas (recomendado para a maioria das sessões)
• claude --model claude-haiku-4-5 — Use Haiku para tarefas rápidas e leves

Você também pode alternar modelos no meio da sessão com o comando /model sem perder contexto de conversa.

Aliases de Shell para Inicialização Mais Rápida

Adicione estes aliases ao seu perfil de shell (~/.zshrc ou ~/.bashrc) para invocação mais rápida do Claude Code:

• alias cc="claude" — Inicialização rápida
• alias cc-fast="claude --model claude-sonnet-4-6" — Modo rápido com Sonnet
• alias cc-deep="claude --model claude-opus-4-7" — Análise profunda com Opus
• alias cc-review="claude --print /review" — Revisão de código não-interativa

Integração de Fluxo de Trabalho Git

Claude Code integra profundamente com fluxos de trabalho git. Aqui estão os padrões que usuários experientes confiam:

Fluxo de Trabalho de Branch de Recurso

Sempre inicie uma sessão de Claude Code para trabalho significativo criando um novo branch:

1. Criar branch: git checkout -b feature/meu-recurso
2. Iniciar Claude Code: claude
3. Descrever o recurso e deixar Claude Code implementá-lo
4. Revisar o diff: git diff main
5. Mesclar quando satisfeito: git checkout main && git merge feature/meu-recurso

Este fluxo de trabalho lhe dá controle total sobre o que mescla ao seu branch principal enquanto permite que Claude Code trabalhe livremente no ambiente de branch de recurso.

Usando Claude Code para Revisão de Código

Execute claude em qualquer branch e use o comando /review para obter uma revisão abrangente de todas as mudanças não confirmadas. Isso é particularmente valioso como uma verificação pré-commit para capturar problemas antes que sejam enviados ao seu repositório.

Assistência para Rebase Interativo

Peça a Claude Code para ajudar a limpar históricos de commits desordenados: "Tenho 12 commits neste branch de exploração e falsos inícios. Por favor, comprima-os em 3 commits lógicos com mensagens claras descrevendo o que cada grupo de mudanças realiza." Claude Code analisa os commits e fornece os comandos git rebase necessários para reestruturá-los limpa.

Usando Claude Code Junto com seu IDE

Claude Code e seu IDE não são mutuamente exclusivos — eles são ferramentas complementares que funcionam melhor em combinação:

• IDE para: Codificação ativa, destaque de sintaxe, preenchimento automático, depuração com pontos de interrupção, exploração visual de arquivo e operações git baseadas em UI
• Claude Code para: Refatoração multi-arquivo, implementação de recursos de descrições em linguagem natural, correção de bug autônoma, geração de testes, documentação e compreensão de partes desconhecidas de codebases grandes

Um fluxo de trabalho comum: use seu IDE para desenvolvimento ativo de recursos, alterne para Claude Code quando você atingir um problema complexo ou precisar fazer mudanças coordenadas em múltiplos arquivos, depois retorne ao seu IDE para revisar e continuar desenvolvendo sobre implementação Claude. As duas ferramentas nunca entram em conflito porque Claude Code opera no seu sistema de arquivo real — mudanças feitas em Claude Code aparecem imediatamente no editor do seu IDE.

Configuração Ideal de Espaço de Trabalho para Sessões Claude Code

Desenvolvedores profissionais que usam Claude Code intensivamente convergiram em configurações de espaço de trabalho que maximizam produtividade:

• Layout de terminal dividido — Execute Claude Code em um painel de terminal, mantenha um segundo painel para executar seu aplicativo, testes ou monitorar logs. Veja resultados de testes aparecerem à medida que Claude Code corrige bugs em tempo real.
• Diff Git no IDE lado a lado com terminal — Mantenha seu IDE aberto na visualização de diff de controle de fonte. Enquanto Claude Code modifica arquivos, você vê as mudanças destacadas em tempo real no seu IDE sem interromper a sessão de Claude Code.
• Persistência de sessão Tmux ou iTerm2 — Use um multiplicador de terminal para manter sessões de Claude Code vivas através de interrupções de rede e fechamentos de tampa do laptop. Isso é particularmente importante para sessões autônomas longas (30+ minutos) onde queda de conexão perderia progresso.
• Diretórios de projeto dedicados — Mantenha seus projetos bem organizados com nomes de diretório claros. Claude Code lê sua estrutura de diretório como parte de seu entendimento de projeto, e organização limpa ajuda a entender imediatamente limites de projeto.