Respuesta corta
Para usar Claude Code a través de APIVAI, define dos variables de entorno: ANTHROPIC_BASE_URL="https://api.apivai.com" y ANTHROPIC_AUTH_TOKEN="<tu clave>", y arranca claude como siempre. Claude Code acepta cualquier clave de API compatible con Anthropic a través de ANTHROPIC_AUTH_TOKEN. Claude Code no cambia; las solicitudes van a los mismos modelos Claude y se cobran desde un saldo prepago a precios de APIVAI, por ejemplo $1.14 / $5.68 por millón de tokens de entrada / salida para Claude Sonnet 4.6 (a fecha de 2026-11-18), es decir, 62% por debajo del precio de lista oficial.
La configuración lleva unos cinco minutos.
¿Qué es Claude Code?
Claude Code es el agente de programación de línea de comandos de Anthropic. Lo ejecutas dentro de la carpeta de un proyecto, describes una tarea en lenguaje natural y él lee tus archivos, propone y aplica cambios, ejecuta comandos como tests o builds y explica lo que hizo. Anthropic recomienda su instalador nativo (curl -fsSL https://claude.ai/install.sh | bash en macOS y Linux, irm https://claude.ai/install.ps1 | iex en Windows PowerShell); el paquete npm @anthropic-ai/claude-code sigue funcionando y requiere Node.js 22 o posterior. Está documentado en la documentación de Claude Code de Anthropic.
Cada paso que da Claude Code es una solicitud de API a un modelo Claude, y un agente que trabaja sobre un código real envía mucho contexto en cada solicitud. Por eso el precio por token importa más en Claude Code que en un uso ocasional del chat. Por defecto, se cobra a través de la API de Anthropic a precios de lista ($3.00 / $15.00 por millón de tokens para Claude Sonnet 4.6). Para una visión más amplia de las cifras, consulta cómo reducir el coste de Claude Code y de la API de GPT.
¿Cómo funciona un proveedor de API personalizado con Claude Code?
Claude Code lee su configuración de conexión de variables de entorno:
ANTHROPIC_BASE_URL: adónde se envían las solicitudes. Para APIVAI eshttps://api.apivai.com, sin/v1y sin barra final, porque Claude Code añade/v1/messagespor su cuenta.ANTHROPIC_AUTH_TOKEN: la clave que se envía con cada solicitud.
Lo que cambia: la dirección y la clave. Lo que sigue igual: Claude Code, sus comandos, herramientas, permisos y los modelos Claude con los que habla.
Requisitos previos
- Claude Code instalado (instalador nativo, o npm con Node.js 22+;
claude --versiondebería mostrar una versión) - Una cuenta de APIVAI con saldo recargado
- Una clave de API creada en el Dashboard de APIVAI
- Una terminal: bash o zsh en macOS/Linux, PowerShell o cmd en Windows
Paso 1: consigue una clave de API para Claude Code
- Crea una cuenta con tu correo y el código de verificación que recibas.
- Recarga tu saldo. El mínimo es $10 con tarjeta o criptomonedas, o ¥20 con Alipay / WeChat Pay. No hay suscripción ni mínimo mensual.
- En el Dashboard, crea una clave de API. Ponle un nombre como "claude-code-laptop" y fija un presupuesto. Cuando la clave llega a su presupuesto deja de funcionar, así que una sesión descontrolada no puede gastar todo tu saldo.
- Copia la clave y mantenla en privado. Usa una clave distinta por máquina o por proyecto para ver los costes por separado y revocar una sin afectar a las demás.
Paso 2: configura tu terminal
macOS y Linux
Añade estas líneas a tu perfil del shell, ~/.zshrc (por defecto en macOS) o ~/.bashrc:
export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="your-apivai-key"
Recarga el perfil y arranca Claude Code:
source ~/.zshrc # o: source ~/.bashrc claude
Windows PowerShell
Abre tu perfil con notepad $PROFILE (crea el archivo si PowerShell dice que no existe) y añade:
$env:ANTHROPIC_BASE_URL = "https://api.apivai.com" $env:ANTHROPIC_AUTH_TOKEN = "your-apivai-key"
Abre una nueva ventana de PowerShell y ejecuta claude.
Windows cmd
setx guarda las variables de entorno del usuario de forma permanente:
setx ANTHROPIC_BASE_URL "https://api.apivai.com" setx ANTHROPIC_AUTH_TOKEN "your-apivai-key"
setx no cambia la ventana en la que lo ejecutaste; se aplica a las terminales que abras después. Cierra la ventana, abre una nueva y ejecuta claude. Las variables definidas así también son visibles para PowerShell.
Alternativa: el archivo de configuración de Claude Code
En lugar de variables del shell, puedes ponerlas en el archivo de configuración de usuario de Claude Code, ~/.claude/settings.json (en Windows, %USERPROFILE%\.claude\settings.json), dentro de un objeto env:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apivai.com",
"ANTHROPIC_AUTH_TOKEN": "your-apivai-key"
}
}Si el archivo ya existe, añádele el bloque env en lugar de reemplazarlo. Así la configuración solo afecta a Claude Code. Las rutas de los archivos y su prioridad pueden cambiar entre versiones, así que consulta la documentación de configuración de Claude Code de Anthropic para los detalles actuales.
Paso 3: verifica la clave antes de arrancar Claude Code
Una solicitud directa te dice si la clave, la URL y tu red están bien, antes de que intervenga Claude Code. En macOS/Linux, con las variables del paso 2 cargadas:
curl https://api.apivai.com/v1/messages \
-H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'En PowerShell:
$body = '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'
Invoke-RestMethod -Uri "https://api.apivai.com/v1/messages" -Method Post -ContentType "application/json" -Headers @{ "x-api-key" = $env:ANTHROPIC_AUTH_TOKEN; "anthropic-version" = "2023-06-01" } -Body $bodyUna respuesta JSON con un campo content significa que todo funciona, y la solicitud aparece en tu Dashboard en unos instantes. Un código de error te lleva a la fila correspondiente de la tabla de solución de problemas de abajo. Ten en cuenta que la URL de prueba contiene /v1/messages, mientras que ANTHROPIC_BASE_URL no debe contenerlo.
¿Cómo elijo y cambio de modelo?
Escribe /model dentro de Claude Code para elegir el modelo de la sesión actual. Las opciones principales, a fecha de 2026-11-18 (lista completa en la página de precios):
| Modelo | Precio APIVAI por 1M (entrada / salida) | Ideal para |
|---|---|---|
| Claude Fable 5.1 | $3.97 / $19.87 | Los problemas más difíciles, tareas autónomas largas |
| Claude Opus 5.5 | $1.52 / $7.57 | Programación compleja, refactorizaciones, análisis |
| Claude Sonnet 5.5 | $0.75 / $3.79 | Programación diaria: la opción recomendada por defecto |
| Claude Sonnet 4.6 | $1.14 / $5.68 | Muy compatible; Sonnet 5.5 es más nuevo y más barato |
| Claude Haiku 4.5 | $0.38 / $1.89 | Ediciones rápidas y preguntas sencillas |
Un patrón práctico: empieza con Sonnet, cambia a Opus con /model cuando una tarea se atasque o necesite un razonamiento más profundo, y vuelve cuando esté resuelta.
¿Cómo mantengo bajo el coste de Claude Code?
- Usa Sonnet para el trabajo rutinario. La mayoría de los cambios, tests y explicaciones no necesitan Opus ni Fable, y Sonnet cuesta una fracción de ellos por token.
- Compacta las sesiones largas. Claude Code tiene un comando
/compactque resume la conversación hasta el momento, para que las solicitudes posteriores lleven menos contexto. Úsalo cuando una sesión se haya alargado, o empieza una sesión nueva para una tarea nueva (consulta la documentación de Anthropic para el comportamiento actual de los comandos). - Deja que funcione el prompt caching. Claude Code cachea automáticamente el contexto repetido, como los prompts de sistema y los archivos. La entrada cacheada se cobra a la tarifa de lectura de caché ($0.11 por 1M para Claude Sonnet 4.6), muy por debajo de la entrada normal.
- Fija un presupuesto por clave. Una clave se detiene al llegar a su presupuesto, lo que limita el coste de cualquier máquina, proyecto o compañero.
- Vigila el Dashboard. Cada solicitud aparece con su modelo, tokens y coste, para que veas qué sesiones salen caras.
Usar Codex CLI con la misma clave
La misma clave de APIVAI funciona con Codex CLI de OpenAI, que usa el formato OpenAI con /v1 en la base URL. Para Codex 0.121 y posteriores, pon esto en ~/.codex/config.toml (en Windows, %USERPROFILE%\.codex\config.toml):
model = "gpt-6.1-sol" model_provider = "apivai" [model_providers.apivai] name = "APIVAI" base_url = "https://api.apivai.com/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"
Después define la clave y arranca Codex:
export OPENAI_API_KEY="your-apivai-key" codex
La misma idea funciona en Cursor; consulta la guía de configuración de Cursor.
Solución de problemas
| Síntoma | Causa probable | Solución |
|---|---|---|
| 401 Unauthorized | Clave incorrecta o eliminada | Vuelve a copiar la clave desde el Dashboard |
| 402 insufficient_quota | El presupuesto de la clave se agotó o es demasiado bajo para este modelo | Añade presupuesto a la clave (recarga primero si tu saldo está vacío) o usa un modelo más barato |
| 401 incluso con una clave correcta | Claude Code está enviando otra credencial: una ANTHROPIC_API_KEY antigua, un apiKeyHelper o una sesión de /login (/status muestra cuál está activa) | Elimina la que sobra, por ejemplo: unset ANTHROPIC_API_KEY (bash/zsh), Remove-Item Env:ANTHROPIC_API_KEY (PowerShell), y quítala de los perfiles o de la configuración |
| 404 Not Found | La base URL contiene /v1 o una errata | Usa exactamente https://api.apivai.com para Claude Code; /v1 solo para herramientas con formato OpenAI como Codex |
| 429 Too Many Requests | Más de 60 solicitudes por minuto en una clave | Espera un momento o reparte el trabajo entre varias claves |
| Claude Code sigue usando la cuenta antigua | Las variables no están cargadas en esta terminal | Abre una terminal nueva; compruébalo con echo $ANTHROPIC_BASE_URL o echo $env:ANTHROPIC_BASE_URL |
| Timeouts o errores de conexión | Un proxy, un firewall o una inspección TLS en tu red | Permite api.apivai.com, o define el proxy de tu red en HTTPS_PROXY (consulta la documentación de Anthropic sobre el soporte de proxy en Claude Code) |
Si un problema persiste, ejecuta la prueba con curl del paso 3; separa los problemas de clave y de red de la configuración de Claude Code. La documentación lista todos los endpoints y errores.
Todos los códigos de error de la API y sus soluciones están reunidos en códigos de error de la API de Claude.
¿Cuánto cuesta Claude Code al mes?
Suponiendo unos 4.000 tokens de entrada y 1.500 de salida por mensaje con Claude Sonnet 4.6, durante 30 días, a fecha de 2026-11-18:
| Uso diario | API oficial | APIVAI |
|---|---|---|
| Ligero (10 mensajes/día) | $10.35 | $3.92 |
| Medio (30 mensajes/día) | $31.05 | $11.77 |
| Intenso (100 mensajes/día) | $104 | $39.24 |
Estas cifras no tienen en cuenta el prompt caching, que suele bajar aún más la factura real. Las sesiones de agente sobre repositorios grandes pueden enviar mucho más contexto por mensaje, así que revisa tu Dashboard tras los primeros días. Los precios actuales están en la página de precios; para una comparación con herramientas por suscripción, consulta el coste de Claude Code frente a Cursor.
FAQ
¿Necesito una cuenta de Anthropic para usar Claude Code así?
No hace falta una clave de API de Anthropic. Claude Code envía las solicitudes a la base URL que definas y se autentica con tu clave de APIVAI.
¿El modelo es el mismo que en la API oficial?
Sí. Las solicitudes pasan a los modelos Claude que elijas con /model; solo cambian la dirección y la facturación.
¿Puedo volver a mi cuenta de Anthropic?
Sí. Elimina o comenta las dos variables (o el bloque env de settings.json) y abre una terminal nueva.
¿APIVAI ve mi código?
APIVAI no guarda ni inspecciona el contenido de las solicitudes ni de las respuestas. Solo conserva los metadatos de uso (modelo, número de tokens, coste, hora) para la facturación.
¿Qué pasa cuando se agota mi saldo o el presupuesto de la clave?
Las solicitudes devuelven 402 hasta que recargues o subas el presupuesto de la clave. No se cobra nada más allá de tu saldo prepago.
¿Una clave sirve para Claude Code y Codex a la vez?
Sí. Una clave funciona con el formato Anthropic (https://api.apivai.com) y con los formatos OpenAI (https://api.apivai.com/v1).