Conecta Claude Code con HiAPI: guía completa de configuración para ahorrar $100 al mes en suscripción

Claude Code es la herramienta de programación en terminal creada por Anthropic, y su capacidad para comprender y refactorizar código está en el primer escalón entre herramientas similares. Pero tiene una barrera que hace dudar a muchos: para usar Claude Code, o pagas una suscripción Max de $200/mes, o pagas $100/mes con uso limitado. Para quienes no se pasan el día escribiendo código, esa cuota mensual fija es difícil de justificar.

La buena noticia es que Claude Code admite BYOK (Bring Your Own Key): basta con configurar dos variables de entorno para conectarlo a una API de terceros. Este artículo explica cómo usar los modelos Claude de HiAPI para impulsar Claude Code y convertir la cuota mensual fija en pago por uso.

Por qué los usuarios de Claude Code buscan claves de API de terceros

La estructura de cuota mensual de la suscripción Max no es favorable para dos tipos de personas:

Usuarios ligeros y moderados. Si solo usas Claude Code una o dos horas al día, el consumo de tokens no llega ni de lejos a justificar el valor de Max. Pagar $100/mes equivale a gastar $3 al día por una cuota que quizá solo uses $0.5.

Usuarios que ya tienen la costumbre de usar APIs. Muchos ya tienen un flujo de trabajo para gestionar claves de API, y el modelo de suscripción se convierte en una carga de gestión adicional. Prefieren "una sola clave para todas las herramientas" antes que comprar una suscripción aparte solo para Claude Code.

La ventaja del pago por uso es evidente: pagas por lo que usas y, si no lo usas, no gastas. Lo que ahorras en la cuota mensual puedes invertirlo en otros modelos o herramientas.

Cómo funciona el mecanismo BYOK de Claude Code

Al arrancar, Claude Code lee dos variables de entorno (el endpoint Anthropic Messages de HiAPI ya implementa llamadas a herramientas, respuestas en streaming y pensamiento extendido, pero la combinación Claude Code + HiAPI aún no se ha probado de extremo a extremo; se recomienda validarla primero con una tarea sencilla tras configurarla):

• ANTHROPIC_BASE_URL: la dirección del endpoint de la API. Por defecto apunta al oficial de Anthropic; si la cambias por la de un proveedor de terceros, puedes usar un endpoint personalizado.
• ANTHROPIC_API_KEY: la clave de autenticación. La clave de API generada por un proveedor de terceros suele empezar por sk-.

El principio no es complicado: todas las peticiones de Claude Code usan el protocolo Anthropic Messages API. Mientras el endpoint personalizado implemente este protocolo, Claude Code funcionará con normalidad. El endpoint /v1/messages de HiAPI es totalmente compatible con Anthropic Messages API, incluidas las llamadas a herramientas, las respuestas en streaming y el pensamiento extendido.

La configuración consiste en escribir estas dos variables en el entorno de la terminal y luego iniciar el comando claude como de costumbre. Más adelante están los pasos completos de configuración.

Por qué elegir HiAPI para conectar Claude Code

HiAPI ofrece actualmente 4 modelos Claude (precios a fecha de 2026-10), que cubren distintas situaciones y presupuestos:

Modelo	Entrada $/M	Salida $/M	Contexto
claude-opus-5-5	$2.02	$10.08	1M
claude-opus-4-8	$2.29	$11.47	200K
claude-sonnet-4-6	$3.00	$15.00	200K
claude-opus-4-8@aws	$5.74	$28.70	1M

Lo más destacado:

Opus 5.5 es el mayor atractivo. Entrada $2.02/M y salida $10.08/M, aproximadamente un 87% menos que el precio típico de un modelo de nivel Opus ($15/$75). Usar capacidad de nivel Opus para tareas complejas de refactorización cuesta mucho menos de lo esperado.

El precio de Sonnet 4.6 está a la par del oficial. Con un precio de $3/$15, no hay sobrecoste en los escenarios de programación diaria: sigues usando lo que necesitas.

Los 4 modelos tienen su función. No se trata de "usar el más barato", sino de elegir el modelo según la complejidad de la tarea; en la siguiente sección se explica cómo elegir.

Además, estos modelos Claude de HiAPI admiten a la vez los protocolos Anthropic Messages y OpenAI Chat. Claude Code usa el protocolo Messages, y otras herramientas compatibles con la interfaz de OpenAI (como Cursor o Codex CLI) también pueden conectarse: una sola clave cubre varios entornos de programación.

Pasos de configuración (listo en 5 minutos)

1. Obtén la clave de API de HiAPI

Inicia sesión en HiAPI, entra en la página «API Key» de la consola y crea una clave nueva. La clave empieza por sk-; cópiala y guárdala en cuanto la crees.

Si no tienes cuenta, regístrate primero y completa la configuración básica.

2. Configura las variables de entorno

Ejecuta en la terminal:

export ANTHROPIC_BASE_URL=https://api.hiapi.ai
export ANTHROPIC_API_KEY=sk-<tu clave de HiAPI>

Sustituye <tu clave de HiAPI> por la clave obtenida en el paso anterior.

Se recomienda añadir estas dos líneas al archivo de configuración del shell (~/.zshrc o ~/.bashrc) para no tener que escribirlas cada vez que abras una terminal:

echo 'export ANTHROPIC_BASE_URL=https://api.hiapi.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-<tu clave de HiAPI>' >> ~/.zshrc
source ~/.zshrc

3. Inicia Claude Code

claude

