Cómo usar Claude Code CLI sin la suscripción mensual de 20 $

Anthropic ha lanzado nuestra herramienta de programación favorita: Claude Code, una increíble herramienta CLI que te permite programar directamente en tu terminal con la asistencia de la IA. Por lo general, acceder a los mejores modelos (como el nuevo Sonnet o Haiku 4.5) requiere una suscripción a Claude Pro (20 $/mes).

¿Pero qué pasa si solo quieres probarlo? ¿O si no programas lo suficiente como para justificar otra factura mensual?

Al conectar la CLI de Claude a Zeabur AI Hub, puedes utilizar exactamente la misma herramienta bajo un modelo de pago por uso (pay-as-you-go). Sin cuotas fijas: solo pagas por los tokens que realmente utilizas.

Aquí te explicamos cómo configurarlo en menos de 2 minutos.

🧱 Requisitos previos

1. Instalar Claude Code:

   bashCopiar

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

2. Credenciales de Zeabur:

   • Ve a tu Panel de Control de Zeabur (Dashboard) para obtener tu AI Hub API Key.

3. Elige tu Endpoint

   Zeabur ofrece actualmente dos endpoints. Para obtener el tiempo de respuesta más rápido en tu terminal, elige el que esté geográficamente más cerca de ti:

   • Asia (Tokio): https://hnd1.aihub.zeabur.ai/
   • Oeste de EE. UU. (San Francisco): https://sfo1.aihub.zeabur.ai/

⚙️ Guía de configuración rápida

Necesitas apuntar la CLI de Claude al servidor de Zeabur en lugar del servidor predeterminado de Anthropic.

Nota: También debes establecer CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. Sin esta variable, Claude Code envía cabeceras beta experimentales que el gateway de AI Hub aún no admite, lo que provoca un error invalid beta flag.

Opción A: Solo para probar (Temporal)

Si quieres probarlo en una sola sesión sin guardar ninguna configuración:

# Elige hnd1 (Asia) o sfo1 (EE. UU.)
export ANTHROPIC_BASE_URL="https://hnd1.aihub.zeabur.ai/"
export ANTHROPIC_AUTH_TOKEN="Tu_Zeabur_AI_Hub_API_Key"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Opción B: Configuración permanente

Si quieres usarlo siempre que lo necesites, añádelo a tu perfil.

1. Abre la configuración de tu shell (por ejemplo, ~/.zshrc):

   bashCopiar

   nano ~/.zshrc

2. Pega estas líneas al final:

   bashCopiar

   # Elige hnd1 (Asia) o sfo1 (EE. UU.)
   export ANTHROPIC_BASE_URL="https://hnd1.aihub.zeabur.ai/"
   export ANTHROPIC_AUTH_TOKEN="Tu_Zeabur_AI_Hub_API_Key"
   export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

3. Guarda (Ctrl+O -> Intro) y Sal (Ctrl+X).

4. Recarga tu configuración: source ~/.zshrc

💸 Empieza a programar (y a ahorrar)

Ahora puedes ejecutar la herramienta CLI. Obtendrás toda la potencia de Claude sin las ataduras de la suscripción.

# Ejecutar con los últimos modelos
claude --model claude-sonnet-4-5

Por qué esto es mejor para usuarios ocasionales:

• Suscripción oficial: 20 $/mes (tarifa plana).
• Método Zeabur: Pagas ~0,50 $ si solo lo usas para un proyecto de fin de semana. 0 $ si no programas ese mes.

¡Feliz programación!