CCUsage Monitor for VSCode

VSCodeのステータスバーでClaude Codeの5時間ブロック使用量とOpenAI Codex CLIの1日使用量を確認できる拡張機能です。

機能

📊 Claude監視: 現在の5時間ブロックの残り時間と消費金額を表示
📅 Codex日次サマリ: 当日のCodex CLIトークン使用量とコスト（価格が判明しているモデルのみ）を表示
🔄 自動更新: 30秒間隔で最新の使用状況に更新
⚙️ カスタマイズ可能: 更新間隔、コスト表示、表示プロバイダを設定可能
🎯 ステータスバー統合: VSCodeの右下に常時表示

インストール

VS Code Marketplace

VSCodeの拡張機能タブを開く
"Bonjinnorenka CCUsage Monitor"を検索
インストールボタンをクリック

または、コマンドラインから：

code --install-extension bonjinnorenka.bonjinnorenka-ccusage-vscode

設定

拡張機能の設定はsettings.jsonまたは設定画面から変更できます：

{
  "ccusage.updateInterval": 30,
  "ccusage.showCost": true,
  "ccusage.providerMode": "auto",
  "ccusage.codexDisplayWindow": "auto",
  "ccusage.codexPercentageMode": "remaining"
}

設定項目

ccusage.updateInterval: 更新間隔（秒）- デフォルト: 30秒
ccusage.showCost: コスト表示のオン/オフ - デフォルト: true
ccusage.providerMode: 表示するプロバイダ（auto / claude / codex / both）- デフォルト: auto
ccusage.codexDisplayWindow: ステータスバーに表示するCodexレートリミット枠（auto / 5h / weekly）- デフォルト: auto
ccusage.codexPercentageMode: Codexレートリミットの残量か使用量かを選択（remaining / used）- デフォルト: remaining

表示内容

ステータスバーには以下の形式で表示されます：

フル表示: ⏱️ 3h 45m | 💰 $2.15
時間のみ: ⏱️ 3h 45m（showCost: falseの場合）
エラー時: ⚠️ CCUsage Error

ホバーすると詳細情報（残り時間、コスト、トークン数）が表示されます。

前提条件

Claude Codeが正常にインストールされ、~/.claude または ~/.config/claude に使用データが保存されていること
OpenAI Codex CLI を使用する場合は ~/.codex/sessions に JSONL ログが保存されていること

トラブルシューティング

「CCUsage Error」が表示される場合

Claude Codeが正しくインストールされているか確認
~/.claudeディレクトリにアクセス権限があるか確認
最近Claude Codeを使用したか確認（データが存在しない場合もエラーになります）

データが更新されない場合

設定でupdateIntervalを短く設定してみてください
VSCodeを再起動してみてください

実装メモ

Claude / Codex の集計ロジックは ccusage の apps/ccusage/src/data-loader.ts と apps/codex/src/data-loader.ts を参考に再実装しています（MIT ライセンス）。
Codex の日次コスト計算は主要モデル向けの既知の単価を静的に保持しています。単価が不明なモデルはトークン数のみ表示します。

ライセンス

ISC License

デプロイメント

この拡張機能はGitHub Actionsを使用して自動デプロイされます。

リリース手順

バージョンを更新: npm version patch|minor|major
タグをプッシュ: git push origin --tags
GitHub Actionsが自動的にVS Code Marketplaceに公開します

必要なシークレット

GitHubリポジトリに以下のシークレットを設定してください：

VSCE_PAT: Visual Studio Code Marketplace Personal Access Token

貢献

バグ報告や機能要望はIssuesにお願いします。

Bonjinnorenka CCUsage Monitor

bonjinnorenka