# Zeabur AI Hub + OpenCode: Programación AI de Pago por Uso

> Olvídate de las suscripciones mensuales. Conecta OpenCode a Zeabur AI Hub para acceder a GPT-5 y Claude 4.5 en tu terminal con una API unificada.

<AIHubShutdownNotice />

Imagina una herramienta tan potente como **[Claude Code](https://zeabur.com/blogs/use-claude-code-with-ai-hub)**, pero con la capacidad de cambiar de modelo desde **GPT-5** a **Claude Sonnet 4.5** al instante, sin gestionar manualmente múltiples suscripciones y claves API.

[**OpenCode**](https://opencode.ai) se ha convertido en el **OpenCode CLI** de referencia para desarrolladores que buscan un **asistente de programación GPT-5 en terminal**. Sin embargo, configurarlo eficazmente requiere la infraestructura adecuada. Al integrar **Zeabur AI Hub**, los desarrolladores pueden desbloquear un modelo de pago por uso que proporciona acceso a los mejores LLM sin la carga de cuotas mensuales fijas.

En este artículo, explicaremos qué son OpenCode CLI y [Zeabur AI Hub](https://zeabur.com/models), y te guiaremos a través del proceso de configuración para obtener una **clave API LLM unificada para desarrolladores**.

## ¿Qué es OpenCode?

![OpenCode Logo ](https://cdn.zeabur.com/opencode.png)

OpenCode es un asistente de programación de código abierto diseñado para vivir en tu terminal. A diferencia de las herramientas propietarias que te encierran en un modelo específico, OpenCode es **agnóstico en cuanto al proveedor**. Esto te permite dirigir tus consultas de código a OpenAI, Anthropic o endpoints personalizados. Su flexibilidad lo convierte en el favorito de los desarrolladores que valoran la privacidad y el control de sus datos.

## ¿Qué es Zeabur AI Hub?

**Zeabur** es una plataforma de despliegue moderna que simplifica la infraestructura para desarrolladores. **Zeabur AI Hub** actúa como una pasarela API unificada que agrega varios proveedores de LLM (como OpenAI y Anthropic) en un solo endpoint.

Esta infraestructura unificada es versátil: no solo impulsa OpenCode, sino también otras integraciones avanzadas como **[Codex](https://zeabur.com/blogs/use-codex-with-ai-hub)**, asegurando una experiencia consistente en todas tus herramientas de IA.

**Beneficios clave de esta integración:**

*   **Precios de Zeabur vs OpenAI:** En lugar de pagar 20 $/mes por ChatGPT Plus *y* 20 $/mes por Claude Pro, obtienes una experiencia de **Claude Sonnet 4.5 de pago por uso**. Solo pagas por lo que usas.
*   **Latencia de velocidad Edge:** Los competidores a menudo sufren retrasos de enrutamiento. Zeabur utiliza endpoints enrutados en el borde (Edge) en Tokio y San Francisco para asegurar que la finalización de tu código sea significativamente más rápida.
*   **Acceso Unificado:** Deja de hacer malabares con las claves. Accede a múltiples modelos de última generación con una sola clave API.

## Guía Paso a Paso: Conectar OpenCode a Zeabur

Sigue este tutorial para configurar tu entorno en menos de 2 minutos.

### Requisitos Previos

1.  **Instalar OpenCode CLI**:
    Asegúrate de tener la herramienta instalada en tu máquina.
    ```bash
    npm install -g opencode
    ```

2.  **Credenciales de Zeabur**:
    *   Ve a tu Dashboard de Zeabur para generar tu **AI Hub API Key**.

3.  **Elige tu Endpoint**:
    Para la menor latencia, elige el endpoint más cercano a tu ubicación:
    *   **Asia (Tokio):** `https://hnd1.aihub.zeabur.ai/`
    *   **EE. UU. Oeste (San Francisco):** `https://sfo1.aihub.zeabur.ai/`

---

## Cómo Configurar el Proveedor en OpenCode

OpenCode utiliza un archivo de configuración para gestionar proveedores personalizados. Añadiremos Zeabur como un proveedor compatible para permitir el cambio de modelos.

### 1. Editar el Archivo de Configuración

Crea o edita el archivo de configuración situado en `~/.config/opencode/config.json`.

```bash
# Abre el archivo de configuración en tu editor preferido
nano ~/.config/opencode/config.json
```

Pega la siguiente configuración. **Nota:** Puedes cambiar la `baseURL` por el endpoint de EE. UU. (`sfo1`) si estás en América.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zeabur": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zeabur AI Hub",
      "options": {
        "baseURL": "https://hnd1.aihub.zeabur.ai/"
      },
      "models": {
        "claude-sonnet-4-5": {
          "name": "Claude Sonnet 4.5"
        },
        "claude-haiku-4-5": {
          "name": "GPT-5-Codex"
        },
        "gpt-5":{
            "name": "GPT 5"
        }
      }
    }
  }
}
```

Guarda el archivo y sal.

### 2. Conectar el CLI

Ahora que la configuración está lista, necesitas autenticarte usando el CLI de OpenCode.

1.  Ejecuta la herramienta:
    ```bash
    opencode
    ```
2.  Introduce el comando de conexión:
    ```bash
    /connect
    ```
3.  Selecciona **Zeabur AI Hub** de la lista de proveedores.
4.  Pega tu **Zeabur AI Hub API Key** cuando se te solicite.

---

## 🚀 Empieza a Programar

¡Ya estás conectado! Puedes cambiar entre los últimos modelos sin cambiar de claves API.

**Por qué los desarrolladores prefieren esta configuración:**

*   **Acceso a Poder No Publicado:** Transforma tu terminal en un **asistente GPT-5** al instante.
*   **Eficiencia de Costes:** Disfruta del acceso a **Claude Sonnet 4.5 con pago por uso**. Si no programas durante una semana, pagas 0 $.
*   **Flexibilidad:** Cambia de GPT a Claude a mitad de proyecto para ver qué modelo resuelve tu bug más rápido.

¡Feliz Código!
