Guia de Instalação e Uso do Claude Code - Configuração do Assistente de Programação com IA

Claude Code é um poderoso assistente de programação com IA que permite colaborar com a IA diretamente no seu terminal. Este guia irá acompanhá-lo pelo processo de instalação e configuração.

Requisitos do Sistema#

Antes de instalar o Claude Code, certifique-se de que o seu sistema atende a estes requisitos:

• Node.js: Versão 18.0 ou superior
• Sistema Operacional: macOS, Linux ou Windows (WSL recomendado)

Início Rápido#

Passo 1: Instale o Node.js#

Se você já tiver o Node.js 18.0 ou superior instalado, pode pular este passo.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

Passo 2: Instale o Claude Code#

Instale o Claude Code globalmente usando npm:

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

# Verify installation
claude --version

Passo 3: Configure o Acesso à API#

Você precisa de dois itens de configuração para usar o Claude Code com a Crazyrouter API:

Configurações recomendadas para o token:

• Nome: Qualquer nome descritivo
• Cota: Defina como ilimitada para desenvolvimento
• Grupo: Selecione "Claude Code" ou "Official Claude 3+"
• Outras opções: Mantenha as configurações padrão

Passo 4: Inicie o Claude Code#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Passo 5: Configuração na Primeira Execução#

Após iniciar o Claude Code pela primeira vez, você verá estas etapas de configuração:

1. Select Theme - Escolha o seu tema de cores preferido e pressione Enter
2. Safety Notice - Revise e confirme o aviso de segurança
3. Terminal Configuration - Use a configuração padrão ou personalize
4. Working Directory Trust - Confie no diretório atual para permitir acesso a arquivos

Parabéns! Agora você está pronto para começar a programar com o seu parceiro de programação com IA.

Configuração Permanente (Opcional)#

Para evitar definir as variáveis de ambiente sempre, adicione-as ao seu perfil de shell:

Bash (~/.bashrc ou ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Após adicionar, recarregue seu shell:

source ~/.bashrc  # or source ~/.zshrc

Perguntas Frequentes#

Erro "Invalid API Key"#

Se você vir "Invalid API Key - Please run /login", verifique:

• Se ANTHROPIC_AUTH_TOKEN está definido corretamente (começa com sk-)
• Se ANTHROPIC_BASE_URL está definido como https://crazyrouter.com/
• Reinicie o seu terminal após definir as variáveis de ambiente

Status "Offline"#

O Claude Code verifica o status da rede conectando-se ao Google. Exibir "offline" não afeta o uso normal - isso apenas indica incapacidade de se conectar aos servidores do Google.

Falhas em Web Fetch#

O Claude Code realiza verificações de segurança antes de acessar páginas web. Certifique-se de:

• Ter uma conexão de internet estável
• Usar um proxy global se necessário

Erros Persistentes de "Fetch Failed"#

Isso pode ser causado por problemas de rede. Tente:

1. Sair do Claude Code (Ctrl+C)
2. Executar novamente o comando claude
3. Se o problema persistir, tente novamente mais tarde

Erros de API#

Se você encontrar erros de API:

• Saia do Claude Code (Ctrl+C)
• Aguarde um momento e reinicie
• Verifique a cota do seu token no painel

Observações Importantes#

• A Crazyrouter fornece encaminhamento direto para os serviços oficiais do Claude Code
• Mantenha seu token de API seguro e nunca o compartilhe publicamente
• Monitore seu uso no painel para evitar cobranças inesperadas

Preços#

O Claude Code usa modelos Claude com a seguinte tabela de preços na Crazyrouter:

Todos os preços incluem um desconto de 45% em comparação com as tarifas oficiais.

Recursos Relacionados#

• Crazyrouter Pricing Page
• Claude Code Official Documentation
• Node.js Official Website

Precisa de ajuda? Entre em contato com o suporte ou consulte a documentação da Crazyrouter para mais informações.