Aiberm Skill

aiberm-skill insegna a un agente di programmazione a leggere il tuo account Aiberm. Una volta installata, puoi chiedere a Claude Code, a Codex, a Grok Bot o a un altro agente: “Quanto saldo mi resta su Aiberm?” L’agente chiama l’API di Aiberm e risponde in linguaggio semplice.

La skill legge saldo, modelli, prezzi, API key, log di utilizzo e cronologia delle ricariche. Può anche creare, modificare, attivare, disattivare ed eliminare le tue API key, e ti chiede conferma prima di ogni modifica.

Info

Una skill è una cartella che contiene un file SKILL.md. L’agente legge il file quando la tua domanda corrisponde alla descrizione della skill, poi esegue curl da solo. Non gira nulla in background e non c’è niente da compilare o da tenere in esecuzione.

Prerequisiti

Un account Aiberm (registrati)
Un agente che supporti le Skill, come Claude Code, Codex o Grok Bot
git, curl e una shell compatibile con bash. macOS e Linux di solito li hanno tutti e tre. Su Windows, Claude Code usa Git Bash.

1. Ottieni l’ID utente e il token di accesso di sistema

La skill ha bisogno di due valori, entrambi in Impostazioni personali:

Valore	Dove trovarlo
ID utente	Nell’intestazione in cima alla pagina, nella forma `ID: 123`
Token di accesso di sistema	Scheda Impostazioni di sicurezza → Token di accesso di sistema → Genera token

Aiberm li verifica entrambi a ogni richiesta relativa all’account, e l’ID deve appartenere all’account proprietario del token.

Warning

Il token di accesso di sistema non è una API key (sk-...). Funziona come il tuo accesso alla console: chiunque lo possieda può fare tutto ciò che puoi fare tu nella console. Tienilo riservato. Se premi Rigenera lo sostituisci, e tutto ciò che usa ancora il vecchio token smette di funzionare.

2. Installa la Skill

Incolla questo prompt in Claude Code, Codex, Grok Bot o un altro agente e lascia che installi la Skill:

Installa Aiberm Skill da https://github.com/aiberm/aiberm-skill: copia la sua cartella skills/aiberm nella cartella da cui carichi le Skill.

Al termine, avvia una nuova sessione. Per aggiornare la Skill in seguito, invia di nuovo lo stesso prompt.

3. Imposta le due variabili

L’agente legge i valori dal proprio ambiente, quindi impostali prima di avviarlo.

macOS / Linux: aggiungi queste righe a ~/.zshrc o ~/.bashrc, poi apri un nuovo terminale:

export AIBERM_ACCESS_TOKEN="your-system-access-token"
export AIBERM_USER_ID="123"

Windows (PowerShell): esegui i comandi qui sotto, poi apri un nuovo terminale:

setx AIBERM_ACCESS_TOKEN "your-system-access-token"
setx AIBERM_USER_ID "123"

Tip

Solo per Claude Code, in alternativa puoi mettere entrambe le variabili nel blocco env di ~/.claude/settings.json.

Per controllare i valori prima di coinvolgere un agente, richiedi il tuo profilo. data.quota diviso 500000 è il tuo saldo residuo in USD.

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

4. Chiedi al tuo agente

Avvia una nuova sessione dell’agente e chiedi con parole tue:

“Quanto saldo mi resta su Aiberm?”
“Quanto ho speso ieri su Aiberm, diviso per modello?”
“Elenca le mie API key di Aiberm e quanta quota resta a ciascuna.”
“Quanto costa claude-sonnet-5-5 per 1M di token su Aiberm?”
“Quali modelli ho usato di più su Aiberm questa settimana?”
“Mostrami le mie ultime ricariche su Aiberm.”
“Crea una API key di Aiberm chiamata my-app con un limite di 5 $.”
“Disattiva il mio token Aiberm old-test.”

Puoi anche richiamare la Skill direttamente: /aiberm in Claude Code e Grok Bot, $aiberm in Codex.

Cosa chiedi	Cosa legge la skill
Saldo e spesa totale	`GET /api/user/self`
Modelli che puoi chiamare	`GET /api/user/models`
Prezzi dei modelli	`GET /api/pricing`
API key	`GET /api/token/`
Log di utilizzo	`GET /api/log/self`
Totali di utilizzo	`GET /api/log/self/stat`
Utilizzo per ora e per modello	`GET /api/data/self`
Cronologia delle ricariche	`GET /api/user/topup/self`
Creazione, modifica o eliminazione di API key	`POST`, `PUT` o `DELETE /api/token/`

Gli importi sono convertiti in USD al tasso di 500000 unità di quota = 1 $. I prezzi sono quelli che il tuo account paga effettivamente.

Creazione e modifica delle API key

Prima di ogni creazione, modifica, attivazione, disattivazione o eliminazione, l’agente ti dice cosa invierà e aspetta il tuo OK.
Salvo diversa richiesta, una nuova API key ha quota illimitata e nessuna scadenza, come nella console. Puoi chiedere un limite di spesa, una data di scadenza o un elenco di modelli consentiti.
Dopo aver creato una API key, l’agente ne mostra la chiave completa una sola volta. Copiala nella tua app o nella configurazione.
L’eliminazione di una API key è irreversibile, e le app che la usano smettono subito di funzionare.

Cosa non fa la skill

A parte le API key, non modifica nulla. Non effettua pagamenti, non riscatta codici di ricarica e non modifica il tuo account. Per queste operazioni usa la console.
Non reimposta il token di accesso di sistema. La skill dice all’agente di non chiamare mai quell’endpoint.
Non mostra per intero le tue API key esistenti. L’elenco dei token contiene le chiavi complete, ma l’agente le mostra mascherate, ad esempio sk-abcd****wxyz. Copia una chiave completa da Gestione token. L’unica eccezione è una API key che l’agente ha appena creato per te.

Warning

Queste regole sono istruzioni per l’agente, non un blocco tecnico. Il token consente tutto ciò che consente il tuo accesso alla console. Usalo solo con agenti e computer di cui ti fidi. Se trapela, premi Rigenera in Impostazioni personali.

Risoluzione dei problemi

Cosa vedi	Cosa fare
L’agente dice che mancano le variabili	Impostale entrambe, apri un nuovo terminale e avvia una nuova sessione dell’agente.
`未提供 New-Api-User`	`AIBERM_USER_ID` non è impostato.
`New-Api-User 与登录用户不匹配`	`AIBERM_USER_ID` non è l’ID dell’account proprietario del token. Copia l’ID da Impostazioni personali dello stesso account.
`access token 无效`	Il token è errato o è stato rigenerato. Generane uno nuovo e aggiorna `AIBERM_ACCESS_TOKEN`.
L’agente non usa la Skill	Verifica che il file si trovi in `~/.claude/skills/aiberm/SKILL.md` o `~/.agents/skills/aiberm/SKILL.md`, poi avvia una nuova sessione. Oppure richiamala direttamente con `/aiberm` (Claude Code, Grok Bot) o `$aiberm` (Codex).
`时间跨度不能超过 1 个月`	L’utilizzo orario copre al massimo 30 giorni per richiesta. Chiedi un intervallo più breve.

Il codice sorgente della skill e l’elenco completo delle richieste si trovano nel repository aiberm-skill. Per gli errori restituiti dall’API dei modelli, consulta Gestione degli errori.