Aiberm Skill
aiberm-skill учит агента для программирования читать данные вашего собственного аккаунта Aiberm. После установки можно спросить Claude Code, Codex, Grok Bot или другого агента: «Сколько у меня осталось на балансе Aiberm?» Агент сам обратится к API Aiberm и ответит простыми словами.
Skill показывает баланс, модели, цены, API-токены, журналы использования и историю пополнений. Ещё он умеет создавать, изменять, включать, отключать и удалять ваши API-токены и перед каждым изменением спрашивает вашего подтверждения.
Skill — это папка с файлом SKILL.md. Когда ваш вопрос подходит под описание Skill, агент читает этот файл и сам запускает curl. Ничего не работает в фоне, ничего не нужно собирать или держать запущенным.
Предварительные требования
- Аккаунт Aiberm (зарегистрироваться)
- Агент с поддержкой Skills, например Claude Code, Codex или Grok Bot
git,curlи bash-совместимая оболочка. В macOS и Linux обычно есть все три. В Windows Claude Code использует Git Bash.
1. Получите ID пользователя и токен доступа к системе
Для Skill нужны два значения. Оба находятся на странице Личные настройки:
| Значение | Где найти |
|---|---|
| ID пользователя | В шапке вверху страницы, в виде ID: 123 |
| Токен доступа к системе | Вкладка Настройки безопасности → Токен доступа к системе → Сгенерировать токен |
Aiberm проверяет оба значения при каждом запросе к аккаунту. ID должен принадлежать тому же аккаунту, что и токен.
Токен доступа к системе — не API-ключ (sk-...). Он работает как вход в консоль: любой, у кого он есть, может делать в консоли всё то же, что и вы. Храните его в секрете. Кнопка Сгенерировать заново заменяет токен, и всё, что ещё использует старый, перестаёт работать.
2. Установите Skill
Вставьте этот промпт в Claude Code, Codex, Grok Bot или другой агент, и он сам установит Skill:
Установи Aiberm Skill из https://github.com/aiberm/aiberm-skill: скопируй папку skills/aiberm из репозитория в папку, из которой ты загружаешь Skills.
Когда агент закончит, начните новый сеанс. Чтобы потом обновить Skill, отправьте тот же промпт ещё раз.
3. Задайте две переменные
Агент берёт значения из переменных окружения, поэтому задайте их до запуска агента.
macOS / Linux: добавьте эти строки в ~/.zshrc или ~/.bashrc, затем откройте новый терминал:
export AIBERM_ACCESS_TOKEN="ваш-токен-доступа-к-системе"
export AIBERM_USER_ID="123"
Windows (PowerShell): выполните команды ниже, затем откройте новый терминал:
setx AIBERM_ACCESS_TOKEN "ваш-токен-доступа-к-системе"
setx AIBERM_USER_ID "123"
Только для Claude Code: вместо этого обе переменные можно указать в блоке env файла ~/.claude/settings.json.
Чтобы проверить значения ещё до подключения агента, запросите свой профиль. data.quota, делённое на 500000, — это остаток баланса в долларах США.
curl -sS "https://aiberm.com/api/user/self" \
-H "Authorization: Bearer $AIBERM_ACCESS_TOKEN" \
-H "New-Api-User: $AIBERM_USER_ID"
4. Спросите агента
Начните новый сеанс агента и спросите своими словами:
- «Сколько у меня осталось на балансе Aiberm?»
- «Сколько я вчера потратил в Aiberm? Разбей по моделям.»
- «Покажи мои API-токены Aiberm и сколько квоты осталось у каждого.»
- «Сколько стоит
claude-sonnet-5-5за 1M токенов в Aiberm?» - «Какими моделями в Aiberm я больше всего пользовался на этой неделе?»
- «Покажи мои последние пополнения в Aiberm.»
- «Создай API-ключ Aiberm с именем
my-appи лимитом $5.» - «Отключи мой токен Aiberm
old-test.»
Skill можно также вызвать напрямую: /aiberm в Claude Code и Grok Bot, $aiberm в Codex.
| О чём вы спрашиваете | Что читает Skill |
|---|---|
| Баланс и общие расходы | GET /api/user/self |
| Модели, которые вам доступны | GET /api/user/models |
| Цены моделей | GET /api/pricing |
| API-токены | GET /api/token/ |
| Журналы использования | GET /api/log/self |
| Сводка по использованию | GET /api/log/self/stat |
| Использование по часам и моделям | GET /api/data/self |
| История пополнений | GET /api/user/topup/self |
| Создание, изменение или удаление API-токенов | POST, PUT или DELETE /api/token/ |
Суммы пересчитываются в доллары США по курсу 500000 квоты = $1. Цены — это то, что ваш аккаунт платит на самом деле.
Создание и изменение API-токенов
- Перед каждым созданием, изменением, включением, отключением или удалением агент сообщает, что именно отправит, и ждёт вашего подтверждения.
- Если не попросить иначе, новый токен создаётся с неограниченной квотой и без срока действия, как в консоли. Можно попросить лимит расходов, срок действия или список разрешённых моделей.
- После создания токена агент один раз показывает его полный ключ. Скопируйте его в своё приложение или конфигурацию.
- Удаление токена нельзя отменить, а приложения, которые используют его ключ, сразу перестают работать.
Чего Skill не делает
- Помимо API-токенов, он ничего не меняет. Не проводит платежи, не активирует коды пополнения и не редактирует аккаунт. Для этого используйте консоль.
- Он не сбрасывает токен доступа к системе. Skill запрещает агенту обращаться к этому маршруту.
- Он не раскрывает полные ключи ваших существующих API-токенов. Список токенов содержит полные ключи, но агент показывает их в замаскированном виде, например
sk-abcd****wxyz. Полный ключ можно скопировать в разделе Управление токенами. Единственное исключение — токен, который агент только что создал для вас.
Эти правила — инструкции для агента, а не техническая блокировка. Токен даёт всё, что даёт ваш вход в консоль. Используйте его только с агентами и на компьютерах, которым доверяете. Если токен утёк, нажмите Сгенерировать заново на странице «Личные настройки».
Устранение неполадок
| Что вы видите | Что делать |
|---|---|
| Агент сообщает, что переменные не заданы | Задайте обе, откройте новый терминал и начните новый сеанс агента. |
未提供 New-Api-User | Не задана переменная AIBERM_USER_ID. |
New-Api-User 与登录用户不匹配 | AIBERM_USER_ID не совпадает с ID аккаунта, которому принадлежит токен. Скопируйте ID на странице «Личные настройки» того же аккаунта. |
access token 无效 | Токен неверный или был сгенерирован заново. Сгенерируйте новый и обновите AIBERM_ACCESS_TOKEN. |
| Агент не использует Skill | Проверьте, что файл лежит по пути ~/.claude/skills/aiberm/SKILL.md или ~/.agents/skills/aiberm/SKILL.md, затем начните новый сеанс. Или вызовите Skill напрямую: /aiberm (Claude Code, Grok Bot) или $aiberm (Codex). |
时间跨度不能超过 1 个月 | Почасовая статистика охватывает не больше 30 дней за один запрос. Запросите период покороче. |
Исходный код Skill и полный список запросов — в репозитории aiberm-skill. Ошибки самого API моделей описаны в разделе Обработка ошибок.