📘 תיעוד 122

מעקב אחרי שימוש הצוות עם אנליטיקס

הצגת מדדי שימוש של Claude Code, מעקב אחרי אימוץ, ומדידת קצב הנדסי בלוח האנליטיקס.

Claude Code מספק לוחות אנליטיקס שעוזרים לארגונים להבין דפוסי שימוש של מפתחים, לעקוב אחרי מדדי תרומה, ולמדוד איך Claude Code משפיע על הקצב ההנדסי. גישה ללוח לפי התוכנית שלך:

ל-Code Review יש לוח משלו. לפעילות סקירה ולהוצאות, ראה View usage.

#גישה לאנליטיקס ל-Team ול-Enterprise

נווט אל claude.ai/analytics/claude-code. Admins ו-Owners יכולים לצפות בלוח.

לוח Team ו-Enterprise כולל:

• מדדי שימוש: שורות קוד שהתקבלו, שיעור קבלת הצעות, משתמשים פעילים יומיים וסשנים
• מדדי תרומה: PRs ושורות קוד שנשלחו בסיוע Claude Code, עם אינטגרציית GitHub
• לוח מובילים: התורמים המובילים מדורגים לפי שימוש ב-Claude Code
• ייצוא נתונים: הורדת נתוני תרומה כ-CSV לדיווח מותאם

לספירת טוקנים ולאומדני עלות לפי משתמש, הגדר ייצוא OpenTelemetry, או ייצא את דוח ההוצאות מהגדרות האנליטיקס של הארגון, שמפרט שימוש בטוקנים והוצאת קרדיטי שימוש משוערת לפי משתמש ולפי מודל.

#הפעלת מדדי תרומה

[!NOTE]

מדדי תרומה נמצאים בבטא ציבורית וזמינים בתוכניות Claude for Teams ו-Claude for Enterprise. המדדים האלה מכסים רק משתמשים בתוך ארגון ה-claude.ai שלך. שימוש דרך Claude Console API או אינטגרציות צד שלישי אינו כלול.

נתוני שימוש ואימוץ זמינים לכל חשבונות Claude for Teams ו-Claude for Enterprise. מדדי תרומה דורשים הגדרה נוספת כדי לחבר את ארגון ה-GitHub שלך.

נדרש תפקיד Owner כדי להגדיר הגדרות אנליטיקס. מנהל GitHub חייב להתקין את אפליקציית GitHub.

[!WARNING]

מדדי תרומה אינם זמינים לארגונים שבהם מופעל Zero Data Retention. לוח האנליטיקס יציג מדדי שימוש בלבד.

1. התקנת אפליקציית GitHub

מנהל GitHub מתקין את אפליקציית Claude GitHub בחשבון GitHub של הארגון בכתובת github.com/apps/claude.

2. הפעלת אנליטיקס של Claude Code

Claude Owner מנווט אל claude.ai/admin-settings/claude-code ומפעיל את תכונת האנליטיקס של Claude Code.

3. הפעלת אנליטיקס של GitHub

באותו עמוד, הפעל את המתג "GitHub analytics".

4. אימות מול GitHub

השלם את תהליך האימות של GitHub ובחר אילו ארגוני GitHub לכלול בניתוח.

הנתונים מופיעים בדרך כלל תוך 24 שעות אחרי ההפעלה, עם עדכונים יומיים. אם לא מופיעים נתונים, ייתכן שתראה אחת מההודעות האלה:

• "GitHub app required": התקן את אפליקציית GitHub כדי לצפות במדדי תרומה
• "Data processing in progress": בדוק שוב בעוד כמה ימים, ואשר שאפליקציית GitHub מותקנת אם הנתונים לא מופיעים

מדדי תרומה מכסים מאגרים שמתארחים ב-github.com. למאגרים ב-GitHub Enterprise Server, לוח האנליטיקס מציג מדדי שימוש בלבד.

#סקירת מדדי סיכום

[!NOTE]

המדדים האלה שמרניים במכוון ומייצגים הערכת חסר של ההשפעה בפועל של Claude Code. נספרות רק שורות ו-PRs שבהם יש ביטחון גבוה במעורבות של Claude Code.

הלוח מציג את מדדי הסיכום האלה בראש:

