GroqCode ⚡

Claude Code exacto, pero con Groq LPU Inference.

Usa Claude Code oficial (con todas sus funciones: MCPs, skills, tools, agent loop, streaming) pero ruteando las llamadas a Groq en lugar de a Anthropic. Sin API key de Anthropic. Sin costes.

Cómo funciona

Claude Code (oficial) ──→ Proxy GroqCode ──→ Groq API (Kimi K2 / Llama 3.3)
      ↑                       ↑
  Todas las features     Traduce Anthropic
  MCPs, skills, tools     Messages API →
  bash, files, search     OpenAI format

El proxy traduce las llamadas de la API Anthropic Messages a formato OpenAI compatible con Groq. Claude Code no sabe que no está hablando con Anthropic.

Funciones que mantiene

Feature	Status
File Read/Write/Edit	✅
Bash/PowerShell execution	✅
Glob/Grep search	✅
MCP servers (stdio, SSE)	✅
Skills system	✅
Agent/Architect tools	✅
Memory (read/write)	✅
Streaming responses	✅
Tool calling (function calling)	✅
Slash commands (/help, /compact, etc.)	✅
CLAUDE.md project context	✅
Web search	⚠️ Depende del modelo
Thinking/Extended thinking	❌ No soportado por Groq

Setup rápido — Windows (PowerShell)

# 1. Clona el repo
git clone https://github.com/mounirbella32/groqcode.git
cd groqcode

# 2. Configura tu API key de Groq
$env:GROQ_API_KEY = "gsk_tu_api_key_aqui"

# 3. Ejecuta el setup automático
.\scripts\setup.ps1

# 4. O hazlo manual:
#    Terminal 1 — Proxy:
$env:GROQ_API_KEY = "gsk_tu_api_key_aqui"
python proxy\server.py

#    Terminal 2 — Claude Code:
$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8082"
$env:ANTHROPIC_API_KEY = "not-needed"
claude

Setup rápido — Linux/macOS

# 1. Clona el repo
git clone https://github.com/mounirbella32/groqcode.git
cd groqcode

# 2. Configura tu API key de Groq
export GROQ_API_KEY="gsk_tu_api_key_aqui"

# 3. Ejecuta el setup automático
chmod +x scripts/setup.sh
./scripts/setup.sh

# 4. Usa:
groqcode

Modelos

Modelo Groq	Uso	Claude Code lo ve como
moonshotai/kimi-k2-instruct-0905	Modelo principal (default)	claude-sonnet-4, opus
llama-3.3-70b-versatile	Modelo rápido	claude-haiku
qwen/qwen3-32b	Alternativa reasoning	—
compound-beta	Compound AI system	—

Cambiar modelos

Variables de entorno:

export LARGE_MODEL="moonshotai/kimi-k2-instruct-0905"  # Para tareas complejas
export SMALL_MODEL="llama-3.3-70b-versatile"            # Para tareas rápidas

Configurar MCPs

Funciona exactamente como en Claude Code. Crea .claude/settings.json en tu proyecto:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    }
  }
}

Configurar Skills

Igual que Claude Code:

tu-proyecto/
  .claude/
    skills/
      mi-skill/
        SKILL.md

Arquitectura del proxy

proxy/
  server.py          # Servidor HTTP que traduce Anthropic → OpenAI/Groq
                     # - Convierte system prompts
                     # - Mapea tool_use ↔ function_calling
                     # - Streaming SSE bidireccional
                     # - Rate limit retry con backoff
                     # - Model aliasing automático
                     # - Strip de campos no soportados (thinking, etc.)
scripts/
  setup.ps1          # Setup automático Windows
  setup.sh           # Setup automático Linux/macOS
  start-proxy.bat    # Launcher del proxy Windows

Troubleshooting

Rate limits (429)

El proxy reintenta automáticamente con backoff exponencial. Si persiste, espera 30s.

"Model not found"

Verifica que el modelo existe en Groq: https://console.groq.com/docs/models

Tool calling no funciona

Algunos modelos pequeños no soportan bien tool calling. Usa Kimi K2 o Llama 3.3 70B.

El proxy no arranca

# Verifica que Python funciona
python3 -c "import json, http.server; print('OK')"

# Verifica que el puerto está libre
# Linux: lsof -i :8082
# Windows: netstat -an | findstr 8082

Obtener API key de Groq

1. Ve a https://console.groq.com/keys
2. Crea una cuenta (gratis)
3. Genera una API key
4. Los modelos open source son gratuitos con rate limits

Licencia

MIT

Créditos

• Claude Code por Anthropic — el mejor agente de coding
• Groq — LPU inference engine ultrarrápido
• Basado en la arquitectura expuesta del source map leak (v2.1.88)