Community画像github.com

token-report

Claude Codeのトークン使用量、キャッシュ読み取り・書き込み、APIリスト値、クォータ読み取り、応答時間をローカルのClaude Codeトランスクリプトからレポートします。

token-report とは?

このスキルは、Claude Codeのセッショントランスクリプトとローカルに保持されたキャプチャ履歴を解析し、トークン使用量、キャッシュヒット率、APIコスト相当額、クォータ、応答時間などを含む詳細な使用状況レポートを生成します。主にPython 3.8以降で動作し、依存関係のインストールは不要で、外部へのデータ送信も行いません。Windowsでは`python`、macOS/Linuxでは`python3`を使用し、指定されたスクリプトパスをそのまま利用します。レポートには、セッションの日付範囲指定、特定セッションファミリーの選択、スタイル切り替え、JSON出力など多彩なオプションが用意されており、生成されたHTMLはローカルで閲覧可能です。なお、`tokenusage.dev`への公開共有は別の`token-share`スキルが必要で、利用者が明示的に要求した場合のみ行います。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stdcmms-lang/token-counter/tree/main/plugins/token-counter-claude/skills/token-report

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

token-report は何をしますか?

このプラグインのスクリプトを使用して、ローカルのClaude Code使用状況レポートを構築します。

レポートはClaude Codeのセッショントランスクリプトと保持されたローカルキャプチャ履歴を読み取ります。 その見出しには、記録されたプロンプトカウント(基本入力+キャッシュ作成+キャッシュ読み取り)が使用されます。 構成ビューはラベル付きUTF-8バイトインベントリであり、Claudeトークン属性ではありません。 外部送信は行わず、依存関係もインストールしません。

Python 3.8以降を使用してください。Windowsの場合は以下を実行します:

python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

macOSまたはLinuxの場合は以下を実行します:

python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

ユーザーのリクエストでサポートされているオプションのみを追加します:

  • --since YYYY-MM-DD および --until YYYY-MM-DD は、キャプチャされたローカルの日付範囲を選択します。
  • --session PREFIX は、キャプチャされたサブエージェントと継続を含む1つのセッションファミリーを選択します。
  • --style clinical、--style matisse、または --style nocturne は、表示スタイルを選択します。
  • --json PATH は、詳細な数値とデータ品質カウンターを書き出します。
  • --metrics-only は、テキストバイトインベントリをスキップします。
  • --no-account は、アカウントファイルを完全にスキップします。
  • --sessions-root PATH は、別のトランスクリプトルートとその独立したローカル状態を選択します。
  • --live-only は、現在存在するトランスクリプトのみを表示し、保持された履歴はキャプチャされたままにします。
  • --no-cache は、使い捨てインデックスをバイパスします。
  • --rebuild は、使い捨てインデックスのみをクリアし、ライブファイルを再抽出してマージします。保持された履歴は削除しません。
  • --doctor は、パス、解析サポート、ローカル状態をチェックします。書き込みや送信は行いません。
  • --out PATH は、HTMLの出力先を選択します。

すべてのコマンドのWindowsバリアントには python を、macOS/Linuxには python3 を使用します。 引用されたスクリプトパスは、示されたとおり正確に維持してください。

結果を説明する前に、端末のサマリーとデータ品質カウンターを読み取ってください。 生成されたHTMLと要求されたJSONをリンクしてください。欠落または部分的な測定値について説明してください。 ドル金額はAPIリスト値と呼び、支出や請求書とは呼ばないでください。記録されたトークン数とバイト構成、推定画像数、適合応答時間の数値を区別してください。

Claude Codeがトランスクリプトを削除する可能性があるため、キャプチャされた履歴はデフォルトで含まれます。 完全なアカウントまたはカレンダー使用状況を主張しないでください。 インデックスを修復するために履歴をクリアしないでください。

ローカルページは、許可リストに登録されたメールアドレスまたは組織メタデータからアカウント名を付ける場合があります。 公開出力と共有では、そのIDは省略されます。履歴には、アカウントプランフィールドと解析されたサブスクリプション作成日のみが保持されます。

過去のプランラベルは、キャプチャされたアカウント観測を使用します。 スクリプトは、観測ルールとサブスクリプション作成日ガードが両方とも合格した場合にのみプランを提供し、それ以外の場合はnullを使用します。 プランラベルや日付宣言を発明しないでください。

subscriptionCreatedAt を変更しないプラン変更は、後の実行で新しい階層が観測されるまで検出できません。 したがって、その実行より前に終了したウィンドウには古いプランが残る可能性があります。 その日付がアップグレードまたはダウングレードで変更されるかどうかは未検証です。

決して .credentials.json、他の資格情報ファイル、外部ツール結果ファイル、画像URLを開かないでください。 プロンプト、出力、思考、ツールの内容を検査または繰り返さないでください。 価格を取得したり、パッケージをインストールしたりしないでください。

tokenusage.dev での公開共有には、ユーザーが明示的に共有、公開、更新、削除を要求した場合にのみ、別のtoken-shareスキルを使用してください。 このレポートの実行は、共有を許可するものではありません。

関連スキル