Claude Code con OpenRouter: cómo usarlo en local sin plan de pago de Anthropic

27 marzo 2026
| No hay comentarios

Anthropic ha lanzado Claude Code como un agente de código avanzado pensado para entornos profesionales: entiende el contexto de tu proyecto, navega archivos, aplica cambios en varios ficheros y muestra diffs tal y como haría un desarrollador humano. Pero por defecto, la integración “oficial” está orientada a usuarios con plan de pago (Pro/Max/Team/Enterprise) o con uso de API pagada.

En este post veremos cómo usar Claude Code apuntando a OpenRouter en lugar de directamente a Anthropic, de forma que puedas beneficiarte de este agente de código local sin depender de una suscripción cara. También exploraremos cómo integrarlo con Visual Studio Code por terminal, manteniendo todo el flujo en tu máquina.

¿Qué es Claude Code y para qué sirve?

Claude Code es un agente de programación basado en Claude 3.5 Sonnet que se ejecuta como CLI y entiende el workspace completo de tu proyecto. No es solo un chat de IA que responde a peticiones aisladas: puede:

  • Leer y navegar todos tus ficheros.

  • Proponer cambios en múltiples archivos a la vez.

  • Mostrar diffs y pedir confirmación antes de aplicarlos.

  • Corregir fallos, refactorizar, implementar nuevas rutas, endpoints, etc.

En el flujo típico ejecutas:

bash
cd /ruta/a/tu/proyecto
claude

Tras esto, Claude Code arranca una interfaz interactiva en tu terminal y puedes lanzarle instrucciones como:

text
Añade un endpoint /api/users en mi API FastAPI que devuelva una lista de usuarios.

El agente generará o modificará los ficheros necesarios, te mostrará un diff y te pedirá confirmación antes de aplicar los cambios. Es un flujo muy potente para desarrolladores y DevOps que quieren tener un “par programador” entero en su terminal.

How to Install and Use Codex CLI: OpenAI's Response to Claude Code

¿Qué problema resuelve OpenRouter aquí?

OpenRouter actúa como un gateway de APIs unificado que permite acceder a más de 200 modelos de diferentes proveedores (Anthropic, OpenAI, Meta, Mistral, etc.) a través de una única API REST estándar.

En el contexto de Claude Code, esto permite:

  • Redirigir el tráfico de Claude Code a través de OpenRouter en lugar de a la API directa de Anthropic.

  • Usar el modelo de Anthropic (por ejemplo anthropic/claude-3-5-sonnet) o incluso modelos gratuitos de otros proveedores si el enrutador lo permite.

  • Tener mayor control y visibilidad sobre el uso (monitorización de costes, tokens, etc.).

El escenario ideal para este post es:

  • Quieres usar Claude Code como agente de código local.

  • No quieres (o no puedes) pagar un plan de Anthropic Pro/Max.

  • Estás dispuesto a usar OpenRouter como intermediario de la comunicación con el modelo.

Requisitos previos

Antes de empezar, asegúrate de tener:

  1. Claude Code instalado via CLI (por ejemplo, a través de npm o vía instalación oficial).

  2. Una cuenta en OpenRouter: accede a openrouter.ai y genera una OPENROUTER_API_KEY en tu panel de configuración.

  3. Un entorno de desarrollo listo (por ejemplo, un proyecto Python/Node/otro con ficheros que poder modificar).

Si sigues las guías oficiales de instalación de Claude Code, el proceso es similar a:

bash
npm install -g @anthropic-ai/claude-code
# o el comando que aparezca en la documentación oficial más reciente

Una vez instalado, puedes comprobar que funciona ejecutando:

bash
claude --version
NOTA: Si usamos la ultima version 2.1.84 nos obliga a tener una cuenta de pago, el método funciona con la versión anterior a esta

Configurar Claude Code para que use OpenRouter

La clave está en reasignar variables de entorno para que Claude Code use la API de OpenRouter en lugar de la API directa de Anthropic.

