OpenRouter + Zed: accede a Claude, DeepSeek, Mistral y más con una sola API key

Guía práctica para usar OpenRouter en Zed: qué es, cómo configurarlo, qué modelos usar (Claude, DeepSeek, HY3, Mistral OCR), precios reales y cómo sacarle partido al panel de agentes y los threads.

¿Qué es OpenRouter?

Si alguna vez has querido probar varios modelos de IA sin tener que crear una cuenta en cada proveedor, gestionar múltiples API keys y reescribir tu código para cada uno, OpenRouter es la respuesta.

OpenRouter es una puerta de entrada unificada a más de 315 modelos de lenguaje. Un solo API key, una sola URL base, y puedes hablar con Claude, DeepSeek, Mistral, Llama, Qwen y muchos más. La API es compatible con el formato de OpenAI, lo que significa que cualquier herramienta que ya uses con GPT funciona también con OpenRouter cambiando la URL base a https://openrouter.ai/api/v1.

Modelos destacados

OpenRouter agrupa los modelos por familia. Aquí tienes los más relevantes para el trabajo diario:

Claude (Anthropic)

Los modelos de Anthropic son de los más potentes para razonamiento, código y tareas largas. Disponibles en OpenRouter en tres niveles:

• Claude Sonnet 4.6 — el equilibrio perfecto entre velocidad y calidad. Ideal para el día a día.
• Claude Opus 4.6 — el más potente de la familia. Para tareas complejas que requieren razonamiento profundo.
• Claude Haiku 4.5 — el más rápido y barato. Perfecto para clasificaciones, resúmenes cortos y tareas simples.

DeepSeek

El gran sorprendente de los últimos meses. Modelos chinos de código abierto con una relación calidad-precio difícil de batir:

• DeepSeek V4 Flash — 284B parámetros totales, 13B activos. Contexto de 1M tokens. Es gratuito con límites de tasa, y de pago a $0.10/$0.20 por millón de tokens (entrada/salida). Excelente para código y razonamiento rápido.
• DeepSeek V3.2 — la variante de producción. A $0.14/$0.28 por millón de tokens.
• DeepSeek V3.2 Speciale — variante de alto cómputo optimizada para razonamiento y tareas agénticas.

DeepSeek soporta niveles de razonamiento high y xhigh, siendo este último el máximo disponible.

Hunyuan HY3 (Tencent)

El modelo de Tencent disponible como preview en OpenRouter. Destaca por su precio muy competitivo, alrededor de $0.066 por millón de tokens de entrada. Buena opción para tareas de alto volumen donde el coste es crítico.

Mistral OCR

Mistral es una empresa francesa con modelos de calidad y precios razonables. Para tareas de documento y visión, su modelo estrella es:

• Mistral OCR 3 — especializado en extracción de texto de documentos, PDFs e imágenes escaneadas. Se factura a $16 por millón de caracteres procesados. Si necesitas digitalizar documentos, es una de las mejores opciones disponibles.
• Mistral Small 4 — modelo de propósito general que combina razonamiento (Magistral), comprensión multimodal (Pixtral) y capacidades de agente (Devstral). Contexto de 262K tokens a $0.15/$0.60 por millón.
• Mistral Medium 3.5 — el modelo flagship más reciente. 128B parámetros, licencia MIT modificada. A $1.50/$7.50 por millón de tokens.

Precios: ¿cuánto cuesta?

OpenRouter usa precios de paso directo: paga la tarifa del proveedor más un pequeño margen de plataforma (generalmente un 5%).

Nivel gratuito

OpenRouter ofrece un nivel gratuito con más de 25 modelos (identificados con el sufijo :free). Los límites son:

• 20 solicitudes por minuto
• 50 solicitudes por día (si no has añadido créditos)
• 1.000 solicitudes por día (si tienes $10 o más en créditos)

Algunos modelos gratuitos destacados: DeepSeek V4 Flash :free, Llama 3.3 70B :free, Gemma 3 :free.

Cómo y cuánto pagar

1. Crea una cuenta en openrouter.ai
2. Ve a Settings → Credits
3. Añade créditos con tarjeta de crédito o criptomonedas — no hay mínimo obligatorio (aunque con $5 ya tienes créditos para arrancar)
4. Ve a Keys y genera tu API key
5. Monitoriza el gasto en el dashboard: puedes ver el uso por modelo y por API key en tiempo real

Un uso moderado (código, chat, algunas tareas largas) con modelos medianos como DeepSeek V3.2 o Mistral Small 4 te saldrá por céntimos al mes. Si usas Claude Opus intensivamente, los costes suben más rápido — en ese caso, considera acceder directamente a la API de Anthropic para evitar el margen de OpenRouter.

Zed: el editor que integra IA de verdad

Zed es un editor de código escrito en Rust, nativo, acelerado por GPU y de código abierto. No tiene capa Electron, lo que lo hace extremadamente rápido. Y tiene soporte de IA en todos los niveles: autocompletado, transformaciones inline, y un panel de agente completo.

Lo importante: Zed soporta OpenRouter como proveedor oficial. Puedes usar cualquier modelo de OpenRouter directamente desde el editor.

Cómo añadir OpenRouter a Zed

Paso 1: obtén tu API key

Entra en openrouter.ai/keys y crea una nueva API key.

Paso 2: añádela a Zed

