Passo 1: Instalar o Node.js

Método 1: instalar com nvm (recomendado)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts

Método 2: Debian/Ubuntu

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

NOTE

Observações para usuários do WSL

• Certifique-se de que o WSL2 está instalado (recomendamos a distribuição Ubuntu)
• Recomendamos instalar via nvm para evitar problemas de permissão

TIP

Verifique a instalação

node --version
npm --version

Passo 2: Instalar o Claude Code

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

TIP

Verifique a instalação do Claude Code

claude --version

Passo 3: Configurar as variáveis de ambiente

Método 1: temporário (sessão atual)

export ANTHROPIC_BASE_URL="https://api.bsf.ai"
export ANTHROPIC_AUTH_TOKEN="your_api_key"

Método 2: permanente no bash (recomendado)

echo '' >> ~/.bashrc
echo '# API config' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.bashrc
source ~/.bashrc

Método 3: permanente no zsh

echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.zshrc
source ~/.zshrc

TIP

Verifique as variáveis de ambiente

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Passo 4: Comece a usar

claude

Perguntas frequentes

Problema: erro de permissão do npm (EACCES)

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Problema: acessar arquivos do Windows no WSL

# Windows filesystem is mounted at /mnt/
cd /mnt/c/Users/YourName/

# Working in WSL native filesystem is recommended
cd ~