رفتن به محتوا

ردیابیِ استفاده‌ی تیم با آنالیتیکس

Claude Code داشبوردهای آنالیتیکس فراهم می‌کند تا به سازمان‌ها کمک کند الگوهای استفاده‌ی توسعه‌دهنده را بفهمند، متریک‌های مشارکت را ردیابی کنند و بسنجند Claude Code چطور بر سرعتِ مهندسی اثر می‌گذارد. به داشبوردِ متناسب با پلنت دسترسی پیدا کن:

پلنآدرسِ داشبوردشاملبیشتر بخوان
Claude for Teams / Enterpriseclaude.ai/analytics/claude-codeمتریک‌های استفاده، متریک‌های مشارکت با ادغامِ GitHub، تابلوی برترین‌ها، خروجی‌گیریِ دادهجزئیات
API (Claude Console)platform.claude.com/claude-codeمتریک‌های استفاده، ردیابیِ خرج، بینش‌های تیمیجزئیات

دسترسی به آنالیتیکس برای Team و Enterprise

Section titled “دسترسی به آنالیتیکس برای Team و Enterprise”

به claude.ai/analytics/claude-code برو. Adminها و Ownerها می‌توانند داشبورد را ببینند.

داشبوردِ Team و Enterprise این‌ها را شامل می‌شود:

  • متریک‌های استفاده: خطوطِ کدِ پذیرفته‌شده، نرخِ پذیرشِ پیشنهاد، کاربران و نشست‌های فعالِ روزانه
  • متریک‌های مشارکت: PRها و خطوطِ کدِ ارسال‌شده با کمکِ Claude Code، با ادغامِ GitHub
  • تابلوی برترین‌ها: برترین مشارکت‌کنندگان بر اساسِ استفاده از Claude Code رتبه‌بندی‌شده
  • خروجی‌گیریِ داده: داده‌ی مشارکت را به‌شکلِ CSV برای گزارش‌گیریِ سفارشی دانلود کن

برای شمارِ توکنِ هر-کاربر و برآوردهای هزینه، خروجیِ OpenTelemetry را پیکربندی کن.

فعال کردنِ متریک‌های مشارکت

Section titled “فعال کردنِ متریک‌های مشارکت”

داده‌ی استفاده و پذیرش برای همه‌ی حساب‌های Claude for Teams و Claude for Enterprise در دسترس است. متریک‌های مشارکت برای اتصالِ سازمانِ GitHubَت به راه‌اندازیِ بیشتری نیاز دارند.

برای پیکربندیِ تنظیماتِ آنالیتیکس به نقشِ Owner نیاز داری. یک adminِ GitHub باید اپِ GitHub را نصب کند.

نصبِ اپِ GitHub

یک adminِ GitHub اپِ Claude GitHub را روی حسابِ GitHubِ سازمانت در github.com/apps/claude نصب می‌کند.

فعال کردنِ آنالیتیکسِ Claude Code

یک Ownerِ Claude به claude.ai/admin-settings/claude-code می‌رود و قابلیتِ آنالیتیکسِ Claude Code را فعال می‌کند.

فعال کردنِ آنالیتیکسِ GitHub

در همان صفحه، کلیدِ «GitHub analytics» را فعال کن.

احراز هویت با GitHub

جریانِ احراز هویتِ GitHub را تکمیل کن و انتخاب کن کدام سازمان‌های GitHub در تحلیل گنجانده شوند.

داده معمولاً ظرفِ ۲۴ ساعت پس از فعال‌سازی ظاهر می‌شود، با به‌روزرسانی‌های روزانه. اگر هیچ داده‌ای ظاهر نشد، ممکن است یکی از این پیام‌ها را ببینی:

  • «GitHub app required»: اپِ GitHub را نصب کن تا متریک‌های مشارکت را ببینی
  • «Data processing in progress»: چند روز دیگر دوباره سر بزن و اگر داده ظاهر نشد تایید کن که اپِ GitHub نصب است

متریک‌های مشارکت از GitHub Cloud و GitHub Enterprise Server پشتیبانی می‌کنند.

بازبینیِ متریک‌های خلاصه

Section titled “بازبینیِ متریک‌های خلاصه”

داشبورد این متریک‌های خلاصه را در بالا نشان می‌دهد:

  • PRs with CC: شمارِ کلِ pull requestهای merge‌شده که دستِ‌کم یک خطِ کدِ نوشته‌شده با Claude Code دارند
  • Lines of code with CC: کلِ خطوطِ کد در همه‌ی PRهای merge‌شده که با کمکِ Claude Code نوشته شده‌اند. فقط «خطوطِ مؤثر» شمرده می‌شوند: خطوطی با بیش از ۳ کاراکتر پس از نرمال‌سازی، با کنار گذاشتنِ خطوطِ خالی و خطوطی که فقط براکت یا نقطه‌گذاریِ بی‌اهمیت دارند.
  • PRs with Claude Code (%): درصدِ همه‌ی PRهای merge‌شده که کدِ کمک‌گرفته‌از‑Claude Code دارند
  • Suggestion accept rate: درصدِ دفعاتی که کاربران پیشنهادهای ویرایشِ کدِ Claude Code را می‌پذیرند، شاملِ استفاده از ابزارهای Edit، Write و NotebookEdit
  • Lines of code accepted: کلِ خطوطِ کدِ نوشته‌شده توسطِ Claude Code که کاربران در نشست‌هایشان پذیرفته‌اند. این پیشنهادهای ردشده را کنار می‌گذارد و حذف‌های بعدی را ردیابی نمی‌کند.

