Seguro has escuchado a mucha gente hablar maravillas de Claude Code. Quizás también los hayas oído mencionar a OpenRouter en la misma frase, casi siempre seguido de una combinación de variables de entorno y una captura de pantalla de una terminal. Si eres nuevo en esto, puede sentirse como si todos se hubieran saltado un paso y saltaran directo a la jerga.

Esta guía es ese paso que falta. Vamos despacio donde importa, explicamos las partes confusas y, al final, entenderás realmente lo que está pasando en lugar de solo copiar y pegar comandos esperando que funcionen.

Las dos piezas, rápido

Claude Code es el agente de codificación en terminal de Anthropic. Lee tus archivos, edita código y ejecuta comandos. Por defecto, habla directamente con los servidores de Anthropic.

OpenRouter es un conmutador (switchboard) de modelos de IA. En lugar de que cada aplicación necesite su propia conexión separada con cada proveedor de IA, OpenRouter se coloca en el medio y te permite enrutar tus solicitudes hacia distintos modelos desde una sola cuenta, un solo panel y un solo lugar para vigilar tu gasto. (¡Incluso modelos gratuitos y open source!)

Puedes revisar todos los modelos que ofrece OpenRouter aquí.

Un chequeo de honestidad importante: la propia documentación de OpenRouter dice que esta combinación solo está garantizada para funcionar bien con los modelos de Anthropic. En realidad no estás cambiando el cerebro de Claude: estás redirigiendo el conducto por el que habla.

Vocabulario rápido: “compatible con OpenAI”

Claude Code envía sus solicitudes en el formato de Anthropic. Algunos servidores solo entienden el formato de OpenAI. Si apuntas Claude Code a uno de esos por error, obtienes errores confusos, como enviar una carta en francés a alguien que solo lee español.

OpenRouter tiene un endpoint que habla el formato de Anthropic de forma nativa, así que no hay paso de traducción ni proxy separado.

¿Uso zsh o bash? ¿Cómo se supone que lo sepa?

Esta pregunta detiene a más principiantes que cualquier otra cosa en esta guía, y es justa. Así se comprueba en diez segundos.

Abre tu terminal y escribe esto, luego presiona enter:

echo $SHELL

Obtendrás una de estas respuestas:

  • Algo que termina en /zsh, como /bin/zsh, significa que usas zsh. Es el predeterminado en las Mac modernas.
  • Algo que termina en /bash, como /bin/bash, significa que usas bash. Es común en Mac antiguas, muchas configuraciones de Linux y Windows Subsystem for Linux (WSL).

Eso es todo. El que aparezca te dice qué archivo editar más adelante:

  • Usuarios de zsh editan ~/.zshrc
  • Usuarios de bash editan ~/.bashrc

Configuración

1. Instala Claude Code

curl -fsSL https://claude.ai/install.sh | bash

2. Consigue una API key de OpenRouter en openrouter.ai y carga algunos créditos.

3. Agrega esto a tu archivo de shell (el que encontraste arriba) y reinicia tu terminal:

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

La última línea es intencional, no un error de tipeo. Un valor antiguo ahí puede causar errores de autenticación confusos. Además, pon estas líneas cerca del final del archivo; de lo contrario, si OPENROUTER_API_KEY se redefine más adelante, el token queda vacío en silencio.

¿Prefieres mantenerlo por proyecto? Usa un archivo de settings:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "tu-openrouter-api-key",
    "ANTHROPIC_API_KEY": ""
  }
}

4. Limpia cualquier login antiguo

/logout

Luego reinicia Claude Code por completo.

5. Lánzalo

cd /ruta/a/tu/proyecto
claude

6. Confirma que funcionó

/status

Debería mostrar ANTHROPIC_AUTH_TOKEN y la URL base de OpenRouter. Revisa también el panel de actividad; es extrañamente satisfactorio ver cómo aparecen las solicitudes.

“Estás listo para arrancar. Claude Code con una fila de modelos esperando su turno.”

Conclusión

Instala Claude Code, consigue una key de OpenRouter, define cuatro variables de entorno en el archivo correcto, /logout, relanza, /status para confirmar. Diez minutos y listo. Quédate con los modelos de Claude al principio y luego explora una vez que sepas cómo se ve “funcionando”.

¿Te interesa dominar agentes de código y automatización con IA? Sigue explorando estos temas en el blog de DojoFullStack: guías prácticas, configuraciones reales y lo que nadie te cuenta sobre trabajar con agentes de IA en producción.