Qwen Code: Alternativa Gratuita

# Instalação do Qwen Code

## Passo 1: Instalação via NPM
npm install -g qwen-code

# ou via Yarn
yarn global add qwen-code

# Verificar instalação
qwen-code --version

## Passo 2: Primeira Execução
qwen-code

# Tela de boas-vindas aparecerá
# Semelhante ao Claude Code

## Passo 3: Login Gratuito
# Escolha "OAuth with Qwen" na tela de login
# Será redirecionado para browser
# Faça login com Google/GitHub
# Volta automaticamente para terminal

## Passo 4: Verificação das 2000 Requests
# Após login, você terá:
# ✅ 2000 requests gratuitos por dia
# ✅ Acesso ao modelo Qwen Coder 3  
# ✅ Interface igual ao Claude Code

echo "✅ Qwen Code instalado com sucesso!"
echo "🎉 2000 requests gratuitos por dia ativados"
echo "🚀 Pronto para desenvolver com IA"

# Performance Comparison - Arena LM Scores

## Code Generation Quality
Qwen Coder 3:     ████████████████████ 85.2%
Claude Sonnet 4:  ████████████████████ 87.1%
GPT-4 Turbo:      ██████████████████   82.3%
GPT-4:           ████████████████     78.9%

## Code Understanding  
Qwen Coder 3:     ███████████████████  83.7%
Claude Sonnet 4:  ████████████████████ 86.4%
GPT-4 Turbo:      ██████████████████   81.2%
GPT-4:           ████████████████     77.5%

## Debugging & Fixes
Qwen Coder 3:     ████████████████████ 86.8%
Claude Sonnet 4:  ████████████████████ 88.2%  
GPT-4 Turbo:      ███████████████████  84.1%
GPT-4:           █████████████████    79.6%

## Conclusão
✅ Qwen Coder 3 está apenas 2-3% atrás do Claude Sonnet 4
✅ Supera GPT-4 e GPT-4 Turbo em código
✅ Excelente para uso profissional
✅ 100% gratuito com 2000 requests/dia

# Instalação do Claude Code Router

## Passo 1: Instalar Router
npm install -g claude-code-router

## Passo 2: Configuração Manual (Arquivo JSON)
# Crie arquivo: ~/.claude-code-router/config.json
{
  "providers": [
    {
      "name": "qwen-free",
      "type": "openai-compatible", 
      "baseURL": "https://api.qwen.ai/v1",
      "apiKey": "sua-chave-qwen-gratuita",
      "models": ["qwen-coder-3"],
      "dailyLimit": 2000
    },
    {
      "name": "openrouter-free",
      "type": "openrouter",
      "baseURL": "https://openrouter.ai/api/v1", 
      "apiKey": "sua-chave-openrouter",
      "models": ["quentral/qwen-coder-3"],
      "dailyLimit": 1000
    }
  ]
}

## Passo 3: Configuração Visual (UI Mode)
claude-code-router --ui

# Abre painel web para configuração
# Mais fácil que editar JSON manualmente
# Interface intuitiva para adicionar providers

## Passo 4: Iniciar com Router
ccr-code  # ao invés de claude-code

# Agora Claude Code usará seus providers gratuitos!

# Setup OpenRouter Gratuito

## Passo 1: Criar Conta
1. Acesse openrouter.ai
2. Sign up com Google/GitHub
3. Confirme email
4. Acesse dashboard

## Passo 2: Gerar API Key
1. Settings > API Keys
2. Create New Key
3. Nome: "Claude Code Router"
4. Copie a chave (or-v1-xxx...)

## Passo 3: Configurar no Router
{
  "name": "openrouter-free",
  "type": "openrouter", 
  "baseURL": "https://openrouter.ai/api/v1",
  "apiKey": "or-v1-sua-chave-aqui",
  "models": [
    "quentral/qwen-coder-3",        // Gratuito
    "microsoft/wizardlm-2-8x22b",  // Gratuito  
    "google/gemma-2-9b-it",        // Gratuito
    "meta-llama/llama-3-8b-instruct" // Gratuito
  ],
  "dailyLimit": 1000,
  "freeModelsOnly": true
}

