# 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.

*Updated June 18, 2026 · RunAPI Editorial*

## ¿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://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.

## ¿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.

### 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.

### 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.


## 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.

## ¿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://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 |

## ¿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.


## ¿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://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 |

## Cómo configurar una clave API de Claude Code con RunAPI

1. **Establece la URL base** — Exporta ANTHROPIC_BASE_URL=https://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 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://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://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.