Aiberm Skill

aiberm-skill le enseña a un agente de programación a leer tu propia cuenta de Aiberm. Una vez instalada, puedes preguntarle a Claude Code, Codex, Grok Bot u otro agente: “¿Cuánto saldo me queda en Aiberm?”. El agente llama a la API de Aiberm y te responde con palabras sencillas.

La skill lee tu saldo, modelos, precios, tokens de API, registros de uso y recargas. También puede crear, editar, habilitar, deshabilitar y eliminar tus tokens de API, y te pide confirmación antes de cada cambio.

Info

Una skill es una carpeta que contiene un archivo SKILL.md. El agente lee el archivo cuando tu pregunta coincide con la descripción de la skill y luego ejecuta curl por su cuenta. No se ejecuta nada en segundo plano, y no hay nada que compilar ni mantener en ejecución.

Requisitos previos

Una cuenta de Aiberm (regístrate)
Un agente compatible con skills, como Claude Code, Codex o Grok Bot
git, curl y un shell compatible con bash. macOS y Linux suelen traer los tres. En Windows, Claude Code usa Git Bash.

1. Obtén tu ID de usuario y tu token de acceso del sistema

La skill necesita dos valores, ambos en Configuración personal:

Valor	Dónde encontrarlo
ID de usuario	En el encabezado de la parte superior de la página, como `ID: 123`
Token de acceso del sistema	Pestaña Configuración de seguridad → Token de acceso del sistema → Generar token

Aiberm comprueba ambos en cada solicitud a la cuenta, y el ID debe pertenecer a la cuenta dueña del token.

Warning

El token de acceso del sistema no es una clave de API (sk-...). Funciona como tu inicio de sesión en la consola: cualquiera que lo tenga puede hacer en la consola lo mismo que tú. Mantenlo en privado. Al pulsar Regenerar se reemplaza, y todo lo que siga usando el token anterior deja de funcionar.

2. Instala la skill

Pega este prompt en Claude Code, Codex, Grok Bot u otro agente y deja que instale la skill:

Instala Aiberm Skill desde https://github.com/aiberm/aiberm-skill: copia su carpeta skills/aiberm en la carpeta desde la que cargas las skills.

Cuando termine, inicia una sesión nueva. Para actualizar la skill más adelante, vuelve a enviar el mismo prompt.

3. Define las dos variables

El agente lee los valores de su entorno, así que defínelos antes de iniciarlo.

macOS / Linux: agrega estas líneas a ~/.zshrc o ~/.bashrc y luego abre una terminal nueva:

export AIBERM_ACCESS_TOKEN="tu-token-de-acceso-del-sistema"
export AIBERM_USER_ID="123"

Windows (PowerShell): ejecuta estos comandos y luego abre una terminal nueva:

setx AIBERM_ACCESS_TOKEN "tu-token-de-acceso-del-sistema"
setx AIBERM_USER_ID "123"

Tip

Solo en Claude Code, puedes poner ambas variables en el bloque env de ~/.claude/settings.json en lugar de definirlas así.

Para comprobar los valores antes de usar un agente, consulta tu perfil. data.quota dividido entre 500000 es tu saldo restante en USD.

curl -sS "https://aiberm.com/api/user/self" \
  -H "Authorization: Bearer $AIBERM_ACCESS_TOKEN" \
  -H "New-Api-User: $AIBERM_USER_ID"

4. Pregúntale a tu agente

Inicia una sesión nueva del agente y pregunta con tus propias palabras:

“¿Cuánto saldo me queda en Aiberm?”
“¿Cuánto gasté ayer en Aiberm, desglosado por modelo?”
“Lista mis tokens de API de Aiberm y la cuota que le queda a cada uno.”
“¿Cuánto cuesta claude-sonnet-5-5 por 1M de tokens en Aiberm?”
“¿Qué modelos usé más en Aiberm esta semana?”
“Muéstrame mis últimas recargas en Aiberm.”
“Crea una clave de API de Aiberm llamada my-app con un límite de $5.”
“Desactiva mi token de Aiberm old-test.”

También puedes invocar la skill directamente: /aiberm en Claude Code y Grok Bot, $aiberm en Codex.

Si preguntas por	La skill consulta
Saldo y gasto total	`GET /api/user/self`
Modelos que puedes llamar	`GET /api/user/models`
Precios de los modelos	`GET /api/pricing`
Tokens de API	`GET /api/token/`
Registros de uso	`GET /api/log/self`
Totales de uso	`GET /api/log/self/stat`
Uso por hora y por modelo	`GET /api/data/self`
Historial de recargas	`GET /api/user/topup/self`
Crear, editar o eliminar tokens de API	`POST`, `PUT` o `DELETE /api/token/`

Los importes se convierten a USD a razón de 500000 de cuota = $1. Los precios son los que tu cuenta paga realmente.

Crear y modificar tokens de API

Antes de crear, editar, habilitar, deshabilitar o eliminar un token, el agente te muestra lo que va a enviar y espera a que lo confirmes.
Salvo que pidas otra cosa, un token nuevo tiene cuota ilimitada y no vence, igual que en la consola. Puedes pedir un límite de gasto, una fecha de vencimiento o una lista de modelos permitidos.
Después de crear un token, el agente muestra su clave completa una sola vez. Cópiala en tu app o en tu configuración.
Eliminar un token no se puede deshacer, y las apps que usan su clave dejan de funcionar de inmediato.

Lo que la skill no hace

Aparte de los tokens de API, no modifica nada. No hace pagos, no canjea códigos de recarga ni edita tu cuenta. Para eso, usa la consola.
No restablece tu token de acceso del sistema. La skill le indica al agente que nunca llame a esa ruta.
No revela las claves completas de tus tokens de API existentes. La lista de tokens contiene las claves completas, y el agente las muestra enmascaradas, como sk-abcd****wxyz. Copia una clave completa desde Gestión de tokens. La única excepción es un token que el agente acaba de crear para ti.

Warning

Estas reglas son instrucciones para el agente, no un bloqueo técnico. El token permite todo lo que permite tu inicio de sesión en la consola. Úsalo solo con agentes y equipos de confianza. Si se filtra, pulsa Regenerar en Configuración personal.

Solución de problemas

Lo que ves	Qué hacer
El agente dice que faltan las variables	Define ambas, abre una terminal nueva e inicia una sesión nueva del agente.
`未提供 New-Api-User`	`AIBERM_USER_ID` no está definida.
`New-Api-User 与登录用户不匹配`	`AIBERM_USER_ID` no es el ID de la cuenta dueña del token. Copia el ID desde Configuración personal de esa misma cuenta.
`access token 无效`	El token es incorrecto o se regeneró. Genera uno nuevo y actualiza `AIBERM_ACCESS_TOKEN`.
El agente no usa la skill	Comprueba que el archivo esté en `~/.claude/skills/aiberm/SKILL.md` o `~/.agents/skills/aiberm/SKILL.md` y luego inicia una sesión nueva. O invócala directamente con `/aiberm` (Claude Code, Grok Bot) o `$aiberm` (Codex).
`时间跨度不能超过 1 个月`	El uso por hora abarca como máximo 30 días por solicitud. Pide un rango más corto.

El código fuente de la skill y la lista completa de solicitudes están en el repositorio aiberm-skill. Para errores de la propia API de modelos, consulta Manejo de errores.