Inicio › Claude Code › OpenRouter
Descripción generalInstalaciónreferencia de la CLIPrecios y límitesAgent SDKHabilidades y pluginsGitHubWeb, escritorio e IDEModelosErrores¿Código abierto?TutorialPara estudiantesAutomatización de QAComparación con CursorComparación con Codex y OpenCodeSubagentesHooksMCPEcosistemaVS CodeOpenRouterLímites de solicitudesGuía en chino
Última actualización: 11 de octubre de 2026

Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)

La gente conecta Claude Code a OpenRouter por dos motivos distintos: pagar por Claude a través de una cuenta que ya tiene o ejecutar modelos de otros proveedores dentro de Claude Code. Ambas opciones funcionan, con algunas salvedades que conviene conocer antes de dedicarles una tarde.

TLDR

  • Vía 1: el endpoint de OpenRouter compatible con Anthropic mediante ANTHROPIC_BASE_URL + tu clave de OpenRouter: solo modelos de Claude, al precio de tarifa más la comisión de OpenRouter.
  • Vía 2: claude-code-router delante de Claude Code: cualquier modelo de OpenRouter por tarea, a cambio de usar un proxy local y lidiar con peculiaridades ocasionales en las llamadas a herramientas.
  • Los modelos distintos de Claude manejan de forma desigual el esquema de herramientas de Claude Code; cabe esperar más reintentos.
  • Si solo quieres Claude, una pasarela de Claude es más económica que OpenRouter: los mismos modelos a 7.69231× su valor nominal en lugar del precio de tarifa más una comisión.

Vía 1: conecta Claude Code directamente a OpenRouter

OpenRouter ofrece un endpoint de Messages compatible con Anthropic junto con su API de estilo OpenAI. Claude Code solo necesita la URL base y una clave, por lo que la configuración utiliza las mismas dos variables que usarías con cualquier pasarela; consulta la documentación de OpenRouter para conocer la ruta base actual si la que aparece abajo ha cambiado:

export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-...     # your OpenRouter key
claude --model anthropic/claude-sonnet-5   # OpenRouter's model id format

Los identificadores de modelo siguen la nomenclatura de OpenRouter vendor/model , que también se usa en las variables de cada nivel (ANTHROPIC_DEFAULT_SONNET_MODEL y otras similares). Ejecuta /status para confirmar el endpoint y /model para cambiar. La facturación es la de OpenRouter: el precio de tarifa del modelo más la comisión de plataforma de OpenRouter sobre los créditos, por lo que esta vía cuesta un poco *más* que usar Anthropic directamente; su ventaja es la comodidad y tener una sola cuenta, no el precio.

Vía 2: claude-code-router para modelos distintos de Claude

claude-code-router es un proxy local que recibe las solicitudes de Claude Code y reenvía cada una a un proveedor que eliges mediante reglas: predeterminado, segundo plano, razonamiento, contexto largo. Configura OpenRouter como proveedor con tu clave, elige los modelos para cada ruta e inicia con ccr code. Así es como se ejecutan modelos de pesos abiertos o de otros proveedores dentro de Claude Code.

// ~/.claude-code-router/config.json (excerpt)
{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
  }],
  "Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}

Qué falla: el bucle de agente de Claude Code depende del formato de uso de herramientas de Anthropic, y el enrutador tiene que traducirlo para los modelos de estilo OpenAI. Los modelos más capaces lo manejan bien; los más pequeños omiten llamadas a herramientas, inventan rutas de archivos o ignoran el protocolo de permisos, y la sesión se degrada en una sucesión de reintentos. Mantén las rutas *default* y *think* en un modelo de Claude y usa las demás para el trabajo en segundo plano, y tendrás una buena configuración.

Cuánto cuesta, con sinceridad

  • OpenRouter directo: precio de tarifa de Anthropic + comisión de OpenRouter. Cómodo, pero nunca más económico que Anthropic.
  • claude-code-router + OpenRouter: lo que cuesten los modelos a los que se dirigen las solicitudes; el ahorro proviene de enviar tareas en segundo plano a modelos económicos, no de que Claude sea más barato.
  • Pasarela de Claude (este sitio): los mismos modelos de Claude, facturados a precios de catálogo con cargo a créditos comprados con un 87% de descuento sobre su valor nominal ($13 → $100 de uso), o un plan ilimitado de tarifa fija desde $1. También están disponibles GPT-6 / GPT-5.x a través del grupo Codex.

Si solo quieres Claude, prescinde de OpenRouter

La mayoría de quienes buscan «OpenRouter en Claude Code» quieren una de dos cosas: una factura de Claude más baja o una forma de pagar sin una cuenta en la consola de Anthropic. OpenRouter resuelve lo segundo y empeora lo primero. Una pasarela resuelve ambas cosas: las mismas dos variables, sin proxy:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Y ambas opciones se pueden combinar: define esta pasarela como proveedor de tipo Anthropic en claude-code-router y dirige los niveles de Claude hacia ella mientras envías las tareas en segundo plano a otro destino. La guía del ecosistema trata el enrutador con más detalle.

PlanDuraciónPrecio
Uso ilimitado durante 1 hora1 hora$1
Uso ilimitado durante 24 horas24 horas$10
Uso ilimitado durante 1 semana1 semana$49
Uso ilimitado durante 15 días15 días$89

Todos los planes ilimitados →

Pruébalo gratis primero

Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crea una cuenta con el código CLAUDECODE

Preguntas frecuentes

¿Claude Code puede usar OpenRouter?

Sí: directamente a través del endpoint de OpenRouter compatible con Anthropic (modelos de Claude), o mediante claude-code-router para cualquier modelo de OpenRouter. Configura ANTHROPIC_BASE_URL y tu clave de OpenRouter para la vía directa.

¿OpenRouter es más económico para Claude Code?

No. OpenRouter cobra el precio de tarifa de Anthropic más su propia comisión. Solo se ahorra al dirigir tareas en segundo plano a modelos más económicos distintos de Claude, o al usar una pasarela de Claude que vende los mismos modelos por debajo del precio de tarifa.

¿Qué modelos funcionan mejor en Claude Code a través de OpenRouter?

Los modelos de Claude, como cabría esperar: el bucle de agente está construido en torno al formato de herramientas de Anthropic. Otros modelos potentes funcionan con el enrutador; los pequeños tienen dificultades con las llamadas a herramientas.

Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.

Obtener una clave de API Ver planes ilimitados

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

Más guías de Claude Code

Claude Code: la guía completaCómo instalar Claude CodeDocumentación de la CLI de Claude Code: comandos y opcionesPrecios y límites de Claude Code, explicadosEl SDK de Claude Code, ahora Claude Agent SDKHabilidades y plugins de Claude CodeClaude Code en GitHub: la App, la Action y @claude¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDEQué modelo utiliza Claude Code y cómo cambiarloErrores de Claude Code y cómo solucionarlos¿Claude Code es de código abierto?Tutorial de Claude Code: tu primera sesión realClaude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativoCómo usar Claude Code para automatizar QAClaude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambosClaude Code vs Codex vs OpenCode: comparativa de los agentes de terminalSubagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentesHooks de Claude Code: control determinista sobre lo que hace el agenteMCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos realesEl ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilanClaude Code en VS Code: la extensión, el uso desde la terminal y los erroresError de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarloCómo usar Claude Code: desde la instalación hasta el uso diario