Al arrancar, Claude Code leerá automáticamente estas dos variables de entorno y enviará las peticiones a HiAPI. Si todo va bien, podrás usar Claude Code como de costumbre; la única diferencia es que el backend ahora es HiAPI.

4. Verifica

Tras iniciarlo, introduce una tarea sencilla para probar, por ejemplo "lista los archivos del directorio actual", y confirma que la respuesta llega bien y que la salida en streaming es fluida. Si hay problemas, comprueba que las variables de entorno estén bien configuradas:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

Cómo elegir el modelo: Sonnet vs Opus

El error más habitual de los principiantes es "si hay Opus, uso Opus". En realidad, elegir el modelo según la tarea es más importante que elegirlo según el precio. A continuación tienes recomendaciones por escenario:

Programación diaria → claude-sonnet-4-6. Escribir código, corregir bugs, añadir funcionalidades, entender la estructura del proyecto. La velocidad de respuesta de Sonnet es suficiente y su capacidad cubre la gran mayoría de las necesidades de programación diaria. El precio está a la par del oficial, pero como no hay un umbral de $100 al mes, el gasto real es mucho menor.

Refactorización compleja / cambios entre archivos → claude-opus-5-5. Ajustes de arquitectura que afectan a varios archivos y tareas que exigen comprender a fondo la lógica del código. Opus 5.5 es el más capaz y cuesta solo $2.02/$10.08, la opción Opus con mejor relación calidad-precio actualmente. Su contexto de 1M también basta para proyectos grandes.

Tareas complejas de carácter general → claude-opus-4-8. Está entre Sonnet y Opus 5.5. Su precio de $2.29/$11.47 también es amigable. Es la "versión potenciada por defecto" para cuando no quieres complicarte eligiendo modelo.

Necesitas contexto de 1M pero no puedes usar Opus 5.5 → claude-opus-4-8@aws. Es la versión de gran contexto de Opus 4.8; su precio es más alto ($5.74/$28.70) y encaja en análisis globales de repositorios de código muy grandes. En escenarios normales, prioriza Opus 5.5.

Resumen en una frase: para el día a día, Sonnet; para tareas complejas, cambia a Opus 5.5. Si calculas el gasto por día, un uso moderado ronda $1-3/día, mucho más flexible que una suscripción de $100/mes.

Sobre el coste: la cantidad de tokens que consume Claude Code varía mucho en cada conversación. Una pregunta sencilla puede ser de cientos de tokens, mientras que una refactorización compleja puede llegar a decenas de miles. Se recomienda evaluar durante una semana el uso real para decidir si compensa frente a la suscripción, sin fijarse solo en la tabla de precios. La consola de HiAPI ofrece estadísticas de uso para seguir el consumo real.

FAQ

¿De verdad se puede usar una clave de API de terceros con Claude Code?

Sí. Anthropic ofrece oficialmente la variable de entorno ANTHROPIC_BASE_URL en Claude Code precisamente para admitir endpoints personalizados. No es un hack ni un uso no oficial.

¿Faltan funcionalidades en Claude Code tras la configuración?

Las funciones principales (lectura y escritura de código, ejecución en terminal, llamadas a herramientas, conversación) usan el protocolo Anthropic Messages API y no se ven afectadas. El endpoint de HiAPI implementa este protocolo por completo. Si aparece un comportamiento extraño, comprueba primero si la clave de API es válida y si las variables de entorno son correctas.

¿Qué hago si Claude Code da error tras la configuración?

El problema más común es que las variables de entorno no hayan surtido efecto. Confirma que echo $ANTHROPIC_BASE_URL devuelve algo en la sesión actual de la terminal. Si usas la aplicación de escritorio de Claude Code en lugar de la versión de terminal, la forma de aplicar las variables de entorno es distinta; consulta el método de configuración de variables de entorno de Claude Code para tu plataforma.

¿Cuánto se puede ahorrar al mes?

Suponiendo que uses Claude Code 2-3 horas al día, con el precio de Sonnet 4.6 el consumo diario de tokens ronda $1-3, lo que supone un gasto mensual de unos $30-90. Frente a la suscripción Max de $100/mes, un usuario ligero o moderado puede ahorrar entre un 40% y un 70%.

El caso de los usuarios intensivos (programar todo el día, muchas refactorizaciones) hay que medirlo: $100/mes es la línea divisoria; si el gasto real de API supera esa cifra, la suscripción Max resulta más rentable. Se recomienda conectar primero una clave de terceros durante una semana y comparar el coste real de tokens con el precio de la suscripción Max antes de decidir.

¿Se pueden usar otros modelos de HiAPI (GPT, DeepSeek, etc.) con Claude Code?

No. Claude Code es una herramienta de Anthropic y solo funciona con la serie de modelos Claude. Sin embargo, los modelos que no son Claude de HiAPI pueden usarse en otras herramientas de programación compatibles con la interfaz de OpenAI (como Codex CLI o Cursor), y la misma clave cubre varias herramientas.

¿Hay límite de velocidad al usar los modelos Claude de HiAPI?

HiAPI aplica límites de velocidad a las claves de API; consulta los valores concretos en la consola. En escenarios de programación normales no se alcanzan los límites. Si vas a usarlo de forma continua e intensiva durante mucho tiempo, comprueba antes en la consola el límite actual.

---

Si eliges HiAPI para conectar Claude Code, el mayor cambio no es el ahorro en sí, sino no tener que pagar una cuota mensual aparte por una sola herramienta. Una clave sirve para Claude Code y también para otros entornos de programación, volviendo a la lógica sencilla de pagar por uso.

Ver detalles del modelo Claude Sonnet 4.6 · Ver detalles del modelo Claude Opus 5.5