AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.
¿Cómo se usa Claude Code con OpenRouter?
Define la URL base como https://openrouter.ai/api, coloca tu clave de API de OpenRouter en ANTHROPIC_AUTH_TOKEN y deja ANTHROPIC_API_KEY en blanco. Claude Code entonces se comunica directamente con OpenRouter, sin proxy local, y consume tus créditos de OpenRouter.
Esta es la configuración descrita en la guía oficial de OpenRouter para Claude Code. Según sus propias palabras, Claude Code usa su protocolo nativo directamente con OpenRouter y no se requiere ningún servidor proxy local. Esa es la principal diferencia con herramientas como Claude Code Router, que ejecutan un proxy en tu equipo (consulta nuestra guía de Claude Code Router si prefieres esa opción).
El resto de este artículo explica las variables exactas, dónde van, las advertencias que indica OpenRouter, cuánto cuesta y cómo los créditos gratuitos pueden pagarlo.
Los mejores créditos de IA para startups
Solicita directamente a través de estos programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegible para startups en fase inicial
Claude (via program) $100,000
Elegible para startups en fase inicial
OpenAI (via program) $2,500
Elegible para startups en fase inicial
Anthropic $20,000
Elegible para startups en fase inicial
AWS $300,000
Elegible para startups en fase inicial
Google Cloud $350,000
Elegible para startups en fase inicial
¿Qué variables de entorno necesita OpenRouter?
Tres variables hacen el trabajo. La guía pide la URL completa de la API de OpenRouter, incluido el esquema, así que un nombre de host sin esquema no sirve.
| Variable | Valor | Motivo |
|---|---|---|
| ANTHROPIC_BASE_URL | https://openrouter.ai/api | Envía el tráfico de Claude Code a OpenRouter |
| ANTHROPIC_AUTH_TOKEN | Tu clave de API de OpenRouter | Se autentica con OpenRouter |
| ANTHROPIC_API_KEY | Cadena vacía | Se deja en blanco explícitamente para evitar conflictos |
La URL base es la parte que más se suele equivocar al buscar una respuesta sobre claude code base url openrouter. Usa https://openrouter.ai/api exactamente así, con https:// al principio.
Dejar ANTHROPIC_API_KEY en blanco es importante porque Claude Code lee ambas variables. Si todavía hay definida una clave antigua de Anthropic, puede entrar en conflicto con el token de OpenRouter.
¿Dónde debes colocar las variables y dónde no?
Tienes dos lugares compatibles y uno que no funciona.
Opción 1: tu perfil de shell. OpenRouter recomienda esta opción para que la configuración persista. Añade las variables allí y luego recarga tu shell. La guía es directa sobre la recarga: si la omites, seguirás probando el entorno antiguo y concluirás erróneamente que la configuración está rota.
Opción 2: un archivo de ajustes a nivel de proyecto. También puedes usar .claude/settings.local.json en la raíz de tu proyecto. Así la configuración queda limitada a un solo proyecto.
No un archivo .env. La guía indica que no coloques estas variables en un archivo .env a nivel de proyecto, porque el instalador nativo de Claude Code no lee los archivos .env estándar.
Una trampa más: si tu clave de OpenRouter está en otra variable a la que hace referencia ANTHROPIC_AUTH_TOKEN, defínela antes de que se consuma. De lo contrario, la autenticación falla. La guía sugiere un archivo que se cargue antes, como ~/.zshenv para zsh.
Los mejores créditos de IA para startups
Solicita directamente a través de estos programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegible para startups en fase inicial
Claude (via program) $100,000
Elegible para startups en fase inicial
OpenAI (via program) $2,500
Elegible para startups en fase inicial
Anthropic $20,000
Elegible para startups en fase inicial
AWS $300,000
Elegible para startups en fase inicial
Google Cloud $350,000
Elegible para startups en fase inicial
¿Cómo lo configuras, paso a paso?
Paso 1: Obtén créditos con AI Perks
Claude Code a través de OpenRouter se factura con tus créditos de OpenRouter, así que empieza buscando algunos gratuitos. La Guía de AI Perks enumera créditos de OpenRouter de hasta $3,000, además de créditos de Anthropic que puedes usar si traes tu propia clave. Revisa el catálogo para ver los importes y los detalles antes de gastar tu propio dinero.
Paso 2: Crea una clave de API de OpenRouter
Genera una clave en la configuración de tu cuenta de OpenRouter. Este es el valor que va en ANTHROPIC_AUTH_TOKEN.
Paso 3: Añade las variables
Coloca la URL base, el token de autenticación y el ANTHROPIC_API_KEY en blanco en tu perfil de shell o en .claude/settings.local.json. No uses un archivo .env. Después, recarga tu shell.
Paso 4: Ejecuta /logout si es necesario
Si antes iniciaste sesión en Claude Code con una cuenta de Anthropic, ejecuta /logout una vez para eliminar la sesión en caché. Luego cierra y vuelve a abrir claude para que cargue las nuevas variables. Si nunca iniciaste sesión con Anthropic, puedes omitir este paso.
Paso 5: Verifica con /status
Ejecuta /status dentro de Claude Code para confirmar la conexión. Después revisa tu panel de OpenRouter: allí aparece el uso, incluidos los tokens de razonamiento.
¿Qué advertencias indica OpenRouter?
La guía es clara sobre los límites, y afectan a cómo debes configurar las cosas.
- Solo Anthropic de primera parte. Claude Code con OpenRouter solo tiene garantizado su funcionamiento con el proveedor de primera parte de Anthropic. Para lograr la máxima compatibilidad, OpenRouter recomienda que Anthropic 1P sea el proveedor con la máxima prioridad.
- Otros modelos pueden fallar. Claude Code está optimizado para los modelos de Anthropic y puede no funcionar correctamente con otros proveedores. Trata los modelos que no son de Anthropic como un experimento, no como una opción predeterminada.
- Supuesto de ventana de contexto. Claude Code asume una ventana de contexto de 200k, a menos que el nombre del modelo termine en
[1m]. - Conmutación por error. Las solicitudes cambian automáticamente entre varios proveedores de Anthropic cuando se enrutan a través de OpenRouter.
- Privacidad. OpenRouter no registra tus prompts con código fuente a menos que actives el registro de prompts en la configuración de tu cuenta.
Esa primera advertencia es la razón por la que las búsquedas de "claude code openrouter free" requieren cuidado. OpenRouter sí ofrece modelos gratuitos, pero tienen límites, y Claude Code solo tiene garantizado su funcionamiento en el proveedor de primera parte de Anthropic. Los modelos gratuitos están limitados a 20 solicitudes por minuto y 50 al día, y suben a 1,000 al día después de que hayas comprado al menos $10 en créditos. Consulta nuestra guía del nivel gratuito de OpenRouter para ver el desglose completo.
Los mejores créditos de IA para startups
Solicita directamente a través de estos programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegible para startups en fase inicial
Claude (via program) $100,000
Elegible para startups en fase inicial
OpenAI (via program) $2,500
Elegible para startups en fase inicial
Anthropic $20,000
Elegible para startups en fase inicial
AWS $300,000
Elegible para startups en fase inicial
Google Cloud $350,000
Elegible para startups en fase inicial
¿Puedes usar el modo rápido a través de OpenRouter?
Sí, pero solo en condiciones específicas. El modo rápido de Anthropic ofrece una salida de hasta 2.5x más rápida a un precio premium, por encima de las tarifas estándar por token del modelo Opus subyacente.
| Requisito | Detalle |
|---|---|
| Modelos | Claude Opus 4.6, 4.7, 4.8 y Claude Opus 5 |
| Versión de Claude Code | v2.1.96 o posterior |
| Variable de entorno | CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 para usar /fast |
| Proveedor | Solo Anthropic de primera parte |
| Ajuste del modelo | Fija la variable de Opus a un ID específico, como anthropic/claude-opus-5 |
El modo rápido solo lo ofrece el proveedor de primera parte de Anthropic, ya que otros proveedores como Amazon Bedrock y Google Vertex no lo admiten. Para usarlo realmente, fija la variable del modelo Opus a un ID específico de Opus en lugar del alias más reciente. La guía no publica aquí el multiplicador premium, así que consulta las tarifas actuales antes de confiar en él.
¿Cuánto cuesta Claude Code en OpenRouter frente a Anthropic directamente?
OpenRouter no aplica recargo sobre la inferencia. La inferencia se factura al precio de lista del proveedor en todos los planes. La comisión se cobra al comprar créditos, nunca en cada solicitud individual.
Esto es lo que supone la comisión en una compra de créditos de $10:
| Compra de créditos | Tasa de comisión | Comisión sobre $10 |
|---|---|---|
| No cripto, Standard | 5.5%, mínimo de $0.80 | $0.80 (5.5% de $10 es $0.55, por debajo del mínimo, así que se aplica el mínimo) |
| Cripto | 5.0% fijo, sin mínimo | $0.50 (5.0% de $10) |
| No cripto, Business | 8% | $0.80 (8% de $10) |
Así que la comparación honesta es esta: el precio por token es el precio de lista del proveedor, y OpenRouter añade una comisión de compra encima. Pagar directamente a Anthropic evita esa comisión. A cambio, obtienes una sola clave, un único panel y conmutación por error entre proveedores de Anthropic.
Los precios por token de cada modelo no se publican en la página de precios de OpenRouter. Hay que consultarlos en la API de modelos. Para las cifras propias de Anthropic, consulta nuestro desglose de precios de la API de Claude.
¿Cómo cambia BYOK las cuentas?
Los planes Standard y Business incluyen $25,000 al mes de inferencia a precio de lista mediante BYOK (trae tu propia clave), sin comisión de OpenRouter. Por encima de esa asignación, OpenRouter cobra el 5% de lo que costaría la solicitud a precio de lista, descontado de tus créditos.
Con BYOK, controlas los límites de velocidad y los costos a través de tu propia cuenta con el proveedor. Ahí es donde los créditos gratuitos de los proveedores resultan útiles: si tu cuenta con el proveedor tiene créditos, tu uso de Claude Code puede consumirlos, sujeto a las condiciones de crédito de ese proveedor.
Los mejores créditos de IA para startups
Solicita directamente a través de estos programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegible para startups en fase inicial
Claude (via program) $100,000
Elegible para startups en fase inicial
OpenAI (via program) $2,500
Elegible para startups en fase inicial
Anthropic $20,000
Elegible para startups en fase inicial
AWS $300,000
Elegible para startups en fase inicial
Google Cloud $350,000
Elegible para startups en fase inicial
¿Qué créditos gratuitos pueden cubrir tu uso de Claude Code?
Estos son los importes del catálogo más relevantes para ejecutar Claude Code. Los detalles, y en qué consiste cada beneficio, están en el catálogo de AI Perks.
| Empresa | Créditos gratuitos | Cómo obtenerlos |
|---|---|---|
| OpenRouter | Hasta $3,000 | Obtén este beneficio |
| Anthropic (directo) | $20,000 | Obtén este beneficio |
| Claude a través de socios | Hasta $100,000 | Obtén este beneficio |
| AWS (Amazon Bedrock) | $300,000 | Obtén este beneficio |
Total de estas cuatro filas: $3,000 + $20,000 + $100,000 + $300,000 = hasta $423,000 en créditos listados.
El catálogo también incluye créditos de OpenAI, Google Cloud, Azure OpenAI, Mistral AI, Together AI, Cerebras y Novita AI. Son útiles sobre todo si quieres probar modelos que no son de Anthropic, teniendo en cuenta la advertencia de OpenRouter de que Claude Code puede no funcionar correctamente con ellos. Para el lado de Anthropic en concreto, lee nuestra guía sobre una clave gratuita de API de Anthropic, y consulta el catálogo para ver los importes mayores de créditos de Claude.
Preguntas frecuentes
¿Claude Code necesita un proxy local para funcionar con OpenRouter?
No. OpenRouter indica que Claude Code usa su protocolo nativo directamente con OpenRouter y que no se requiere ningún servidor proxy local. Solo configuras variables de entorno. Una herramienta basada en proxy como Claude Code Router es un enfoque distinto, útil cuando quieres reglas de enrutamiento personalizadas entre muchos modelos.
¿Por qué Claude Code sigue usando mi antiguo inicio de sesión de Anthropic?
Probablemente tienes una sesión en caché. Ejecuta /logout una vez y luego cierra y vuelve a abrir claude para que lea las nuevas variables. Además, confirma que recargaste tu shell después de editar el perfil y que ANTHROPIC_API_KEY está en blanco. Verifica el resultado con /status.
¿Puedo usar Claude Code con OpenRouter gratis?
En parte. Los usuarios nuevos de OpenRouter obtienen una pequeña asignación gratuita, y existen modelos gratuitos con límites de 20 solicitudes por minuto y 50 al día. Pero Claude Code solo tiene garantizado su funcionamiento en el proveedor de primera parte de Anthropic. Para un uso real, revisa los créditos gratuitos listados en getaiperks.com.
¿OpenRouter cobra algo extra por solicitud para los modelos de Claude?
No. La inferencia se factura al precio de lista del proveedor, y la comisión de OpenRouter se aplica al comprar créditos: 5.5% en Standard y 8% en Business. Las compras no cripto tienen un mínimo de $0.80, y las compras en cripto tienen un 5.0% fijo. Compara esto con pagar directamente a Anthropic usando los créditos de Anthropic del catálogo.
¿Puedo usar créditos gratuitos de Anthropic a través de OpenRouter?
Con BYOK, asocias tu propia clave de proveedor y los costos pasan por tu cuenta con el proveedor. Standard y Business incluyen una asignación mensual de BYOK de $25,000 sin comisión de OpenRouter. Para encontrar créditos de Anthropic de hasta $100,000 a través de socios, consulta el catálogo en AI Perks.
¿Por qué la ventana de contexto de mi Claude Code es de 200k?
Claude Code asume una ventana de contexto de 200k, a menos que el nombre del modelo termine en [1m]. Si quieres que Claude Code trate la ventana como más grande, el nombre del modelo debe llevar ese sufijo. La guía no publica más detalles sobre qué modelos lo admiten.
Los mejores créditos de IA para startups
Solicita directamente a través de estos programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegible para startups en fase inicial
Claude (via program) $100,000
Elegible para startups en fase inicial
OpenAI (via program) $2,500
Elegible para startups en fase inicial
Anthropic $20,000
Elegible para startups en fase inicial
AWS $300,000
Elegible para startups en fase inicial
Google Cloud $350,000
Elegible para startups en fase inicial
¿Listo para financiar tu configuración de Claude Code?
La configuración lleva minutos. Lo que merece planificación es el costo: los créditos de OpenRouter, los créditos de Anthropic y los créditos de la nube se registran todos en un solo catálogo, así que puedes ajustar los créditos adecuados a tu uso antes de pagar el precio de lista.
Obtén créditos gratuitos de IA en getaiperks.com →
Explora el catálogo completo de créditos gratuitos de IA en getaiperks.com y ejecuta Claude Code con créditos que no pagaste.
