Instalando Claude Code no terminal (Mac, Windows e Linux)

Dato clave

A instalação do Claude Code no Windows tem 3 etapas que 90% das pessoas pulam. Pular qualquer uma delas resulta em erro silencioso que só aparece depois.

Instalar o Claude Code parece simples até travar. Aqui está o passo a passo completo para Mac, Windows e Linux, com os erros mais comuns já documentados e resolvidos.

Pré-requisitos

Antes de instalar você precisa ter conta na Anthropic com plano Pro ativo (US$ 20 por mês). Node.js 18 ou superior também é requisito em todos os sistemas. Verifique no terminal com node -v.

Mac e Linux

Em Mac e Linux a instalação é direta. Abra o terminal e rode o comando oficial. Faça login com a conta Anthropic quando o navegador abrir e volte ao terminal.

prompt

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

Windows

No Windows recomendo usar WSL2 (Ubuntu) ou o terminal PowerShell com Node instalado. Existem comportamentos diferentes entre os dois caminhos. Para começo absoluto, PowerShell já resolve.

Primeiros comandos depois da instalação

prompt

# verifique a instalação
claude --version

# abra o Claude no diretório atual
claude

# saia da sessão com Ctrl+D

Pro tips

01
No Windows, se aparecer erro de execução de scripts no PowerShell, rode Set-ExecutionPolicy RemoteSigned como administrador antes de tentar de novo.
02
Se o login no navegador travar, feche o terminal, abra de novo e rode claude login. Resolve a maioria dos casos.
03
Mantenha o Node atualizado. Versões antigas geram erro silencioso na primeira execução.

Continue lendo

Claude Code

Como escrever um CLAUDE.md que realmente funciona

O CLAUDE.md é o arquivo que ensina ao Claude quem você é. Feito do jeito certo, você para de repetir contexto toda sessão. Template completo incluído.

Claude Code

Seu primeiro projeto real com Claude Code no terminal

Um projeto simples, concreto e útil para você fazer no terminal hoje. Sem complicação, sem app completo. Direto ao valor.

Perguntas frequentes

Preciso pagar pra instalar o Claude Code?

O Claude Code é gratuito pra instalar mas pra usar você precisa de uma conta Anthropic com plano Pro ativo (US$ 20 por mês), o mesmo valor do ChatGPT Plus.

Funciona em qualquer versão do Windows?

Funciona no Windows 10 e 11. A recomendação é usar WSL2 com Ubuntu pra ter o ambiente mais próximo de Linux, mas o PowerShell também funciona se você só quer começar rápido.

Preciso saber programar pra usar Claude Code?

Não. Claude Code aceita comandos em português natural. Você descreve o que quer e ele escreve o código, executa e ajusta. Saber o básico de terminal ajuda mas não é obrigatório.

Por que aparece erro de Node version?

O Claude Code exige Node 18 ou superior. Versões antigas geram erro silencioso na primeira execução. Atualize com nvm install --lts ou baixe a versão mais recente em nodejs.org.

Posso usar Claude Code no mesmo computador junto com Cursor ou outros editores?

Sim. Claude Code roda no terminal, não interfere com editores. Você pode usar Cursor pra editar, Claude Code pra executar tarefas em lote, ChatGPT no browser. Cada ferramenta tem seu lugar.

Quer implementar isso?

Me chama no WhatsApp. Ajudo você a configurar ou implemento pra você.

Quero ajuda no WhatsApp

Gastão Matos

@gastaomatos