• PRs with CC: ספירה כוללת של pull requests שמוזגו ומכילים לפחות שורת קוד אחת שנכתבה עם Claude Code
• Lines of code with CC: סך שורות הקוד בכל ה-PRs שמוזגו שנכתבו בסיוע Claude Code. נספרות רק "effective lines": שורות עם יותר מ-3 תווים אחרי נרמול, בלי שורות ריקות ושורות עם סוגריים בלבד או פיסוק טריוויאלי.
• PRs with Claude Code (%): אחוז מכל ה-PRs שמוזגו שמכילים קוד בסיוע Claude Code
• Suggestion accept rate: אחוז הפעמים שמשתמשים מקבלים הצעות עריכת קוד של Claude Code, כולל שימוש בכלים Edit, Write ו-NotebookEdit
• Lines of code accepted: סך שורות הקוד שכלי Edit ו-Write של Claude Code הוסיפו או הסירו בעריכות שהתקבלו. זה לא כולל הצעות שנדחו, ושורות שנמחקו אחר כך לא מפחיתות את הסך.

#עיון בגרפים

הלוח כולל כמה גרפים להצגת מגמות לאורך זמן.

#מעקב אחרי אימוץ

גרף Adoption מציג מגמות שימוש יומיות:

• users: משתמשים פעילים יומיים
• sessions: מספר סשנים פעילים של Claude Code ליום

#מדידת PRs לפי משתמש

הגרף הזה מציג פעילות של מפתחים בודדים לאורך זמן:

• PRs per user: מספר כולל של PRs שמוזגו ליום חלקי משתמשים פעילים יומיים
• users: משתמשים פעילים יומיים

השתמש בזה כדי להבין איך הפרודוקטיביות האישית משתנה ככל שאימוץ Claude Code עולה.

#הצגת פירוט pull requests

גרף Pull requests מציג פירוט יומי של PRs שמוזגו:

• PRs with CC: pull requests שמכילים קוד בסיוע Claude Code
• PRs without CC: pull requests בלי קוד בסיוע Claude Code

החלף לתצוגת Lines of code כדי לראות את אותו פירוט לפי שורות קוד במקום לפי מספר PRs.

#איתור תורמים מובילים

לוח המובילים מציג את 10 המשתמשים המובילים מדורגים לפי נפח תרומה. אפשר להחליף בין:

• Pull requests: מציג PRs עם Claude Code מול All PRs לכל משתמש
• Lines of code: מציג שורות עם Claude Code מול All lines לכל משתמש

לחץ על Export all users כדי להוריד נתוני תרומה מלאים לכל המשתמשים כקובץ CSV. הייצוא כולל את כל המשתמשים, לא רק את 10 המובילים שמוצגים.

#שיוך PR

כשמדדי תרומה מופעלים, Claude Code מנתח pull requests שמוזגו כדי לקבוע איזה קוד נכתב בסיוע Claude Code. זה נעשה על ידי התאמת פעילות סשנים של Claude Code לקוד בכל PR.

#תהליך השיוך

כש-pull request ממוזג:

1. שורות שנוספו מחולצות מ-diff של ה-PR
2. מזוהים סשנים של Claude Code שערכו קבצים תואמים בתוך חלון זמן
3. שורות ה-PR מותאמות לפלט של Claude Code באמצעות כמה אסטרטגיות
4. מחושבים מדדים לשורות בסיוע AI ולסך השורות

לפני ההשוואה, השורות מנורמלות: רווחים לבנים נחתכים, רווחים מרובים מכווצים, מרכאות מתוקננות, והטקסט מומר לאותיות קטנות.

pull requests שמוזגו ומכילים שורות בסיוע Claude Code מסומנים ב-GitHub בתווית claude-code-assisted.

#חלון זמן

סשנים מ-21 ימים לפני עד 2 ימים אחרי תאריך המיזוג של ה-PR נלקחים בחשבון להתאמת שיוך.

#קבצים שלא נכללים

קבצים מסוימים מוחרגים אוטומטית מהניתוח כי הם נוצרים אוטומטית:

• קבצי נעילה: package-lock.json, yarn.lock, Cargo.lock, ודומים
• קוד שנוצר: פלטי Protobuf, תוצרי בנייה, קבצים ממוזערים
• ספריות בנייה: dist/, build/, node_modules/, target/
• fixtures של בדיקות: snapshots, cassettes, נתוני mock
• שורות מעל 1,000 תווים, שסביר שהן ממוזערות או שנוצרו

#הערות שיוך

שים לב לפרטים הנוספים האלה כשמפרשים נתוני שיוך:

• קוד שנכתב מחדש במידה משמעותית על ידי מפתחים, עם יותר מ-20% הבדל, לא משויך ל-Claude Code
• סשנים מחוץ לחלון של 21 ימים לא נלקחים בחשבון
• האלגוריתם לא מתייחס לענף המקור או לענף היעד של ה-PR בזמן ביצוע השיוך

