Remaining Tokens

Claude Code、Codex、Cursor のサブスクリプション利用制限を VS Code の ステータスバーから確認する拡張機能です。ステータスバーの AI usage に ホバーすると、CLI が返したもののうち 5h、1w、1month の利用率と リセット時刻を表示します。

動作

• Claude Code は既定で claude -p /usage を直接実行します。
• Codex は codex app-server の読み取り専用 account/rateLimits/read を使用します。
• Cursor は疑似端末で起動して /usage を送ります。
• CLI の TUI を最終画面へ復元し、期間・使用率・リセット時刻を共通モデルへ 変換します。
• 取得できないサービスや存在しない期間は、他の結果を妨げません。
• ステータスバーをクリックするか Remaining Tokens: Refresh Usage を実行すると再取得します。
• CLI はプロジェクトや / ではなく、provider ごとに作成して後で削除する空の 一時ディレクトリで起動します。

この方式は非公開 API や認証情報を直接読みません。その代わり CLI の表示変更の 影響を受ける可能性があります。解析できなかった実出力は Remaining Tokens: Show Output で確認できます。

ログは VS Code 下部パネルの Output にある Remaining Tokens チャンネルへ 出力されます。デバッグ実行時も自動でパネルへフォーカスは移しません。

CLI の場所や起動方法は設定の provider 別 command で argv 配列として変更できます。 たとえば Claude Code を npx で実行する場合は次のように設定します。

"remainingTokens.providers.claude.command": [
  "npx",
  "-y",
  "@anthropic-ai/claude-code",
  "-p",
  "/usage",
  "--output-format",
  "text",
  "--no-session-persistence"
]

各 provider の mode は、通常プロセスとして実行する process、疑似端末を使う terminal、Codex の構造化 API を使う codex-app-server から選べます。 Codex は reset credit を消費する /usage を呼ばず、既定で読み取り専用の codex-app-server を使用します。

開発

npm install
npm test
npm run build

npm run package でインストール可能な VSIX を作成できます。