داشبورد چند نمودار برای تصویرسازیِ روندها در طولِ زمان دارد.

نمودارِ Adoption روندهای استفاده‌ی روزانه را نشان می‌دهد:

  • users: کاربرانِ فعالِ روزانه
  • sessions: شمارِ نشست‌های فعالِ Claude Code در روز

سنجشِ PR به‌ازای هر کاربر

Section titled “سنجشِ PR به‌ازای هر کاربر”

این نمودار فعالیتِ هر توسعه‌دهنده را در طولِ زمان نشان می‌دهد:

  • PRs per user: شمارِ کلِ PRهای merge‌شده در روز تقسیم بر کاربرانِ فعالِ روزانه
  • users: کاربرانِ فعالِ روزانه

از این برای فهمِ اینکه بهره‌وریِ فردی با افزایشِ پذیرشِ Claude Code چطور تغییر می‌کند استفاده کن.

نمودارِ Pull requests تفکیکِ روزانه‌ی PRهای merge‌شده را نشان می‌دهد:

  • PRs with CC: pull requestهایی که کدِ کمک‌گرفته‌از‑Claude Code دارند
  • PRs without CC: pull requestهایی بدونِ کدِ کمک‌گرفته‌از‑Claude Code

به نمای Lines of code سوییچ کن تا همان تفکیک را بر اساسِ خطوطِ کد به‌جای شمارِ PR ببینی.

یافتنِ برترین مشارکت‌کنندگان

Section titled “یافتنِ برترین مشارکت‌کنندگان”

تابلوی برترین‌ها ۱۰ کاربرِ برتر را بر اساسِ حجمِ مشارکت رتبه‌بندی‌شده نشان می‌دهد. بینِ این‌ها سوییچ کن:

  • Pull requests: برای هر کاربر PRها با Claude Code در برابرِ کلِ PRها را نشان می‌دهد
  • Lines of code: برای هر کاربر خطوط با Claude Code در برابرِ کلِ خطوط را نشان می‌دهد

روی Export all users کلیک کن تا داده‌ی کاملِ مشارکتِ همه‌ی کاربران را به‌شکلِ یک فایلِ CSV دانلود کنی. خروجی همه‌ی کاربران را شامل می‌شود، نه فقط ۱۰ تای برترِ نمایش‌داده‌شده.

وقتی متریک‌های مشارکت فعال‌اند، Claude Code pull requestهای merge‌شده را تحلیل می‌کند تا تعیین کند کدام کد با کمکِ Claude Code نوشته شده. این کار با مطابقت دادنِ فعالیتِ نشستِ Claude Code با کدِ هر PR انجام می‌شود.

PRها به‌عنوانِ «with Claude Code» برچسب می‌خورند اگر دستِ‌کم یک خطِ کدِ نوشته‌شده در طولِ یک نشستِ Claude Code داشته باشند. سیستم از مطابقتِ محافظه‌کارانه استفاده می‌کند: فقط کدی که در دخالتِ Claude Code اطمینانِ بالایی هست به‌عنوانِ کمک‌گرفته‌شده شمرده می‌شود.

وقتی یک pull request merge می‌شود:

  1. خطوطِ افزوده‌شده از diffِ PR استخراج می‌شوند
  2. نشست‌های Claude Code که فایل‌های هم‌خوان را در یک بازه‌ی زمانی ویرایش کرده‌اند شناسایی می‌شوند
  3. خطوطِ PR با خروجیِ Claude Code با چند استراتژی مطابقت داده می‌شوند
  4. متریک‌ها برای خطوطِ کمک‌گرفته‌از‑هوش‌مصنوعی و کلِ خطوط محاسبه می‌شوند

پیش از مقایسه، خطوط نرمال می‌شوند: فاصله‌ی سفید بریده می‌شود، فاصله‌های متعدد جمع می‌شوند، نقل‌قول‌ها یک‌دست می‌شوند و متن به حروفِ کوچک تبدیل می‌شود.

pull requestهای merge‌شده‌ای که خطوطِ کمک‌گرفته‌از‑Claude Code دارند در GitHub به‌عنوانِ claude-code-assisted برچسب می‌خورند.

نشست‌های ۲۱ روز پیش تا ۲ روز پس از تاریخِ merge شدنِ PR برای مطابقتِ انتساب در نظر گرفته می‌شوند.

