Como Instalar o Claude Code CLI em 2026: Guia Completo de Configuração

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

Explore todos os AI Perks

Como Instalar o Claude Code CLI em 2026

Para instalar o Claude Code, execute npm install -g @anthropic-ai/claude-code@latest no seu terminal. A instalação leva cerca de 30 segundos. Verifique com claude --version, em seguida, autentique-se com claude auth login para começar a usá-lo.

O Claude Code requer Node.js 18 ou posterior. Uma vez instalado, ele roda em macOS, Linux e Windows com os mesmos comandos. E enquanto você estiver configurando, o AI Perks pode te dar créditos gratuitos da Anthropic no valor de $1.000-$25.000+ para usar o Claude Code sem custo algum.

Economize seu orçamento em créditos de IA

Pesquisar ofertas para

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

TodosGrátisParcerias

Pesquisar ofertas para

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

TodosGrátisParcerias

Software	Creditos Aprox	Condicoes	Indice De Aprovacao	Acoes

Promova seu SaaS

Alcance mais de 90.000 fundadores globalmente que procuram ferramentas como a sua

Inscrever-se agora

Requisitos do Sistema

Verifique sua versão do Node.js:

node --version

Se for inferior a 18, instale a LTS mais recente em nodejs.org ou use o nvm.

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

Explore todos os AI Perks

Instalar Claude Code no macOS

Passo 1: Instalar Node.js (Se Ainda Não Tiver)

Use o Homebrew:

brew install node

Ou baixe de nodejs.org.

Passo 2: Instalar Claude Code

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

Passo 3: Verificar Instalação

claude --version

Você deverá ver um número de versão impresso (ex: 1.x.x).

Passo 4: Autenticar

claude auth login

Isso abrirá um navegador para fazer login através da sua conta Anthropic.

Instalar Claude Code no Linux

Passo 1: Instalar Node.js (Ubuntu/Debian)

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

Para outras distribuições (Fedora, Arch, etc.), use seu gerenciador de pacotes.

Passo 2: Instalar Claude Code

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

Se você receber erros de permissão, não use sudo com npm. Em vez disso, corrija o prefixo do npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Em seguida, reinstale.

Passo 3: Verificar e Autenticar

claude --version
claude auth login

Instalar Claude Code no Windows

Passo 1: Instalar Node.js

Baixe o instalador do Windows de nodejs.org e execute-o. Certifique-se de que "Add to PATH" esteja marcado durante a instalação.

Passo 2: Abrir PowerShell ou Terminal

Abra o PowerShell (ou Windows Terminal) como Administrador.

Passo 3: Instalar Claude Code

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

Passo 4: Verificar Instalação

claude --version

Se claude não for reconhecido, reinicie seu terminal ou verifique se a pasta de binários globais do npm está no seu PATH:

npm config get prefix

Adicione o caminho resultante (com \ anexado) à sua variável PATH do sistema.

Passo 5: Autenticar

claude auth login

Métodos de Autenticação

O Claude Code suporta três métodos de autenticação:

Método 1: Login OAuth (Mais Fácil)

claude auth login

Abre um navegador para fazer login através da sua conta Anthropic. Melhor para uso pessoal com assinatura Pro/Max.

Método 2: Chave de API (Recomendado para Créditos Gratuitos)

Defina sua chave de API Anthropic como uma variável de ambiente:

macOS/Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # ou ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

Esta é a melhor opção para usar créditos gratuitos da Anthropic do AI Perks em vez de uma assinatura paga.

Método 3: Arquivo de Configuração

Edite ~/.claude/auth/credentials.json:

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

Configuração Inicial: Verificar se Tudo Funciona

Após a instalação e autenticação:

Testar Funcionalidade Básica

claude

Você deverá ver o REPL do Claude Code. Tente um prompt:

Olá! Qual modelo você está rodando?

O Claude deverá responder com uma saudação e indicar o modelo ativo.

Testar Operações de Arquivo

Navegue até uma pasta de projeto:

cd ~/projects/my-app
claude

Peça ao Claude para ler seu README:

Você pode ler o README.md e resumir este projeto?

Se o Claude ler e responder, sua configuração funciona.

Erros Comuns de Instalação e Correções

Erro: npm ERR! EACCES permission denied

Você não tem permissão para escrever na pasta global do npm. Correção:

# Não use sudo. Em vez disso, altere o prefixo do npm:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Adicione a exportação ao seu ~/.zshrc ou ~/.bashrc para torná-la permanente.

Erro: command not found: claude

Após a instalação, o comando claude não é encontrado. Causas:

