株式会社AgenticSec 的軟體工程師爲西。

在日常開發中,當我越來越常使用 Claude Code 時,token 與成本雖然可以用數字追蹤,但技能、MCP、子代理在團隊中究竟滲透到什麼程度,卻往往得逐一翻看各個 session 才勉強掌握——這樣的體驗我反覆遇到。明明有方便的功能,卻來不及共享;本來以為已導入的 MCP,卻沒有人在用。這種「看不見」的問題,我認為只要有一個 dashboard,就能改善相當多。

TL;DR

我們將 Claude Code 的技能、MCP 伺服器、子代理的使用狀況與 token 消耗量自動收集,並可在團隊內共享的 dashboard,以 OSS 形式公開了。

GitHub: https://github.com/AgenticSec/ClaudeCodeUsageDashboard

dashboard-screenshot.png

Inspired by

這個 dashboard 是受到 「為了達成所有工程師 100% 活用 Claude Code,而製作了 dashboard」 這篇文章的啟發而誕生的。

該文章解析 Claude Code 的 transcript,將技能、子代理、MCP 的使用狀況可視化,並報告了公開後 1 週內子代理使用數約增加 1.5 倍的成果。
受到「只要可視化就會改變行為」這個實證的啟發,我也以OSS 的形式製作了相同類型的 dashboard。

「有在使用」與「有善加運用」之間看不見的差距

當 Claude Code 導入團隊時,是否真的有發揮與投入相符的效益——費用對效益其實意外地難以看見。光看成本數字,只能知道「用了多少」,卻看不出「是否有善加運用」。

真正想知道的是,團隊究竟把 Claude Code 的功能發揮到什麼程度。

現在在 Claude Code 的世界裡,不只是單純透過聊天來寫程式,還可以透過組合技能、MCP 伺服器、子代理,把 AI 的能力擴展好幾倍。

  • 技能(Slash Commands) — 例如 /commit 自動產生 commit 訊息、/review-pr 做 PR review、定義自訂工作流程
  • MCP 伺服器 — 與 Notion、Slack、Figma、資料庫等外部服務進行即時整合
  • 子代理 — 將工作並行委派給專門代理,例如 Explore(探索程式碼庫)、Plan(規劃設計)等

有善用這些功能的團隊,與只用原生聊天功能的團隊之間,生產力會產生巨大的差距。

問題在於,這種差距從外部看不見。

「MCP 伺服器明明已經導入,卻沒有人在用」、「明明有很方便的技能,卻沒有人知道它的存在」——這類情況,如果不看使用資料,是不會察覺的。

這個 dashboard 解決的問題

把團隊的「只導入了」變成「確實有在活用」

這個 dashboard 會從 Claude Code 的 session 資料中自動收集並可視化技能、MCP、子代理的使用狀況,讓團隊整體的活用程度一眼就能掌握。

可看見的項目 對團隊的重要性
技能的使用頻率 辛苦做出來的自訂技能,團隊內真的有在用嗎?是否有人根本不知道它的存在?
MCP 伺服器的呼叫次數 導入的 Notion 或 Slack 整合,有被整個團隊活用嗎?是否只集中在少數人?
子代理的活用狀況 Explore、Plan 等專門代理,團隊是否有用得上手?是否有人還在用手動搜尋浪費時間?
token 消耗與成本 整體團隊的預算管理。成員之間對 Opus/Sonnet/Haiku 的分配是否適當?

能直接連結到具體行動的資料

dashboard 所得到的資料,可以直接轉化成團隊改善的行動。

例 1:促進 MCP 伺服器活用

看 dashboard 發現 mcp__notion 的呼叫次數在整個團隊中很少 → 向全團隊分享 Notion MCP 的使用方式 → 減少為了查文件而切換到瀏覽器的浪費

例 2:推廣技能

發現 /commit 的使用率很低 → 在 CLAUDE.md 中加入技能介紹 → 統一 commit 訊息的品質

例 3:促進子代理活用

發現 Explore 代理的使用很少 → 指導在大型程式碼庫探索時使用子代理 → 縮短理解程式碼所需的時間

運作方式

只要安裝插件就能自動收集

我們活用了 Claude Code 的 Stop hookPlugin 機制。只要安裝插件,在 session 結束時就會自動解析 transcript(~/.claude/projects/{hash}/{session_id}.jsonl),並送到 API。

不會對開發者的工作流程造成任何影響。

架構

Claude Code session 結束
  │
  ▼
Stop hook (session-uploader.py)
  │  解析 transcript JSONL
  │  擷取技能 / MCP / 子代理 / token
  │
  ▼
POST /api/v1/usage/ingest
  │
  ▼
dashboard UI (Recharts)

dashboard 畫面

KPI 卡片

顯示 session 數、對話輪數、技能/MCP/子代理呼叫次數、預估成本、總 token 數。

技能・MCP・子代理分布

以圓餅圖顯示使用比例。可一眼看出導入的 MCP 伺服器是否真的有被活用、哪些技能最受歡迎。也有助於發現團隊內的最佳實踐。

使用者排行榜・使用者別分析

以成本為基準,顯示誰使用 Claude Code 的程度有多少。可視化活用程度的落差,進而帶動整個團隊一起提升。點擊排行榜的長條,或從使用者下拉選單選擇,即可顯示該使用者的所有指標(技能/MCP/子代理使用趨勢、成本變化、模型使用分配)。

活用案例: 「A 同事很積極使用子代理,但 B 同事幾乎沒用 MCP 伺服器」→ 便可對 B 同事進行個別支援。

Repository 別分析

透過 repository 下拉選單,可以確認以專案為單位的使用狀況。使用者與 repository 的篩選可以組合,甚至能做出像是「A 同事在 X repository 裡是怎麼使用的」這種精準分析。

成本・token 趨勢

以圖表顯示每日變化。可及早偵測成本突然增加,以及 token 消耗模式的變化。

模型分布

Opus / Sonnet / Haiku 的使用比例,可作為成本最佳化的判斷依據。

Recent Sessions

顯示最近的 session 清單,並附上使用者名稱、repository 名稱、模型、token、成本。

整體畫面大概是這樣!
ダッシュボード全画面

總結

Claude Code 的真正價值,在於將技能、MCP、子代理組合起來,擴展 AI 的能力。然而,這些活用狀況若不看 log,是無法知道的。

這個 dashboard 可以解決「雖然導入了,但不知道有沒有被使用」這個問題。只要安裝插件,資料收集就會開始,並能將整個團隊的工具活用狀況可視化。

  • 如果技能沒有被使用 → 加強宣導
  • 如果 MCP 伺服器的使用很偏頗 → 做培訓
  • 如果子代理沒有被活用 → 提供指引

只要有資料可見,就能改善。歡迎試試看。

GitHub: https://github.com/AgenticSec/ClaudeCodeUsageDashboard

最後

AgenticSec 一直重視開發者體驗,同時也在開發能夠在世界舞台上競爭的 AI × 資安 產品。
我們目前積極招募中,如果你有興趣,也歡迎看看招募頁面


原文出處:https://qiita.com/tamepicomaru/items/8f9b238ae28e380e6029


精選技術文章翻譯,幫助開發者持續吸收新知。

共有 0 則留言


精選技術文章翻譯,幫助開發者持續吸收新知。
🏆 本月排行榜
🥇
站長阿川
📝3   💬3   ❤️1
198
🥈
我愛JS
💬2  
7
🥉
Gigi
2
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次
📢 贊助商廣告 · 我要刊登