Principais Conclusões
- Dois métodos de instalação: Use o instalador nativo (
curl -fsSL https://claude.ai/install.sh | bash) para uma configuração sem dependências, ou npm (npm install -g @anthropic-ai/claude-code) se você precisar de fixação de versão. - Os requisitos de sistema são mínimos: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), ou Windows 10+ com WSL. Pelo menos 4GB de RAM. Nenhuma GPU é necessária.
- Conta necessária: Você precisa de uma conta Claude Pro, Max, Teams, Enterprise ou Console (API). O plano gratuito do Claude.ai não inclui acesso ao Claude Code.
- A configuração leva menos de cinco minutos: Instale, autentique no seu navegador e comece a usar o Claude Code em qualquer diretório de projeto imediatamente.
Como Instalar o Claude Code: Guia de Configuração Completo (2026)
O Claude Code é o assistente de codificação por IA da Anthropic que roda diretamente no seu terminal. Ele lê sua base de código, escreve código, executa comandos e lida com edições complexas em múltiplos arquivos -- tudo a partir de uma única interface de linha de comando.
Ao contrário das ferramentas de chat de IA baseadas em navegador, o Claude Code opera dentro do seu ambiente de desenvolvimento real. Ele vê sua estrutura de arquivos, entende o contexto do seu projeto e faz alterações em arquivos reais na sua máquina.
Este guia orienta você em cada etapa da instalação do Claude Code em 2026, desde a verificação dos pré-requisitos até a execução da sua primeira sessão de codificação assistida por IA. Esteja você no macOS, Linux ou Windows, você terá o Claude Code rodando em menos de cinco minutos.
O Que Você Precisa (Checklist de Pré-requisitos)
Antes de instalar o Claude Code, confirme se você tem o seguinte:
- Sistema operacional: macOS 13.0 (Ventura) ou posterior, Ubuntu 20.04+ ou Debian 10+, ou Windows 10 (versão 1809+) com WSL
- RAM: Pelo menos 4GB (8GB recomendados para bases de código maiores)
- Conexão de internet: O Claude Code se conecta à API na nuvem da Anthropic, portanto, uma conexão ativa é necessária
- Conta da Anthropic: Uma conta Claude Pro ($20/mês), Claude Max ($100-200/mês), Teams, Enterprise ou Console (API)
- Terminal: Bash, Zsh ou PowerShell
- Node.js 18+ (necessário apenas para o método de instalação via npm)
Você não precisa de uma GPU. Todo o processamento de IA acontece nos servidores da Anthropic. Sua máquina só precisa rodar o cliente CLI e enviar solicitações pela rede.
Passo 1: Instalar o Node.js (Se Você Não Tiver)
Se você planeja usar o método de instalação via npm, você precisa do Node.js 18 ou superior. Se você já tem o Node.js instalado, verifique sua versão:
node --version
Se a saída mostrar v18.0.0 ou superior, pule para o Passo 2. Caso contrário, instale ou atualize o Node.js usando o nvm (Node Version Manager), que é a abordagem recomendada porque evita problemas de permissão e permite alternar entre versões do Node facilmente.
Instalar o nvm no macOS ou Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Feche e abra novamente seu terminal, então instale o Node.js:
nvm install 22
nvm use 22
node --version
Você deve ver um número de versão começando com v22. O Node.js 22 é a versão LTS atual e funciona perfeitamente com o Claude Code.
Instalar o Node.js no Windows (dentro do WSL):
Primeiro, certifique-se de que o WSL está instalado (veja a seção Windows abaixo). Em seguida, abra seu terminal WSL e execute os mesmos comandos nvm acima.
Passo 2: Instalar o Claude Code
Você tem duas opções para instalar o Claude Code. O instalador nativo é agora o método recomendado, mas o npm continua totalmente suportado.
Opção A: Instalador Nativo (Recomendado)
O instalador nativo requer zero dependências -- sem Node.js, sem npm. Ele se atualiza automaticamente em segundo plano e é o principal método que a Anthropic testa e suporta.
macOS e Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, como Administrador):
irm https://claude.ai/install.ps1 | iex
O instalador baixa o binário do Claude Code, coloca-o no seu PATH e configura as atualizações automáticas. Todo o processo leva menos de um minuto.
Opção B: Instalação via npm
Se você preferir o npm -- por exemplo, para fixar uma versão específica ou porque o npm é padrão no seu fluxo de trabalho -- execute:
npm install -g @anthropic-ai/claude-code
Importante: Não use sudo com a instalação do npm. Se você receber erros de permissão, a correção correta é usar o nvm (que instala o Node.js no seu diretório home) em vez de rodar o npm como root.
Verificar a Instalação
Independentemente do método escolhido, verifique se o Claude Code está instalado:
claude --version
Você deve ver um número de versão. Você também pode executar o diagnóstico integrado:
claude doctor
Este comando verifica seu ambiente e relata quaisquer problemas de configuração.
Passo 3: Autenticar
O Claude Code requer autenticação antes que você possa usá-lo. Execute:
claude
A primeira vez que você executar este comando, o Claude Code abrirá seu navegador padrão e solicitará que você faça login na sua conta da Anthropic. Siga as instruções para autorizar o CLI.
Opções de Autenticação
Login baseado no navegador (padrão): Melhor para máquinas pessoais. O Claude Code abre uma janela do navegador, você faz o login e o CLI recebe um token de autenticação automaticamente. Isso funciona com contas Claude Pro, Max, Teams e Enterprise.
Chave de API (para CI/CD e automação): Se você estiver executando o Claude Code em um ambiente headless ou pipeline de CI/CD, defina sua chave de API como uma variável de ambiente:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Você pode gerar uma chave de API a partir do Anthropic Console. O uso da API é faturado por token de acordo com as taxas publicadas pela Anthropic.
Assinatura vs. Faturamento por API: Com uma assinatura Pro ou Max, o uso do Claude Code está incluído no seu plano mensal (sujeito a limites de uso). Com uma chave de API do Console, você paga por token. Escolha com base no seu volume de uso -- as assinaturas são mais simples para uso regular, enquanto o faturamento por API oferece mais controle para cargas de trabalho variáveis ou automatizadas.
Passo 4: Seu Primeiro Projeto
Agora que o Claude Code está instalado e autenticado, experimente-o em um projeto real.
Navegue até qualquer diretório de projeto:
cd ~/my-project
Inicie o Claude Code:
claude
Você está agora em uma sessão interativa. O Claude Code leu a estrutura do seu projeto e está pronto para ajudar. Tente dar a ele uma tarefa:
> Explain the architecture of this project
O Claude Code escaneará seus arquivos, identificará a stack tecnológica e fornecerá um resumo de como o projeto está organizado.
Tente algo mais prático:
> Add input validation to the user registration form
O Claude Code identificará os arquivos relevantes, proporá alterações e pedirá sua confirmação antes de modificar qualquer coisa. Você revisa cada alteração em uma visualização de diff e a aceita ou rejeita.
Para uma tarefa única sem entrar no modo interativo, use a flag -p:
claude -p "Write unit tests for the auth module"
Isso executa a tarefa, exibe o resultado e encerra -- útil para scripts e perguntas rápidas.
Passo 5: Configuração Essencial
O Claude Code funciona logo de cara com padrões sensatos, mas você pode personalizar seu comportamento para o seu fluxo de trabalho.
Seleção de Modelo
O Claude Code usa o modelo Claude mais recente por padrão. Para especificar um modelo diferente:
claude config set model claude-opus-4-6
Ou para uma única sessão:
claude --model claude-sonnet-4-20250514
Permissões
O Claude Code pede confirmação antes de realizar ações potencialmente destrutivas, como escrever arquivos ou executar comandos shell. Você pode configurar este comportamento:
claude config set permissions.auto-accept-edits true
Configurações a Nível de Projeto
Crie um arquivo .claude/settings.json na raiz do seu projeto para definir configurações compartilhadas pela equipe:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Este arquivo deve ser enviado para o controle de versão para que toda a sua equipe compartilhe o mesmo comportamento do Claude Code.
Para substituições pessoais que não devem ser enviadas, use .claude/settings.local.json em seu lugar.
Configuração de Servidor MCP
O Claude Code suporta servidores Model Context Protocol (MCP) para estender suas capacidades. Configure-os em .mcp.json na raiz do seu projeto:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Instalando em Diferentes Ambientes
macOS
O instalador nativo é o caminho mais simples no macOS. Tanto máquinas Apple Silicon (M1/M2/M3/M4) quanto Intel são suportadas:
curl -fsSL https://claude.ai/install.sh | bash
Alternativamente, o Claude Code está disponível via Homebrew:
brew install --cask claude-code
Linux
Funciona no Ubuntu 20.04+, Debian 10+ e na maioria das distribuições modernas:
curl -fsSL https://claude.ai/install.sh | bash
Se você estiver em uma distribuição mais antiga, use o método npm com nvm para evitar problemas de dependência em nível de sistema.
Windows (WSL)
O Claude Code no Windows requer o WSL ou Git for Windows. O WSL é a abordagem recomendada:
- Abra o PowerShell como Administrador e instale o WSL:
wsl --install
-
Reinicie seu computador quando solicitado.
-
Abra o terminal WSL (Ubuntu por padrão) e instale o Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Alternativamente, você pode usar o instalador nativo do Windows diretamente no PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
Para ambientes conteinerizados, adicione o Claude Code ao seu Dockerfile:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
Para pipelines de CI/CD, passe a chave de API em tempo de execução em vez de embuti-la na imagem:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
Pipelines de CI/CD
O modo headless do Claude Code (flag -p) foi projetado para automação. Aqui está um exemplo de GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
A flag --output-format json retorna uma saída estruturada que as etapas seguintes podem analisar.
Atualizando o Claude Code
Instalador Nativo
Se você instalou o Claude Code com o instalador nativo, as atualizações acontecem automaticamente em segundo plano. Nenhuma ação é necessária. Você pode configurar o canal de atualização:
claude config set update-channel stable
Para verificar sua versão atual:
claude --version
npm
Se você instalou via npm, atualize manualmente:
npm update -g @anthropic-ai/claude-code
Ou instale uma versão específica:
npm install -g @anthropic-ai/claude-code@latest
Integração com IDE
Embora o Claude Code seja uma ferramenta focada no terminal, ele se integra diretamente com IDEs populares para uma experiência mais visual.
Extensão do VS Code
A extensão do VS Code fornece uma interface gráfica nativa para o Claude Code dentro do seu editor. Ela inclui um painel de chat, desfazer baseado em checkpoints, referências de arquivos com menções @ e a capacidade de executar várias conversas em abas paralelas.
Para instalar, abra o VS Code e pesquise por "Claude Code" no painel de Extensões, ou execute:
code --install-extension anthropic.claude-code
Uma vez instalada, você pode abrir o painel do Claude Code na barra lateral e interagir com ele como na versão de terminal, mas com o benefício adicional de ver os diffs de arquivos renderizados no visualizador de diff nativo do VS Code.
Plugin JetBrains
Para IntelliJ IDEA, PyCharm, WebStorm, GoLand e outras IDEs da JetBrains, instale o plugin Claude Code do JetBrains Marketplace:
- Abra sua IDE JetBrains
- Vá em Settings depois Plugins e depois Marketplace
- Pesquise por "Claude Code"
- Clique em Install e reinicie a IDE
O plugin JetBrains executa o CLI do Claude Code dentro do terminal integrado da sua IDE e abre as alterações propostas no visualizador de diff da IDE. Atualmente está em versão beta, mas totalmente funcional para uso diário.
Solução de Problemas
"command not found: claude"
O binário do Claude Code não está no seu PATH. Se você usou o instalador nativo, tente abrir uma nova janela de terminal. Se isso não funcionar, execute o script de instalação novamente. Para instalações via npm, certifique-se de que seu diretório bin global do npm está no seu PATH:
npm config get prefix
Adicione o subdiretório bin desse caminho à variável PATH do seu shell.
"Node.js version too old"
O Claude Code requer Node.js 18+. Verifique sua versão com node --version. Se for inferior a 18, instale uma versão mais recente usando o nvm:
nvm install 22
nvm use 22
Erros de Permissão do npm (EACCES)
Nunca use sudo npm install -g. Em vez disso, corrija o diretório padrão do npm ou use o nvm, que instala tudo no seu diretório home e evita conflitos de permissão inteiramente:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Falha na Autenticação ou o Navegador Não Abre
Se o login baseado no navegador não funcionar (comum em servidores remotos ou WSL), você pode autenticar com uma chave de API:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Gere sua chave de API em console.anthropic.com.
"Network Error" ou Timeout Durante a Instalação
Sua rede ou firewall pode estar bloqueando o npm ou o instalador nativo. Tente:
npm config set registry https://registry.npmjs.org/
Se você estiver atrás de um proxy corporativo, configure o npm para usá-lo:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
O Claude Code Roda Lentamente
O Claude Code em si é leve -- a lentidão geralmente significa latência de rede para a API da Anthropic. Verifique sua conexão com a internet. Se estiver em uma VPN, tente desconectar. Você também pode verificar o status da API em status.anthropic.com.
Próximos Passos
Você tem o Claude Code instalado, autenticado e funcionando. Aqui está para onde ir a partir de agora:
- Aprenda o fluxo de trabalho: Leia nosso tutorial do Claude Code para um mergulho profundo em estratégias de prompting, edição de múltiplos arquivos e como obter o máximo do desenvolvimento assistido por IA.
- Compare suas opções: Veja como o Claude Code se sai em nossa comparação Claude Code vs Cursor se você estiver decidindo entre ferramentas de codificação por IA.
- Explore recursos avançados: O Claude Code suporta servidores MCP, hooks personalizados, automação headless e configurações multi-modelo. A documentação oficial cobre isso em detalhes.
O Claude Code é a maneira mais rápida de trazer a IA para o seu fluxo de trabalho de desenvolvimento existente sem mudar suas ferramentas ou sair do seu terminal. Agora que está instalado, comece com uma pequena tarefa em um projeto real -- você verá a diferença imediatamente.
