Contribution metricsをClaude Codeで有効化してPR貢献を計測する手順

Contribution metricsは、Claude Codeのanalyticsダッシュボードに「どのPRがClaude Code支援で書かれたか」を表示するベータ機能です。Claude for TeamsとEnterpriseで使え、GitHub組織との連携を別途設定して初めて表示されます。GitHubアプリの導入からOwnerの設定、GitHub組織の認証までを4ステップで済ませます。

Contribution metricsで分かること

Claude for Teams・Enterpriseのanalyticsダッシュボードには、もともと利用状況の指標が表示されています。採用率やアクティブユーザー数のような、Claude Code自体のセッションから取れる数字です。Contribution metricsはそこに別の軸を足します。GitHubと連携し、実際にマージされたPRのうちどれだけがClaude Codeの支援を受けたかを、コード行数とPR数の両面で可視化します。

この機能はパブリックベータで、対象はclaude.ai組織内のユーザーに限られます。Claude Console API経由の利用やサードパーティ統合は集計に含まれません。設定にはOwnerロールと、GitHub組織側の管理者権限の両方が要ります。

有効化前に確認すること

作業に入る前に、次の3点を確認しておくと手戻りがありません。

• プラン: Claude for TeamsまたはEnterpriseであること。API(Claude Console)顧客向けのanalyticsにはcontribution metricsが含まれません
• Zero Data Retention(ZDR)を有効にしていないこと: ZDRを有効化した組織ではcontribution metricsが使えず、ダッシュボードは利用状況の指標のみになります
• GitHub CloudまたはGitHub Enterprise Serverを使っていること: contribution metricsが対応するのはこの2つです

有効化の4ステップ

設定は4ステップで完結します。どのステップを誰が実行するかを間違えると、途中で権限不足に当たって止まるので、先に役割を確認しておきます。

ステップ1: GitHub管理者がgithub.com/apps/claudeからClaude GitHub Appを組織のGitHubアカウントにインストールします。この作業はGitHub側の管理者しか行えません。

ステップ2・3: Claude OwnerがClaude Codeの管理設定ページ(claude.ai/admin-settings/claude-code)に移動し、Claude Code analytics機能を有効化します。同じページに「GitHub analytics」というトグルがあるので、続けて有効にします。

ステップ4: GitHub認証フローに進み、分析対象に含めるGitHub組織を選択して完了します。組織を複数運用している場合、この画面でanalyticsの対象に含めたい組織だけを選べます。全社のリポジトリをまとめて解析対象にする必要はなく、Claude Codeの利用が進んでいる組織だけを先に対象にする、という進め方もできます。

データが反映されるまでとメッセージの見分け方

設定を終えてから通常24時間以内にデータが表示され、以降は日次で更新されます。反映が遅れているとき、ダッシュボードには2種類のメッセージが出ます。

• 「GitHub app required」: GitHubアプリ自体がまだインストールされていません。ステップ1からやり直します
• 「Data processing in progress」: アプリはインストール済みで処理待ちの状態です。数日待っても表示されない場合は、アプリが正しくインストールされているかを再確認します

どちらのメッセージかで、確認すべき箇所がステップ1側かステップ2以降側かに分かれます。この見分けをつけずに待ち続けると、原因がGitHub側なのかClaude側なのか切り分けられません。

有効化後に見えるようになる指標

設定が終わると、ダッシュボード上部にサマリー指標が並びます。「Claude Codeが関わったPR数」「Claude Code支援で書かれたコード行数」「全マージ済みPRに対するClaude Code関与PRの割合」に加えて、もともとの利用状況指標である「編集提案の受け入れ率」「受け入れられたコード行数」も並びます。これらの数値は意図的に保守的で、Claude Codeの関与に高い確信度があるコードだけをカウントします。

グラフ面では、日次アクティブユーザーとセッション数を追う「Adoption」、ユーザーあたりのPR数の推移を見る「PRs per user」、Claude Code支援ありなしでPRを日次に積み上げる「Pull requests」、上位10人を並べる「Leaderboard」の4種類が使えます。LeaderboardはCSVで全ユーザー分をエクスポートできるので、上位10人の表示だけでは見えない全体像も追えます。

有効化後にAPIやGitHub側からもデータを取れる

ダッシュボードを毎回開かなくても、貢献データを取得する経路がもう2つあります。Enterpriseプランなら、Claude Enterprise Analytics APIを使えます。Primary Ownerがclaude.ai/analytics/api-keysでread:analyticsスコープのキーを発行すれば、Claude Codeを含むClaudeの各利用形態のエンゲージメント・利用状況・コストレポートをユーザー単位でプログラムから取得できます。このAPIはTeamsプランには提供されません。

もう1つはGitHub側からの参照です。Claude Code支援コードを含むマージ済みPRにはclaude-code-assistedラベルが付くので、GitHubの検索でこのラベルを条件にすれば、ダッシュボードを介さずに対象PRを直接絞り込めます。どちらの経路も、ダッシュボードのLeaderboardからCSVを都度エクスポートするより、継続的なレポーティングに向いています。個々のPRがこのラベルを付けられる詳しい判定基準はAnalyticsでPRがClaude Codeの貢献として計上される仕組みで扱っています。

よくあるつまずき

• 有効化の設定を変更できない: analytics設定を変更できるのはClaude組織のOwnerロールだけです。いったん有効化された後のclaude.ai/analytics/claude-codeダッシュボード自体はAdminとOwnerの両方が閲覧できます。有効化担当と日常的な閲覧担当を別のロールに分けても支障はありません
• GitHub analyticsトグルはあるがオンにできない: 先にステップ1のGitHub Appインストールが済んでいるか確認します。アプリが入っていない状態ではトグルを有効にしても機能しません
• 数日待ってもデータが出ない: 「Data processing in progress」のまま止まっている場合、GitHub App側のインストールが対象リポジトリまで正しく及んでいるかを、GitHub組織側の設定画面から確認します
• API(Claude Console)側でも見たい: Console経由のanalyticsにcontribution metrics相当の機能はありません。Consoleダッシュボードは利用状況と支出の指標に限られます。トークン単位のコスト把握にはClaude CodeのOpenTelemetryで利用量とコストを可視化のような別経路が必要です
• GitHub Enterprise Serverを使っている: クラウド版のGitHubだけでなく、GitHub Enterprise Serverも対応対象です。オンプレミス運用だからという理由だけで導入を諦める必要はありません

まとめ

Contribution metricsの有効化は、GitHub管理者によるアプリインストール、Claude OwnerによるClaude Code analyticsとGitHub analyticsの有効化、GitHub組織の認証という4ステップで完結します。Claude for Teams・Enterprise限定で、Zero Data Retentionを有効にした組織では使えません。設定後は24時間以内、以降は日次でデータが更新され、PR数・コード行数・受け入れ率・Leaderboardといった指標が使えるようになります。有効化そのものはOwnerしか行えませんが、日々の閲覧はAdminにも開けるので、設定担当と数字を追う担当を分けて運用することもできます。チーム全体の支出も一緒に見たい場合はClaude Codeのコスト管理、導入をチームに広げる進め方はClaude Codeチーム導入ガイドを参照してください。