Claude Code Analyticsでチーム貢献度を可視化する
Claude Codeのアナリティクスダッシュボードが出すコントリビューションメトリクスとPR貢献度の集計方法、有効化手順、Console版との違いをまとめます。
Claude Code Analyticsは何を数えているか
Claude Codeのアナリティクスダッシュボードは、開発者の利用パターン・コントリビューションメトリクス・エンジニアリング速度への影響を組織向けに集計します。ダッシュボードはプランによって場所と中身が変わります。Claude for Teams・Enterpriseのユーザーはclaude.aiのアナリティクス画面を、Claude Console(API)を使う組織はplatform.claude.comのダッシュボードを使います。
同じ「アナリティクス」という名前でも、この2つは提供する指標がかなり違います。Teams/EnterpriseはGitHub連携によるPR単位の貢献度分析とリーダーボードを持ちますが、Consoleは利用状況と支出の追跡に留まります。どちらを使う組織かによって、この先読むべき節が変わります。
Team/Enterpriseのダッシュボードで何が見られるか
claude.ai/analytics/claude-codeにAdminまたはOwnerでアクセスすると、次の4つが見られます。
| 項目 | 内容 |
|---|---|
| 利用状況メトリクス | 内容受け入れたコード行数、提案の受け入れ率、日次アクティブユーザーとセッション数 |
| コントリビューションメトリクス | 内容Claude Codeが関与したPRとコード行数(GitHub連携) |
| リーダーボード | 内容Claude Code利用量で並べた上位貢献者 |
| データエクスポート | 内容貢献度データをCSVでダウンロード |
ユーザー単位のトークン数やコスト見積もりが必要な場合は、この画面ではなくOpenTelemetryエクスポートか、組織のアナリティクス設定からエクスポートできる支出レポートを使います。支出レポートはユーザーごと・モデルごとのトークン使用量と見積もり使用クレジットを一覧できる、ダッシュボードとは別の帳票です。
コントリビューションメトリクスを有効にする
コントリビューションメトリクスはパブリックベータで、Claude for Teams・Enterpriseで使えます。利用状況・採用データ自体は全アカウントで見られますが、GitHub組織との連携には追加のセットアップが必要です。設定にはOwnerロールが必要で、GitHub側の管理者がアプリをインストールする必要があります。
有効化は4ステップです。
- GitHub管理者が組織のGitHubアカウントにClaude GitHubアプリをインストールする(github.com/apps/claude)
- ClaudeのOwnerがclaude.ai/admin-settings/claude-codeでClaude Code analytics機能を有効にする
- 同じ画面でGitHub analyticsトグルを有効にする
- GitHub認証フローを完了し、分析対象にするGitHub組織を選択する
有効化から実際にデータが出るまでは通常24時間以内で、以降は日次更新です。データが出ない場合は「GitHub app required」(アプリ未インストール)か「Data processing in progress」(処理中、数日待って確認)のいずれかのメッセージが表示されます。対応するGitHub Cloud・GitHub Enterprise Serverの両方でこの機能は動きます。
サマリー指標とPR貢献度の定義
ダッシュボード上部には5つのサマリー指標が並びます。これらの指標は意図的に控えめに集計されていて、Claude Codeの実際の影響を過小評価する方向に振られています。Claude Codeの関与に高い確信が持てる行・PRだけがカウントされます。
| 指標 | 定義 |
|---|---|
| PRs with CC | 定義Claude Codeで書かれたコードを1行以上含むマージ済みPRの総数 |
| Lines of code with CC | 定義Claude Codeが関与した全マージ済みPRの合計行数(有効行のみ) |
| PRs with Claude Code(%) | 定義全マージ済みPRのうちClaude Code関与PRの割合 |
| Suggestion accept rate | 定義Edit・Write・NotebookEditツールの提案が受け入れられた割合 |
| Lines of code accepted | 定義セッション内でユーザーが受け入れたClaude Code由来のコード行数 |
「有効行」は3文字を超える正規化後の行で、空行や括弧・些末な句読点だけの行は除外されます。「Lines of code accepted」は却下された提案を含まず、その後の削除も追跡しません。つまりこの数字は「一度は受け入れられた行数」であって「いま残っている行数」ではない点に注意が必要です。
ダッシュボードにはさらに4種類のチャートがあります。Adoptionチャート(日次アクティブユーザーとセッション数の推移)、PRs per userチャート(日次マージPR数を日次アクティブユーザーで割った値の推移)、Pull requestsチャート(Claude Code関与PRとそれ以外の日次内訳、コード行数表示にも切り替え可能)、そしてLeaderboard(貢献量上位10ユーザー、PR数とコード行数を切り替え表示)です。Leaderboardからは「Export all users」で全ユーザー分のCSVをダウンロードでき、これは画面表示される上位10人だけでなく全員分が含まれます。
PR貢献度はどうやって計算されているか
コントリビューションメトリクスが有効なとき、Claude CodeはマージされたPRを分析し、どのコードがClaude Codeの支援で書かれたかを判定します。判定はPRのdiffとClaude Codeのセッションログの突き合わせで行われます。
タグ付けの基準は保守的です。少なくとも1行、Claude Codeセッション中に書かれたコードを含むPRだけが「with Claude Code」としてタグ付けされます。判定プロセスは4段階で進みます。
- PRのdiffから追加された行を抽出する
- その時間帯に該当ファイルを編集したClaude Codeセッションを特定する
- PRの行をClaude Codeの出力と複数の戦略で照合する
- AI支援行と全体行数からメトリクスを計算する
照合の前には正規化が入ります。空白のトリム、連続スペースの圧縮、引用符の統一、小文字への変換です。この正規化のおかげで、フォーマッタが入って空白だけ変わったような行も同一視されます。マージ済みPRのうちClaude Code関与行を含むものは、GitHub上で claude-code-assisted ラベルが付きます。
時間窓と除外対象
照合の対象になるのは、PRのマージ日から見て21日前から2日後までのセッションです。この窓の外にあるセッションは、実際にそのPRのコードを書いていても照合対象になりません。長期ブランチで作業してからマージまで日が空いたケースでは、この窓に収まらず正しく帰属しないことがあります。
除外されるファイルもあります。package-lock.jsonやCargo.lockのようなロックファイル、Protobuf出力・ビルド成果物・minifyされたファイルなどの自動生成コード、dist/やnode_modules/のようなビルドディレクトリ、スナップショットやモックデータのテストフィクスチャ、そして1,000文字を超える行(minifyや自動生成の可能性が高い)です。
さらに2つの注記があります。開発者が20%を超えて大幅に書き直したコードはClaude Codeに帰属されません。またアルゴリズムはPRのソースブランチや宛先ブランチを判定に考慮しません。ブランチ運用によっては、この2点が実測値と体感のズレを生む原因になります。
Console版アナリティクスとの違い
Claude ConsoleのAPI顧客はplatform.claude.com/claude-codeでアナリティクスにアクセスします。アクセスにはUsageView権限が必要で、これはDeveloper・Billing・Admin・Owner・Primary Ownerの各ロールに付与されています。同じ日次ユーザー別指標をプログラムから取得したい場合は、Admin APIキーを使ってClaude Code Analytics APIを叩きます。
Consoleダッシュボードが表示するのは次の4つで、GitHub連携によるコントリビューションメトリクスは含まれません。
| 指標 | 内容 |
|---|---|
| Lines of code accepted | 内容ユーザーが受け入れたコード行数の合計(却下分・その後の削除は含まない) |
| Suggestion accept rate | 内容Edit・Write・NotebookEditツールの提案受け入れ率 |
| Activity | 内容日次アクティブユーザーとセッション数のチャート |
| Spend | 内容日次のAPIコストとユーザー数 |
チーム別の内訳を見たい場合は、team insightsテーブルでメンバーごとの当月支出・当月コード行数を確認できます。メンバーはAPIキー利用者ならキー識別子で、OAuthユーザーならメールアドレスで表示されます。Console側の支出額はあくまで分析目的の見積もりで、実際の請求額は請求ページで確認する必要があります。
アナリティクスは3つの用途に使える
数字を眺めるだけでは意味がありません。公式が挙げる活用は主に3つに集約できます。
1つ目はアダプションの監視です。Adoptionチャートとユーザー数の推移から、ベストプラクティスを共有できるアクティブユーザー、組織全体の採用トレンド、摩擦や問題を示唆する利用の落ち込みを見つけます。
2つ目はROIの測定です。「このツールは投資に見合うか」という問いに、自組織のコードベースから得たデータで答えられます。導入が進むにつれてPRs per userがどう変化したか、Claude Code関与PRとそうでないPRの行数を比較し、DORAメトリクスやスプリントベロシティと組み合わせて評価します。
3つ目はパワーユーザーの発掘です。Leaderboardで見つかる高採用率のメンバーは、プロンプト技法の共有・フィードバック提供・新規ユーザーのオンボーディングを担える候補になります。
プログラムからのアクセスも用意されています。Enterpriseプランでは、Claude Enterprise Analytics APIがユーザー単位のエンゲージメント・利用状況・コストレポートを、Claude Codeを含むClaude全体のサーフェスについて返します。Primary Ownerがread:analyticsスコープのキーを発行して使い、このAPIはTeamsプランでは使えません。TeamとEnterpriseのどちらでこの差が生まれるかはClaude Enterpriseプランガイドで扱っています。GitHub側からコントリビューションデータを検索したいだけなら、claude-code-assistedラベルでPRを検索する方法もあります。組織全体のデータ取り扱い方針とあわせて可視化を設計する場合はClaude Code組織導入の意思決定マップも参考になります。
まとめ
Claude Code Analyticsは、Teams・Enterpriseがclaude.aiで見るダッシュボードと、Console(API)顧客がplatform.claude.comで見るダッシュボードの2系統に分かれ、前者だけがGitHub連携によるPR単位のコントリビューションメトリクスを持ちます。指標はいずれも保守的に集計されており、「Lines of code accepted」のように受け入れ後の削除を追跡しない指標や、21日前〜2日後という固定の時間窓のように、実測値と体感がずれる要因もあらかじめ把握しておく必要があります。活用の軸はアダプションの監視・ROIの測定・パワーユーザーの発掘の3つで、Enterpriseプランではread:analyticsスコープのAPIキーによるプログラムからのアクセスも可能です。
よくある質問
コントリビューションメトリクスはConsole(APIキー)利用者にも使えるか
使えません。GitHub連携によるコントリビューションメトリクスはclaude.ai組織内のユーザーだけが対象で、Claude Console API経由やサードパーティ統合経由の利用はカウントされません。
Proプラン・Maxプランでもアナリティクスダッシュボードは使えるか
使えません。アナリティクスダッシュボードとコントリビューションメトリクスはTeamとEnterpriseプラン限定です。個人向けのProやMaxプランには提供されていません。
「Lines of code accepted」が実際のコードベースの行数と一致しないのはなぜか
この指標は却下された提案を除外する一方、受け入れ後の削除は追跡しません。つまり一度受け入れられて後から消された行も加算されたままになるため、現在のコードベースの実測行数とは一致しません。
PR貢献度の21日という時間窓を延ばすことはできるか
公式ドキュメントには時間窓を組織側で調整する設定は記載されていません。長期ブランチで作業する組織は、この21日前〜2日後という固定窓の外で書かれたコードが正しく帰属されない可能性を前提に数字を読む必要があります。