Claude Code Analyticsでチーム貢献度を可視化する
Claude Codeのアナリティクスダッシュボードが出すコントリビューションメトリクスとPR貢献度の集計方法、有効化手順、Console版との違いをまとめます。
Claude Code Analyticsは何を数えているか
Claude Codeのアナリティクスは、開発者の利用パターン、コントリビューションメトリクス、エンジニアリング速度への影響を組織単位で集計します。ダッシュボードはプランで場所も中身も変わります。
開くダッシュボードで指標が変わる
Claude for Teams / Enterprise
利用状況、GitHub連携によるPR単位のコントリビューションメトリクス、リーダーボード、CSVエクスポートがあります。
API(Claude Console)
利用状況、支出、メンバー別のチームインサイトです。GitHub連携の貢献度分析はありません。
どちらの組織かで、この先で読む節が変わります。
誰がどの画面を開けるか
権限の書き方は、公式の2つのページで少しずれています。Claude Codeのドキュメントは、claude.ai側のダッシュボードを「AdminとOwnerが見られる」と書きます。一方、ヘルプセンターの利用分析の記事は、Teamプランでは対象をOwnerとPrimary Owner、EnterpriseプランではOwner・Primary Owner・Adminとしています。Enterprise Adminは支出(Spend)以外を見られます。
Teamプランで「Admin」ロールのメンバーがClaude Codeの画面を開けるかどうかは、2つのページから読み取れません。開けないときは、OwnerかPrimary Ownerに見てもらうのが確実です。
操作ごとの必要ロールは次のとおりです。
| やりたいこと | 必要なもの |
|---|---|
| コントリビューションメトリクスの設定 | 必要なものOwnerロール。GitHub側はアプリを入れられる管理者 |
| Console版ダッシュボードの閲覧 | 必要なものUsageView権限(Developer・Billing・Admin・Owner・Primary Ownerが持つ) |
| Enterprise Analytics APIのキー発行 | 必要なものPrimary Owner(read:analyticsスコープ) |
Analytics APIをオンにする操作もPrimary Ownerだけで、OwnerやAdminにはその項目が出ません。組織が親組織に紐づいている場合は、親組織のPrimary Ownerが行います。詳しくはClaude Team/Enterpriseの利用状況分析ガイドにあります。
Team/Enterpriseのダッシュボードで見られるもの
公式のClaude Codeドキュメントが挙げる構成は次の4つです。
| 項目 | 内容 |
|---|---|
| 利用状況メトリクス | 内容受け入れたコード行数、提案の受け入れ率、日次アクティブユーザーとセッション数 |
| コントリビューションメトリクス | 内容Claude Codeが関与したPRとコード行数(GitHub連携) |
| リーダーボード | 内容Claude Code利用量で並べた上位貢献者 |
| データエクスポート | 内容貢献度データをCSVでダウンロード |
ヘルプセンターの側では、同じ画面が「Productivity」「Usage」「Value」の3タブとして説明されています。Usageタブにはスキル、MCPサーバー、ツール利用、エージェント種別ごとのセッションが並びます。Valueタブには推定生産性向上、コミット単価、PR単価があり、計算式が画面に表示され、入力値を自組織の前提に合わせて変えられます。Claude Codeのドキュメントにはこの2つのタブの記述がないので、Valueタブの数字を使うときはヘルプセンターの説明を見てください。
ユーザー単位のトークン数やコストが欲しいときは、ダッシュボードでなく別の帳票を使います。
- OpenTelemetryエクスポート: リアルタイムのメトリクスとイベントを自前の可観測性基盤へ流す
- 支出レポート: 組織のアナリティクス設定からCSVで出せる
支出レポートの出し方は、Settings > Analyticsの「How much is Claude costing?」までスクロールし、「Export spend report」を押します。期間はMTD・Last Month・Last 90 Days・Customから選び、Customでもさかのぼれるのは90日で、最新のデータは前日分です。CSVの1行は「1人×1モデル」で、期間内の合計が入ります。メールアドレス、アカウントUUID、プロダクト、モデル、リクエスト数、入力トークン、出力トークン(拡張思考を含む)、割引後の支出、割引前の支出が含まれます。
座席ベースのEnterpriseでは、支出レポートは使用クレジットを有効にした組織にだけ出て、中身は座席の割り当てを超えた分だけです。従量課金のEnterpriseでは組織の利用全体が入ります。支出レポートのProduct列は、Code Reviewやセキュリティ機能のように以前はClaude Codeに含まれていた活動が、別の行項目で出ることがあります。請求額との関係も、ヘルプセンターは支出レポートやAnalytics APIが請求書に「よく一致するはず」と書いています。Console版の支出は分析用の見積もりで、実際の請求は請求ページで見ます。コスト全般はClaude Codeのコスト管理で扱っています。
コントリビューションメトリクスを有効にする
コントリビューションメトリクスはパブリックベータで、Claude for TeamsとEnterpriseで使えます。利用状況と採用のデータは全アカウントで見られ、GitHub組織との連携にだけ追加のセットアップが要ります。集計されるのはclaude.ai組織内のユーザーで、Claude Console API経由やサードパーティ統合の利用は含まれません。
有効化の4ステップ
- 1
GitHubアプリを入れる
GitHub管理者が、組織のGitHubアカウントにClaude GitHubアプリをインストールします(github.com/apps/claude)。
- 2
Claude Code analyticsを有効にする
ClaudeのOwnerが、claude.ai/admin-settings/claude-codeで機能をオンにします。
- 3
GitHub analyticsトグルをオンにする
同じ画面にあるトグルです。
- 4
GitHub認証と対象組織の選択
認証フローを完了し、分析に含めるGitHub組織を選びます。
有効化から通常24時間以内にデータが出て、以降は日次で更新されます。GitHub CloudとGitHub Enterprise Serverの両方に対応します。
サマリー指標の定義と読み違えやすい点
ダッシュボード上部には5つのサマリー指標が並びます。公式はこれらを意図的に控えめな集計だと説明していて、Claude Codeの実際の影響を過小評価する方向に振られています。関与に高い確信が持てる行とPRだけが数えられます。
| 指標 | 定義 |
|---|---|
| PRs with CC | 定義Claude Codeで書かれたコードを1行以上含むマージ済みPRの総数 |
| Lines of code with CC | 定義マージ済みPRのうち、Claude Codeの支援で書かれた行の合計(有効行のみ) |
| PRs with Claude Code(%) | 定義全マージ済みPRのうちClaude Code関与PRの割合 |
| Suggestion accept rate | 定義Edit・Write・NotebookEditツールの提案が受け入れられた割合 |
| Lines of code accepted | 定義Claude Codeが書いたコードの行数 |
「有効行」は正規化後に3文字を超える行で、空行や括弧・些末な句読点だけの行は除かれます。
行数の指標には読み違えやすい点が1つあります。「Lines of code accepted」について、公式のConsole版の説明には「却下された提案を含まず、その後の削除も追跡しない」とあります。つまり一度受け入れられた行数であって、いま残っている行数ではありません。Team/Enterprise側の同名の指標にこの注記は書かれていないので、同じ定義かどうかはドキュメントからは確認できません。
チャートは4種類です。Adoptionは日次アクティブユーザーとセッション数の推移、PRs per userは日次のマージPR数を日次アクティブユーザーで割った値です。Pull requestsはClaude Code関与PRとそれ以外の日次内訳で、コード行数表示にも切り替えられます。Leaderboardは貢献量の上位10ユーザーを出し、「Export all users」のCSVには10人に限らず全員が入ります。
PR貢献度の判定ロジックと時間窓
マージされたPRを分析し、どのコードがClaude Codeの支援で書かれたかを、PRのdiffとClaude Codeのセッションログの突き合わせで判定します。基準は保守的で、Claude Codeのセッション中に書かれたコードを少なくとも1行含むPRだけが「with Claude Code」になります。
判定の流れ
- 1
追加行を抽出
PRのdiffから追加された行を取り出します。
- 2
セッションを特定
一定の時間窓の中で、該当ファイルを編集したClaude Codeセッションを探します。
- 3
出力と照合
PRの行をClaude Codeの出力と、複数の戦略で照合します。
- 4
メトリクスを算出
AI支援行と全体の行数から計算します。
照合の前に、行は正規化されます。空白のトリム、連続スペースの圧縮、引用符の統一、小文字への変換です。フォーマッタで空白だけ変わった行も同一視されるのは、この正規化のためです。関与行を含むマージ済みPRには、GitHub上で claude-code-assisted ラベルが付きます。
判定の境界値
時間窓(前)
21日
PRのマージ日から見て
時間窓(後)
2日
マージ日の後まで
書き直しの上限
20%
超えるとClaude Codeに帰属しない
行の長さの上限
1,000文字
超える行は除外
マージ日が9月30日のPRなら、照合されるのは9月9日から10月2日までのセッションです(日付は計算例です)。9月5日のセッションで書いたコードは、このPRの照合対象になりません。窓の外のセッションは考慮されない、と公式が明記しています。
除外対象のファイルもあります。
- ロックファイル(package-lock.json、Cargo.lockなど)
- 自動生成コード(Protobuf出力、ビルド成果物、minifyされたファイル)
- ビルドディレクトリ(dist/、build/、node_modules/、target/)
- テストフィクスチャ(スナップショット、cassette、モックデータ)
判定はPRのソースブランチや宛先ブランチを見ません。ブランチ戦略で帰属を調整する仕組みはない、ということです。
数字が合わないときの切り分け
ダッシュボードの数字が体感と違うとき、公式の記述から原因を絞れるものを表にします。
| 症状 | 考えられる原因と確認先 |
|---|---|
| 「GitHub app required」と出る | 考えられる原因と確認先GitHubアプリが未インストール。GitHub管理者がインストールする |
| 「Data processing in progress」と出る | 考えられる原因と確認先処理中。数日待ち、それでも出なければアプリの導入を確認する |
| PR系の指標がなく利用状況だけ | 考えられる原因と確認先ZDR有効の組織は貢献指標が出ない仕様 |
| 関与したはずのPRにラベルがない | 考えられる原因と確認先セッションが窓の外、大幅に書き直した(20%超)、除外ファイルだけの変更、claude.ai組織外(Console APIやサードパーティ経由)の利用のいずれか |
| リーダーボードに全員いない | 考えられる原因と確認先画面は上位10人まで。全員分は「Export all users」 |
| 費用が請求額と違う | 考えられる原因と確認先Console版は見積もり。Team/Enterpriseの支出レポートは請求書に近く、座席ベースEnterpriseは割り当て超過分だけ |
公式ドキュメントには、時間窓や除外ファイルを組織側で調整する設定は記載がありません。窓に収まらない作業が多い組織は、その前提で数字を読むことになります。
Console版アナリティクスの中身
ConsoleのAPI顧客は、platform.claude.com/claude-codeでアナリティクスを開きます。同じ日次のユーザー別指標をプログラムから取るときは、Admin APIキーでClaude Code Analytics APIを使います。
ダッシュボードの表示は4つです。Lines of code acceptedとSuggestion accept rateに加え、Activity(日次のアクティブユーザーとセッション数)とSpend(日次のAPIコストとユーザー数)が並びます。GitHub連携のコントリビューションメトリクスは、API顧客には提供されていません。
チーム別にはteam insightsテーブルがあり、メンバーごとの当月支出と当月コード行数が見られます。APIキーの利用者はキー識別子、OAuthユーザーはメールアドレスで表示されます。
指標をどう使うか
公式が挙げる使い道は3つです。目的から見る指標を選ぶと次のようになります。
| 目的 | 見る指標 | 組み合わせるもの |
|---|---|---|
| 採用状況の把握 | 見る指標Adoptionチャートとユーザー数 | 組み合わせるもの利用が落ち込んだ時期に摩擦がなかったか |
| 投資対効果の説明 | 見る指標PRs per userの変化、関与PRとそれ以外の行数比較 | 組み合わせるものDORAメトリクスやスプリントベロシティ |
| 展開役の発掘 | 見る指標Leaderboardの高採用メンバー | 組み合わせるものプロンプト技法の共有、オンボーディングの依頼 |
コントリビューションの数字は控えめに集計されるので、絶対値より導入前後や期間どうしの変化で見るほうが、過小評価の影響を受けにくくなります。
プログラムからの取得は、Enterpriseプランに用意されています。Enterprise Analytics APIは、Claude Codeを含むClaude全体について、ユーザー単位のエンゲージメント・利用状況・コストのレポートを返します。キーはPrimary Ownerがread:analyticsスコープで作り、Teamプランでは使えません。TeamとEnterpriseの差はClaude Enterpriseプランガイドにあります。GitHub側から貢献データを引くだけなら、claude-code-assistedラベルでPRを検索する方法もあります。全体像はClaude Codeの解説にあります。
まとめ
見るべき画面は、Teams/Enterpriseならclaude.aiの3タブ、Console顧客ならplatform.claude.comで、PR単位の貢献度が出るのは前者だけです。数字が体感とずれたら、時間窓・書き直し率・除外ファイル・組織外の利用の4点を先に疑うと、原因を絞りやすくなります。