1. Variables de entorno esenciales

En tu terminal, exporta las siguientes variables:

bash
export OPENROUTER_API_KEY="tu-openrouter-api-key-aquí"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""

Explicación de cada una:

  • OPENROUTER_API_KEY: tu clave de API de OpenRouter.

  • ANTHROPIC_BASE_URL: la URL base donde Claude Code buscará la API de Anthropic, pero en este caso apunta a OpenRouter.

  • ANTHROPIC_AUTH_TOKEN: el token de autenticación que Claude Code usará para conectarse; aquí coincidirá con tu API key de OpenRouter.

  • ANTHROPIC_API_KEY="": vacía, para evitar que Claude Code intente usar la API directa de Anthropic y priorice OpenRouter.

2. Guardarlas en tu shell (macOS/Linux)

Si usas bash o zsh, puedes añadir estas líneas a tu fichero de perfil:

bash
echo 'export OPENROUTER_API_KEY="tu-openrouter-api-key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://openrouter.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=""' >> ~/.zshrc
source ~/.zshrc

Si usas bash:

bash
echo 'export OPENROUTER_API_KEY="tu-openrouter-api-key"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://openrouter.ai/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=""' >> ~/.bashrc
source ~/.bashrc

Con esto, cada vez que abras una nueva terminal, las variables estarán configuradas y el comando claude usará OpenRouter de forma automática.

 

NOTA: Podemos definir que modelo usar, lo ideal es elegir uno que sea free para que no nos cobren nada en absoluto.

 

 

El problema es que al ser un modelo Free puede ser usado por muchas personas y no nos de la respuesta al momento de usarlo, lo ideal es configurarlo con «openrouter/free» y de esta forma usara el primer modelo free disponible que tenga.

(Opcional) Uso con un router adicional: Claude Code Router

Si quieres ir un paso más allá, puedes usar el Claude Code Router (proyecto de código abierto) para desacoplar aún más el modelo de Anthropic y usar cualquier modelo de OpenRouter, incluyendo modelos gratuitos.

1. Idea de Claude Code Router

El router actúa como un proxy entre Claude Code y OpenRouter:

  • Claude Code se conecta a http://localhost:XXXX (el router).

  • El router traduce las llamadas a la API de OpenRouter, usando tu OPENROUTER_API_KEY y el model_id que elijas (por ejemplo anthropic/claude-3-5-sonnet o mistralai/mistral-7b).

2. Cambiar la variable de base URL

Una vez que el router esté escuchando en tu máquina, apuntas Claude Code a él:

bash
export ANTHROPIC_BASE_URL="http://localhost:3000"

En el fichero de configuración del router, normalmente verás algo parecido a:

js
const OPENROUTER_API_KEY = "tu-openrouter-api-key";
const MODEL_ID = "anthropic/claude-3-5-sonnet";

Con esta configuración, Claude Code seguirá viendo una API “estándar”, pero el backend será OpenRouter (o el modelo que hayas elegido), y todo el tráfico pasa por tu máquina local, lo que da buena privacidad y control.

Usar Claude Code con Visual Studio Code

Aquí es donde el escenario se vuelve especialmente interesante para tu flujo de desarrollo.

1. La extensión oficial de Claude Code en VS Code

Existe una extensión oficial llamada “Claude Code for VS Code” disponible en el Marketplace de Visual Studio Code.
Esta extensión:

  • Muestra un panel lateral dentro de VS Code.

  • Permite diffs en línea, sugerencias de cambios, y comunicación directa con Claude Code.

El inconveniente: requiere una cuenta de Anthropic con acceso a Claude Code (Pro/Max/Team/Enterprise o plan de API pay‑as‑you‑go), así que no es un escenario 100% gratuito.

2. VS Code con terminal integrado + CLI de Claude Code

Si quieres evitar depender de la suscripción de Anthropic, la mejor opción es usar el CLI de Claude Code dentro del terminal integrado de VS Code.

