Closed AlphaAlpha 內測

Watch your Claude usage
from anywhere. 隨時隨地
掌握你的 Claude 用量。

Ravenclaude publishes your Claude Code & Codex subscription usage — rate-limit windows, cost, context — to a private server, so you can see it across every machine and on your phone. Ravenclaude 把你的 Claude Code 與 Codex 訂閱用量(rate-limit 視窗、花費、context)發佈到私有伺服器,讓你在每一台機器、甚至手機上都看得到。

🤖

AgentAgent

Claude / CodexClaude / Codex

→

📥

steward

local cache本機快取

→

📤

ranger

publisher上傳

→

🗄️

server

Cloudflare D1Cloudflare D1

→

🐦‍⬛

appapp

menubar / phone選單列 / 手機

Request access申請內測資格

Enter your email and we'll send a one-time link to claim your access token. Seats are limited. 留下你的 email,系統會寄出一次性連結,開啟後即可領取你的 token。名額有限。

Disclaimer免責條款

This is an alpha test. Data is not guaranteed to be retained and may be wiped at any time. 這是 alpha 測試,資料不保證保留,可能隨時被清除。
Service quality and availability are not guaranteed; the API may change or go down without notice. 不保證服務品質與可用性,API 可能隨時變動或中斷,恕不另行通知。
Your email is used only to send the claim link and test-related notices, and will be deleted when the test ends. 你的 email 只用於寄送領取連結與測試相關通知,測試結束後將刪除。

Then set it up — about 5 minutes接著這樣設定 — 約 5 分鐘

1Claim your token領取你的 token

Open the link in the email and click Reveal my token. It shows once — copy it somewhere safe. This is your PUBLISHER_TOKEN. 開啟信中的連結,點 Reveal my token。token 只會顯示一次,請立即複製保存,這就是你的 PUBLISHER_TOKEN。

2Install the collector (steward)安裝收集器(steward)

Caches your agent's usage locally. Requires jq for the shell path (the prebuilt binary needs nothing). 在本機快取 agent 的用量。shell 版需要 jq(預編譯 binary 則免依賴)。

curl -fsSL https://raw.githubusercontent.com/iambanklee/claude-steward/main/install.sh | bash

The installer asks: Claude, Codex, or both.安裝時會問:Claude、Codex,或兩者都裝。

3Install the publisher (ranger)安裝上傳器(ranger)

Uploads the cache to the alpha server, in the background — it never blocks your agent. 在背景把快取上傳到 alpha 伺服器,完全不會卡住你的 agent。

curl -fsSL https://raw.githubusercontent.com/iambanklee/claude-ranger/main/install.sh | bash

4Point it at the alpha server設定連到 alpha 伺服器

Edit ~/.claude/claude-ranger.conf (for Codex: ~/.codex/codex-ranger.conf) and set these two lines — paste the token from step 1: 編輯 ~/.claude/claude-ranger.conf(Codex 為 ~/.codex/codex-ranger.conf),填入這兩行,token 用步驟 1 領到的:

PUBLISHER_URL="https://castle-black.ravenclaude.com"
PUBLISHER_TOKEN="paste-your-token-here"

Then restart your agent. By default only session_id and rate_limits are sent — never your code, paths, or prompts. 然後重啟你的 agent。預設只會送出 session_id 與 rate_limits,絕不會傳送你的程式碼、路徑或提示。

5Confirm it's flowing, then watch it anywhere確認資料有進來,然後隨處查看

Use your agent for a moment, then check the server sees you: 操作一下你的 agent,再確認伺服器收到資料:

curl -H "Authorization: Bearer <your-token>" \
  https://castle-black.ravenclaude.com/latest | jq .rate_limits

Seeing your rate-limit windows means the pipeline works. To watch it live, install the Ravenclaude menubar app (macOS, with iOS / Android / Windows ports) — see github.com/iambanklee/ravenclaude. Point it at the same server URL and token. 看到 rate-limit 視窗就代表管線通了。要即時查看,請安裝 Ravenclaude 選單列 app(macOS,另有 iOS / Android / Windows 版本)——見 github.com/iambanklee/ravenclaude,填入相同的伺服器 URL 與 token 即可。