Passo 1: Instalar o Node.js
Método 1: instalar com Homebrew (recomendado)
bash
brew install nodeSe o Homebrew ainda não estiver instalado, instale-o primeiro:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Método 2: baixar do site oficial
- Acesse https://nodejs.org
- Baixe e instale o arquivo .pkg da versão LTS
TIP
Verifique a instalação
bash
node --version
npm --versionPasso 2: Instalar o Claude Code
bash
npm install -g @anthropic-ai/claude-codeTIP
Verifique a instalação do Claude Code
bash
claude --versionPasso 3: Configurar as variáveis de ambiente
Descubra qual é o seu shell
bash
echo $SHELLO macOS Catalina e versões posteriores usam zsh por padrão.
Método 1: temporário (sessão atual)
bash
export ANTHROPIC_BASE_URL="https://api.bsf.ai"
export ANTHROPIC_AUTH_TOKEN="your_api_key"Método 2: permanente no zsh (recomendado)
bash
echo '' >> ~/.zshrc
echo '# API config' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.zshrc
source ~/.zshrcMétodo 3: permanente no bash
bash
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.bash_profile
source ~/.bash_profileMétodo 4: arquivo de configuração (recomendado)
Edite o arquivo de configuração vim ~/.claude/settings.json
json{ "env": { "ANTHROPIC_AUTH_TOKEN": "Replace with your API Key", "ANTHROPIC_BASE_URL": "https://api.bsf.ai", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 }, "permissions": { "allow": [], "deny": [] } }
TIP
Verifique as variáveis de ambiente
bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKENPasso 4: Comece a usar
Inicie o Claude Code
bash
claudeUse em um projeto específico
bash
cd ~/Projects/my-project
claudePerguntas frequentes
Problema: a segurança do sistema bloqueia a execução
- Abra Preferências do Sistema > Privacidade e Segurança
- Localize o aplicativo bloqueado e clique em Abrir Assim Mesmo
Problema: erro de permissão do npm (EACCES)
Ao encontrar erros EACCES, corrija as permissões do npm:
bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code