Los pasos son:

  1. Abre tu proyecto en VS Code:

bash
code /ruta/a/tu/proyecto

  1. Abre el terminal integrado (Ctrl + ``, o Ctrl + Shift + «).

  2. Entra en el directorio:

bash
cd /ruta/a/tu/proyecto

  1. Lanza Claude Code:

bash
claude

En este punto, ya tienes:

  • El entorno de VS Code abierto, con todos tus ficheros.

  • Claude Code corriendo en el terminal, apuntando a OpenRouter gracias a las variables de entorno que configuraste antes.

Desde ahí puedes:

  • Pedir a Claude Code que cree nuevos endpoints, migre ficheros, refactorice código, etc.

  • Ver los diffs que propone en el terminal y confirmarlos para aplicarlos en tu proyecto real.

Es un flujo muy parecido a la extensión gráfica, solo que más “terminal‑first”, y además no depende de un plan de pago de Anthropic, sino de tu API key y cuotas de OpenRouter.

Limitaciones y buenas prácticas

Antes de cerrar el post, conviene mencionar algunos puntos realistas:

  • OpenRouter tiene límites de uso: aunque hay modelos gratuitos y créditos de bienvenida, el uso intensivo acabará generando coste según el modelo y los tokens consumidos.

  • La API de Anthropic puede cambiar: los formatos de petición, headers o modelos podrían evolucionar, lo que obligaría a ajustar mínimamente el enrutador o las variables de entorno en el futuro.

Buenas prácticas recomendadas:

  • Guarda la OPENROUTER_API_KEY solo en variables de entorno; nunca la comites en el repositorio de código.

  • Aísla el entorno de Claude Code en un perfil o directorio específico si trabajas en múltiples proyectos.

  • Si usas el router, mantenlo actualizado (normalmente es un proyecto de código abierto en GitHub) para aprovechar mejoras de compatibilidad y soporte de nuevos modelos.

Mini‑ejemplo práctico en VS Code

Para que el lector tenga un ejemplo completo, puedes orientarle a un flujo tipo:

  1. Crea un proyecto Python básico:

bash
mkdir claude-code-demo
cd claude-code-demo
python3 -m venv venv
source venv/bin/activate

  1. Inicia VS Code:

bash
code .

  1. Abre el terminal integrado y lanza:

bash
cd claude-code-demo
claude

  1. En Claude Code, pide:

text
Crea una app FastAPI con un endpoint /api/users que devuelva una lista de usuarios.

  1. Observa cómo se crean o modifican los ficheros (main.py, requirements.txt, etc.) y cómo se muestran los diffs en tu terminal.

Este mini‑tutorial deja claro que el flujo completo funciona sin necesidad de una extensión gráfica: solo terminal, VS Code y el CLI de Claude Code configurado con OpenRouter.

 

Conclusión

Con la combinación Claude Code + OpenRouter tienes un agente de código local muy potente que puedes usar sin estar atado a una suscripción de Anthropic Pro/Max. Mediante variables de entorno y, opcionalmente, un router adicional, puedes:

  • Usar modelos de Anthropic u otros proveedores sin cambiar el cliente.

  • Integrarlo perfectamente con VS Code vía terminal integrado.

  • Controlar mejor el uso y costes en función de los modelos que elijas.

Este enfoque es ideal para:

  • Desarrolladores que quieren probar Claude Code sin pagar un plan inicial.

  • Equipos de DevOps o Cloud que quieren integrar un agente de código en su flujo de trabajo sin comprometerse con una API cara desde el primer día.

Si quieres compartir feedback, puedes comentar en el post qué modelos de OpenRouter te dan mejores resultados con Claude Code, o en qué tipo de flujos (backend, infraestructura, scripting) estás usando este setup.

Enlaces útiles

AI, General, IA, Inteligencia Artificial
| Tags: , , ,