برخی فایل‌ها به‌طور خودکار از تحلیل کنار گذاشته می‌شوند چون خودکارتولیدشده‌اند:

  • فایل‌های lock: package-lock.json، yarn.lock، Cargo.lock و مشابه
  • کدِ تولیدشده: خروجی‌های Protobuf، artifactهای build، فایل‌های minify‌شده
  • دایرکتوری‌های build: dist/، build/، node_modules/، target/
  • fixtureهای تست: snapshotها، cassetteها، داده‌ی mock
  • خطوطِ بیش از ۱٬۰۰۰ کاراکتر، که احتمالاً minify‌شده یا تولیدشده‌اند

این جزئیاتِ بیشتر را هنگامِ تفسیرِ داده‌ی انتساب در نظر داشته باش:

  • کدی که به‌میزانِ چشمگیر توسطِ توسعه‌دهندگان بازنویسی شده، با بیش از ۲۰٪ تفاوت، به Claude Code منتسب نمی‌شود
  • نشست‌های بیرونِ بازه‌ی ۲۱‌روزه در نظر گرفته نمی‌شوند
  • الگوریتم هنگامِ انتساب شاخه‌ی مبدأ یا مقصدِ PR را در نظر نمی‌گیرد

بیشترین بهره را از آنالیتیکس بگیر

Section titled “بیشترین بهره را از آنالیتیکس بگیر”

از متریک‌های مشارکت استفاده کن تا ROI را نشان دهی، الگوهای پذیرش را شناسایی کنی و اعضای تیمی را که می‌توانند به دیگران در شروع کمک کنند پیدا کنی.

نمودارِ Adoption و شمارِ کاربران را ردیابی کن تا این‌ها را شناسایی کنی:

  • کاربرانِ فعالی که می‌توانند بهترین شیوه‌ها را به اشتراک بگذارند
  • روندهای کلیِ پذیرش در سراسرِ سازمانت
  • افت‌های استفاده که ممکن است نشانه‌ی اصطکاک یا مشکل باشند

متریک‌های مشارکت کمک می‌کنند به «آیا این ابزار ارزشِ سرمایه‌گذاری دارد؟» با داده‌ای از کدبیسِ خودت پاسخ دهی:

  • تغییراتِ PR به‌ازای هر کاربر را در طولِ زمان با افزایشِ پذیرش ردیابی کن
  • PRها و خطوطِ کدِ ارسال‌شده با و بدونِ Claude Code را مقایسه کن
  • در کنارِ متریک‌های DORA، سرعتِ اسپرینت یا دیگر KPIهای مهندسی استفاده کن تا تغییراتِ ناشی از پذیرشِ Claude Code را بفهمی

شناساییِ کاربرانِ قدرت

Section titled “شناساییِ کاربرانِ قدرت”

تابلوی برترین‌ها کمک می‌کند اعضای تیمی با پذیرشِ بالای Claude Code را پیدا کنی که می‌توانند:

  • تکنیک‌های پرامپت‌نویسی و ورک‌فلوها را با تیم به اشتراک بگذارند
  • درباره‌ی آنچه خوب کار می‌کند بازخورد بدهند
  • به onboardingِ کاربرانِ تازه کمک کنند

دسترسیِ برنامه‌نویسانه به داده

Section titled “دسترسیِ برنامه‌نویسانه به داده”

برای پرس‌وجوی این داده از طریقِ GitHub، PRهای برچسب‌خورده با claude-code-assisted را جست‌وجو کن.

دسترسی به آنالیتیکس برای مشتریانِ API

Section titled “دسترسی به آنالیتیکس برای مشتریانِ API”

مشتریانِ API که از Claude Console استفاده می‌کنند می‌توانند به آنالیتیکس در platform.claude.com/claude-code دسترسی پیدا کنند. برای دسترسی به داشبورد به دسترسیِ UsageView نیاز داری، که به نقش‌های Developer، Billing، Admin، Owner و Primary Owner اعطا می‌شود.

داشبوردِ Console این‌ها را نشان می‌دهد:

  • Lines of code accepted: کلِ خطوطِ کدِ نوشته‌شده توسطِ Claude Code که کاربران در نشست‌هایشان پذیرفته‌اند. این پیشنهادهای ردشده را کنار می‌گذارد و حذف‌های بعدی را ردیابی نمی‌کند.
  • Suggestion accept rate: درصدِ دفعاتی که کاربران استفاده از ابزارهای ویرایشِ کد را می‌پذیرند، شاملِ ابزارهای Edit، Write و NotebookEdit.
  • Activity: کاربران و نشست‌های فعالِ روزانه که روی نموداری نشان داده می‌شوند.
  • Spend: هزینه‌های روزانه‌ی API به دلار در کنارِ شمارِ کاربران.

جدولِ بینش‌های تیمی متریک‌های هر-کاربر را نشان می‌دهد:

  • Members: همه‌ی کاربرانی که به Claude Code احراز هویت کرده‌اند. کاربرانِ API key با شناسه‌ی key نمایش داده می‌شوند، کاربرانِ OAuth با آدرسِ ایمیل.
  • Spend this month: کلِ هزینه‌های APIِ هر کاربر برای ماهِ جاری.
  • Lines this month: کلِ خطوطِ کدِ پذیرفته‌شده‌ی هر کاربر برای ماهِ جاری.