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

Instale o Claude Code em 2 minutos. Configuração para macOS, Linux, Windows. Configure chaves de API, corrija erros comuns e potencialize o Claude Code com créditos gratuitos da Anthropic.

Claude CodeInstall Claude CodeClaude CLIClaude Code SetupAI Perks
Author Avatar
Andrew
AI Perks Team
10,765

Quick Answer

Instale o Claude Code com `npm install -g @anthropic-ai/claude-code@latest`. Requer Node.js 18+. Verifique com `claude --version`. Autentique via `claude auth login` ou defina ANTHROPIC_API_KEY. Potencialize gratuitamente com créditos Anthropic no valor de $1.000-$25.000+ em getaiperks.com.

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.

AI Perks Cards

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.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

Requisitos do Sistema

RequisitoMínimoRecomendado
Node.js18.020+ (LTS)
npm9.010+
SOmacOS 12+, Ubuntu 20.04+, Windows 10+Mais recente
RAM4 GB8 GB+
Espaço em Disco500 MB2 GB+
InternetNecessárioBanda larga estável

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.


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.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

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

Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

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.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

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.

Programa de CréditoCréditos DisponíveisComo Obter
Anthropic Claude (Direto)$1.000 - $25.000Guia AI Perks
AWS Activate (Bedrock - Claude)$1.000 - $100.000Guia AI Perks
Google Cloud Vertex (Claude)$1.000 - $25.000Guia AI Perks
Microsoft Founders Hub$500 - $1.000Guia AI Perks
Programas de VC + Aceleradoras$1.000 - $5.000Guia AI Perks

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.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

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.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

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.

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.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.