Claude Code instalado
Instala Claude Code desde la fuente oficial y confirma que funciona con claude --version en tu terminal. Si ese comando da un error, corrige la instalación antes de configurar cualquier clave API.
Claude Code
Configuración de clave API para Claude Code
Claude Code lee dos variables de entorno para enrutar solicitudes a cualquier destino: ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY. Apúntalas a RunAPI y ejecuta cualquier modelo Claude a la mitad de la tarifa oficial. Esta guía muestra los comandos exactos para Mac, Linux y Windows.
Actualizado el June 18, 2026
RunAPI Editorial
De un vistazo
¿Cómo se configura una clave API personalizada en Claude Code?
Claude Code usa dos variables de entorno para decidir a dónde van las solicitudes y cómo se autentican. Establece ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY con valores de RunAPI y cada solicitud se enruta a través de RunAPI con un 50% de descuento. ¿Quieres usar un proveedor diferente por completo? RunAPI también funciona como una pasarela de reemplazo directo para que puedas ejecutar modelos Claude sin una cuenta directa de Anthropic.
Dos variables
ANTHROPIC_BASE_URL establece el endpoint. ANTHROPIC_API_KEY establece la clave. Esa es toda la configuración: dos variables, sin otros cambios.
Valor del endpoint
Establece ANTHROPIC_BASE_URL en https://api.runapi.ai para que Claude Code se enrute a través de RunAPI.
Persiste la configuración
Añade ambas exportaciones a tu perfil de shell (.zshrc o .bashrc) para no tener que volver a configurarlas en cada sesión. Los usuarios de Windows las configuran en PowerShell y abren una nueva ventana.
50% de descuento
Cada modelo Claude se factura a la mitad de la tarifa oficial de Anthropic. Sin suscripción, sin límite.
Antes de comenzar
¿Qué necesitas antes de configurar Claude Code?
La configuración tarda unos minutos. Necesitas Claude Code instalado, una cuenta de RunAPI y una terminal. Ejecuta claude --version primero para confirmar que Claude Code funciona antes de tocar cualquier configuración de clave API.
Una cuenta de RunAPI
Regístrate en runapi.ai. El nivel gratuito incluye créditos para probar cualquier modelo Claude antes de cargar saldo.
Una clave API
Crea una clave desde Dashboard → API Keys. Cópiala una vez: se muestra completa solo en el momento de la creación. No la pegues en repositorios públicos ni la compartas en capturas de pantalla.
Acceso a la terminal
Necesitas una shell para configurar variables de entorno. macOS y Linux usan .zshrc o .bashrc. Los usuarios de Windows pueden usar PowerShell: configura la variable y luego abre una nueva ventana de terminal para que surta efecto.
Paso a paso
Cómo configurar una clave API de Claude Code con RunAPI
Ejecuta estos comandos en orden. Configuran el endpoint y la clave, los persisten en tu perfil de shell y confirman que Claude Code los recoge. Reemplaza el marcador de posición con tu clave real de RunAPI. Usa ANTHROPIC_API_KEY (no CLAUDE_API_KEY): esa es la variable que Claude Code realmente lee.
1
Establece la URL base
Esto le indica a Claude Code que envíe solicitudes a RunAPI en lugar del endpoint predeterminado de Anthropic.
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
Establece la clave API
Pega tu clave de RunAPI en lugar del marcador de posición. Claude Code la usa para autenticar cada solicitud.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
Persiste ambas variables
Añade ambas exportaciones a ~/.zshrc (o ~/.bashrc) para que sobrevivan a nuevas sesiones de terminal. Recarga con source ~/.zshrc. En Windows, configúralas en PowerShell y abre una nueva ventana de terminal para que el cambio surta efecto.
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
Verifica la configuración
Confirma que la variable imprime la URL de RunAPI. Si está vacía, recarga tu perfil de shell o abre una nueva terminal: las variables configuradas en una sesión no se transfieren automáticamente.
echo $ANTHROPIC_BASE_URL
5
Ejecuta Claude Code
Lanza Claude Code en tu proyecto. Ahora se enruta a través de RunAPI con un 50% de descuento sobre la tarifa oficial.
claudeVariables de entorno
¿Qué variables de entorno lee Claude Code?
Claude Code lee un pequeño conjunto de variables para controlar el endpoint, la autenticación, el modelo y la longitud de salida. La tabla enumera las que importan para una configuración de endpoint personalizado y qué hace cada una. Nota: usa ANTHROPIC_API_KEY (no CLAUDE_API_KEY) — esa es la variable que Claude Code realmente lee.
| Variable | Propósito | Valor de ejemplo |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizado al que Claude Code envía las solicitudes | https://api.runapi.ai |
| ANTHROPIC_API_KEY | Clave utilizada para autenticar las solicitudes | sk-your-runapi-key |
| ANTHROPIC_MODEL | Modelo predeterminado para nuevas sesiones | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Límite de tokens devueltos por respuesta | 8192 |
También puedes almacenar estos valores en un archivo de configuración .claude.json en tu directorio de inicio o de proyecto, en lugar de exportarlos en cada sesión.
Elegir un modelo
¿Qué modelo Claude deberías ejecutar en Claude Code?
Claude Code acepta cualquier ID de modelo Claude a través de RunAPI. Elige según la tarea: un modelo rápido y económico para ediciones de rutina, uno equilibrado para codificación diaria o el más potente para problemas difíciles. Establece ANTHROPIC_MODEL para cambiar el predeterminado, o cambia de modelo dentro de Claude Code: la facturación sigue al modelo que realmente uses.
claude-haiku-4-5
El más rápido y económico a $1/M de entrada y $5/M de salida a través de RunAPI. Ideal para ediciones de rutina y consultas rápidas.
claude-sonnet-4-6
Predeterminado equilibrado para codificación diaria a $3/M de entrada y $15/M de salida a través de RunAPI. La mayoría de los desarrolladores usa este.
claude-opus-4-7
El más potente para problemas difíciles a $5/M de entrada y $25/M de salida a través de RunAPI. Úsalo para refactorizaciones y revisiones complejas.
Cambia en cualquier momento
Establece ANTHROPIC_MODEL o cambia el modelo dentro de Claude Code en cualquier momento. La facturación sigue al modelo que realmente uses, todo con un 50% de descuento.
Corrección de errores comunes
¿Por qué mi clave API de Claude Code no funciona?
La mayoría de los problemas de configuración provienen de una de tres cosas: el nombre incorrecto de la variable de entorno (usa ANTHROPIC_API_KEY, no CLAUDE_API_KEY), una sesión de shell obsoleta que no ha recogido los cambios de tu perfil, o un error tipográfico en la clave. La tabla enumera los errores comunes y la solución para cada uno.
| Error o síntoma | Causa probable | Solución |
|---|---|---|
| 401 Unauthorized | Clave API incorrecta o caducada | Verifica ANTHROPIC_API_KEY y crea una nueva clave en el panel de RunAPI si es necesario |
| Las solicitudes siguen llegando a Anthropic | ANTHROPIC_BASE_URL no configurada en esta shell | Ejecuta echo $ANTHROPIC_BASE_URL; si está vacío, recarga tu perfil o abre una nueva terminal |
| 404 Not Found | Barra diagonal al final o ruta incorrecta en la URL base | Establece la URL base exactamente en https://api.runapi.ai sin ruta adicional al final |
| Modelo no encontrado | ID de modelo inválido o con error tipográfico | Usa un ID válido como claude-sonnet-4-6 o claude-opus-4-7 |
| Variables perdidas al reiniciar | Exportaciones no escritas en el perfil de shell | Añade ambas exportaciones a ~/.zshrc o ~/.bashrc y recarga |
Versión rápida
Configuración de clave API de Claude Code en cuatro pasos
1
Establece la URL base
Exporta ANTHROPIC_BASE_URL=https://api.runapi.ai para enrutar solicitudes a través de RunAPI.
2
Establece la clave API
Exporta ANTHROPIC_API_KEY con tu clave de RunAPI desde Dashboard → API Keys.
3
Persiste ambas variables
Añade ambas exportaciones a ~/.zshrc o ~/.bashrc y recarga con source ~/.zshrc para que sobrevivan a nuevas sesiones. En Windows, configúralas en PowerShell y abre una nueva ventana de terminal.
4
Ejecuta Claude Code
Ejecuta claude --version para confirmar la instalación, luego lanza claude en tu proyecto. Las solicitudes ahora se enrutan a través de RunAPI con un 50% de descuento sobre la tarifa oficial.
Preguntas frecuentes
Preguntas frecuentes sobre la clave API de Claude Code
¿Cómo añado una clave API a Claude Code?
Configura dos variables de entorno. Exporta ANTHROPIC_BASE_URL a https://api.runapi.ai y ANTHROPIC_API_KEY a tu clave de RunAPI. Añade ambas a tu perfil de shell (.zshrc o .bashrc) para que persistan entre sesiones. Claude Code las lee al iniciarse y enruta cada solicitud a través de RunAPI.
¿Dónde obtengo una clave API para Claude Code?
Crea una en runapi.ai. Regístrate, abre Dashboard → API Keys y genera una clave. Cópiala de inmediato: la clave completa solo se muestra en el momento de la creación. El nivel gratuito incluye créditos para probar cualquier modelo Claude antes de cargar saldo.
¿Para qué sirve ANTHROPIC_BASE_URL?
Le indica a Claude Code a qué endpoint enviar las solicitudes. Por defecto, Claude Code llama directamente a Anthropic. Al establecerla en https://api.runapi.ai, cada solicitud se enruta a través de RunAPI, que factura los mismos modelos al 50% de la tarifa oficial.
¿Puedo usar Claude Code con otros proveedores de API como OpenAI?
¿Hay alguna forma de usar Claude Code con otros proveedores de API como OpenAI? Sí: Claude Code admite cualquier endpoint compatible con OpenAI mediante ANTHROPIC_BASE_URL. RunAPI expone una pasarela compatible para que puedas cambiar de proveedor sin modificar tu código, usando una sola clave para Claude, GPT y otros modelos.
¿Por qué Claude Code sigue facturando a la tarifa completa?
Ejecuta echo $ANTHROPIC_BASE_URL en tu terminal. Si no imprime nada, la exportación no persistió. Añade ambas exportaciones a ~/.zshrc o ~/.bashrc, ejecuta source ~/.zshrc y luego abre una nueva terminal para verificar. Los usuarios de Windows deben abrir una nueva ventana de PowerShell después de configurar las variables de entorno.
¿Puedo almacenar la clave en un archivo de configuración?
Sí. Coloca los valores en un archivo .claude.json en tu directorio de inicio o de proyecto, en lugar de exportarlos en cada sesión. Ambos métodos funcionan: el archivo es útil para claves por proyecto, mientras que las exportaciones son más sencillas para una configuración global única.
¿Cómo monitoreo el costo después de la configuración?
Abre el panel de RunAPI. Muestra el gasto por clave y por solicitud en tiempo real. Para limitar el costo de salida, configura CLAUDE_CODE_MAX_OUTPUT_TOKENS para que cada respuesta tenga un límite, y usa claude-haiku-4-5 para ediciones de rutina.
¿Esto cambia el comportamiento de Claude Code?
No. RunAPI redirige las solicitudes directamente a los modelos Claude subyacentes. La salida, el uso de herramientas y el comportamiento son idénticos a llamar directamente a Anthropic. Solo cambias a dónde van las solicitudes y cómo se facturan: la experiencia de codificación permanece igual.
RELACIONADO
Explorar más
Precios de Claude Code
Comparativa de costes: facturación API frente a suscripción Max en Claude Code.
Configuración API de Cursor
Conecta Cursor a RunAPI en dos minutos y ahorra un 50% en tarifas API.
Configuración API de VS Code
Usa modelos RunAPI en VS Code Copilot Chat y extensiones.
RunAPI CLI
Ejecuta cualquier modelo desde tu terminal con un solo comando.
Apunta Claude Code a RunAPI con dos comandos.
Crea una cuenta gratuita en RunAPI, establece ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY en tu perfil de shell, y ejecuta cualquier modelo Claude en Claude Code con un 50% de descuento sobre los precios oficiales de Anthropic.