Cómo configurar Claude Code con WaveSpeed LLM (endpoint compatible con OpenAI)

Claude Code Sin una Clave de Anthropic

Claude Code es el CLI oficial de Anthropic para programar con Claude — pero no tienes que enrutar las solicitudes a través de la API de Anthropic. Si ya tienes una cuenta de WaveSpeed, puedes apuntar Claude Code a WaveSpeed LLM y obtener acceso a Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek y más de 290 modelos a través de un único endpoint compatible con OpenAI.

Esta guía cubre las variables de entorno exactas, la URL base y el formato de ID de modelo que necesitas.

Por Qué Enrutar Claude Code a Través de WaveSpeed

• Una sola factura, muchos modelos. Claude, GPT, Gemini, Llama, Qwen — todo facturado a través de tu cuenta de WaveSpeed.
• Compatible con OpenAI en todas partes. No es necesario malabarear claves de API de Anthropic, OpenAI y Google por separado.
• Sin arranques en frío. Latencia consistente bajo carga, igual que la API nativa de Anthropic.
• Portabilidad de modelos. Cambia de Claude Opus a GPT-5.2 a mitad de sesión modificando una sola variable de entorno.

Lo Que Necesitas

Campo	Valor
URL Base	https://llm.wavespeed.ai/v1
Clave API	Tu clave API de WaveSpeed
Protocolo	OpenAI Chat Completions
Formato de ID de modelo	vendor/model (p. ej., anthropic/claude-opus-4.6)

Paso 1: Instala Claude Code

Si aún no lo tienes:

npm install -g @anthropic-ai/claude-code

Paso 2: Obtén Tu Clave API de WaveSpeed

1. Inicia sesión en wavespeed.ai.
2. Abre el panel → API Keys.
3. Crea una nueva clave y cópiala.

Paso 3: Configura Claude Code para Usar WaveSpeed

Claude Code admite endpoints personalizados compatibles con OpenAI mediante variables de entorno. Configúralas antes de iniciar:

macOS / Linux

export ANTHROPIC_BASE_URL="https://llm.wavespeed.ai/v1"
export ANTHROPIC_API_KEY="YOUR_WAVESPEED_API_KEY"
export ANTHROPIC_MODEL="anthropic/claude-opus-4.6"

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://llm.wavespeed.ai/v1"
$env:ANTHROPIC_API_KEY = "YOUR_WAVESPEED_API_KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-4.6"

Para hacerlas persistentes, agrégalas a tu ~/.zshrc, ~/.bashrc o a las variables de entorno de Windows.

Paso 4: Inicia Claude Code

claude

Claude Code enrutará cada solicitud a través de WaveSpeed LLM usando el modelo que configuraste. Verás respuestas de streaming normales — sin diferencia con la API nativa de Anthropic.

Cambiar de Modelos a Mitad de Proyecto

Como los más de 290 modelos comparten un único endpoint, cambiar es una modificación de una sola línea. Abre un nuevo shell con un modelo diferente:

export ANTHROPIC_MODEL="openai/gpt-5.2-pro"
claude

O prueba una alternativa de código abierto:

export ANTHROPIC_MODEL="deepseek/deepseek-v4"
claude

Útil cuando quieres comparar cómo diferentes modelos manejan el mismo código base.

Modelos Recomendados para Claude Code

No todos los modelos están optimizados para programación agéntica. Estos funcionan bien:

ID de Modelo	Mejor Para
anthropic/claude-opus-4.6	Predeterminado — la mejor codificación de contexto largo y uso de herramientas
anthropic/claude-sonnet-4.6	Claude más rápido y económico para tareas del día a día
openai/gpt-5.2-pro	Mejor rendimiento de razonamiento alternativo
openai/gpt-5.2-chat	Velocidad y calidad equilibradas
deepseek/deepseek-v4	Programador de código abierto sólido, menor costo

Solución de Problemas

“Invalid API key” / 401 Asegúrate de que ANTHROPIC_API_KEY esté configurada con tu clave de WaveSpeed, no una clave de Anthropic. Claude Code la envía como token bearer a cualquier URL a la que apunte ANTHROPIC_BASE_URL.

“Model not found” Incluye siempre el prefijo del proveedor. anthropic/claude-opus-4.6 funciona; claude-opus-4.6 no.

Las solicitudes siguen yendo a api.anthropic.com ANTHROPIC_BASE_URL debe estar configurada en el mismo shell desde el que lanzas claude. Verifica con:

echo $ANTHROPIC_BASE_URL

Si está vacío, vuelve a exportarla o recarga la configuración de tu shell.

El uso de herramientas / llamadas a funciones no funciona Asegúrate de que el modelo que elegiste admita herramientas. anthropic/claude-opus-4.6 y openai/gpt-5.2-pro lo hacen; algunos modelos más pequeños no.

Precios

Pagas la tarifa por token de WaveSpeed para el modelo que selecciones — sin cargos adicionales por Claude Code. Compara precios en wavespeed.ai/llm. Claude Opus 4.6 cuesta $5/M tokens de entrada, $25/M de salida. Los modelos más pequeños bajan de $1/M.

Por Qué Funciona Esta Configuración

La opción ANTHROPIC_BASE_URL de Claude Code fue diseñada para que los equipos pudieran enrutar a través de proxies, gateways y capas de autenticación empresarial. WaveSpeed LLM es un gateway compatible con OpenAI, y Claude Code acepta el protocolo OpenAI Chat Completions cuando se apunta a uno — por lo que la configuración funciona de forma limpia.

Empieza a Programar Hoy

Tres variables de entorno y ya tienes Claude Code ejecutándose en más de 290 modelos con una sola factura.

Obtén tu clave API de WaveSpeed y apunta Claude Code a https://llm.wavespeed.ai/v1 en minutos.