OpenCode + OpenRouter: tu agente de codificacion multimodelo en local

Usas Claude Code todos los días pero pagas suscripción y solo tienes un modelo. Puedes tener decenas de modelos, pagar solo por lo que usas, y todo corriendo desde la terminal.

Qué vas a aprender

• Qué es OpenCode, cómo instalarlo y por qué es el mejor reemplazo open-source de Claude Code
• Cómo conectarlo a OpenRouter para acceder a 400+ modelos sin suscripción fija
• Configuración multi-modelo: usa un modelo barato para tareas simples y uno caro para las complejas, todo desde el mismo proyecto
• El flujo completo: instalar → conectar → elegir modelo → codificar
• Comparativa de costos: OpenCode Go ($10/mes) vs OpenRouter PAYG vs Claude Code ($20/mes)

01 · OpenCode: el Claude Code open-source que corre lo que quieras

OpenCode es un agente de codificación open-source, creado por Anomaly. Tiene más de 160.000 estrellas en GitHub, 900+ contribuidores y lo usan 7,5 millones de desarrolladores al mes.

Funciona en la terminal (TUI), como app de escritorio (beta para Mac, Windows y Linux) y como extensión para VS Code, Cursor, Zed, Windsurf y VSCodium.

Lo clave: no pagas licencia. OpenCode es gratis. Pagas solo por los modelos que usas.

Instalación

# La forma más rápida (macOS/Linux)
curl -fsSL https://opencode.ai/install | bash

# Con npm (funciona en Windows también)
npm install -g opencode-ai

# En macOS con Homebrew
brew install anomalyco/tap/opencode

# En Windows con Scoop
scoop install opencode

# App de escritorio (macOS)
brew install --cask opencode-desktop

Las descargas para Windows y Linux están en opencode.ai/download.

Primeros pasos

cd /ruta/de/tu/proyecto
opencode

Adentro del TUI (terminal user interface):

• Tab → modo plan (piensa antes de actuar)
• Enter → modo ejecución
• /help → todos los comandos
• /init → analiza tu proyecto y genera AGENTS.md con el contexto

02 · OpenRouter: el marketplace de modelos

OpenRouter es una API unificada para más de 400 modelos de 60 proveedores. En vez de tener 10 APIs diferentes (OpenAI, Anthropic, Google, Meta, Mistral...), tenés una sola.

Cuesta cero abrir cuenta: vas a openrouter.ai/keys, generás una API key y tenés crédito gratis para probar (50 requests/día en modelos gratis, sin tarjeta).

Modelos recomendados para codificar

No pagas hasta que usas. Si un mes no codeas, no gastas nada.

El modelo :free en OpenRouter te da acceso gratuito a ciertos modelos con rate limits bajos. Ideal para probar.

03 · OpenCode + OpenRouter: la combinación

OpenCode trae a OpenRouter como proveedor nativo. No necesitas configurar nada raro.

Conexión en un minuto

# 1. Instalá OpenCode
npm install -g opencode-ai

# 2. Andá a tu proyecto
cd mi-proyecto

# 3. Abrí OpenCode
opencode

# 4. Adentro del TUI, conectá OpenRouter
/connect
# Seleccioná "OpenRouter" de la lista de proveedores
# Pegá tu API key de openrouter.ai/keys

# 5. Elegí un modelo
/models
# Seleccioná el que quieras (ej: anthropic/claude-sonnet-4-5)

Ya está. Ahora estás codeando con OpenCode + el modelo que elegiste, pagando solo por uso.

Configuración avanzada (opencode.json)

Si querés más control, creá un opencode.json en la raíz de tu proyecto:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "models": {
        "anthropic/claude-sonnet-4-20250514": {
          "options": {
            "provider": {
              "order": ["anthropic"],
              "allow_fallbacks": false
            }
          }
        }
      }
    }
  }
}

04 · Estrategia multi-modelo: el modelo correcto para cada tarea

Lo interesante de OpenCode + OpenRouter no es tener un modelo, sino poder cambiarlos según lo que estés haciendo.

Dentro de OpenCode podés cambiar de modelo al vuelo con /models. No tenés que cerrar nada.

La cuenta del mes:

• Si usás exclusivamente Claude Sonnet 4.5, Gastás unos $15-30/mes (depende de cuánto codees).
• Si combinás modelos baratos para tareas simples, $10-20/mes.
• Con OpenCode Go ($10/mes) tenés acceso ilimitado a modelos open-source como DeepSeek V4, Qwen, MiMo.

Comparado con Claude Code ($20/mes por un solo modelo), la combinación OpenCode + OpenRouter te da más modelos por menos plata.

05 · OpenCode Go y Zen: las alternativas todo-en-uno

Si no querés gestionar APIs, OpenCode tiene dos opciones propias:

OpenCode Go ($5 el primer mes, $10 después)

• Modelos open-source: DeepSeek V4, Qwen 3.7 Max, Kimi K2.5, MiMo, MiniMax
• Límites generosos, sin sorpresas
• Ideal si codeás seguido y querés un costo fijo

OpenCode Zen (pay-as-you-go)

• Modelos curados y benchmarkeados específicamente para coding agents
• Cargás $20 y se auto-repone cuando llega a $5
• Los modelos corren en servidores US, zero-retention

Las dos funcionan con OpenCode sin configurar nada extra.

06 · Proyecto real: el setup que uso

# Instalación limpia
npm install -g opencode-ai

# Crear proyecto
mkdir mi-api && cd mi-api
opencode

Dentro de OpenCode:

1. /connect → OpenRouter → pegar API key
2. /models → seleccionar gpt-4o-mini (para empezar, es barato)
3. /init → que analice el proyecto

Cuando necesito algo complejo, cambio a claude-sonnet-4-5 con /models. Después vuelvo a gpt-4o-mini. Todo desde la misma sesión.

07 · Reglas para no fracasar

1. No uses el mismo modelo para todo. GPT-4o-mini para boilerplate, Sonnet para debugging. Si usas el modelo caro para todo, la cuenta se dispara sin necesidad.

2. OpenRouter tiene modelos :free. Usalos para probar, pero no para sesiones largas (rate limits muy bajos).

3. Guardá la API key en un lugar seguro. OpenRouter te da una key que usás para todos los modelos. No la subas a GitHub.

4. OpenCode guarda credenciales en ~/.local/share/opencode/auth.json. Si cambias de máquina, migrá ese archivo o volvé a conectar.

5. Configurá opencode.json por proyecto. Cada proyecto puede tener su modelo preferido y sus propias reglas de proveedor.

6. Los modelos :nitro en OpenRouter tienen el throughput más rápido. Usalos cuando estés iterando rápido. Los :exacto priorizan calidad de tool-calling.

Guías relacionadas

• Guía completa para usar Claude Code
• Templates de diseño UI para agentes IA con styles.refero.design
• Marketing Skills para Claude Code