#להפיק את המרב מהאנליטיקס

השתמש במדדי תרומה כדי להדגים ROI, לזהות דפוסי אימוץ, ולמצוא חברי צוות שיכולים לעזור לאחרים להתחיל.

#מעקב אחרי אימוץ

עקוב אחרי גרף Adoption ואחרי ספירות משתמשים כדי לזהות:

• משתמשים פעילים שיכולים לשתף שיטות עבודה מומלצות
• מגמות אימוץ כוללות בארגון
• ירידות בשימוש שעשויות להצביע על חיכוך או על בעיות

#מדידת ROI

מדדי תרומה עוזרים לענות על "האם הכלי הזה שווה את ההשקעה?" עם נתונים מבסיס הקוד שלך:

• עקוב אחרי שינויים ב-PRs לפי משתמש לאורך זמן ככל שהאימוץ עולה
• השווה PRs ושורות קוד שנשלחו עם Claude Code מול בלי Claude Code
• השתמש לצד מדדי DORA, מהירות ספרינט, או מדדי KPI הנדסיים אחרים כדי להבין שינויים מאימוץ Claude Code

#זיהוי משתמשי על

לוח המובילים עוזר למצוא חברי צוות עם אימוץ גבוה של Claude Code שיכולים:

• לשתף טכניקות prompting ותהליכי עבודה עם הצוות
• לתת משוב על מה שעובד טוב
• לעזור בקליטת משתמשים חדשים

#גישה לנתונים באופן תכנותי

בתוכנית Enterprise, Claude Enterprise Analytics API מחזיר דוחות מעורבות, שימוש ועלות לפי משתמש לארגון שלך על פני משטחי Claude, כולל Claude Code. Primary Owner יוצר מפתח עם ההיקף read:analytics בכתובת claude.ai/analytics/api-keys. ה-API אינו זמין בתוכנית Teams.

כדי לשאול נתוני תרומה דרך GitHub במקום זאת, חפש PRs שמסומנים בתווית claude-code-assisted.

#גישה לאנליטיקס ללקוחות API

לקוחות API שמשתמשים ב-Claude Console יכולים לגשת לאנליטיקס בכתובת platform.claude.com/claude-code. נדרשת הרשאת UsageView כדי לגשת ללוח. לתפקידים Developer, Billing, Admin, Owner ו-Primary Owner יש את ההרשאה הזו. כדי למשוך מדדים יומיים לפי משתמש באופן תכנותי, השתמש ב-Claude Code Analytics API עם מפתח Admin API.

[!NOTE]

מדדי תרומה עם אינטגרציית GitHub אינם זמינים כרגע ללקוחות API. לוח ה-Console מציג מדדי שימוש והוצאות בלבד.

לוח ה-Console מציג:

• Lines of code accepted: סך שורות הקוד שכלי Edit ו-Write של Claude Code הוסיפו או הסירו בעריכות שהתקבלו. זה לא כולל הצעות שנדחו, ושורות שנמחקו אחר כך לא מפחיתות את הסך.
• Suggestion accept rate: אחוז הפעמים שמשתמשים מקבלים שימוש בכלי עריכת קוד, כולל הכלים Edit, Write ו-NotebookEdit.
• Active users ו-Sessions: ספירות יומיות של משתמשים פעילים וסשנים של Claude Code.
• Spend: עלויות API יומיות בדולרים.

#הצגת תובנות צוות

טבלת תובנות הצוות מציגה את העמודות האלה לפי משתמש לטווח התאריכים שאתה בוחר בראש הלוח, כברירת מחדל 30 הימים האחרונים:

• Members: משתמשים ומפתחות API עם שימוש מדווח ב-Claude Code בטווח הזה. משתמשי מפתח API מוצגים לפי שם המפתח, ומשתמשי OAuth לפי כתובת אימייל.
• Spend: סך עלויות API לפי משתמש.
• Lines accepted: סך לפי משתמש של שורות שכלי Edit ו-Write הוסיפו או הסירו בעריכות שהתקבלו.

[!NOTE]

נתוני ההוצאות בלוח ה-Console הם אומדנים לצורכי אנליטיקס. לעלויות בפועל, פנה אל עמוד Cost.

#משאבים קשורים

• ניטור עם OpenTelemetry: ייצוא מדדים ואירועים בזמן אמת למערך התצפית שלך
• ניהול עלויות ביעילות: הגדרת מגבלות הוצאה ואופטימיזציה של שימוש בטוקנים
• הרשאות: הגדרת תפקידים והרשאות