Abre el panel de comandos con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Linux/Windows) y escribe "zed: open settings". Esto abre tu ~/.config/zed/settings.json.

Añade la sección de OpenRouter:

{
  "language_models": {
    "openrouter": {
      "api_key": "sk-or-v1-TUKEY"
    }
  },
  "agent": {
    "default_model": {
      "provider": "openrouter",
      "model": "anthropic/claude-sonnet-4-6"
    }
  }
}

Alternativamente, puedes definir la variable de entorno OPENROUTER_API_KEY en tu shell (.zshrc, .bashrc, etc.) y Zed la detectará automáticamente.

Paso 3: selecciona el modelo

En el selector de modelos del panel de agente (parte inferior del panel), aparecerán todos los modelos de OpenRouter. Puedes cambiar entre ellos por tarea.

Si prefieres que OpenRouter elija automáticamente el mejor modelo disponible, usa openrouter/auto como modelo.

Añadir modelos personalizados

Puedes configurar modelos específicos con opciones avanzadas de enrutamiento:

{
  "language_models": {
    "openrouter": {
      "api_key": "sk-or-v1-TUKEY",
      "available_models": [
        {
          "provider": "openrouter",
          "name": "deepseek/deepseek-v4-flash",
          "display_name": "DeepSeek V4 Flash",
          "max_tokens": 131072
        },
        {
          "provider": "openrouter",
          "name": "mistralai/mistral-small-4",
          "display_name": "Mistral Small 4",
          "max_tokens": 32768
        }
      ]
    }
  }
}

El panel de agentes

El Agent Panel es la pieza central de la IA en Zed. Se abre con el icono ✨ de la barra de estado, o desde el Command Palette con agent: new thread.

Desde aquí puedes:

• Escribir prompts en lenguaje natural y el agente leerá, editará y ejecutará código en tu proyecto
• Añadir contexto con @ — menciona ficheros, directorios, símbolos o threads anteriores
• Ver en tiempo real qué herramientas está usando el modelo (lectura de ficheros, búsquedas, ejecución de comandos)
• Revisar y aprobar los cambios antes de aplicarlos
• Extender el agente con servidores MCP para conectarlo a servicios externos

El mismo modelo puede estar disponible a través de varios proveedores. Por ejemplo, Claude Sonnet 4.6 aparece como opción tanto desde Zed Pro, como desde OpenRouter, como directamente de Anthropic — el logo a la izquierda del nombre indica cuál estás usando.

La barra lateral de Threads

El aspecto más potente de Zed para trabajo en IA pesada es la posibilidad de ejecutar múltiples agentes en paralelo.

Abre la barra lateral de threads con Cmd+Alt+J (macOS) o Ctrl+Alt+J (Linux/Windows). Verás todos tus threads agrupados por proyecto.

Cada thread es independiente: tiene su propio agente, su propia ventana de contexto y su propio historial de conversación. Puedes tener, por ejemplo:

• Un thread con Claude Opus trabajando en refactorizar un módulo complejo
• Un thread con DeepSeek V4 Flash (gratuito) ejecutando tests y analizando resultados
• Un thread con Mistral Small 4 respondiendo dudas rápidas sobre la documentación

Para cambiar entre threads sin abrir la barra lateral, usa Ctrl+Tab.

Los threads que ya no necesites se pueden archivar pasando el cursor por encima y haciendo clic en el icono de archivo, o seleccionándolos y pulsando Shift+Backspace. El historial completo se conserva y puedes restaurar cualquier thread en cualquier momento.

Si dos threads van a editar los mismos ficheros y quieres evitar conflictos, puedes aislar uno en un nuevo Git worktree directamente desde la interfaz.

Chatear con modelos en Zed

Más allá del agente orientado a código, Zed permite chatear con modelos de forma más libre:

• Inline Assistant: selecciona cualquier fragmento de código, pulsa Cmd+Enter (macOS) o Ctrl+Enter (Linux), escribe tu instrucción y el modelo genera los cambios directamente en el buffer. Puedes usar múltiples cursores para enviar el mismo prompt a varias posiciones a la vez.
• Thread como chat: abre un thread nuevo sin contexto de proyecto y úsalo como un chat normal. Funciona perfectamente para preguntas generales, redacción o exploración de ideas.
• Referencias cruzadas: desde el Inline Assistant puedes referenciar un thread existente con @thread para continuar el contexto de una conversación más larga sin repetir el contexto.

Para cambiar el modelo en medio de una conversación, usa el selector de modelos en la parte inferior del panel. El cambio aplica desde el siguiente mensaje.

Consejo final: elige el modelo según la tarea

No hay un modelo universalmente mejor. La estrategia que funciona:

• Tareas de volumen, clasificación, resúmenes cortos → DeepSeek V4 Flash (gratuito o casi)
• Código del día a día, refactors medianos → Claude Sonnet 4.6 o Mistral Small 4
• Razonamiento profundo, arquitectura, decisiones complejas → Claude Opus 4.6 o DeepSeek V3.2 Speciale
• Extracción de documentos PDF o imágenes → Mistral OCR 3
• Alto volumen con presupuesto ajustado → Hunyuan HY3 Preview

OpenRouter te deja cambiar entre todos ellos con un solo cambio en el selector. Empieza con los gratuitos, sube cuando necesites más.