🐧 Instalando no Linux

O Claude Code funciona em qualquer distribuição Linux que tenha suporte ao Node.js 18+. O método de instalação do Node.js varia por distro, mas o nvm funciona universalmente em todas elas.

O nvm é instalado via script curl e adiciona automaticamente as configurações no .bashrc ou .zshrc. Depois de instalar o nvm, instalar o Node.js é um único comando.

# Instalar nvm via curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Aplicar as configurações no shell atual
source ~/.bashrc
# OU se usar zsh:
source ~/.zshrc

# Instalar versão LTS mais recente
nvm install --lts

# Definir como padrão
nvm use --lts
nvm alias default 'lts/*'

# Verificar instalação
node -v    # Esperado: v20.x.x ou superior
npm -v     # Esperado: 10.x.x

# Adicionar repositório NodeSource (Node.js 20)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Instalar
sudo apt-get install -y nodejs

# Verificar
node -v

Com Node.js e npm instalados via nvm, a instalação do Claude Code não precisa de sudo. O npm instala o pacote no diretório do nvm do usuário, evitando problemas de permissão.

# Instalar Claude Code globalmente (sem sudo com nvm!)
npm install -g @anthropic-ai/claude-code

# Verificar onde foi instalado
which claude
# Esperado: /home/usuario/.nvm/versions/node/v20.x.x/bin/claude

# Verificar versão
claude --version

Para que o Claude Code funcione a cada sessão sem precisar reconfigurar, adicione as variáveis de ambiente com export no arquivo de inicialização do seu shell.

# Abrir o arquivo para edição
nano ~/.bashrc
# OU para zsh:
nano ~/.zshrc

# Adicionar ao FINAL do arquivo:

# === Claude Code ===
# Para OpenRouter (use modelos alternativos):
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="sk-or-v1-SUA-CHAVE-OPENROUTER"

# OU para Anthropic direta:
export ANTHROPIC_AUTH_TOKEN="sk-ant-api03-SUA-CHAVE"

# Salvar: Ctrl+O, Enter, Ctrl+X (no nano)

# Aplicar imediatamente sem reiniciar:
source ~/.bashrc

# Verificar se as variáveis estão configuradas
echo $ANTHROPIC_AUTH_TOKEN
# Deve mostrar sua chave

echo $ANTHROPIC_BASE_URL
# Deve mostrar a URL da API (se configurada)

# Listar todas variáveis com ANTHROPIC:
env | grep ANTHROPIC

No Linux desktop, o Claude Code pode abrir o browser para autenticação OAuth. Em servidores sem GUI, a autenticação é feita exclusivamente via variável de ambiente.

# Execute claude sem variáveis
# para login via browser:
claude

# O Xdg-open abrirá o browser
# padrão (Firefox, Chrome, etc.)
# Faça login no Anthropic Console

# Configure a API key no .bashrc
export ANTHROPIC_AUTH_TOKEN="sk-ant-..."

# Aplique:
source ~/.bashrc

# Teste:
claude -p "Teste de conexão"

Problemas comuns de instalação no Linux têm soluções simples. Manter o Claude Code atualizado é importante para ter acesso a recursos novos e correções de bugs.

# Verificar versão atual
claude --version

# Atualizar para versão mais recente
npm update -g @anthropic-ai/claude-code

# Ou reinstalar completamente
npm install -g @anthropic-ai/claude-code@latest

# nvm pode não estar carregado
source ~/.bashrc
# ou reabrir o terminal

# Verifique se Node.js é do nvm:
which node
# Deve ser: /home/user/.nvm/...
# Se for /usr/bin/node, reinstale com nvm

# Verificar variável configurada:
echo $ANTHROPIC_AUTH_TOKEN
# Deve mostrar a chave (não vazio)