> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AIHubMix CLI (herramienta de línea de comandos)

> AIHubMix CLI es la herramienta de línea de comandos oficial de AIHubMix: un único binario, sin dependencias, que permite consultar el saldo de la cuenta, gestionar claves API y ver los modelos disponibles directamente en el terminal, con salida amigable para scripts y agentes de IA.

**AIHubMix CLI** es la herramienta de línea de comandos oficial de AIHubMix (ejecutable `aihubmix`). Una vez instalada, puedes consultar el saldo de la cuenta, gestionar claves API y ver los modelos disponibles directamente en el terminal, sin necesidad de abrir la consola web. Es un único binario, **no requiere instalar Python, Node ni Go**, y se instala con un solo comando; todos los comandos admiten salida JSON, lista para integrarse con scripts, CI y agentes de IA (como Claude Code).

**Qué puede hacer:**

* **Consultar saldo**: consulta en tiempo real el saldo de la cuenta y la cuota utilizada
* **Gestionar Keys**: crea, consulta, busca, modifica y elimina claves API
* **Ver modelos**: lista los modelos disponibles para el token actual
* **Apto para scripts**: salida JSON + códigos de salida estables, ideal para automatización y agentes de IA

<Info>
  **No confundas las dos credenciales**: el CLI inicia sesión con el «token de acceso al sistema» (Manage Key, formato `fd***`); obtenlo en la consola [console.aihubmix.com/setting](https://console.aihubmix.com/setting) haciendo clic en «Generar token de acceso al sistema». Se usa para **gestionar la cuenta** y **no** es lo mismo que la clave API (`sk-***`) que usas para llamar a los modelos.
</Info>

<Tip>
  ¿Buscas el antiguo script Python (`aihubmix_cli.py`)? Consulta [Obtener información de la cuenta vía API](/es/api/Cli). Esta página describe su reemplazo de nueva generación: más simple y más rápido.
</Tip>

## Instalación

### Instalación rápida (recomendada)

Copia el comando correspondiente a tu sistema, pégalo en el terminal y ejecútalo: descargará el binario y lo añadirá automáticamente al `PATH`:

<CodeGroup>
  ```bash macOS / Linux theme={null}
  curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
  ```

  ```powershell Windows PowerShell theme={null}
  irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
  ```
</CodeGroup>

Tras la instalación, **abre un nuevo terminal** y ejecuta `aihubmix login` para empezar a usarlo.

<Info>
  También puedes descargar manualmente el binario de tu plataforma desde [Releases](https://github.com/AIhubmix/platfrom-cli/releases) (en Windows: `aihubmix_windows_amd64.exe`) y colocarlo en un directorio del `PATH`; en sistemas tipo Unix ejecuta `chmod +x`.
</Info>

Cuando lo necesites, puedes ajustar el comportamiento de instalación con variables de entorno:

| Variable           | Descripción                                      | Valor por defecto                                                               |
| ------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------- |
| `AIHUBMIX_VERSION` | Instala una versión específica (p. ej. `v0.2.0`) | `latest`                                                                        |
| `AIHUBMIX_BIN_DIR` | Directorio de instalación personalizado          | Unix: `/usr/local/bin` o `~/.local/bin`; Windows: `%LOCALAPPDATA%\aihubmix\bin` |

## Inicio rápido

Una vez iniciada la sesión, puedes usar todos los comandos:

```bash theme={null}
# 1. Iniciar sesión: abre el navegador en la página de generación del token, pega el Manage Key (la entrada no se muestra)
aihubmix login

# 2. Ver identidad y saldo actuales
aihubmix whoami

# 3. Ver información completa de la cuenta
aihubmix me

# 4. Listar tus claves API
aihubmix keys list
```

## Referencia de comandos

| Comando                                  | Función                                           |
| ---------------------------------------- | ------------------------------------------------- |
| `aihubmix login`                         | Iniciar sesión (pegar Manage Key)                 |
| `aihubmix logout`                        | Cerrar sesión y eliminar las credenciales locales |
| `aihubmix whoami`                        | Ver la identidad y el saldo de la sesión actual   |
| `aihubmix me`                            | Ver información completa de la cuenta y el saldo  |
| `aihubmix models list`                   | Ver los modelos disponibles actualmente           |
| `aihubmix keys list [--num N]`           | Listar claves API                                 |
| `aihubmix keys search <palabra clave>`   | Buscar claves por palabra clave                   |
| `aihubmix keys get <id>`                 | Ver los detalles de una clave específica          |
| `aihubmix keys create [parámetros]`      | Crear una nueva clave                             |
| `aihubmix keys update <id> [parámetros]` | Modificar una clave                               |
| `aihubmix keys delete <id>`              | Eliminar una clave                                |

<Tip>
  Añade `--help` a cualquier comando para ver todos sus parámetros, por ejemplo `aihubmix keys create --help`.
</Tip>

## Operaciones habituales

### Gestionar claves API

```bash theme={null}
# Crear una clave con límite de $10, restringida a modelos específicos
aihubmix keys create -n prod-key -q 10 -m "gpt-4o,claude-3.5-sonnet"

# Crear una clave sin límite de cuota y sin fecha de expiración
aihubmix keys create -n ci-key -u

# Renombrar una clave (el resto de la configuración no cambia)
aihubmix keys update 123 -n new-name

# Deshabilitar una clave
aihubmix keys update 123 --status 0

# Eliminar una clave
aihubmix keys delete 123
```

Aquí `-q 10` indica que la clave tiene un límite de \$10, y `-u` indica que no tiene límite de cuota. La eliminación solicita confirmación por defecto; en escenarios de CI puedes añadir `--yes` para omitirla.

### Uso en scripts / agentes de IA

El CLI es muy amigable con la automatización y puede ser ejecutado directamente por CI, scripts o agentes de IA (como Claude Code):

* **Sin inicio de sesión**: pasa el Manage Key mediante la variable de entorno `AIHUBMIX_TOKEN` o el flag `--token` para omitir el inicio de sesión interactivo (prioridad: `--token` > `AIHUBMIX_TOKEN` > archivo de configuración).
* **Salida JSON**: añade `--json` (`-j`) a cualquier comando; los resultados normales van a stdout y los errores a stderr, lo que facilita el análisis con `jq`.
* **Códigos de salida estables**: los scripts pueden usarlos para determinar el éxito o el fracaso.

```bash theme={null}
# Ejecutar con variable de entorno, extraer todos los nombres de las claves
AIHUBMIX_TOKEN=fd*** aihubmix keys list --json | jq '.data[].name'

# Consultar saldo
AIHUBMIX_TOKEN=fd*** aihubmix whoami --json | jq -r '.balance'
```

Significado de los códigos de salida:

| Código de salida | Significado                                                    |
| ---------------- | -------------------------------------------------------------- |
| `0`              | Éxito                                                          |
| `1`              | Error general (parámetros incorrectos, fallo de negocio, etc.) |
| `2`              | Fallo de autenticación (sin sesión iniciada / token inválido)  |
| `3`              | Error de red / conexión                                        |

## Flags globales

Los siguientes parámetros se aplican a todos los comandos:

| Parámetro          | Abreviatura | Descripción                                                           |
| ------------------ | ----------- | --------------------------------------------------------------------- |
| `--token <token>`  | `-t`        | Pasa el Manage Key directamente (para CI / scripts)                   |
| `--json`           | `-j`        | Devuelve el resultado en formato JSON                                 |
| `--base-url <url>` | `-b`        | URL base de la API personalizada (por defecto `https://aihubmix.com`) |
| `--no-color`       |             | Desactiva la salida con color                                         |
| `--config <path>`  |             | Especifica la ruta del archivo de configuración                       |
| `--version`        |             | Ver la versión                                                        |

## Archivo de configuración

La información de inicio de sesión se guarda en `~/.aihubmix/config.json` (en Windows: `%USERPROFILE%\.aihubmix\config.json`), con permisos restringidos a **solo lectura/escritura para el usuario actual**. Al iniciar sesión, el Manage Key no se muestra en pantalla ni se escribe en los logs.

<Warning>
  No incluyas el Manage Key en repositorios de código ni lo compartas con otras personas. Si se filtra, genéralo de nuevo en la consola; el token antiguo dejará de ser válido de inmediato.
</Warning>

## Preguntas frecuentes

**¿Hace falta instalar Python / Node / Go?**

No. El CLI es un único binario, listo para usar tras descargarlo.

**¿Qué diferencia hay entre el Manage Key y la API Key?**

El Manage Key (`fd***`) se usa para gestionar la cuenta (consultar saldo, gestionar claves) y lo utiliza el CLI; la API Key (`sk-***`) se usa para llamar a los modelos. Se generan en lugares distintos de la consola y no son intercambiables.

**¿Es compatible con Windows?**

Sí. Hay binarios nativos para Windows, macOS y Linux.

**¿Cómo usarlo sin interacción en CI / scripts?**

Pasa el Manage Key mediante la variable de entorno `AIHUBMIX_TOKEN`, combínalo con `--json` y los códigos de salida, y no necesitarás ejecutar `aihubmix login`.

**¿Qué hago si olvido o se filtra el Manage Key?**

Genéralo de nuevo en [console.aihubmix.com/setting](https://console.aihubmix.com/setting); el token antiguo dejará de ser válido.

***

*Documentación relacionada: [API de plataforma · CliEndpoints](/es/api/CliEndpoints/get-self) · [Script Python antiguo](/es/api/Cli) · [Consola de AIHubMix](https://console.aihubmix.com)*

***

Última actualización: 2026-06-22