Claude Code instalado
Instala Claude Code desde la fuente oficial y confirma que se ejecuta con el comando claude en tu terminal.
Claude Code
Configuración de API key de Claude Code
Claude Code lee dos variables de entorno para enrutar solicitudes a cualquier lugar: ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY. Apúntalas a RunAPI y ejecuta cada modelo Claude a la mitad de la tarifa oficial. Esta guía muestra los comandos exactos.
Actualizado el June 18, 2026
RunAPI Editorial
De un vistazo
¿Cómo se configura una API key personalizada en Claude Code?
Claude Code usa dos variables de entorno para decidir a dónde van las solicitudes y cómo se autentican. Establécelas con valores de RunAPI y cada solicitud se enruta a través de RunAPI con un 50% de descuento. Las tarjetas a continuación cubren lo esencial antes del tutorial completo.
Dos variables
ANTHROPIC_BASE_URL establece el endpoint. ANTHROPIC_API_KEY establece la clave. Esa es toda la configuración.
Valor del endpoint
Establece ANTHROPIC_BASE_URL en https://api.runapi.ai para que Claude Code se enrute a través de RunAPI.
Guárdalos
Añade ambos exports a tu perfil de shell o .claude.json para no tener que volver a establecerlos en cada sesión.
50% de descuento
Cada modelo Claude factura a la mitad de la tarifa oficial de Anthropic. Sin suscripción, sin límite.
Antes de empezar
¿Qué necesitas antes de configurar Claude Code?
La configuración tarda unos minutos. Necesitas Claude Code instalado, una cuenta de RunAPI y una terminal. La lista a continuación cubre todo lo necesario antes del primer comando.
Una cuenta de RunAPI
Regístrate en runapi.ai. El nivel gratuito incluye créditos para probar cualquier modelo Claude antes de fondear un saldo.
Una API key
Crea una clave desde Panel de control → API Keys. Cópiala una vez — se muestra completa solo al crearla.
Acceso a terminal
Necesitas un shell para establecer variables de entorno. macOS, Linux y WSL en Windows funcionan de la misma manera.
Paso a paso
Cómo configurar una API key de Claude Code con RunAPI
Ejecuta estos comandos en orden. Establecen el endpoint y la clave, los guardan en tu perfil de shell y confirman que Claude Code los recoge. Reemplaza el marcador de posición con tu clave real de RunAPI.
1
Establece la URL base
Esto le dice 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 API key
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
Guarda ambas variables
Añade ambos exports a ~/.zshrc (o ~/.bashrc) para que sobrevivan nuevas sesiones de terminal. Recarga con source ~/.zshrc.
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.
echo $ANTHROPIC_BASE_URL
5
Ejecuta Claude Code
Inicia 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 lista las que importan para una configuración de endpoint personalizado y qué hace cada una.
| Variable | Propósito | Valor de ejemplo |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizado al que Claude Code envía solicitudes | https://api.runapi.ai |
| ANTHROPIC_API_KEY | Clave usada 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 barato para ediciones rutinarias, uno equilibrado para la programación diaria, o el más potente para problemas difíciles.
claude-haiku-4-5
El más rápido y barato a $1/M de entrada y $5/M de salida a través de RunAPI. Ideal para ediciones rutinarias y consultas rápidas.
claude-sonnet-4-6
Predeterminado equilibrado para la programación diaria a $3/M de entrada y $15/M de salida a través de RunAPI. La mayoría de los desarrolladores usan 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. La facturación sigue el modelo que realmente llamas, todo con un 50% de descuento.
Resolución de errores comunes
¿Por qué no funciona mi API key de Claude Code?
La mayoría de los problemas de configuración provienen de una variable no establecida, un shell desactualizado o un error tipográfico en la clave. La tabla lista los errores comunes y la solución para cada uno.
| Error o síntoma | Causa probable | Solución |
|---|---|---|
| 401 Unauthorized | API key incorrecta o expirada | Verifica ANTHROPIC_API_KEY y crea una nueva clave en el panel de control de RunAPI si es necesario |
| Las solicitudes siguen llegando a Anthropic | ANTHROPIC_BASE_URL no establecida en este shell | Ejecuta echo $ANTHROPIC_BASE_URL; si está vacía, 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 como https://api.runapi.ai sin ruta al final |
| Modelo no encontrado | ID de modelo inválido o mal escrito | Usa un ID válido como claude-sonnet-4-6 o claude-opus-4-7 |
| Variables perdidas al reiniciar | Los exports no se escribieron en el perfil de shell | Añade ambos exports a ~/.zshrc o ~/.bashrc y recarga |
Versión rápida
Configuración de API key de Claude Code en cuatro pasos
1
Establece la URL base
Exporta ANTHROPIC_BASE_URL=https://api.runapi.ai para enrutar las solicitudes a través de RunAPI.
2
Establece la API key
Exporta ANTHROPIC_API_KEY con tu clave de RunAPI desde Panel de control → API Keys.
3
Guarda ambas variables
Añade ambos exports a ~/.zshrc o ~/.bashrc y recarga para que sobrevivan nuevas sesiones.
4
Ejecuta Claude Code
Inicia 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 API key de Claude Code
¿Cómo añado una API key a Claude Code?
Establece 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 para que persistan. Claude Code las lee al iniciar y enruta cada solicitud a través de RunAPI.
¿Dónde obtengo una API key para Claude Code?
Crea una en runapi.ai. Regístrate, abre Panel de control → API Keys y genera una clave. Cópiala de inmediato, ya que la clave completa solo se muestra al crearla. El nivel gratuito incluye créditos para probar cualquier modelo Claude antes de fondear un saldo.
¿Para qué sirve ANTHROPIC_BASE_URL?
Le dice a Claude Code a qué endpoint enviar las solicitudes. Por defecto, Claude Code llama directamente a Anthropic. Establecerla en https://api.runapi.ai enruta cada solicitud a través de RunAPI, que factura los mismos modelos al 50% de la tarifa oficial.
¿Por qué Claude Code sigue facturando a la tarifa completa?
La URL base probablemente no está configurada en tu shell actual. Ejecuta echo $ANTHROPIC_BASE_URL — si está vacía, el export no persistió. Añádela a ~/.zshrc o ~/.bashrc, recarga con source y luego abre una nueva terminal y verifica de nuevo.
¿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 enfoques funcionan; el archivo es más práctico para claves por proyecto, mientras que los exports son más simples para una configuración global única.
¿Cómo monitoreo el costo después de la configuración?
Abre el panel de control de RunAPI. Muestra el gasto por clave y por solicitud en tiempo real. Para limitar el costo de salida, establece CLAUDE_CODE_MAX_OUTPUT_TOKENS para que cada respuesta tenga un límite, y elige un modelo más barato como Haiku para ediciones rutinarias.
¿Esto cambia cómo se comporta Claude Code?
No. RunAPI envía las solicitudes directamente a los modelos Claude subyacentes. La salida, el uso de herramientas y el comportamiento son idénticos a la configuración predeterminada. Solo cambias dónde van las solicitudes y cómo se facturan — la experiencia de programación permanece igual.
¿Qué modelo debería configurar como predeterminado?
La mayoría de los desarrolladores establecen ANTHROPIC_MODEL en claude-sonnet-4-6 para la programación diaria. Usa claude-haiku-4-5 para ediciones rápidas y baratas o claude-opus-4-7 para refactorizaciones difíciles. Puedes cambiar de modelo dentro de Claude Code en cualquier momento, y la facturación sigue el modelo que llamas.
Apunta Claude Code a RunAPI con dos comandos.
Crea una cuenta gratuita de RunAPI, establece ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY, y ejecuta cada modelo Claude en Claude Code con un 50% de descuento sobre los precios oficiales de Anthropic.