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

> Usa Claude Code CLI mediante pago por uso con Zeabur. Sin suscripción mensual.

<AIHubShutdownNotice />

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**:
    
    ```bash
    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:

```bash
# 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`):
    
    ```bash
    nano ~/.zshrc
    ```
    
2.  Pega estas líneas al final:
    
    ```bash
    # 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.

```bash
# 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!