## Passo 4: Estratégia de Uso
# Use Qwen para tarefas complexas (2000/dia)
# Use OpenRouter para tarefas simples (1000/dia) 
# Total: 3000 requests gratuitos por dia!

## Modelos Gratuitos Disponíveis
✅ Qwen Coder 3 (excellent for code)
✅ WizardLM 2 (good for explanations)
✅ Gemma 2 9B (fast responses)
✅ Llama 3 8B (general purpose)

# Estratégia de Uso Inteligente

## Distribuição por Tipo de Tarefa

### Qwen Code (2000 requests/dia) - PREMIUM TASKS
🎯 Code generation complexo
🐛 Debugging e fixes críticos  
🔄 Refactoring de arquitetura
📚 Code reviews detalhados
🧪 Geração de testes unitários

### OpenRouter (1000 requests/dia) - SUPPORT TASKS  
💬 Explicações de código
📝 Documentação e comentários
🤔 Brainstorming de soluções
🔍 Análises simples
❓ Perguntas conceituais

## Horários Estratégicos

### Manhã (9h-12h): Qwen Code
- Foco em desenvolvimento pesado
- Geração de componentes principais
- Implementação de features críticas

### Tarde (14h-18h): Mix Qwen + OpenRouter  
- Code generation (Qwen)
- Documentação (OpenRouter)
- Reviews e ajustes (Qwen)

### Noite (19h-22h): OpenRouter
- Estudos e experimentos
- Leitura de código existente
- Planejamento do próximo dia

## Script de Monitoramento
#!/bin/bash
# check-usage.sh

echo "📊 Status dos Requests Gratuitos"
echo "================================"

# Qwen Usage
quen_used=$(qwen-code --usage | grep "today" | cut -d: -f2)
quen_remaining=$((2000 - $quen_used))

# OpenRouter Usage  
or_used=$(curl -s "https://openrouter.ai/api/v1/usage"   -H "Authorization: Bearer $OR_API_KEY" | jq '.daily_used')
or_remaining=$((1000 - $or_used))

echo "🤖 Qwen Code: $quen_used/2000 ($quen_remaining restantes)"
echo "🌐 OpenRouter: $or_used/1000 ($or_remaining restantes)"
echo "💡 Total disponível: $((quen_remaining + or_remaining)) requests"

if [ $quen_remaining -lt 100 ] && [ $or_remaining -gt 200 ]; then
  echo "⚠️  Switch para OpenRouter recomendado"
elif [ $or_remaining -lt 50 ] && [ $quen_remaining -gt 200 ]; then  
  echo "⚠️  Switch para Qwen Code recomendado"
fi

# Quando Usar Cada Abordagem

## ✅ Qwen Code é PERFEITO para:
- 👨‍🎓 Estudantes e iniciantes
- 💼 Freelancers com projetos pequenos/médios  
- 🧪 Experimentação e learning
- 🏠 Projetos pessoais e side projects
- 💰 Desenvolvedores com orçamento limitado
- 🚀 Startups em fase de validação

## ⚠️ Claude Code Pago vale a pena para:
- 🏢 Empresas com desenvolvimento intensivo
- 👥 Times grandes com uso 24/7
- 🔧 Projetos que precisam de features específicas
- 💰 Quem pode pagar $100/mês sem problemas
- 🎯 Desenvolvimento mission-critical

## 🎯 Estratégia Híbrida (Recomendada):
1. Comece com Qwen Code gratuito
2. Aprenda e domine o workflow  
3. Se atingir limites consistentemente
4. Considere upgrade para versão paga
5. Mantenha gratuito para projetos menores