jpskill.com
💼 ビジネス コミュニティ 🟡 少し慣れが必要 👤 経営者・事業責任者・マーケ

💼 Cost Track

cost-track

Claude Codeの利用時に、セッションごとに

⚡ ⏱ 経費仕訳 1時間 → 5分

📺 まず動画で見る(YouTube)

▶ 【自動化】AIガチ勢の最新活用術6選がこれ1本で丸分かり!【ClaudeCode・AIエージェント・AI経営・Skills・MCP】 ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Auto-capture per-session token usage from the Claude Code session jsonl and persist to the cost-tracking namespace

🇯🇵 日本人クリエイター向け解説

一言でいうと

Claude Codeの利用時に、セッションごとに

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o cost-track.zip https://jpskill.com/download/2232.zip && unzip -o cost-track.zip && rm cost-track.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/2232.zip -OutFile "$d\cost-track.zip"; Expand-Archive "$d\cost-track.zip" -DestinationPath $d -Force; ri "$d\cost-track.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して cost-track.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → cost-track フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

💬 こう話しかけるだけ — サンプルプロンプト

  • › Cost Track で、私のビジネスを分析して改善案を3つ提案して
  • › Cost Track を使って、来週の会議用の資料を作って
  • › Cost Track で、現状の課題を整理してアクションプランに落として

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Cost Track

アクティブな Claude Code セッションの jsonl (~/.claude/projects/<encoded-cwd>/<session>.jsonl) を読み取り、モデルごとのアシスタントメッセージの usage を集計し、REFERENCE.md の料金を使用して USD コストを計算し、構造化されたレコードを cost-tracking AgentDB 名前空間に書き込みます。これは、cost-report と cost-optimize が消費する実際のデータを提供するプロデューサーです。

使用するタイミング

  • 意味のある作業のまとまりの後、レポートのために支出を記録する場合。
  • セッション終了時、最終的な集計を永続化する場合。
  • 長時間のセッション中に定期的に（cron-friendly — /loop 30m を参照）。

手順

  1. プロジェクトのルートからトラッカーを実行します。

    node plugins/ruflo-cost-tracker/scripts/track.mjs

    スクリプトは、現在の作業ディレクトリからセッション jsonl を自動的に検出します。特定のセッションを固定するには: TRACK_SESSION=/path/to/session.jsonl。ドライラン（メモリへの書き込みなし）を行うには: TRACK_DRY_RUN=1。

  2. マークダウンの概要を確認します — 合計コスト、モデル別およびティア別の内訳、および永続化されたメモリキー。

  3. 永続化を確認します — mcp__claude-flow__memory_search --query "session-" --namespace cost-tracking で新しいレコードがリストされるはずです。cost-report のステップ 1 はこの名前空間から読み取ります。

レコードの形式（cost-tracking 名前空間内）

キー: session-<sessionId>。値 (JSON):

{
  "sessionId": "1dba3b8c-...",
  "cwd": "/Users/cohen/Projects/ruflo",
  "startedAt": "2026-05-04T...",
  "endedAt": "2026-05-05T...",
  "messageCount": 234,
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "input_tokens": 12345,
      "output_tokens": 6789,
      "cache_creation_input_tokens": 800000,
      "cache_read_input_tokens": 2000000,
      "messages": 50,
      "cost_usd": 1.23
    }
  },
  "byTier": { "haiku": 0.0, "sonnet": 0.45, "opus": 1.23, "unknown": 0 },
  "total_cost_usd": 1.68,
  "capturedAt": "2026-05-05T..."
}

料金の信頼できる情報源

スクリプトの PRICING 定数は、REFERENCE.md の「Model pricing (USD per 1M tokens)」を反映しています。料金が変更された場合は、両方を同時に更新してください。キャッシュ書き込みトークンは cache_write レートで課金され、キャッシュ読み取りトークンは cache_read レートで課金されます（Anthropic の請求ドキュメントによる）。

環境変数による上書き

Env デフォルト 目的
TRACK_CWD process.cwd() スキャンするプロジェクトのセッションを上書きします
TRACK_SESSION 最新の jsonl 特定のセッションファイルを固定します
TRACK_OUT 未設定 JSON サマリーもこのパスに書き込みます
TRACK_DRY_RUN=1 未設定 memory store 呼び出しをスキップします
TRACK_QUIET=1 未設定 マークダウン出力を抑制します
TRACK_NAMESPACE cost-tracking ターゲットの名前空間を上書きします

相互参照

  • cost-report (コンシューマー) — このスキルによって生成されたレコードを読み取ります
  • REFERENCE.md 「Cost attribution formula」 — スクリプトが実装する計算式
  • cost-budget-check (コンシューマー; P2 でリリース予定) — 合計を読み取り、アラートを評価します
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Cost Track

Reads the active Claude Code session jsonl (~/.claude/projects/<encoded-cwd>/<session>.jsonl), tallies assistant-message usage per model, computes USD cost using REFERENCE.md pricing, and writes a structured record to the cost-tracking AgentDB namespace. This is the producer that gives cost-report and cost-optimize real data to consume.

When to use

  • After a meaningful chunk of work, to capture spend for the report.
  • At session-end to persist the final tally.
  • Periodically during long sessions (cron-friendly — see /loop 30m).

Steps

  1. Run the tracker from the project root:

    node plugins/ruflo-cost-tracker/scripts/track.mjs

    The script auto-discovers the session jsonl from the current working directory. To pin a specific session: TRACK_SESSION=/path/to/session.jsonl. To dry-run (no memory write): TRACK_DRY_RUN=1.

  2. Inspect the markdown summary — total cost, per-model and per-tier breakdowns, and the persisted memory key.

  3. Verify persistence — mcp__claude-flow__memory_search --query "session-" --namespace cost-tracking should list the new record. cost-report step 1 reads from this namespace.

Record shape (in cost-tracking namespace)

Key: session-<sessionId>. Value (JSON):

{
  "sessionId": "1dba3b8c-...",
  "cwd": "/Users/cohen/Projects/ruflo",
  "startedAt": "2026-05-04T...",
  "endedAt": "2026-05-05T...",
  "messageCount": 234,
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "input_tokens": 12345,
      "output_tokens": 6789,
      "cache_creation_input_tokens": 800000,
      "cache_read_input_tokens": 2000000,
      "messages": 50,
      "cost_usd": 1.23
    }
  },
  "byTier": { "haiku": 0.0, "sonnet": 0.45, "opus": 1.23, "unknown": 0 },
  "total_cost_usd": 1.68,
  "capturedAt": "2026-05-05T..."
}

Pricing source of truth

The script's PRICING constant mirrors REFERENCE.md "Model pricing (USD per 1M tokens)". Update both together when prices change. Cache-write tokens are billed at cache_write rate; cache-read tokens at cache_read (per Anthropic billing docs).

Env overrides

Env Default Purpose
TRACK_CWD process.cwd() Override which project's sessions to scan
TRACK_SESSION most-recent jsonl Pin a specific session file
TRACK_OUT unset Also write the JSON summary to this path
TRACK_DRY_RUN=1 unset Skip the memory store call
TRACK_QUIET=1 unset Suppress markdown output
TRACK_NAMESPACE cost-tracking Override target namespace

Cross-references

  • cost-report (consumer) — reads records produced by this skill
  • REFERENCE.md "Cost attribution formula" — the math the script implements
  • cost-budget-check (consumer; landing in P2) — reads totals to evaluate alerts