📘 תיעוד 83

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

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

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

#גישה לאנליטיקה עבור Team ו-Enterprise

נווט אל claude.ai/analytics/claude-code. מנהלי מערכת (Admins) ובעלים (Owners) יכולים לצפות בלוח הבקרה.

לוח הבקרה של Team ו-Enterprise כולל:

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

עבור ספירת טוקנים והערכות עלות לכל משתמש, הגדר ייצוא OpenTelemetry, או ייצא את דוח ההוצאות מהגדרות האנליטיקה של הארגון שלך, שמפרט שימוש בטוקנים והוצאה משוערת של נקודות זכות (usage-credit) לכל משתמש ולכל מודל.

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

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

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

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

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

1. התקנת אפליקציית GitHub: מנהל GitHub מתקין את אפליקציית ה-GitHub של Claude בחשבון ה-GitHub של הארגון שלך בכתובת github.com/apps/claude.
2. הפעלת אנליטיקת Claude Code: בעל תפקיד Owner ב-Claude מנווט אל 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 Cloud וב-GitHub Enterprise Server.

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

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

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

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

#עיון בתרשימים

לוח הבקרה כולל מספר תרשימים להמחשת מגמות לאורך זמן.

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

תרשים האימוץ (Adoption) מציג מגמות שימוש יומיות:

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

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

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

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

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

#צפייה בהתפלגות בקשות משיכה

תרשים בקשות המשיכה (Pull requests) מציג התפלגות יומית של PRs ממוזגים:

• PRs with CC: בקשות משיכה המכילות קוד שנעזר ב-Claude Code.
• PRs without CC: בקשות משיכה ללא קוד שנעזר ב-Claude Code.

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

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

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

• Pull requests: מציג PRs עם Claude Code לעומת כלל ה-PRs עבור כל משתמש.
• Lines of code: מציג שורות עם Claude Code לעומת כלל השורות עבור כל משתמש.

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

#ייחוס PR

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

#קריטריונים לתיוג

PRs מתויגים כ-"with Claude Code" אם הם מכילים לפחות שורת קוד אחת שנכתבה במהלך הפעלת Claude Code. המערכת משתמשת בהתאמה שמרנית: רק קוד שבו קיימת ודאות גבוהה למעורבות של Claude Code נספר כקוד שנעזר בו.

#תהליך הייחוס

כאשר בקשת משיכה ממוזגת:

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

לפני ההשוואה, השורות עוברות נירמול: רווחים לבנים נחתכים, רווחים מרובים מצומצמים, מירכאות מותאמות לתקן אחיד, והטקסט מומר לאותיות קטנות (lowercase).

בקשות משיכה ממוזגות המכילות שורות שנעזרו ב-Claude Code מתויגות בתווית claude-code-assisted ב-GitHub.

#חלון זמן

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

#קבצים מוחרגים

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

• קובצי נעילה (Lock files): package-lock.json, yarn.lock, Cargo.lock ודומים להם.
• קוד שנוצר אוטומטית (Generated code): פלטי Protobuf, תוצרי בנייה (build artifacts), קבצים מכווצים (minified).
• תיקיות בנייה (Build directories): dist/, build/, node_modules/, target/.
• נתוני בדיקה קבועים (Test fixtures): תצלומי מצב (snapshots), קלטות (cassettes), נתוני דמה (mock data).
• שורות באורך של מעל 1,000 תווים, אשר סביר להניח שהן מכווצות או נוצרו אוטומטית.

#הערות לגבי הייחוס

יש לקחת בחשבון פרטים נוספים אלה בעת פירוש נתוני הייחוס:

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

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

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

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

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

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

#מדידת ROI

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

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

#זיהוי משתמשים מתקדמים

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

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

#גישה פרוגרמטית לנתונים

בתוכנית Enterprise, ה-Claude Enterprise Analytics API מחזיר דוחות מעורבות, שימוש ועלות לפי משתמש עבור הארגון שלך בכל ממשקי Claude, כולל Claude Code. בעל תפקיד Primary Owner יוצר מפתח עם טווח ההרשאות (scope) 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.

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

לוח הבקרה של Console מציג:

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

#צפייה בתובנות צוות

טבלת תובנות הצוות מציגה מדדים לפי משתמש:

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

הערה: נתוני ההוצאות בלוח הבקרה של Console הם הערכות לצורכי אנליטיקה. לקבלת עלויות מדויקות, עיין בדף החיוב שלך.

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

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