1. Terminal não reiniciado - Feche e reabra seu terminal
2. PATH sem o binário do npm - Execute echo $(npm config get prefix)/bin e adicione ao PATH
3. Configuração de shell incorreta - Para zsh, edite ~/.zshrc; para bash, edite ~/.bashrc

Erro: Versão do Node.js muito antiga

O Claude Code requer Node.js 18+. Atualize:

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# Baixe a LTS mais recente de nodejs.org

Erro: Falha na autenticação

• Verifique se sua chave de API começa com sk-ant-
• Verifique se ela não foi revogada em console.anthropic.com
• Certifique-se de que não há espaços extras na sua variável de ambiente ANTHROPIC_API_KEY
• Tente regenerar a chave

Erro: Cannot find module '@anthropic-ai/claude-code'

A instalação não foi concluída. Tente:

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

Alimente o Claude Code com Créditos Gratuitos da Anthropic

O Claude Code requer uma assinatura paga ($20-$200/mês) ou créditos de API para rodar. Créditos gratuitos da Anthropic via AI Perks cobrem o custo da API integralmente.

Potencial total: $4.500 - $156.000+ em créditos gratuitos do Claude

Após instalar o Claude Code, configure-o com uma chave de API alimentada por créditos gratuitos e pule completamente a cobrança de assinatura.

Passo a Passo: Instalar + Executar Claude Code Gratuitamente

Passo 1: Instalar Claude Code

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

Passo 2: Obter Créditos Gratuitos da Anthropic

Inscreva-se no AI Perks e candidate-se a programas de crédito. A maioria das decisões chega em uma semana.

Passo 3: Gerar uma Chave de API

Faça login em console.anthropic.com e crie uma chave de API em Settings > API Keys.

Passo 4: Configurar Claude Code

export ANTHROPIC_API_KEY="sk-ant-..."

Adicione ao seu arquivo de configuração do shell para torná-lo persistente.

Passo 5: Começar a Codificar

claude

Cada prompt agora usa seu saldo de crédito gratuito. Nenhuma assinatura é necessária.

Perguntas Frequentes

Quanto tempo leva para instalar o Claude Code?

A instalação leva de 30 a 60 segundos via npm, assumindo que o Node.js 18+ já está instalado. Se precisar instalar o Node.js primeiro, adicione 5-10 minutos. Verifique o sucesso com claude --version.

Preciso de uma assinatura paga para instalar o Claude Code?

Não, a instalação é gratuita. Você só precisa de uma assinatura Anthropic paga ou créditos de API para usar o Claude Code. Créditos gratuitos no valor de $1.000-$25.000+ via AI Perks eliminam o custo completamente.

Posso instalar o Claude Code em várias máquinas?

Sim, instale em quantas máquinas desejar. A instalação em si é gratuita. Sua conta Anthropic, chaves de API e créditos são compartilhados entre as máquinas - o uso de qualquer máquina conta para o mesmo saldo.

Como instalo o Claude Code em um servidor (CI/CD)?

Use o mesmo comando npm install, em seguida, configure via variável de ambiente (ANTHROPIC_API_KEY). Para CI/CD, armazene a chave de API como um segredo e injete-a durante a execução do pipeline. Créditos gratuitos via AI Perks financiam o uso de CI/CD a $0.

Posso instalar o Claude Code sem Node.js?

Não, o Claude Code requer Node.js 18+ para rodar. Não existem binários independentes distribuídos oficialmente pela Anthropic. Use o nvm ou o gerenciador de pacotes do seu SO para instalar o Node.js, se necessário.

Como instalo uma versão específica do Claude Code?

Instale com o flag de versão: npm install -g @anthropic-ai/claude-code@1.2.0 (substitua pela versão desejada). Veja as versões disponíveis no changelog do GitHub.

O que acontece depois de instalar o Claude Code?

Execute claude --version para verificar, depois claude auth login (ou defina ANTHROPIC_API_KEY). Inicie com claude de qualquer pasta de projeto. O Claude pode ler seu código, sugerir alterações e executar tarefas. Com créditos gratuitos via AI Perks, o uso ilimitado custa $0.

Instalar Claude Code + Obter Créditos Gratuitos da Anthropic

Instalar o Claude Code leva 30 segundos. Alimentá-lo gratuitamente requer uma assinatura do AI Perks:

• $1.000-$25.000+ em créditos gratuitos da Anthropic
• Estratégias de empilhamento para mais de $50.000 em tempo de execução
• Mais de 200 vantagens adicionais para startups além dos créditos de IA
• Guias atualizados para cada versão do Claude Code

Assine em getaiperks.com →

Instale o Claude Code em 30 segundos. Alimente-o gratuitamente em getaiperks.com.