Aiberm Skill
aiberm-skill 讓程式開發 Agent 學會讀取你自己的 Aiberm 帳戶。安裝之後，你可以直接問 Claude Code、Codex、Grok Bot 或其他 Agent：「我的 Aiberm 還剩多少餘額？」Agent 會呼叫 Aiberm 的 API，用白話回答你。
這個 Skill 可以查詢餘額、模型、價格、API 權杖、使用紀錄和儲值紀錄。它也能建立、編輯、啟用、停用和刪除你的 API 權杖，而且每次變更前都會先問過你。
Skill 就是一個包含 SKILL.md 檔案的資料夾。當你的問題符合 Skill 的描述時，Agent 會讀取這個檔案，然後自己執行 curl。不會有程式在背景執行，也沒有東西需要建置或保持執行。
前置條件
- 一個 Aiberm 帳戶（註冊）
- 一個支援 Skill 的 Agent，例如 Claude Code、Codex 或 Grok Bot
git、curl和相容 bash 的 shell。macOS 和 Linux 通常都已內建；在 Windows 上，Claude Code 會使用 Git Bash。
1. 取得使用者 ID 和系統訪問權杖
Skill 需要兩個值，都在 個人設定 頁面：
| 值 | 位置 |
|---|---|
| 使用者 ID | 頁面頂端的頁首，顯示為 ID: 123 |
| 系統訪問權杖 | 安全設定 分頁 → 系統訪問權杖 → 生成權杖 |
Aiberm 的每個帳戶請求都會同時檢查這兩個值，而且 ID 必須屬於權杖所屬的帳戶。
系統訪問權杖不是 API 金鑰（sk-...）。它等同於你的控制台登入：持有它的人，能做你在控制台裡能做的任何事。請妥善保管。按下 重新產生 會替換掉它，仍在使用舊權杖的地方都會失效。
2. 安裝 Skill
把下面這段提示詞貼到 Claude Code、Codex、Grok Bot 或其他 Agent，讓它幫你安裝 Skill：
從 https://github.com/aiberm/aiberm-skill 安裝 Aiberm Skill：把儲存庫裡的 skills/aiberm 資料夾複製到你載入 Skill 的資料夾。安裝完成後，開啟新的工作階段。之後要更新 Skill，再傳送一次同樣的提示詞即可。
3. 設定兩個環境變數
Agent 會從自己的環境變數讀取這兩個值，所以要在啟動 Agent 之前設定好。
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，也可以改把這兩個變數寫進 ~/.claude/settings.json 的 env 區塊。
在交給 Agent 之前，可以先請求一次個人資料，確認這兩個值沒問題。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. 向 Agent 提問
開一個新的 Agent 工作階段，用你自己的話問就好：
- 「我的 Aiberm 還剩多少餘額？」
- 「我昨天在 Aiberm 花了多少錢？按模型分開列。」
- 「列出我的 Aiberm API 權杖，還有每個各剩多少額度。」
- 「
claude-sonnet-5-5在 Aiberm 上每 100 萬 token 多少錢？」 - 「這週我在 Aiberm 上用最多的是哪些模型？」
- 「幫我看一下最近的 Aiberm 儲值紀錄。」
- 「幫我在 Aiberm 建立一個叫
my-app的 API 金鑰，額度上限 5 美元。」 - 「把我的 Aiberm 權杖
old-test停用。」
也可以直接呼叫這個 Skill：在 Claude Code 和 Grok Bot 中輸入 /aiberm，在 Codex 中輸入 $aiberm。
| 你問的內容 | Skill 讀取的 API |
|---|---|
| 餘額和累計花費 | 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 權杖
- 每次建立、編輯、啟用、停用或刪除之前，Agent 都會先告訴你要送出的內容，等你同意後才執行。
- 除非你另有要求，新權杖和控制台的預設一樣：額度無限、永不過期。你也可以指定額度上限、到期時間或允許使用的模型清單。
- 建立權杖後，Agent 會顯示一次完整的金鑰。請把它複製到你的應用程式或設定檔中。
- 刪除權杖後無法復原，使用該金鑰的應用程式會立即失效。
Skill 不會做的事
- 除了 API 權杖之外，不會修改任何東西。它不會付款、兌換儲值碼，也不會修改你的帳戶。這些操作請到 控制台 進行。
- 不會重設你的系統訪問權杖。Skill 明確要求 Agent 永遠不要呼叫那個端點。
- 不會顯示既有 API 權杖的完整金鑰。權杖清單裡有完整的金鑰，Agent 只會以遮罩後的形式顯示，例如
sk-abcd****wxyz。需要完整金鑰時，請到 權杖管理 複製。唯一的例外是 Agent 剛為你建立的權杖。
這些規則是給 Agent 的指令，不是技術上的限制。這個權杖擁有你控制台登入的全部權限。只在你信任的 Agent 和電腦上使用。如果外洩了，到個人設定裡按 重新產生。
疑難排解
| 你看到的情況 | 處理方式 |
|---|---|
| Agent 說缺少環境變數 | 把兩個變數都設定好，開啟新的終端機，再開一個新的 Agent 工作階段。 |
未提供 New-Api-User | 沒有設定 AIBERM_USER_ID。 |
New-Api-User 与登录用户不匹配 | AIBERM_USER_ID 不是權杖所屬帳戶的 ID。請從同一個帳戶的個人設定複製 ID。 |
access token 无效 | 權杖填錯了，或已經重新產生過。請產生新的權杖，並更新 AIBERM_ACCESS_TOKEN。 |
| Agent 沒有使用這個 Skill | 確認檔案位於 ~/.claude/skills/aiberm/SKILL.md 或 ~/.agents/skills/aiberm/SKILL.md，然後開一個新的工作階段。也可以直接呼叫：/aiberm（Claude Code、Grok Bot）或 $aiberm（Codex）。 |
时间跨度不能超过 1 个月 | 按小時的用量每次請求最多涵蓋 30 天。請縮短查詢的時間範圍。 |
Skill 的原始碼和完整的請求清單在 aiberm-skill 儲存庫。模型 API 本身的錯誤請見 錯誤處理。